RoutePlanner 0.10
-----------------

A highway trip planner based (a long, long time ago) on Jim
Butterfield's RoadRoute for the Amiga computer.  If there's any
original RoadRoute code still here, I'd be surprised.

RoutePlanner requires the Python interpreter to be installed on your
system.  It probably requires Python 1.5.2 at a minimum; the version
distributed in Debian 2.2 (potato) should work fine.  It is also
compatible with Python 1.6 and 2.x, if you recompile any necessary
extensions.  The command line version will also run under Jython (nee
JPython), the Python interpreter coded in Java.

You also need the following Python modules (Debian packages in parens):
 kjBuckets (python-kjbuckets)*
 PQueue    (python-pqueue)*
 snack     (python-newt) [only if you want to run rplan]
 pyglade   (python-glade) [only if you want to run grplan or gredit]

* Optional; RoutePlanner will fall back on (slower) pure Python code
  if the package is missing.

kjBuckets is available at
http://starship.python.net/crew/aaron_watters/kjbuckets/index.html
It is included in Debian 2.2 (potato) and the testing and unstable
branches of Debian.

python-pqueue is not included in Debian 2.2 (potato), but it will be
in the next release (woody).  You can also obtain it from
http://www.pigpond.com/~earthpig/PQueue-0.2.tar.bz2

This release includes three user interfaces:

- rpcli will run on any console; it should even run on Win32 and other
  platforms.  If available, it will use the readline module for
  editing and history.

- rplan uses a slang-based interface using Red Hat's "newt" toolkit.

- grplan uses a Gnome interface based on libglade.

All three have similar features; however, the Gnome version will
retain preferences and other stuff.

A GUI-based editor is also available.  The editor will ensure that the
databases are kept in canonical format (so patches will apply somewhat
cleanly); if you edit the database by hand, you need to manually do an:

   db = rpdbase.RPDatabase('filename')
   db.Save('filename2')

cycle to maintain correctness.  Please submit patches that fix
problems with the database to the author.

Additional information will eventually be provided in the HTML
documentation.  You can read "RoutePlanner.guide" for a description of
the AmigaOS RoutePlanner program, upon which this version is based
(albeit very loosely).  Please note that none of the licensing terms
in that file apply to this release, and that the file itself is now
released under the same license as the Python code here.


Chris Lawrence
