==== Description ====

Gate3 is an application that generates Ada code from a glade3 file, for rapid
testing of GTK user interface.

Gate3 takes as input files generated by glade 3.8.
Since Gtkbuilder for Ada does not support glade 3.10 or higher,
DO NOT USE WITH GLADE 3.12 or YOU MAY ENCOUNTER COMPATIBILTY PROBLEMS !!

Gate3 is limited in scope and does not generate User_Handler callbacks.
It is just a simple tool to avoid tedious typing.

Important notice : if you want to generate code for Gtk2, see last paragraph

Date : August   2016 - v05 release
Date : January  2013 - v04 release
Date : December 2013 - minor add-on for Gtk3

==== Copyright ====
(C) 2012/2013 Francois FABIEN
-- Send comments to : francois_fabien@hotmail.com
The program is licensed under the MIT license.

==== Requirements ====

you need
-- GNAT compiler
-- GTKAda
-- Templates_Parser (A module of Ada Web Server)
       Package Debian : libtemplates-parser11.6-dev
       Sources Git d'Adacore :
       $ git clone http://forge.open-do.org/anonscm/git/template-parser/template-parser.git

       A convenient mirror to retrieve a single zip file :
       https://github.com/sogilis/template-parser


==== How to build Gate3 ====

Prerequisites :

********************  MANDATORY ******************************************
Setup the environnement variable GPR_PROJECT_PATH to find the project file
gtkada.gpr and templates_parser.gpr


For Windows, example of GPR_PROJECT_PATH
(if you used the default locations)
C:\GNAT\2012\lib\gnat;C:\GtkAda\lib\gnat

For Debian, add the line to file .bashrc :
GPR_PROJECT_PATH=/path/to/gtkada.gpr; export GPR_PROJECT_PATH
(if you used the default locations)
 /usr/share/ada/adainclude
**************************************************************************

To build just use the makefile script :
$ make

The build script compiles Gate3 and runs the simple.glade test case.

==== Installing ====

1/Modify the license file gate3_license.txt to your particular needs

2/Install in the directory of your choice (by default /usr/local)
$ make install
or in a custom directory
$ make PREFIX=/path/to/dir install


==== Using Gate3 ====

Usage: gate3 [options] glade3-file
Options:
    -h --help                 show this message
    --version                 show version
    -m proc_name              Proc_Name : Ada main procedure name
    -d some/dir               search some/dir for input files
    -o some/dir               some/dir : directory for output
    -t some/dir               some/dir : directory for templates
    -p                        create output directory


Read file GUIDE_gate3_EN.txt for a tutorial on Glade and code samples.


==== Plateforme of test ====

Debian 64 bit (Wheezy) with gcc-4.6 and libgtkada2.24.1-dev
GLADE version 3.8.3

==== Acknowledgments ====

Thanks to Brian Drummond for his suggestions and testing.
Thanks to Pascal Pignard for his suggestions and testing and the Gtk3 template.

==== Generating code for Gtk2 ====

There is no switch to enable both Gtk2/Gtk3 code generation.
This would require a new version of gate3.
Anyway, with just a change in template for the main you can generate code suitable for Gtk2.
In 2 steps :
1/ rename file gate3_main.tmplt to gate3_main_gtk3.tmplt (to save it).
2/ rename file gate3_main_gtk2.tmplt to gate3_main.tmplt