home
***
CD-ROM
|
disk
|
FTP
|
other
***
search
/
ftp.barnyard.co.uk
/
2015.02.ftp.barnyard.co.uk.tar
/
ftp.barnyard.co.uk
/
cpm
/
walnut-creek-CDROM
/
ENTERPRS
/
CPM
/
UTILS
/
S
/
SCAN12.ARK
/
SCAN12.DOC
< prev
Wrap
Text File
|
1989-09-27
|
7KB
|
204 lines
* * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * *
* *
* 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