This is the README file for "pi-address". 


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. 
  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.

- 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.


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)

  There is a mirror site at ftp://walther.in-berlin.de/pub/pilot.
  (Thanks to Johannes Walther for providing this ftp area as backup).
  In case you have trouble to connect to the primary ftp server,
  try this one instead.

  For people in the US maybe this mirror will be much faster:
  ftp://pv915.pv.reshsg.uci.edu/pub/pilot/.
  (Thanks to Rainer Doemer for this ftp space).

  The archive contains a ready to run binary, all the source files,
  a small address database and some documentation.

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


Requirements:

- libqt.so.1.32
  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

  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.a
    Static library from the pilot-link package (V0.8.9 and V0.8.11 and have
    been tested, see  ftp://ryeham.ee.ryerson.ca/pub/PalmOS/)

  Too actually build the program do the following:

  o  QTDIR has to be set to point to the root-dir of qt (e.g. /usr/local/qt)
  o  PILOT_LINK has to be installed. Set the toplevel dir in Makefile
     (libpisock.a will be linked statically)
  o  make depend
  o  make
  o  make install


Tested platforms:

- Linux, 2.0.x, i386

- Solaris, 2.5.x, Sparc

- NetBSD, 1.3, Amiga

- FreeBSD, 2.2.5R, i486

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


Credits:

- Thanks to Rainer Doemer, Philipp W. Grau, Jon Lasser, Frank Ronneburg, 
  Till Siering, 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>

