Guikachu 1.4.0: "Lost Ones"
===========================

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. I/O is
implemented via GNOME-VFS, the XML storage format is managed with 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.3).
The ImageMagick library is used for managing bitmap resources.
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.

The build process is only tested with the GCC 3.x 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.4.0.tar.gz
 $ cd guikachu-1.4.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
--------
 * Uses GNOME-VFS, you can load files from anywhere, e.g. from the
   Web, from an SMB share, from a tarball.
 * Exporting to/importing from PilRC .rcp files
 * Support for non-Palm PilRC targets (like the eBookMan)
 * Support for the following PalmOS resource types:
	- String and string list resources
	- Dialog resources
	- Menu resources
	- Form resources
	- Bitmap and BitmapFamily resources
	- Per-application resources (e.g. version number)
 * WYSIWYG Form Editor, with drag & drop capability, cut & paste, and
   visual resizing
 * Flexible, complete undo support
 * 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
------------------
See the included NEWS file for details about this release.
