// $Id: README,v 1.15 2000/05/12 21:41:10 christof Exp $

This is a C++ backend for glade, the GUI designer for Gtk. 
This means this program reads glade files and outputs a C++ program source
skeleton for you.  
Each (marked) GUI class has a derivative user class for you to modify and
extend.

We use this at work, so it's functionality is somewhat biased towards the 
parts of gtk we use. And since my time is limited, I didn't implement each
property of each widget.

If you feel something important is missing, please add it and don't forget
to send me your patch so I can include it in future revisions. You might as
well ask me if the feature is planned in the near future.


As I had to code glade--'s output in plain C and
create Gtk-- widgets afterwards I'm going to try to implement a libglade
like approach. The pressure to start this work has significantly decreased
since gnome menus and accelerators are working now!

-------------------------- REQUIREMENTS -----------------------------

You need (at least!):
- glade http://www.comp.lancs.ac.uk/~damon/builder/index.html or check out
		the most recent snapshot at cvs.gnome.org
	for creating the files

to compile glademm
- gcc 2.8+ or egcs-1.0.3+ (http://www.fsf.org/  or   http://www.cygnus.com/)
	[gcc 2.7 port was given up]
  I really recommend gcc-2.95!

to compile your programs
- gtk+ (1.2.x recommended) (http://www.gtk.org/)
- gtk-- (1.1.x recommended, but 1.0.3 is better tested)
	(http://www.iki.fi/terop/gtk/gtk--.html)
- GNU autoconf (http://www.fsf.org/)
- GNU automake (http://www.fsf.org/)
- please make sure that you have the development packages of the needed
  libraries installed, too. (Those containing the .h files)

I also recommend to take a look at my gtk--addons which are available
at cvs.gnome.org. 

---------------------------- USAGE --------------------------------------

simply compile by invoking 
	./configure
	make
	[make install]

create program files
	glade-- --sample sample.glade
or use glade's 'gear' button.
	
Compile your programs by invoking
	cd dir_of_.glade_file
	./autogen.sh (or make)
	
----------------- HOW TO GET IT --------------------------------------

The current (public) source code is available at
	[anon]cvs.gnome.org .
Read http://developer.gnome.org/ ... for more information.

Releases of this program are at
	http://home.wtal.de/petig/Gtk/ .

It's quickly evolving, so you if you got glade-- elsewhere 
you might take a look at this URL now (or even better check out the cvs
version)!

------------------------ USING ANONYMOUS CVS ACCESS --------------------

cvs -d :pserver:anonymous@anoncvs.gnome.org:/cvs/gnome login
<no password, hit return>
cvs -z3 -d :pserver:anonymous@anoncvs.gnome.org:/cvs/gnome co glade--
... working ...

If you want to update your copy enter the directory where you checked it out
and type
cvs -z3 update -dP glade--

------------------------- CONTACT ADDRESSES ----------------------------
	
Enjoy
    Christof Petig <christof.petig@wtal.de>

Feedback and Thanks are always welcome.

Now since there is a glade discussion lists, you might well address your
glade-- problems there:
	glade-devel@glade.pn.org
But beware. I might not have the time to watch this list closely. If you do
not get an answer within a few days try to contact me personally.

For announcements subscribe to:
	glade-list@glade.pn.org (is this list still there?)
As a habit I also post announcements to gnome-announce.
