
General Information
===================

This is Glade, a user interface builder for GTK+.

Glade's home page is currently http://glade.pn.org

GTK+, which stands for the Gimp ToolKit, is a library for creating graphical
user interfaces for the X Window System. GTK+ version >= 1.0.2 is needed:
http://www.gtk.org/ (Glade should now also compile and run with GTK 1.1.3,
and the themes version of GTK, though this isn't completely working yet.) 

Glade outputs C code itself. Support for other languages is being developed
by others:
  C++ source code output for the Gtk-- bindings: http://home.wtal.de/petig/
  Perl & Python output is also under development.

Glade is in the early stages of development. It's not fully functional yet.
See the 'TODO' file for current status & planned future developments.
The 'doc/manual.txt' file gives a very brief overview of using Glade.

Glade now supports gettext, and includes Portuguese (Brazilian), French,
German and Spanish translations (though these are not all complete).
To use these set your LANG environment variable to "fr", "de" "es" or "pt_BR"
before running Glade (e.g. "setenv LANG pt_BR" in csh or
"export LANG; LANG=pt_BR" in sh). See 'ABOUT-NLS' for more info.

Comments/suggestions welcome, to glade@glade.pn.org


Installation
============

See the file 'INSTALL'


Building Glade-Generated C Source Code
======================================

Currently you need autoconf & automake to build the C source files which are
written by Glade. (You could possibly create your own Makefile if you are
desperate.)
  http://www.cygnus.com/~tromey/automake/

You should be able to just type 'make' to build the sources - the configure
script should be built automatically.

Note that source code to handle styles isn't included yet,
nor is full support for a few widgets: pixmap, toolbar.

  *** NOTE *** A common error reported when trying to compile programs is:

     aclocal: configure.in: 10: macro `AM_PATH_GTK' not found in library

  This means that the gtk.m4 file cannot be found. (gtk.m4 is a set of m4
  macros which is installed as part of GTK and is used to build programs which
  use GTK.) aclocal (part of automake) searches for these macros to add to
  aclocal.m4 in your programs root directory.

  To find out where GTK is installed, run 'gtk-config --prefix'.
  The gtk.m4 file should be in the 'share/aclocal' subdirectory.
  To find out the directory that aclocal is using, run 'aclocal --print-ac-dir'
  Now copy the gtk.m4 file to the proper aclocal directory and it should work.

  If you are using GTK 1.1.x a similar problem may occur with GLib.
  To solve this you also need to copy the glib.m4 file to the aclocal
  directory. glib-config can be used to find out where the glib.m4 file is.


Mailing Lists
=============

There are two mailing lists related to Glade:

  glade-list@glade.pn.org   for announcements of new versions of Glade, and
  glade-devel@glade.pn.org  for discussions relating to development of Glade.

To subscribe, send mail to majordomo@glade.pn.org with "subscribe
glade-list" or "subscribe glade-devel" in the body of the message.


How to report bugs
==================

To report a bug, send mail to glade@glade.pn.org

In the mail include:

* The version of Glade

* Information about your system. For instance:

   - What version of GTK+
   - What operating system and version

  And anything else you think is relevant.

* How to reproduce the bug. 

* If you can, send a stack trace. To do that, start gdb with 'gdb glade',
  start glade with 'r', do whatever causes the crash, and then type 'bt' in
  the debugger to print a stack trace.


Submitting Patches
==================

Please use diff -ru to create the patch, and send it as a gzipped file
attachment. If it entails major changes to Glade, please discuss it on
the glade-devel list first.


Damon Chaplin (glade@glade.pn.org), 16 November 1998
