Guikachu 1.2.0
==============

Guikachu is a GNOME application for graphical editing of resource
files for PalmOS-based pocket computers. The user interface is
modelled after Glade, the GNOME UI builder. Check out
http://cactus.rulez.org/projects/guikachu/ for up-to-date
information.


Requirements
------------
Guikachu uses GTKmm and GNOMEmm for its user interface. File I/O is
implemented via the libxml package. Dialog windows are loaded via
libglade. GConf is used to store user preferences. You will need the
versions of these packages available in the GNOME 1.4 bundle (with the
exception of GNOMEmm which you will need to upgrade to version 1.2.0)
To actually create the PalmOS resource files, you will also need PilRC
(part of the GNU PalmOS SDK) to compile the .rpc files produced by
Guikachu.
To use the stand-alone Guikachu-to-RCP converter program, xsltproc
(part of the libxslt package) is required.

The build process is only tested with the GCC 3.0 compiler family. There
has been reports of issues with the virtual inheritance code when
using older versions of GCC (e.g. 2.95).


Installation
------------
Untar the Guikachu source tarball somewhere, and start the 'configure'
script:

 $ tar xzvf guikachu-1.2.0.tar.gz
 $ cd guikachu-1.2.0
 $ ./configure
 * make
 
See the INSTALL file for general help on using the `configure' script.
If everything is just fine, you can install and try it

 $ make install
 $ guikachu

If you start Guikachu and it segfaults when you try to open any
window, it is an indication of guikachu.glade not propertly
installed. Please re-install Guikachu (it will try to check for
required files on startup, but it has no way of detecting the Glade
file being out of date)


Features
--------
 * libXML-based I/O
 * Exporting to PilRC .rcp files (compile with pilrc -H)
 * Support for non-PalmOS PilRC targets (like the eBookMan)
 * String and string list resources
 * Dialog resources
 * Menu resources
 * Form resources
 * Per-application resources (e.g. version number)
 * WYSIWYG Form Editor, with drag & drop capability and visual resizing
 * XSLT style sheets and shell script to generate RCP files from
   Guikachu documents
 * Sample file with sample GNU PalmOS SDK-based application
 * Documentation (a complete user's manual)

 
Reporting bugs
--------------
(and good feature/UI/whatever ideas)
Please use the GNOME Bugzilla (accesible at http://bugzilla.gnome.org)
to file bug reports and feature requests. Detailed instructions are
available on the page. If you find the Bugzilla interface too
complicated, just email directly our mailing list at
guikachu-main@lists.sourceforge.net.


Contact information
-------------------
The Guikachu website is located at http://cactus.rulez.org/projects/guikachu/
The mailing list for both users and contributors is accessable at
http://lists.sourceforge.net/mailman/listinfo/guikachu-main
You can also mail the author directly, at cactus@cactus.rulez.org.


About this release
------------------
After half a year of development, we are proud to offer version 1.2,
our new production-quality release, with several new features,
including the following:

	* Support for string list resources
	* Usability improvements in the form editor, including
	  resizing of widgets via drag-and-drop, and selecting widgets
	  by drawing a bounding box with the mouse
	* Support for projects targeting non-Palm handhelds
	  (currently, this is limited to eBookMan palmtops)
	* Improved font support, including escape sequences
	* And, of course, lots of bug fixes and miscellaneous small
	  usability improvements

See the NEWS file for details
