

			     Welcome to Glade
                             ================

		(a user interface builder for the GTK+ toolkit)

        Glade's Home Page                      : http://glade.pn.org
        Email Address for comments/bug reports : glade@glade.pn.org


NOTE: Glade still needs quite a bit of work to be done before it
      can be safely used for building complete applications. It is currently
      useful for putting together prototypes, or for cutting & pasting
      generated code into your own projects, but I would not advise using it
      to build entire applications.

NOTE: Styles are not supported yet, nor is full support for some Gnome widgets.


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

Glade is a RAD tool to enable quick & easy development of user interfaces
for the GTK+ toolkit. It also contains built-in support for generating the
C source code needed to recreate the interfaces.

The user interfaces designed in Glade are stored in the well-known XML format,
enabling easy integration with external tools. Several tools are already
available which can turn the XML files into source code in other languages
such as C++ and Python (see below).


See the 'TODO' file for current status & planned future developments.
The 'doc/manual.txt' file gives a very brief overview of using Glade.
The 'FAQ' contains answers to some common questions.


License
=======

Glade is distributed under the GNU General Public License (GPL), as described
in the COPYING file.

Note that you are free to use whatever license you like for the source code
generated by Glade. (We do not consider the code generated by Glade to be
'a work based on the Program' as described at the start of the GPL.)


Requirements
============

 o GTK+ 1.2.0 or above - http://www.gtk.org

 o gnome-libs >= 1.0.16 if you want Gnome support. If you have an older version
   of gnome-libs installed and don't want to upgrade, use
   './configure --disable-gnome' to build Glade without Gnome support.

 o Automake 1.4 - ftp://ftp.gnu.org/pub/gnu/automake
                  http://www.gnu.org/software/automake
                  ftp://rawhide.redhat.com/i386/RedHat/RPMS   (for i386 RPMs)
   This is needed to build the C source code generated by Glade.

 o Autoconf 2.13 - ftp://ftp.gnu.org/pub/gnu/autoconf
                   http://www.gnu.org/software/autoconf
                   ftp://rawhide.redhat.com/i386/RedHat/RPMS   (for i386 RPMs)
   This is needed to build the C source code generated by Glade.

 o Gettext 0.10.35 - ftp://alpha.gnu.org/gnu/gettext-0.10.35.tar.gz
   This is needed if you want to build applications with support for gettext.
   (Gettext provides support for translating the strings in your application
    into other languages.)


Languages Supported
===================

 o C - Glade outputs C code itself. The libglade library is also under
   development, allowing the XML files describing the user interface to be
   loaded dynamically. (See http://www.daa.com.au/~james/gnome/.)

 o C++ - for the Gtk-- bindings: http://home.wtal.de/petig/

 o Ada - support is included in the Ada GTK+ bindings: http://ada.eu.org/gtkada

 o Python support is included in the PyGTK bindings. See http://www.gtk.org

 o Perl - http://freespace.virgin.net/dermot.musgrove/computers/perl/
       or http://www.glade.perl.connectfree.co.uk/index.html
       or on CPAN under the Glade module,
	 e.g. ftp://sunsite.doc.ic.ac.uk/packages/CPAN/modules/by-module/Glade/

 o Eiffel - http://www.lfix.co.uk/eiflib/index.html#eglade


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

See the file 'INSTALL'


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

You need automake & autoconf to build the generated C code. You also need
gettext 0.10.35 if you enabled gettext support. See the 'Requirements' section
above.

Run './autogen.sh' in the toplevel directory of the project to run automake,
autoconf and the related utilities to build the Makefiles. Pass it any options
you want passed to configure, e.g. './autogen.sh --prefix /usr/local/gnome'

Then run 'make' to build your application.

Note that for Gnome applications, you must also do a 'make install' so that
the pixmaps are installed properly. If you don't do that, it will still run,
but you won't see the pixmaps.


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+.
   - If you have Gnome.
   - 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), 6 November 1999
