summaryrefslogtreecommitdiff
path: root/README
blob: a3e05766e63d7a73f68ccf064cb952a7df08e16c (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
Glade
=====

A user interface designer for Gtk+ and GNOME

Web: http://glade.gnome.org

Mailing Lists: glade-users@ximian.com - For discussions about using
                                        Glade to build applications.
               glade-devel@ximian.com - For discussions about the
                                        development of Glade itself.


General Information
~~~~~~~~~~~~~~~~~~~

Glade is a RAD tool to enable quick & easy development of user interfaces
for the GTK+ toolkit and the GNOME desktop environment.
The user interfaces designed in Glade are stored in XML format,
enabling easy integration with external tools.
In particular libglade can load the XML files and create the interfaces
at runtime. The DTD for the XML files is included with libglade, and is
also at http://glade.gnome.org/glade-2.0.dtd.
Other tools are available which can turn the XML files into source code
in languages such as C++, Perl and Python.


About Glade-3
~~~~~~~~~~~~~

This version of Glade (Glade-3) is a complete rewrite of the original Glade codebase.

One of the main differences from glade-2 is that C code generation has been removed from 
glade-3: this has been done on purpose, since using generated code is deprecated; the preferred 
way to use glade files is with libglade (if code generation is needed, this can be provided 
as another tool or plugin, code generation is simply not a part of the glade-3 project).
Another main difference is that glade-3 was designed to make maximal use of GObject
introspection, thus easing the integration of external toolkits and handling widgets,
signals and properties genericly; thus making it easier to write fancy features in the 
future (toolkits such as gtk+ itself, gnome, gnome-db and any others are implemented 
externaly as widget catalogs with optional support libraries, thus catalogs may be 
distributed seperatly; possibly along with their libglade support modules).

It has a few useful new features such as stacked Undo/Redo and Multiple Project support
and respects the same XML format as glade-2.

For a more details on what has changed, what still needs work, etc. see
the NEWS file & the glade3 product at bugzilla.gnome.org.
Comments, bug reports and patches are more than welcome.


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+ 2.20.0 or above - http://www.gtk.org
   You also need the glib, pango and atk libraries.
   Make sure you have the devel packages as well, as these will contain the
   header files which you will need to compile C applications.

 o libxml 2.4.1 - used to parse the XML files. If you have GNOME 2 you
   should already have this.


Installation
~~~~~~~~~~~~

See the file 'INSTALL'