pi-address README file


What is pi-address:

- GUI frontend to address databases from a 3Com Palm Pilot. 
  It can read/edit/save database files in PDB-format. Those files can be 
  read from or written to the pilot using "pilot-xfer" from the pilot-link 
  package. 

- The program can directly read/write the address data from/to the Pilot.

- The programm can also be used as a general address manager without a
  3Com Palm Pilot. Some of the record fields may be not very meaningful in
  this case.

pi-address cannot:

- SYNC your database between Palm Pilot and the GUI frontend (watch out
  for "Kpilot" if you want this). Maybe this feature will be added later.

Warning: This is still beta software, be sure to have a backup of your
         address database before trying to write back files created with
         pi-address.

Where to find:

- The newest version can always be found at:
  ftp://linux.in-berlin.de/pub/pilot/pi-address.tar.gz
  (Thanks to Frank Ronneburg for providing me with this ftp space)

- A little homepage is located at: http://www.in-berlin.de/User/miwie/pia/
  (Links to the online version of the FAQ and some screenshots provided)

Requirements:

- libqt.so
  You need one of the newer version of Qt (http://www.troll.no). Both
  libqt.so.1.31 and libqt.so.1.32 are known to work. The former has a
  minor bug, which affects the programm slightly and was solved in 1.32.
  Of course the newest versions (1.40, 1.42, 1.43, 1.44, 1.45) work too.
  Note however that the new V2.X of QT currently is not supported and the
  program won't work with it!

  If you want or have to build the program on your own you need this too:

  - development version of libqt
    You need the header files and "moc", the "meta object compiler" from Qt

  - libpisock.so
    Dynamic library and header files from the pilot-link package (V0.8.9, 
    V0.8.11, V0.9.0 and V0.9.3 have been tested, 
    see ftp://ryeham.ee.ryerson.ca/pub/PalmOS/)

  Too actually build the program do the following:

  o  the new autoconf way
     ./configure
     make
     make install

  o  or the old way

     Edit the Makefile according to your local setup
     (especially INCDIRS, LFLAGS_PISOCK_DIR and LFLAGS_QT_DIR)
     make depend
     make
     make install


Tested platforms:

- Linux, 2.0.x, i386

- Linux, arm

- Solaris, 2.5.x/2.6/2.7, Sparc

- Solaris, 2.7, x86

- NetBSD, 1.3, Amiga

- FreeBSD, 2.2.5R, i486

- OpenBSD

- SGI, Irix 6.2, 6.3, 6.5

- HP-UX, 10.20

- Compaq Tru64 UNIX (formerly DEC OSF/1)

  If anybody runs pi-address successfully on another platform 
  please let me know!


Credits:

- Thanks to Flrian Cramer, Rainer Doemer, Philipp W. Grau, Alan Harder, 
  Jon Lasser, Frank Ronneburg, Peter Schwenke, Till Siering, David Wang, 
  Johannes Walther, Carsten Wartmann and Peter Weyers for giving me 
  bug reports, hints, suggestions, ...

 
Contact:

- You can contact the author via email: 
  Michael Wiedmann <mw@miwie.in-berlin.de>

