Libman
A small but powerful LIB-key manager for the HP49/HP49+
With the Filer, libs can be purged and moved but the LIB
menu on the LIB key cannot be rearranged in any way. This
key becomes intolerably slow with about 20 libs on the HP49.
Libman solves these and other problems.
One may easily create small LIB menus for one or more
directories. Libraries whose commands are not used directly (like
extable) or which are set by extra keys need not show up in
the LIB menu, hence will not slow down the LIB key anymore. They remain active.
One can also rearrange the libraries
into categories, e.g., games on page 1, etc. A "spacer"
inserts gaps in the LIB menu, e.g., to fill the game page if
there are only 5 games, say. Store the library in a
port and attach it as usual with a warmstart.
If Libman is set from the LIB
menu, the screen looks as indicated by the screen-shot, displaying also title and version. The one-page command menu of
Libman is shown as well, with precise descriptions below.
Data on the LIB menu are stored in LPAR, a list which may be
different in different directories, similar to PPAR. In other
words, LIB-key customization may be context-sensitive.
This is very useful for people using many different libraries
from different areas. Do not modify LPAR manually, various
commands will do it for you. Purging LPAR or storing the
empty list in it amounts to the same. Important: There are 2 versions,
Libman (last version 7.2003) is valid for ROM 19-6 on the HP49,
and LibmanPlus (alias Libman+) is valid for ROM 1.22 on the HP49+. The
essential difference is that Libman+ has four options at the end of the LIB menu,
:0: :1: :2: :3: if the menu has been customized. In stack (default) mode,
these set corresponding port browsers, see below. In edit
mode, these options set port menus as usual. Since there is no menu of the
card files, :3: sets the MTH menu in edit mode.
What is New
VERSION 1.2004 (Libman+): Each of the options :0: :1:
:2: :3: of the LIB menu sets port browser in default mode.
VERSION 9.2003 (Libman+): Appending to the LIB menu a port entry :3:
for SD-card management.
VERSION 8.2003 :(Libman+) Updating to ROM 1.22 because of a different
management of the LIB menu by the OS.
VERSION 2.2003:
LBOX is faster, with a simplified application menu. Menu of
the main browser LBOX reorganized. This html version is a
revised version of the plain ASCII file Libman.text.
VERSION 7.2002:
Completely new browser for rearranging the LIB menu, no stack
manipulation anymore. 4 browsers make everthing as pleasant
as possible.
LDAT
removed.
VERSION 6.2002:
New command
LDAT toggles library data. Enriched apps-menu
of LBox. CsLIB and Rearrange (formely Reord) are also in the
apps menu of LBox which has become a full-screen browser. Its
commands AddL, RemL, CsLIB can now get multiple items to be
marked with a special check-option in the apps menu.
Fast instruction for a first use.
Press command CsLIB or LBox. This opens the
main browser of all attached libs (see also the screenshots
below). Select with F1 your favourite ones for the LIB menu
and press press Cust.You are now in the so-called
Rearrange-box of the selected libs with its own menu. The
menu options DROP and GAP allow to drop some
items, to add gaps (empty places in the LIB menu), and ORDER
permits to reorder the items such that the checked ones are
on top. The first two menu options do the Cheching and
Unchecking. With GAP one easily gets a multiple of 6 many
items which puts the 3 port entries on a separate page. OK
confirms the customization, i.e., you'll see the titles on
the LIB key in the order shown in the Rearrange box.. After
returning to the main browser leave it with CANCEL and
the LIB menu looks as wanted. Clearly, customization is valid
only in USR mode. Outside USR mode, the LIB menu looks
unorganized as before and there aren't any port browsers at the end of the
LIB menu in Libman+.
Both CsLIB (Customize LIB) and LBox (Library
Box) are browsers containing all attached libs on your
calculator. The only difference is that the menu options Cust
(Customize) and AddLs (Add Libs) of CsLIB refer to the
current directory only. Thus, in HOME these commands act identically. The 2-page application menu of these
browsers looks as follows:
| vCHK |
UnCHK |
Cust |
AddLs |
CmdBx |
OK |
| CFG |
EXTP |
HALT |
ORDα |
CANCL |
OK |
Both browsers show the lib titles and
numbers for instance as in the screen. Normally, the libs are
listed in ascending order of the lib numbers.
But option ORDα on menu page 2 swaps this with alphabetic order of
the library titles as in the screen, internally controlled by
user flag 27. Alphabetic ordering may slow down the browser
on the 49. In the menu only CFG
and EXTP
are "hacker" options.
They recall $CONFIG and $EXTPRG if
present in the library source. You see them on the stack with HALT
which suspends the main browser temporarily so that one
can do some other things and then return to the library browser with CONT. In
all browsers, vCHK checks the items with little numbers in
growing order, UnCHK removes all check marks. Items can also be checked with
the +/- key which sets standard check marks, no numbers. Clearly, this is useful only if order doesn't count.
Attention. When having checked
some items do not press shifted UParrow or DOWNarrow for fast
scrolling because this erases the check marks although the checked items
remain checked internally (a bug in the old HP48 browser engine).
Cust puts the checked libs into the
Rearrange box which contains the libs you see with the LIB
key, for instance as shown in the screenshot. A little number in
at the end of the browser title shows how long the LIB menu
will be. In the example screen this is a 6 which means that
the LIB menu will have two pages, the second one containing
only the port entries. If nothing is checked, Cust takes only
the scanned one for customization. You may later add some
libs to the LIB menu with AddLs. One may add gaps or drop
some items or reorder as stated already above. The example
screenshot will generate a gap on page 1 at position 5.
Some items had just been checked. If pressing ORDER and then OK on
this screen you get Choosext at the 1st, Fontman at the 2nd
postion in the resulting LIB menu. Once the LIB menu has been customized, the Rearrange box
may also directly be set with the Rearr
command, see below.
Important:
Only the OK-option in the Rearrange box confirms the LIB menu
customization. Returning to the main browser with CANCEL
does not set anything! Remember, if the Rearrange browser is called from inside CsLIB, then OK creates or overwrites LPAR
in the current directory. If the Rearrange box is called directly or
from inside LBox, the LPAR first found on the
path is overwritten or created in HOME if not found.
Leaving the main browser with OK or ENTER
sets the command menu of the selected library. If you don't want
the selected library menu, leave LBOX with CANCEL. Instead of
setting a library's menu you may also browse through its commands
with CmdBx as in the screen. This is the last not yet commented menu option of the
main browser. It shows all visible commands of the selected
lib. In addition, it also shows HELP on F1 whenever HELP
exists for the scanned command (like for the command Ð in OT49 as shown
in the last screen). Just press HELP to see the HELP text.
Presently, only few libraries provide HELP although this can easily be made
with D
L
from OT49. In the CmdBx-browser, Stk
on F6 recalls a selected command while EVAL and EXIT do what
they suggest.
Description of Libman's six library commands (refers
to RPN mode only)
| CsLIB |
A browser similar to LBox. The only
difference is that its menu options Cust or AddLs
customize the LIB menu in the current directory after
pressing OK in the Rearrange-box. That is, LPAR
is created or overwritten only in the current
directory, while starting with LBox, OK will act on the
LPAR first found on the path, normally the one from
HOME. |
| Rearr |
The Rearrange box. A browser that
rearranges the LIB menu as described above, provided
LPAR is on the path (i.e., the LIB menu has already
been customized with CsLIB). |
| Updat |
Updates LPAR which after purging or updating a
library may contain obsolate
data. Does nothing if LPAR is empty or not existent. LPAR
may be empty. In this case, the LIB menu consist of
port entries only. |
| UnCs |
uncustomizes the LIB menu by
deleting the small key assignment made in the
Rearrange box with OK. Should be used only when
purging Libman or updating it to a newer version. |
| LofRP |
(List of Rom-Pointers). This
powerful command yields the list of all named and
unnamed rompointers of any external or internal
library. Its argument is the lib number, a real or
zint. E.g., 222 LofRP yields the huge list of
rompointers of the CAS library. You can use this and
other lists for making own application menus. The
ouput list is empty if and only if no external or
internal library with the input romid exists. If a
rompointer's content is needed, recall it with DType
from OT49, for instance. |
| LBox |
Main browser, decribed above. We
propose to assign it to rightshift-hold LIB (93.31).
This is a useful alternative to the standard LIB key.
LBox works completely independent on any user
customization of the LIB menu. |
The browsers :0: :1:
:2: :3: at the end of the LIB menu
Suppose you customized the LIB menu and are in USR mode. Then you see
:0: :1: :2: :3: at the end of the LIB menu which in
default mode are port browsers similiar to browsing a port with the filer
but with a smaller menu. In particular, :3: is a card browser provided there
is a card in the slot. Otherwise it simply browses HOME. The menu options
EVAL VIEW COPY MOVE PURGE RCL HEADER
HALT
are self-explaining and the
most important operations with files on a port, card included. In addtion, some hard keys are active as long as this menu lives.
As usual, the Arrow keys
,
and
their shiftings do the browsing,
may be
used for setting the TREE and
for
entering another port or directory. Other hard keys functions are almost
the same as in the built-in filer. They are mainly for
temporary file sorting except for Unsort on key U which
has no key in the built-in filer. Double-click
on ALPHA is useful for name search. There is no ORDER
option in the menu because files on the SD-card or in ports aren't reorderable. There is also no TREE entry from the menu and no
transfer option because these browsers need not have the full
functionality of a filer. The browser is left with CANCEL and resets
the last page of the LIB menu. Here a listing of some active hard keys in the
port browsers. A key is denoted by the letter on it
except for +/-.
| N |
Name sorting (LS N = inverse name sorting). |
| S |
Size sorting (LS S = inverse size sorting). |
| T |
Type sorting (LS T = inverse type sorting). |
| U |
Unsorting (original order of files on
the SD-card). |
| +/- |
Selecting files, e.g., for COPY. Also done
with ENTER |
Wolfgang Rautenberg - raut@math.fu-berlin.de
- www.math.fu-berlin.de/~raut
Credits: The browsers in Libman are partly based on
the descriptions in Programming in SysRPL by Carsten Dominik
and Eduardo Kalinowski. Peter Geelhoed wrote the codes
extracting $CONFIG and $EXTPRG. Note that Libman has no
library splitter/creator because the much older OT49 always contained it, named
DL
.