1. ABOUT GUILOADER/C++
2. RELEASE NOTES
3. INSTALLATION
   * General Info
   * X11/Posix Installation
   * What's Installed
   * Windows Installation (MinGW)
4. HOW TO REPORT BUGS


======================
1. About GuiLoader/C++
======================

GuiLoader/C++ is a C++ binding to the GuiLoader library. It is a convenience layer that simplifies development of GuiLoader based applications written in the C++ language by introducing exception safety, binding GTK+ objects defined in GuiXml to C++ variables and type-safe dynamic connection to signals.

Project Home: http://crow-designer.sourceforge.net


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

2.10.0, 2007/01/06

* Added .spec file (based on Denis Leroy work)
* Bugs fixed:
  - TSignalConnector::connect function has invalid "if" statement (typo)
  - Typical example: GtkTextBuffer signals are not ignored on exit
* Registered new signals for GuiXml v9
* 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/C++ compilation requires runtime and development packages of this software installed:

- guiloader
- gtkmm-2.4

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

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

GuiLoader/C++ 'configure' script supports --enable-hiddenvisibility option that passes -fvisibility=hidden flag to the GCC compiler. This compilation mode produces significantly smaller C++ executables and more optimized code on ELF platforms. (Currently GuiLoader/C++ crashes when compiled with GCC 4.1 or earlier in such a way.)

**** What's Installed

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

**** Windows Installation (MinGW)

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

Assuming that corresponding instructions in GuiLoader package README are already followed, GuiLoader/C++ adds this additional prerequisite to be installed:

- gtkmm wrapper for Win32: http://ftp.gnome.org/pub/gnome/binaries/win32/gtkmm/

GuiLoader/C++ may be built and installed now with these commands executed in MSYS window from the toplevel distribution directory 'guiloader-c++-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=1489). 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