FlagBrowser v4.0 ================ Flag Catalog replacement by Richard Steventon (c)1994-1996. CONTENTS ======== 1. Introduction 1.1 Copyright and Disclaimer 1.2 The FlagBrowser Program 1.2.1 Features 2. Installing and Removing the FlagBrowser program 2.1 Installing the program 2.2 Universal Font Library (UFL) 2.3 Bytes and Checksum 2.4 Removing the program 3. Usage 3.1 Explanation of Keys 4. Changing the Flag descriptions 4.1 How to Do it 4.2 Format of the FlagTab Libdat Object 5. Postcard-ware: 6. Acknowledgments 7. History 8. Resources and References 1. Introduction --------------- 1.1 Copyright and Disclaimer ----------------------------- All files in the FlagBrowser package are copyrighted by Richard Steventon unless otherwise noted. The software and any information contained herein are provided "as is" and shall be subject to change without notice. The author makes no warranty of any kind with regard to this program and related documentation, including, but not limited to, the implied warranties of merchantability and fitness for a particular purpose. The author shall not be liable for any errors or for incidental or consequential damages in connection with the furnishing, performance, or use of this software or documentation. 1.2 The FlagBrowser Program --------------------------- The FlagBrowser program is meant to be a fast replacement for the built-in flag catalog. It is designed for those people who have actually bothered to read the manual and as such, does not contain "choose boxes" or other frills. 1.2.1 Features -------------- * fast * complete discriptions of built-in flags * all flag descriptions can be changed * Save/Abort changes * uses Universal Font Library * size under 5K * main program is 100% SASM (HP mnemonics, source provided) * stand alone program (not a library) * works from any port * Postcard-ware 2. Installing and Removing the FlagBrowser Program -------------------------------------------------- The FlagBrowser Program requires about 4.5k to install and an auxiliary library called the Universal Font Library (UFL) must be present. 2.1 Installing -------------- a) send the program to the HP48 b) read the next section for the Universal Font Library (UFL) requirements 2.2 Universal Font Library (UFL) -------------------------------- The FlagBrowser Program requires the UFL to be present. Read the UFL documentation from the UFL package (included) for more information From the UFL package, one of two libraries must be present. Either ufl1.lib or ufl3.lib and not ufl2.lib because the FlagBrowser Program requires FNT1. If you have not installed one of the UFL libraries, install it now: a) send the library(ufl1.lib or ufl3.lib) to the HP48 b) put a copy of the library on the stack c) enter the port number to store the library (0-33 GX, 0-2 SX) d) here is an example of the stack setup so far: -------------------------- 4: 3: 2: Library 257: UFL... 1: 0 | | | | | | | e) at this point, press [STO] f) perform a warmstart with [ON][C] or turn on and off the HP48 g) erase the variable containing the library. h) The FlagBrowser Program is ready for use. 2.3 Bytes and Checksum ---------------------- Bytes: 4353.5 Checksum: # 2597h 2.4 Removing the FlagBrowser Program ------------------------- a) Use the PURGE command. For more information on the PURGE command, see your USER manual. b) You may want to PURGE the UFL as well, if you are not using it. See the UFL documentation for details. 3. Usage -------- 3.1 Explanation of 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 - [0] to [6] jump to that flag base eg [2] sets flag 20 to the top. 4. Changing the Flag descriptions --------------------------------- 4.1 How to Do it ---------------- 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 or GNU-TOOLS. 4.2 Format of the FlagTab Libdat Object --------------------------------------- This is the first Libdat object in the program. 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 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 5. Postcard-ware ---------------- Postcard-ware means that you *should* send me a postcard to say thanks if you find FlagBrowser v4.0 useful. Here is my address again : Richard Steventon 7 Sun Valley Avenue Constantia, 7800 South Africa 6. Acknowledgments ------------------ The following are not in any particular order: Mika for Jazz, DB (without which, I could not have done FlagBrowser), and his kind permission to use his keyhandler from ED. Mozgy for friendship. Dan Kirkland for the words "Mine WILL be better!" Bill Wickes and Raymond Hellstern for their flag browsers. Joe Horn for his patience and extensive testing. Arnold Moy for documentation assistance. Everybody on IRC channel #hp48 for comments, etc 7. History ---------- 5 Oct. 94 Version 1.0 released Dec. 94 Version 2.0 released 24 Feb. 95 Version 3.0 released 20 Nov. 96 Version 4.0 released 8. Resources and References --------------------------- HPTools - PC based System RPL and Assembly Language compiler ftp://hpcvbbs.external.hp.com/dist/ Jazz - HP48 based System RPL and Assembly Language development tools http://www.hut.fi/~mheiskan/ UFL - Universal Font Library http://www.engr.uvic.ca/~aschoorl/ufl/ Richard Steventon email : rsteven@engmlab.uct.ac.za (valid 28-02-1997 to end 1998) IRC : EFFnet channel #hp48 with the nick: MindWalkr