1. ABOUT GUILOADER
2. RELEASE NOTES
3. INSTALLATION
   * General Info
   * X11/Posix 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 the 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://crow-designer.sourceforge.net


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

2.10.0, 2007/01/06

* Updated GuiXml version: 9
* Added .spec file (based on Denis Leroy work)
* Minor internal improvements


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

**** General Info

GTK+ manual contains several useful hints on 'configure'-based installations: http://developer.gnome.org/doc/API/2.0/gtk/gtk-building.html

**** X11/Posix Installation

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

- gtk+-2.0

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/guiloader/guiloader.h

**** Windows Installation (MinGW)

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 Bug Tracker (Bug Tracker is currently not available, use this URL: http://gnomefiles.org/comment.php?soft_id=1488). Reports should include all relevant information if possible:

* Crow 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