
	This file describes the programs that for some reason are not yet
	included in the Jazz library.

	The programs are provided separately and in library form.

**********************************************************************

	Name:	EC
	Desc:	Entries browser. Address sorted.
		Requires Jazz, RPL.TAB and DIS.TAB and VV
	Stack:	( --> ? )

	Keys:	Up Down		= move 1 entry
		LS+Up/Down	= move 10 entries
		RS+Up/Down	= top/bottom

		F / alpha	= Find (case independant name search)
		NXT		= Next match
		PREV		= Prev match
		ENTER		= Push entry to stack
		LS+ENTER	= Push address of entry to stack
		RS+ENTER	= push name to stack
		ON		= exit
		0-9		= find address
				  ( 0-9A-F keys give further accuracy)
		+/-		= beep on/off
		EEX		= grep mode (using find string)
				  Up/Down can be slow after this, use wisely
		Right		= Call DOB on entry and view with VV

	Installation:
		Change the "ID VV" at the end of the code to whatever is
		necessary (romptr?).

**********************************************************************

	Name:	PK
	Desc:	Pack object
	Stack:	( ob %speed --> $ ), 0 <= %speed <= %15
	Keys:	ON aborts

	Notes:	%speed determines *minimum* look-back range (#0FF-#FFF)
		PK uses a history buffer to store what has been scanned.
		If memory is low no history may be available for some
		patterns and thus both speed and efficiency will be lost
		(available history is always used fully if it covers the
		minimum look-back range).
		If you have a GX with lots of memory speed 0 is recommended.

	Name:	UPK
	Desc:	Unpack a packed object
	Stack:	( $ --> ob )

	Warnings:
		PK may still have a bug causing scrambled output. Hasn't been
		repeated yet. Until then might be better to verify pack
		result with UPK+BYTES checks.

**********************************************************************

	Name:	RTB->
	Desc:	Converts RPL.TAB to a readable string.
		Requires Jazz
	Stack:	( --> $ )

	Name:	->RTB
	Desc:	Converts and entry list to RPL.TAB format
	Stack:	( $ --> $' )

	Notes:
		->RTB input must end in a newline character.
		->RTB parses each line separately accepting following format:
			[=]<EntryName>	[EQU #]<Address> [Comments]
		For example RTB-> output is valid input for ->RTB as is
		the entries.a file provided by HP.
		->RTB assumes the lines are already sorted, otherwise ->RTB
		would take much too long to execute.
	Warning:
		DO NOT FORGET TO MAKE A NEW DIS.TAB WITH MKTAB
		IF YOU CHANGE YOUR RPL.TAB

**********************************************************************

	Name:	TB
	Desc:	Tabifies source strings.
	Stack:	( $ --> $' )

		TB tries to recognize RPL and machine language portions in
		the string, leaves RPL parts as they are but tries to indent
		instructions and their field selectors with a tabulator.
		Eg space character sequences are converted to a single
		tabulator.
		New Jazz uses tab so this is not so useful anymore.

**********************************************************************

	Name:	ED
	Desc:	String editor, small font.
		Requires Jazz (FNT1)
	Stack:	( $ --> $' )

	Memory requirements:
		#300 nibbles for a data buffer
		Enough memory to duplicate $ if it isn't already in tempob.

	Note that ED makes no copy of the original string if the string is
	already in tempob. Store the $ to a variable first if you wish to
	have a backup. This feature will *NOT* be changed.

	ED uses the 4x6 from in Jazz. Other font sizes are not supported nor
	will ever be.

	Keys:

	NS,LS,RS planes:

+-------+-------+-------+-------+-------+-------+
|BSTART |BEND   |BCOPY  |BDEL   |       |FIND   |	B refers to block
|       |       |       |       |       |       |
|       |       |       |       |       |REPLALL|
+-------+-------+-------+-------+-------+-------+
|ARG?   |       |MEXEC  |       |UP     |NEXT   |
|ROW?   |CHR?   |MSTART |TOHEX  |PGUP   |       |
|POS?   |CHRCAT |MEND   |TOASC  |TOP    |STATUS |
+-------+-------+-------+-------+-------+-------+
|''     |       |       |LT     |DN     |RT     |
|       |       |       |       |PGDN   |       |
|       |RCLSTK1|       |LSTART |BOTTOM |LEND   |
+-------+-------+-------+-------+-------+-------+
|GOTO   |GOSUB  |GOYES  |REVERSE|       |       |
|GOLONG |GOSUBL |GONC   |       |       |       |
|GOVLNG |GOSBVL |GOC    |       |       |       |
+-------+-------+-------+-------+-------+-------+
|EXIT   |TOGBEEP|TAB    |DEL    |BS     |
|       |TOGCASE|       |DELLINE|       |
|       |TOGOVER|       |       |       |
+-------+-------+-------+-------+-------+
|alpha  |7      |8      |9      |/      |
|       |SETMK7 |SETMK8 |SETMK9 |()     |
|       |GOMK7  |GOMK8  |GOMK9  |#      |
+-------+-------+-------+-------+-------+
|lshift |4      |5      |6      |*      |
|       |SETMK4 |SETMK5 |SETMK6 |[]     |
|       |GOMK4  |GOMK5  |GOMK6  |ASS_RPL|
+-------+-------+-------+-------+-------+
|rshift |1      |2      |3      |-      |
|       |SETMK1 |SETMK2 |SETMK3 |<<>>   |
|       |GOMK1  |GOMK2  |GOMK3  |""     |
+-------+-------+-------+-------+-------+
|REDISP |0      |.      |SPC    |+      |
|       |       |,      |PI     |{}     |
|OFF    |GOMK0  |NEWLINE|       |::     |
+-------+-------+-------+-------+-------+

Alpha plane special keys:

A LS -	= ::newline; with indent checks
A RS -	= $ ""
A LS +	= {newline} with indent checks
A RS +	= CODEnewlineENDCODE

A DEL	= DEL
A BS	= BS
A ENTER	= newline & indent the same way as previous line

Input routines have:
	Left/right
	Far left/right
	DEL/BS
	ON (cancel)
All character/string keys work except those requiring indentation checks
unless input data is decimal.

During CHRCAT enter echos character, ON exits.

TOHEX/TOASC take BLK as arg, if one is not set current character (pair if
necessary) is marked.

REVERSE reverses block or if one is not chosen until the end of current word.

ARG is terminated with enter, next non-modifier key is then repeated.
ON or error aborts repeat.

MACRO key automatically terminates macro save mode, nesting is not
allowed. Only main level ED keys (non-modifiers) are saved. Max length is 50
keys.

MACRO example:
	Assume you have a hex string containing 3-nibble values.
	DIS it to get an editable string, start ED
	Remove the HXS <len> field so all you have is "hhhhhhhh...."
	Then press:
		LS+CST				( start save )
		Right Right Right Newline	( to separate 3 digits)
		Up SQRT Right			( to reverse the number )
		RS+CST				( end save )
		MTH 1000 ENTER CST		( execute macro 1000 times )

	Error and ON-key abort macro execution as well as repeating.
	Error also aborts macro save.
**********************************************************************

	Name:	VV
	Desc:	Simple string viewer, requires Jazz (FNT1)
	Stack:	( $ --> $ )
	
	Keys:	Up/Down/Left/Right
		PRG	= Page up
		STO	= Page down
		'	= Page left
		EVAL	= Page right
		F	= Top
		NXT	= Bottom
		-	= Slow scrolling
		+	= Fast scrolling
		ENTER/ON = Exit 

**********************************************************************
