hrsh2csv: conversion utility for Hours PalmPilot databases
----------------------------------------------------------

*** WARNING: While every effort has been made to find and remove bugs
*** from hrsh2csv, it is still under active development. You use it at your
*** own risk. Since hrsh2csv is still under active development, there may be
*** bugs which will cause the conversion crash to the point where your data
*** gets lost.

hrsh2csv is a small command line utility to convert PalmPilot PDB files which
were created by the Hours application. The binary PDB files contents are
converted into CSV (comma separated value) format to stdout.

hrsh2csv is Free Software provided under the terms of the GNU General Public
License (GPL). Read the file "COPYING" that is included in this distribution to
learn more about the GNU GPL.


Installation
------------

hrsh2csv is distributed in sources only. You need to recompile it yourself. To
do so, unpack the sources and go to the hrsh2csv directory. Open the file
"Makefile" and customize it to fit your needs. Than type the following
commands on the shell:

  make
  make install 

By default the hrsv2csv will be installed with "prefix=/usr/local". You can
override this by editing the makefile or typing the following instead of 
"make install".

  make prefix=/your/own/prefix install

There are only two files that gets installed in your system.
hrsh2csv which is the executable converter and hrsh2csv.1 which is
the appropriate man page.

After compiling and installing you can type

  make clean

to save disk space. Of course you can delete the whole source code directory if
you don't need it anymore.


Documentation
-------------

hrsh2csv comes with its own man page. If you'd like to produce a dvi, ps or pdf
file out of it type:

  make doc


Resources
---------

hrsh2csv is a part of the Hours Project which is located at the Web under the
following URL:

  http://hours.sourceforge.net

Development of Hours and hrsh2csv has been hosted at SourceForge for some time.
SourceForge is a hosting site for many Open Source software projects provided
by VA Linux Systems, Inc. Hours' and hrsh2csv's particular project page on
SourceForge is at the following web site:

  http://sourceforge.net/projects/hours


Author
------

hrsh2csv and Hours was written by Peter Novotnik. If you find any bugs in those
programs, please do not hesitate to contact the author. His email address is:

  peternov1@gmx.de

You can also make a bug report or a feature request at the about mentioned
project site.


--
  Peter Novotnik <peternov1@gmx.de>
  Sat May  3 10:00:52 CEST 2003
