Guikachu 0.4
============

Guikachu is a GNOME application for graphical editing of resource
files for PalmOS-based pocket computers (get it?). It is written by
Gerg rdi <cactus@cactus.rulez.org>. Check out
http://cactus.rulez.org/projects/guikachu/ for up-to-date informations.

Requirements
------------
Guikachu uses GTK-- and GNOME-- for its user interface. File I/O is
implemented with the libxml package. Dialog windows are loaded via
libglade. You will need the versions of these packages available in
the GNOME 1.4 bundle (with the exception of GNOME-- which you will
need to upgrade to version 1.1.17)
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.

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

 $ tar xzvf guikachu-0.4.tar.gz
 $ cd guikachu-0.4
 $ ./configure
 
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 (no DTD yet for .guikachu files)
	* Exporting to PilRC .rcp files (compile with pilrc -H)
	* String resources
	* Dialog resources
	* Menu resources
	* Form resources
	* Per-application resources (e.g. version number, icon)
	* Form editor (supported widgets: label, button, repeating
	  button, graffiti stae indicator)

Yet to come:
	* User interface improvements (e.g. context menus)
	* Picture resources, application icons
	* Support for more widgets
	* Figure out a way to support relative positioning features of
	  PilRC 
	* Documentation
	* Sample file with sample GNU PalmOS SDK-based application
	* General bug-hunting, robustness

Reporting bugs
--------------
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 this is too compilcated for you for whatever reason, don't hesitate
to simply mail me at cactus@cactus.rulez.org.

Changes in this version
-----------------------
Numerous user interface improvements make it more pleasant to work
with Guikachu. Two new widgets are supported: the Button (unified with
the Repeating Button) and the Graffiti State Indicator widgets. As
always, see the NEWS file for details.
