Guikachu 0.6
============

Guikachu is a GNOME application for graphical editing of resource
files for PalmOS-based pocket computers. 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 via 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.21)
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 on the GCC 2.95 compiler family. EGCS
in particular is known to have problems (consider upgrading to GCC
2.95).

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

 $ tar xzvf guikachu-0.6.tar.gz
 $ cd guikachu-0.6
 $ ./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
	* 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 state indicator, push button, check box)
	  with graphical drag & drop capability to make designing
	  forms more easier and faster

Yet to come:
	* User interface improvements (e.g. context menus)
	* Picture resources, application icons
	* Support for more widgets
	* Rendering texts via native PalmOS fonts
	* 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
--------------
(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 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
-----------------------
This is a rushed release because previous versions wouldn't work with
GNOME-- 1.2.0. Other than the port, only minor fixes are included.
As always, see the NEWS file for details.
