RPL48, a System RPL and Machine Language program developer's toolkit.

[Note: If you're not sure what System RPL is, or whether you need it,
 please read RPL.DOC in the POSTINGS directory on this disk.  It's my
 attempt to make the whole subject understandable.  -jkh-]

This is version 1.12 beta of the RPL48 development toolkit for the HP48SX.

RPL48 v1.12b consists of the following files:

RPL      LIB - the <-RPL->:4.1b library
LIB      LIB - the <-LIB->:1.7 library
RPL      TAB - the reference table
RPLXMPL  DIR - sources of sys-RPL example programs (see below)
LIBXMPL  DIR - <-LIB->:1.7 example
QIX      DIR - source of a little animation demo
CNFLIB   DIR - source of a warmstart configuration library
CNFLIB   DOC - documentation for CNFLIB.DIR
BINTS    DIR - <-LIB->:1.7 example
LINE         - ->COD example
BNF      DIR - source of a BNF parser generator
BNF      DOC - documentation for BNF.DIR
GENTAB   C   - a reference table generator written in ANSI C
LIBRARY  DOC - a text from C.Patton about libraries, (c) by C.Patton, HP Cv.
RPL48    DOC - RPL48 toolkit documentation (plain ASCII)
README   1ST - this file

The following two libraries are alpha versions of the MKROM command and the
debugger written by Mika Heiskanen (mheiskan@vipunen.hut.fi), both libraries
are requiring an installed <-RPL-> library with a serial no. in the reange
97-113. ATTENTION: USE WITH CAUTION !!!

MKROM    LIB - MKROM library
MKROM    DOC - brief doc of MKROM
MKROMX   DIR - MKROM input example
DEBUG    LIB - DEBUG library
DEBUG    DOC - brief doc of DEBUG

Even the <-RPL-> library is branded to J.K.Horn, RPL48 v1.12b is GiftWare,
please refer to RPL48.DOC, chapter 1.1 and Appendix C for further information.

Know problems with <-RPL->:4.1b:
 - don't use EC A-Z { on the supplied reference table - a bug in EC causes
   a jam the display in this special case and I'm not shure about its side
   effects (no mem lost yet, but I've done a ON-C immediately..)


Here's a brief description for the programs of the XMPL directory:

SETUP   ( --> dir )
    Compiles the entire directory

UP      ( --> )
    User friendly UPDIR - could be bound to 31.2

MON     ( --> $ )
    A little memory monitor

LBLD    ( --> grob grob )
    A little menu label drawing utility

PBYTES  ( % --> %' )
    Returns the amount of memory used in a port (even of a WPed port)

->rpl   ( $ --> ob )
    A little shell for ->RPL

DCD     ( dir --> dir' )
    DeCompile Directory. Usefull for dirs generated by L->DIR

CCD     ( --> dir )
    Compile Current Directory (SETUP compiles this program 1st and uses
    it for compiling the whole dir)

tEVAL   ( ob --> ? unit )
    Returns the execution time of ob in ms

FIXIT   ( $ --> ob )
    Tries to fix bad d/l string (the junk that starts with 'HPHP48-x..'
    after d/l). Bases on Joe Horns FIXIT.

ITYPE   ( ob --> # )
    Returns the object type of ob for use with CK<n>... words

cst     ( --> {} )
    A sample CST menu

DAR     ( hxs --> $ )
    DisAssemble Rom. More or less interactive disassembling of ROM based code

Strip   ( ob --> ob' )
    Strips the superflous words from user-RPL programs

GetKO   ( --> ob % )
    Waits for a full keystroke and returns its key object and the key value

F&R     ( $s $f $r --> $' )
    Search $s for all $f and replace them by $r

DBG
    Displays the user stack and waits for a keypress. Any other key than
    <ENTER> causes an ABORT to be executed. Usefull for taking a look at
    the stack from within a program

Types   ( --> )
   Displays a little table of CK<n>... dispatch values

Time    ( --> )
   A running BIG digital clock. Press any key to quit it


Enjoy,
        8-Detlef & Raymond