Installation Instructions for PDA.Palm package for Python

This package now uses the standard Python module builder, augmented by
a small configuration script.  This should make building significantly
easier than in the last release...

To install this package, first unpack the tar file in a suitable
location.  (If you're reading this, you've already done that!)

Next, build the extension modules:

  - Run the 'configure' script.  The following options are available:

       --pilot-link-prefix=<directory>  (default: /usr/local)
           The location of pilot-link; libraries are looked for in
           $(pilot-link-prefix)/lib, and so forth.

       --shared / --static  (default: --shared)
           Configure for dynamic or static linking.  (See below.)

     If all goes well, 'configure' should create a new subdirectory
     called 'plat-<something>', where <something> is the name by which
     Python knows your platform (eg. 'linux2').  There should also be
     a Makefile in the current directory.

  - run 'make'.

  - run 'make install'

    Assuming all went well, PalmPython will now be installed in the
    site-packages subdirectory of your Python library.


** Static Linking:

Theoretically, you should be able to build a statically-linked Python
binary instead of shared libraries, just by passing '--static' to the
configure script.  All this really does is change one line in the
'Setup' file; the Python build process is supposed to do the rest.
Unfortunately, it does not seem to work on my machine, so if you
actually manage to make it work I'd appreciate hearing from you.


--Rob Tillotson <rob@io.com>
