* * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * SCAN version 1.2 * * * * A Buffered Bi-directional Text File Scroll Utility * * * * Terry Hazen * * Los Gatos, California * * 09/29/85 * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * INTRODUCTION... SCAN is a buffered bi-directional text file scroll utility that was adapted from BISHOW, Version 3.01. The name was changed to avoid conflicts with possible newer BISHOW versions, and because BISHOW's assembly-time options were deleted. The DU: form is now supported and most control characters are displayed. File scroll commands may be customized by the user. SCAN will display normal ASCII files, squeezed files, and will display LBR members and directories. SCAN displays most control characters, a useful feature when viewing WordStar and similar files with embedded print and format control characters. SCAN can replace TYPE, LDIR, LTYPE, TYPEL, etc, in many situations. SCAN requires a terminal with home cursor and erase screen functions. Scrolling backwards by page or by line is done by erasing and re-displaying the text, so that SCAN works more satisfactorily on high baud rate terminals like the WYSE, which supports 38400 baud. THE SCAN COMMAND LINE... The SCAN command line may include the filename with optional du: specification, and optional library member name. The screen display width and number of lines per scroll may also be changed. Usage: SCAN [du:]fn.ft [member] [columns [scroll lines]] Examples: SCAN - displays usage help screen SCAN TXT50.ASM - displays normal file SCAN TXT50.AQM - displays squeezed file SCAN TXT50.DOC 65 20 - displays file and sets screen display to 65 columns wide and 20 lines/scroll SCAN TXT50.LBR - displays directory of LBR when .LBR extension is used and no member name is specified SCAN TXT50 TXT50.AQM - displays member file in LBR Command Line Options: [du:] - Normal drive and/or user specification [member] - Displays a member file in a library. The use of the .LBR extension in the library filename is optional. [columns [scroll lines]] - Sets the number of columns displayed and the number of lines per scroll. The number of columns may be specified by itself, or both columns and scroll lines may be specified SCAN FILE SCROLL COMMANDS... SCAN, as supplied, has the following file scroll commands, many of them emulating WordStar cursor control commands: First Line ----------------> 1 Next Page -----------------> ^C, F, Space Previous Page -------------> ^R, B Next Line -----------------> ^X, N, CR Previous Line -------------> ^E, P Scroll Display Left -------> ^S, Backspace Scroll Display Right ------> ^D, Tab Set Display Width/Scroll --> S EXIT SCAN -----------------> Q, ESC Any other command will display a help screen. CUSTOMIZING SCAN... SCAN requires a terminal with home cursor and erase screen functions. These control sequences and any desired changes in the commands may be patched directly into SCAN.COM using DDT, PATCH, or any similar utility, at the locations given below. Some of the distribution command options emulate WordStar commands, but you may customize any or all of these commands to suit your own preferences. You may change the commands to emulate your favorite word processor, or to use your cursor arrow keys, for example. If any of the commands are changed, you should also update the help screen text beginning at 0116H. If you are using DDT or PATCH to modify SCAN.COM, use this list of functions and their corresponding addresses: HEX -DEFAULT- ADDR HEX ASCII FUNCTION ----------------------------------------------------------------- 0106H 1AH ESC Home cursor and clear screen sequences. Up to 0107H 5BH [ 7 bytes are available. The default 0108H 48H H sequences are for the VT100/ANSI. End 0109H 1AH ESC your combined sequences with 00H. 010AH 5BH [ 010BH 32H 2 010CH 4AH J 010DH 00H End of home cursor and clear screen area. 0116H Start of help screen text area. Update the text in this area with any changed commands. File Scroll Command definitions: ------------------------------- 067AH 31H 1 First Line command. 067FH 20H SPACE Next Page command, first option. 0684H 03H ^C Next Page command, second option. 0689H 42H B Previous Page command, first option. 068EH 12H ^R Previous Page command, second option. 0693H 0DH CR Next Line command, first option. 0698H 4EH N Next Line command, second option. 069DH 1AH ^Z Next Line command, third option. 06A2H 50H P Previous Line command, first option. 06A7H 17H ^W Previous Line command, second option. 06ACH 51H Q Exit command, first option. 06B1H 1BH ESC Exit command, second option. 06B6H 53H S Set Screen Display command. 06BBH 08H BS Scroll Display Left command, first option. 06C0H 13H ^S Scroll Display Left command, first option. 06C5H 09H TAB Scroll Display Right command, first option. 06CAH 04H ^D Scroll Display Right command, first option. Default Settings: ---------------- 08B8H 3EH > Beginning of >>> Unsqueezing text <<< msg. If this message annoys you, put a 00H here. 0D38H 3AH : Fence character for LBR directory display. 10A7H 17H (23 dec) Default number of lines per scroll. 10A8H 4EH (78 dec) Default number of columns displayed - 1 (79 - 1). 79 is used, as some terminals do not allow the 80th column to be filled without going to the next line. 10B8H 00H (0 dec) Maximum number of LBR directory names to be displayed per line - 1 (1 per line - 1). Allow 14 spaces for each directory listing. Change this number if you change the default number of columns to be displayed. A 00H here causes the listings to be displayed in a single column, which is easy to read. An 04H will give 5 names per line, the maximum for 79 columns. ACKNOWLEDGEMENTS... Phil Cary wrote BISHOW 1.00, which was a buffered, bidirectional version of SHOW.ASM from Interface Age, November 1981. BISHOW was subsequently updated and enhanced by W.F.Mcgee, Lucien Pan, Keith Petersen, Bruce Ratoff, Dick Mead, Chuck Forsberg, Ted Emigh, and Frans van Duinen. The DU: code was adapted from Bob Van Valzah's FAST and Ron Fowler's MLOAD. Thanks! - Terry Hazen