
1. ABOUT GUILOADER/C++
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/C++
======================

GuiLoader/C++ is a C++ binding to GuiLoader library. It is a convenience layer that simplifies development of GuiLoader based applications written in 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://gideon.sourceforge.net
Gideon Forum: http://groups.google.com/group/gideondesigner


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

2.7.1, 2006/07/10

* Minor optimization to signal connection code
* Connecting to unregistered signal error is now reported


===============
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/C++ compilation requires runtime and development packages of this software installed:

- GTK+ toolkit (http://www.gtk.org)
- GuiLoader (http://gideon.sourceforge.net)
- GTK+/C++ wrapper (http://www.gtk.org/bindings.html)

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. Unfortunately GuiLoader/C++ crashes when compiled (with GCC 4.1 or earlier) in such a way; hopefully this will change in future GCC releases.

**** What's Installed

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

**** Windows Installation (MinGW)

NOTE: 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:

- GTK+/C++ wrapper for Win32: http://www.pcpm.ucl.ac.be/~gustin/win32_ports

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 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!
