doc: Make the developers guide just a description of file formats.
[pspp] / src / ui / gui / README
1 The GUI uses the Gtk+ library.  Many parts are defined using
2 GtkBuilder files, which have a '.ui' prefix.  These are XML files and
3 as such can be editied using a text editor, which is often easiest
4 when making small changes.  More substantial changes however are best
5 done using Glade.  Since however PSPP has many custom defined widgets,
6 Glade must be started with certain environment variables set.  The
7 easiest way to run Glade with the correct variables is as follows:
8
9     make src/ui/gui/glade-wrapper
10     ./src/ui/gui/glade-wrapper <name-of-gtk-builder-file>
11
12 If you create new custom widgets for use in PSPP you must do the following to
13 make sure they are available to Glade:
14
15 * Add a call to its '_get_type' function to preregister_widgets(),
16   which is found in widgets.c.
17
18 * Add the name of the module to
19   src_ui_gui_libwidgets_essential_la_SOURCES in automake.mk.