This is the README file for makeaddr.

Author:

   Adam Stein (adam@scan.mc.xerox.com)

Copyright:

  Copyright (c) 1999, 2003  Xerox Corporation.  All Rights Reserved.

  Permission to use, copy, modify  and  distribute  without  charge
  this  software,  documentation, images, etc. is granted, provided
  that this copyright and the author's name is retained.

  A fee may be charged for this program ONLY to recover  costs  for
  distribution  (i.e.  media costs).  No profit can be made on this
  program.

  The author assumes no responsibility for  disasters  (natural  or
  otherwise) as a consequence of use of this software.

Description:

  This program will read a Palm Pilot Address Book database and create
  an address book in FrameMaker MIF file format suitable for printing.

  This program has the ability to select which Pilot address book 
  catagories are saved to the MIF file.

  The only command line argument allowed is the Pilot database to
  read.  If this argument isn't given, it will default to:

	$ENV{'HOME'}/.pilotmgr/Backup/LatestArchive/AddressDB.pdb

  This is the location where Pilot Manager's backup conduit would
  store the file.

Requirements:

  This program requires Perl 5.004 or higher.  Also required is
  the pilot-link Perl module (v0.9.2 or newer).

  The pilot-link package (which includes the Perl5 module) can be
  found at:

	ftp://ryeham.ee.ryerson.ca/pub/PalmOS/

Installation:

  This program has only been tested on Solaris 2.x systems.

  Change the first line in "makeaddr" to reflect where Perl is installed
  on your system.

  Modify the line that starts out:

	local (@savecat)...

  (line 31) to list the Pilot Address Book categories to save

  Copy the makeaddr program to your favorite bin directory.

Bugs/Additions:

  I would appreciate knowing about any bugs either found or
  fixed and any enhancements made.  I would like to keep a
  centralized version with the upgrades so that there aren't
  50 million different versions.  I can't make any
  guarantees to when bug fixes would be made (if any are
  found :-{), but I'll do my best.

  I hope this program is of use to you, either in it's capacity or as
  an example in Perl/Pilot programming.

