Back to index

Installation

Backing up your databases

Please backup your databases before installing LispMe. It's very unlikely that LispMe destroys other databases and it never happened in any test, but better safe than sorry...

Deleting older versions

Please delete any older versions of LispMe with the Memory application before installing V2.3. The DB format has changed and a crash is likely when LispMe finds an earlier version of its memory dump.

Choosing versions

This package includes LispMe10.prc (Version 2.31) and LispMe20.prc (Version 2.32). LispMe20 is for PalmOS2 and PalmOS3 only and has some features not possible with PalmOS1: However, there are still many PalmOS1 users, so I compiled LispMe for this OS release, too. So LispMe10 is not an old version, but supports the same features as LispMe20, except floating point.

There's no special version for the Palm III, instead LispMe checks the OS version and uses additional resources (especially twice the stack space) when it recognizes a Palm III. So it's easy: If you're running PalmOS1, install LispMe10.prc, if you're running PalmOS2 or PalmOS3, install LispMe20.prc. You can install LispMe10.prc on PalmOS2, but this would be silly, as you will miss all new features LispMe supports with PalmOS2. On the other hand, running LispMe20.prc on PalmOS1 is not possible and results in an error.

Don't try to install both versions on one Pilot, they both use the same creator ID and the DB format is not compatible!

Needing math?

PalmOS1 users please ignore this section. LispMe supports transcendental functions like atan. However, LispMe does not implement these functions, but uses a standard Pilot library called MathLib for this purpose. LispMe for PalmOS2 will work without MathLib, but you can't use transcendental functions without it. MathLib is included in this package for your convenience. So if you already installed MathLib or decide to dispense with it, go to the next section. Otherwise select MathLib.prc for installation.

Installing LispMe

Just use your favorite installation tool to install LispMe10.prc or LispMe20.prc and (optionally) MathLib.prc

Installing Parentheses Hack

You have to install HackMaster to use Parentheses Hack. You probably already installed it, but if not, go here to get it. Parentheses Hack simplifies entering of LispMe programs, but isn't really necessary for LispMe to work. For details see here.

Just use your favorite installation tool to install ParHack.prc and activate it via HackMaster. Don't forget to deactivate Parentheses Hack in HackMaster before installing a new version!

Setting up MemoPad and installing demos

Note: Some sample programs have changed from version 2.2 to 2.3. These are: LispMe expects all memos to be loaded in the MemoPad category LISP. If this is the first time you install LispMe, you should create a MemoPad category Lisp (case doesn't matter) in your desktop MemoPad. Import the file samples.csv into this category (unselect the private field in the import dialog), even if you already installed an earlier version of LispMe, since some demos have changed. If you modified earlier demos, you have to carefully mix your changes with the new demos.

Alternatively, you can use the install-memo tool from the Pilot Link suite to transfer each .txt file in this directory. Don't forget to remove the first line of each memo on your Pilot, as install-memo adds the file name as the first line. Additionally, you have to change the category of each memo to LISP.

Hotsyncing

Now hotsync your pilot.

Pilot setup

The first thing you should do after installing LispMe on your Pilot is setting up LispMe's memory preferences. Go to the Preferences dialog and select memory sizes according to these guidelines:

That's it!

Have a look at the demos and have fun with LispMe!