GASCHEsoft  presents

Agenda 48

... designed for HP 48G/GX
... written in 100% system RPL
... compiled on an HP 48GX with Mika Heiskanen's famous Jazz (6.1)
... brought to you by the makers of HP-Encrypt
...  by GASCHEsoft, 1998

What is Agenda 48 ?

Agenda 48 turns your HP 48 G or GX (sorry, not S/SX) into a PDA !
The library is (like the HP 48 itself) fully Y2K compliant.
The allowed dates range from 10/15/1582 to 12/31/9999.
It respects your settings of the date format
(mm/dd/yy or dd.mm.yy), but please DON'T change them
after getting started with Agenda 48.

How to install Agenda 48:

1. Download the file A48.lib to your HP 48G/GX.
2. Put it on the stack.
3. Enter port:1648 to the stack. On a G, port is 0,
   on a GX port can be 0 to 33 depending on your expansion cards.
4. Press [STO].
5. Turn your HP off and back on.
   CAUTION: The contents of the stack will be lost!
6. Agenda 48 is self-configuring, so you are now ready to use it.
   When you use Agenda 48 for the first time, it will generate
   a variable Agdb (Agenda DataBase) in your HOME directory.
   Here is where all information is stored.

How to use Agenda 48:

The library adds the following commands to the command set of your HP 48.
Press [right-shift] [2] [A48] to see them.

Command    Description            Stack diagram (4: 3: 2: 1: --> 4: 3: 2: 1:)

OATD       Open Agenda ToDay.                              ( --> )

OATD+      Open Agenda ToDay + offset. (1: real (IP is used) --> )

AGBR       AGenda BRowser: opens the                (1: date --> )
           agenda at a specified day.

SHTD       SHow ToDay.                                     ( --> )

SHTD+      SHow ToDay + offset.        (1: real (IP is used) --> )

SDAY       Show specified DAY.                      (1: date --> )

STOA       STOre in Agenda.               (2: string 1: date --> ) or
                                          (2: date 1: string --> )

?STOA      STOre in Agenda only if the    (2: string 1: date --> ) or
           same isn't already stored.     (2: date 1: string --> )

SRCA       SeaRCh in Agenda.               (2: date 1: real1 --> ) or
                                         (2: string 1: real2 --> ) or
                          (2: {date string} 1: {real1 real2} --> )

           IF SIGN(real1) == 1 THEN all dates after date are found.
           IF SIGN(real1) == -1 THEN all dates before date are found.
           IF SIGN(real1) == 0 THEN date must be matched exactly.

           IF real2 <> 0 THEN all strings containing string are found.
           IF real2 == 0 THEN string must be matched exactly.

           The list combines the two with a logical AND.

PRGA       PuRGe from Agenda.                              see SRCA

STRDA      STRip Duplicates from Agenda.                   ( --> )

RCKA       Recall and ChecK Agenda database.   ( --> 1: list of {date string})

CKRA       ChecK and Replace Agenda database.  (1: list of {date string} --> )
           Warning:
           This overwrites your current Agdb!
           Save the contents of the variable 'Agdb' residing in HOME
           elsewhere before using this command!

AA48       About Agenda 48.                                ( --> )

Annotation: date means a real number in either mm.ddyyyy or dd.mmyyyy format,
            depending on flag -42.

The Agenda Browser provides you with the following menu:

<-Y        Switches one (left-shifted 10, right-shifted 100) year(s) back.

Y->        Switches one (left-shifted 10, right-shifted 100) year(s) forward.

<-M        Switches one (left-shifted 3, right-shifted 6) month(s) back.

M->        Switches one (left-shifted 3, right-shifted 6) month(s) forward.

QUIT       Quits the browser.

OK         Shows the selected day.

NXT LOW    Toggles on and off the slower and less smooth low memory consumption
           mode which quits the browser before showing a day. Use it only when
           you have less than 5 KB free memory.

All standard choose box keys are enabled too.

Show Day provides you with the following menu:

EDIT       Lets you edit an entry.

NEW        Lets you enter a new entry. Enters for you automatically
           any string in stack level 1. The new entry is inserted after the
           selection. Left-shifting prepends and right-shifting appends it
           to the list.

PURGE      Purges the selected entry.

ORDER      Sorts the list alphabetically. Left-shifting moves the selection
           to the top, right-shifting to the bottom.

CANCEL     Quits Show Day by discarding all changes.

OK         Quits Show Day by actualizing your Agdb.

NXT ->STK  Exports an entry to the stack.

NXT STK->  Imports a string from the stack. For shifting see NEW.

All standard choose box keys are enabled too.

Version History:

v1.0 (12/20/1998):       FIRST PUBLIC RELEASE

Legal:

Agenda 48 is freeware.
But please register by mail or email (see at the end of this read-me)
if you use it longer than for a trial period.
You do NOT have to pay anything, but you will encourage me to continue developing
software for your calculator.
Because I spent all my rare spare time for almost one year in Agenda 48, I would be very
happy about any gift, especially Macintosh software !
(Didn't you just write a nice shareware ?)

Agenda 48 is protected by copyright law. You must not disassemble or modify it
except for your PERSONAL use only.

Please feel free to redistribute Agenda 48. But you must not sell it or use it
commercially in any other way without my written permission.

Agenda 48 was developed very carefully and SHOULD not corrupt your HP's memory.
However, GASCHEsoft is not responsible for any damage occurring by the use of Agenda 48.

Frequently asked questions:

Is there any S/SX version ? - No, there isn't and will never be because of Agenda 48's GUI.

Do you have plans to expand Agenda 48 ? - Yes, if I get enough registrations. When I get
  some information about the built-in character table engine, I can rewrite the browser !

Can you please send me the source code ? - Yes, it costs you US$ 10.-- and is for
educational use only. If you want to base your software on it, feel free to ask !

Contacting GASCHEsoft:

Please feel free to send any comments (and registrations/gifts of course) to:

GASCHEsoft Inc.
c/o Thomas Gasche
Furkastrasse 81
CH-4054 Basel
Switzerland

E-Mail: gasche00@stud.unibas.ch