
1. ABOUT GUILOADER
2. RELEASE NOTES
3. INSTALLATION
   * General Info
   * GNU/Linux and *BSD Installation
   * What's Installed
   * Windows Installation (MinGW)
4. HOW TO REPORT BUGS


==================
1. About GuiLoader
==================

GuiLoader is a high-performance and compact GuiXml loader library. This library allows GTK+ applications to create GUI widgets and objects at run-time from GuiXml resource files. GuiLoader is written in C language as a GObject subclass and has a trivial language-independent API. GuiLoader was designed to be easily wrapped for any language that has GTK+ bindings.

Project Home: http://gideon.sourceforge.net
Gideon Forum: http://groups.google.com/group/gideondesigner


================
2. Release Notes
================

2.7.1, 2006/07/10

* Better handling NULL values in arrays of entities that were struct's in Gideon 2.7.0
* Verbose error message for GuiXml versions prior 7
* More strict error checking in signal connection code
* Fixed bug in typical example: GtkTextBuffer signals are not ignored on exit


===============
3. Installation
===============

**** General Info

'INSTALL' file contains general installation instructions. More hints on 'configure'-based installations may be found in GTK+ manual: http://developer.gnome.org/doc/API/2.0/gtk/gtk-building.html

**** GNU/Linux and *BSD Installation

GuiLoader compilation requires runtime and development packages of this software installed:

- GTK+ toolkit (http://www.gtk.org)

Building and installing GuiLoader may be performed with standard commands executed from the toplevel distribution directory 'guiloader-x.y.z':

$ ./configure --enable-hiddenvisibility
$ make
<become root if necessary>
# make install

GuiLoader 'configure' script supports --enable-hiddenvisibility option that passes -fvisibility=hidden flag to the GCC compiler. This compilation mode produces smaller executables and more optimized code on ELF platforms.

**** What's Installed

GuiLoader library:   lib/libguiloader.*
Pkg-config file:     lib/pkg-config/guiloader.pc
Header file:         include/gideon/guiloader.h

**** Windows Installation (MinGW)

NOTE: The preferable way to build GuiLoader for Windows is to use MSVC 8.0 compiler; README.msvc contains detailed instructions on how to do this with Boost.Build system.

GuiLoader has these prerequisites to be installed:

- MinGW and MSYS: http://www.mingw.org
- GTK+ for Win32: http://gladewin32.sourceforge.net

GuiLoader may be built and installed now with these commands executed in MSYS window from the toplevel distribution directory 'guiloader-x.y.z':

$ ./configure
$ make LDFLAGS="-mwindows"
$ make install


=====================
4. How to Report Bugs
=====================

Bug reports should be posted to the Gideon Forum. Reports should include all relevant information if possible:

* Gideon Designer and GuiLoader versions
* versions of OS and distribution
* full versions of GTK+ and compiler 
* program output and crash dialog text 
* procedure to reproduce the bug
* .gui files and source code
* everything else that might help

English grammar, spelling and style corrections are highly appreciated!
