FlagBrowser v3.0 .... nice and fast!
by Richard Steventon

--> S/SX/G/GX

In fact, it sure is a LOT faster than using any other one including
the built-in one on the G/GX (which is the slowest I've seen).

Features:
=========
- main program is 100% Assembly (HP mnemonics, source provided).
- you can change the flag descriptions!  <--- NOTE !!!
- Stand alone program (not a library).
- size is under 5K.
- 10 minute timeout to save batteries.
- Very fast (this is important ;)
- Postcard-ware (more about this later).


Keys:
=====
- Up and Down Arrow keys to scroll up and down
- [NXT] changes between user and system flags
- [+/-] toggles the flag highlighted by the scroll bar
- RS + Up/DnArrow keys = Top/Bottom of flag list
- [ENTER] saves flag changes and exits
- [ATTN] exit and don't save changes
- [PRG] help/info screen (with cute GROB)
- [0] to [6] jump to that flag base eg [2] sets flag 20 to the top.
- Other keys result in a "DoBadKey" beep.

Postcard-ware:
==============
Postcard-ware means that you *should* (ie please) send me a postcard
to say thanks if you find FlagBrowser v3.0 useful.  If I get a lot of
postcards (more than 1), maybe people (my mother) will believe me when
I tell them I am working (on my HP) and not "playing".  This will mean
that I will have more time to produce other things for the hp48 !  So,
here is my address again in case you can't bear to press the [h] key
in FlagBrowser:

Richard Steventon
7 Sun Valley Avenue
Constantia, 7800
South Africa


Changing the Flag descriptions:
===============================
On the hp48: Included in this package is the source code and a file
	called flagtab.  FlagTab is a flagtable (to be compiled
	on Jazz) that you can use to change FlagBrowsers' Flag
	descriptions.

	NOTE: The ONLY logical choice of Ass/DissAssembler is
		Mika's JAZZ, because the main Code ob contains
		embedded System-RPL and data, so the resultant
		string will be quite large. And besides, Jazz
		is one hell of a library!

On a PC:	You will need to change the file fb_table.s and recompile
		it with HPTOOLS.



Format of the FlagTab Libdat Object:
====================================

This is the second Libdat object in the program.  The first is xFNT1.

ASSEMBLE
	CON(5)	=DOEXT0		* Prolog : Library data
	REL(5)	endTab		* Length offset
** Then 128 REL(5) statements, 64 Systems flag offsets & 64 User
** These form a jump table so you can use the same description for
** more than 1 flag eg: "User Flag".... this saves memory!
	REL(5)	SysFlag1
	REL(5)	SysFlag2
	.
	.
	.
** After the jump table are the length of the strings and then the
** flag description strings (in that order) like so:
** The flag data consistes of a 2 nib length and then the description eg:
SysFlag1
	CON(2)	len1
	NIBASC	\Description in text format\
SysFlag2
	CON(2)	len2
	NIBASC	\Another Description in text\

endTab				* Marker for length offset
RPL
***********************************************************************


Additional notes:
=================
People with Jazz.lib v1.0 (or higher) can replace the first Library
data object in FlagBrow with xFNT1, this will chop the size down by
roughly 700 bytes.  Remember to DIS with flag 4 SET, as this will be
a lot faster!

Tested on SX revision E by myself and as follows by Joe Horn:

  - G (rev K)
  - GX (rev R) without any RAM cards
  - GX with 128K in port 1
  - GX with 1 Meg in slot 2, write-protected
  - GX with 1 Meg in slot 2, write-enabled

All disclaimers claimed... backup your memory if in doubt.


Credits:
========
Joe Horn for his patience and extensive testing.
Mika for Jazz, DB (without which, I could not have done FlagBrowser),
     and his kind permission to use his keyhandler from ED.
Mozgy for permission to include FNT1 in the binary.
Dan Kirkland for the phrase "Mine WILL be better!"
Jon Paine for lending me his GX and organising a cheap one for me.
Bill Wickes and Raymond Hellstern for their flag browsers.
My girlfriend, who put up with me while I "played" for many hours.
Everybody on IRC channel #hp48 for comments, encouragement, etc

That is about it...

If you have any questions/comments/flames/lawsuits/etc then feel
free to email me.

-Bye
-Richard Steventon

ps, to contact me: <email> stvric01@uctvax.uct.ac.za (until 28 Feb 1995)
			   lstevent@cs.uct.ac.za     (until 28 Feb 1996)
		   IRC	   RichardS on channel #hp48 (normally 1pm GMT)
----------------------------------------------------------------------------
		 Overheard in the passage one day at 'varsity:
	     "...and then I'll whip out my Hewlett Packard and..."
____________________________________________________________________________