               Ŀ
                MemKey2 - Memory Indicator in the CST Menu 
               
                             for HP48 S SX G GX

     Written by Jorge Costa <l38861@alfa.ist.utl.pt> in April 10, 1998


------------
= Overview =
------------

MemKey is a memory utility. It allows users to take control over the amount of
free memory in each port. Memkey 2 is dedicated to users with large RAM cards
installed, which is the only case where a program like MemKey becomes useful.

--------------
= Disclaimer =
--------------

THERE ARE NO GUARANTIES AS TO THE PERFORMANCE OF THIS PACKAGE.

I AM NOT RESPONSIBLE FOR *ANY* KIND OF DAMAGE CAUSED BY THE
DOCUMENTATION OR SOFTWARE PROVIDED.

I RECOMMEND YOU TO BACKUP YOUR MACHINE'S MEMORY BEFORE USING THE 
SOFTWARE.

USE THIS AT YOUR OWN RISK.

PERMISSION TO COPY THE WHOLE UNMODIFIED PACKAGE IS GRANTED, PROVIDED 
THAT
THE COPIES ARE NOT MADE FOR RESALE (EXCEPTING NOMINAL COPYING FEES).

THIS PRODUCT MAY NOT BE USED FOR COMERCIAL PURPOSES, WITHOUT PRIOR 
WRITTEN
PERMISSION FROM THE AUTHOR.

--------------------------------
= Compatibility & program info =
--------------------------------

This software uses unsupported entries, although they seem stable. It runs
on both S/SX and G/GX machines and was tested in HP48 ROM rev E, J and P.

Here are some of the configurations that were successfully tested:

-> HP48S.
-> HP48SX + ROM cards on slot 1 and slot 2.
-> HP48GX + 128Kb RAM card on slot 1.
-> HP48GX + 1Mb RAM card on slot 2.
-> HP48GX + 128Kb RAM card on slot 1 + 1Mb RAM card on slot 2.
-> HP48GX + merged 128 Kb RAM card on slot 1 + 1Mb RAM card on slot 2.

Size: 1180.5 bytes  Checksum: #1005h (#4101d)

---------------
= Description =
---------------

MemKey displays the amount of available user memory in the label correspondent
to its menu key. By pressing the key, a browser will display the information
on all existing ports.

The browser keys are:

UP ............. Decrease port number.
DOWN ........... Increase port number.
RS+UP .......... Jump to port #0.
RS+DOWN ........ Jump to last port (at the bottom of the screen).
RS+ON .......... Turn OFF the HP48.
ON ............. Exit MemKey.

The browser menu is:

[KB] ........... Switch between values in kbytes and bytes.
[->STK] ........ Copy the list of browser items to the stack.
[?] ............ Show version/author info.
[OK] ........... Exit MemKey.

There is an additional functionality related to key combinations:

[MemKey] ....... Start the browser (as explained).
LS+[MemKey] .... Jump to ALLMEM, if installed.
RS+[MemKey] .... Equivalent to MEM.

ALLMEM is a command (from a library of the same name) that displays the amount
of free user memory as well as card slot memory, written by Sjon C. Moore. For
more information, visit his web site at http://www.gatecom.com/~sirjon/hp/ .

There are some important things you must be aware of:

1. This is a System RPL/User RPL hybrid, you can't edit the program.

2. Because of 1., you can't use the command line to add it to the
   custom menu.

3. Because of 2., please follow the installation procedure written below.

4. If you use the program, don't keep the label visible all the time,
   because it might slow down the calculator (due to garbage collection).

----------------
= Installation =
----------------

-> Download the MemKey file to your calculator using binary transfer.

-> Put the object in the stack - you now have something like { { "MemKey2"...
   on level 1.

-> There two chances:

   1- If you don't have any custom menu stored, just enter 'CST' STO.
   2- If there already is a custom menu, go to the directory where you
   have it stored (usually HOME), type CST + 'CST' STO.

-> Press CST key, you now have MemKey in the first menu label.

---------------------------
= Know limitations & bugs =
---------------------------

Several bugs were solved in the transition from the first release of MemKey.

If you are using the first release of MemKey, let me warn you that there was
a terrible bug visible in the interactive stack on the HP48 ROM rev P and
that crashed the ROM rev R calculators. It seems that problems may occur
every time a user command is included in the code that generates a menu grob.

If you want to stick to the first release, please e-mail me and I'll send you
a fixed version 1.

To the present date, no bugs are known on MemKey 2, if you find one, please
report it to me _asap_. You'll be credited for that! :-)

Of course, suggestions are _always_ welcome!

As to limitations, the browser is still very slow, as well as the display
routine. Key repetition is not yet available, several modifications have to
be made to make it possible.

--------------------
= Acknowledgements =
--------------------

This program is a result of a lot of people's work.

I would like to thank to (in alphabetical order):

-> Christian Meland, for lots of suggestions and for help on S/G detection.

-> Christophe Meynard, for PMEM's code, included in MemKey.

-> HP, for the HP48 and the software development tools.

-> Joe Horn, for his original idea of displaying time in a custom menu label,
   for suggestions and also for HIPORT's code, included in MemKey.

-> Martin Pedersen, for beta testing and suggestions.

-> Mika Heiskanen, for Jazz, Hack and ENTRIES.SRT.

-----------
= Changes =
-----------

From version 1.0:

-> Removed xMEM in the menu display, fixing a bug.
-> Added a browser, for a list of the available memory in all ports.
-> MEM is obtained from RS+[MemKey], instead of [MemKey].
-> LS+[MemKey] starts ALLMEM, if installed.

------------------------------------------------------------------------------
=   Jorge Costa - Chemical Engineer - Instituto Superior Tecnico - Portugal  =
=   E-mail: l38861@alfa.ist.utl.pt      WWW: http://alfa.ist.utl.pt/~l38861  =
------------------------------------------------------------------------------
