
                          ADDRESS BOOK v1.1a


                        by Eduardo Kalinowski

  Portions of code by Joe Horn, Andre Schoorl, Daniel Lindstrom and
                          Jean-Yves Avendard



INTRODUCTION
------------
    This is another address book library for the HP48G series
calculator. Actually, despite its name, it can be used to store any
kind of data in a record-based way. Each record has a name and some
data. When you start the program, you see the list of all names in the
address book. Clicking on the |VIEW| softkey allows you to view the
data associated to it.


VERSION HISTORY
---------------

Version 1.1a
    - Corrected bug that happened if UFL was not found.

Version 1.1
    - Corrected bug when using the ENTER key to view a record.
    - Changed the format of ADDRBKpar. To convert your old records,
      just run the supplied program CONVERT. It will try to convert
      your records to the new format. If no ADDRBKpar variable could
      be found, it exits with the error "Undefined Name". If the
      contents of ADDRBKpar were invalid, it exits with the error "Bad
      Argument Value".

Version 1.0
    - First version released.
    

INSTALLATION
------------
    Download the ADDRBK.LIB file to your HP48G calculator. This
library will NOT work on S series HP48 calculators. Install the
library. Installing a library is considered basic knowledge of the
calcualator operation, because it is described in the Manual, Chapter
28. If you don't know how to do it, look at the manual. After the
library is installed, you may purge the ADDRBK.LIB variable from your
calculator to save space.
    This library requires the UFL library by Andre Schoorl, with FNT1
installed. UFL can be downloaded from Andre Schoorl's homepage at
http://www.engr.uvic.ca/~aschoorl/


USE
---
    To enter the address book, press Right-Shift+2, and click the
|ADDRE| softkey (press NXT one or more times if you can't see it). You
should see two softkeys: |ADDR| and |ABOUT|. Press |ABOUT| to bring an
about scree, and |ADDR| to enter the main program.

    You now should see a list of all the records. If this is the first
time you run this program, the list will probably be empty. Click on
the |NEW| softkey to add a record. First, you will be prompted for the
record's name. This is the name that will appear in the list. Enter a
name and press ENTER. Names longer than 22 characters will be
truncated in the record list, but in the record view (described later
their name is not lost. Now enter the data. This is the information
the record will contain, such as telephone numbers, addresses, etc.
You may enter up to eight lines of 33 characters each. Press ENTER
when done, and you'll be brought back to the main screen, with your
new record there. The record list is automatically sorted everytime
you make a modification.

    NOTE: While adding a record, press ON to cancel.
    
    To view a record, move the highlight to it an press the |VIEW|
softkey. When you are done, press any key to go back to the main
window. Alternatively, hightlight the record and press ENTER.

    To edit a record, select it and press the |EDIT| softkey. You'll
be prompted for the name and the data again. Make any modifications
you wish and press ENTER, or press ON to cancel.

    Use the |DEL| sofkey to delete a record. Hightlight it and press
that softkey. You'll be asked if you really want to delete it. Press
ENTER, ON or |YES| to delete if, or |NO| if you changed your mind.

    The |ABOUT| softkey brings an about screen, just like the softkey
in the main library menu.

    To quit, press ON or |QUIT|. Your records will be saved.

    There is no undo function, but if you make a mistake, you may
recover your records to the way there were before you entered the
address book by exiting it via ON-C. However, this will delete the
stack and PICT contents also.

    The records are stored in the ADDRBKpar variable. Do not modify
its contents.


COPYRIGHT AND DISCLAIMER
------------------------
    This program is (c) by Eduardo Kalinowski. Some routines this
program uses were created by Joe Horn, Andre Schoorl, Daniel Lindstrom
and Jean-Yves Avenard.
    This program is freeware. It may be freely distributed if in its
whole, unmodified form; and if you do not charge anything for it,
except nominal copying fees.
    This program comes with no warranty of any kind. Use it at your
own risk. Backup your memory if not sure.
    You may e-mail me at ekalin@iname.com . My homepage is at
http://hp48g.home.ml.org .
