Millennium/48
============

This program calculates the number of days left until new year's eve,
1999/2000. If you know the "Millennium" TV-Series, you have probably
seen the message Frank Black gets when starting his computer. Well,
this is the same for the HP48.

On a HP48 G(X), it displays it's message "Welcome. There are xxx days
left." using a cool 3D-box (press F to continue). On an SX, it
displays the message using the INPUT environment (so press ENTER to
continue). The program can be customized to use your first name
("Welcome, FOO."); see below.

I wrote the whole thing using a HP48 GX (ROM revision R) with a 512kb
RAM card (4 covered ports). So, this little bugger *should* work
on any HP48 S(X)/G(X) with 1kb free memory in any port (yes, even
covered ports on a GX!), since it is plain user-RPL. I could not
really test it, though (only on one SX, revision E, and my GX,
revision R).

0. Warranty and license: GPL
----------------------------

This program is free software; you can redistribute it and/or modify
it under the terms of the GNU General Public License as published by
the Free Software Foundation; either version 2 of the License, or
(at your option) any later version.

This program is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
GNU General Public License (file "COPYING") for more details.

So, if this erases your calculator's memory - don't blame me. It
should not be able to do something like that (no sysRPL!), but you
have been warned.

1. Installation
---------------

The program comes in 3 variants:

    1. "Millennium"  Directory
    2. "Mill.lib"    Library, auto-attaching
    3. "Milla.lib"   Library, auto-attaching, auto-executing

The libraries use lib number 1791; I have not registered this one, so
if it causes trouble, use the "Millennium" directory instead.

You just have to copy the file you want to your calc. If you have
chosen a library, you have to store it in a port, eg.:

       'Mill.lib'
       DUP
       EVAL
       0
       STO
       PURGE

Afterwards, turn your calc off and on again. You can store your
name in a variable called "mname" in the HOME directory. Millennium/48
checks wether this variable contains a string (longer than 1
character) and customizes the message accordingly. This is optional -
try it if you like.

"Millennium" and "Mill.lib" provide a function called "Key.Mill" which
reassigns rShift-ON and enters USER-key mode in order to automatically
launch the program when turning your calc off and on. "Milla.lib" does
this automatically when warm-starting the calculator (I prefer this
one).

2. Usage
--------

The directory variant of Millennium/48 contains the following 2 commands:

      1. "Millennium"   Launch the main program. Rather
		       self-explanatory. No parameters taken off the
		       stack.
      2. "Key.Mill"    Assigns Millennium/48 to rShift-ON.

"Key.Mill" (only available in "Millennium" and "Mill.lib", see above)
puts the keyboard into USER-mode and assigns the program to
rShift-ON. So, whenever you switch your calc off and on, Millennium/48
is launched.

3. Milla.lib
------------

As already mentioned above, this version automatically puts the
keyboard into USER mode and changes the ON-key definition every time
the calc is "rebooted" (new library installed, ON-C pressed, etc). If
you do not like this to happen, use "Mill.lib".

4. Uninstallation
-----------------

Remove the "Millennium" directory

       'Millennium'
       PGDIR

or the library:

       0:1791
       DUP
       DETACH
       PURGE

Then remove the key redefinition of the ON-key:

       19.3
       DELKEYS

You can also disable the USER mode:

       -62
       CF

5. Contact
----------

You can reach me via email:

Robert Fendt <fendt@student.physik.uni-dortmund.de>