This document includes:

* General information
* Licensing
* Requirements


* General information

GLE is the layout engine for the the Gtk+ toolkit.
Currently, if you want to use it, you have to build and install
this library and to modify your gtk programs in the foolowing way:

in the main() function of your gtk program add the initialization
for the GLE library after the initialization of gtk:

int
main (int argc, char *argv[])
{
  [...]
  
  gtk_init (&argc, &argv);
+ gle_init (&argc, &argv);

  [...]
}

you then need to link your program with the GLE library as well by
adding the "-lgle" option to your compiler/linker, e.g.

$ gcc my-fancy-app.c -o runme -lgle -lgtk -lgdk -lglib -lm

now after you have invoked ./runme, you can press <Ctrl>+<Alt>+<Tab>
in any of the gtk windows that your application creates, and the GLE
shell will popup showing you the widget tree of that specific window.


* Licensing

The Gle library is released under the terms of the GNU LGPL (GNU LIBRARY
GENERAL PUBLIC LICENSE).
Read the file COPYING.LIB for more information.

The rest of the code is released under the terms of the GNU GPL (GNU GENERAL
PUBLIC LICENSE).
Read the file COPYING for more information.

* Requirements

The GLE library depends on a couple of extra packages
for working properly:

	- The latest Gtk+: This is the release of the Gtk+ toolkit.
	  You can find Gtk+ releases at:
	  
	  ftp://ftp.gimp.org/pub/gtk/


* Getting GLE

GLE has it's own web page from which you can get the latest release:

http://www.SoftHome.net/pub/users/timj/gle/index.htm


Have fun,

	Tim Janik <timj@gimp.org>
