Scroll 1.09
===========
Scroll is a scrolling textfile reader. You can scroll upwards and
downwards through text files of any length. Extended View highlight codes
as used by *lp and *lpS are acted on to give bold, italics, superscript,
wide, subscript and underline effects. These can be turned off to give
plain View extensions of *bold* and underline. Scroll will also run on
the Archimedes.
If there is enough memory, Scroll uses shadow mode 0, otherwise mode 3 is
used. Unless a command line file is given, Scroll shows the current
directory and asks for a filename. At this prompt you can also give
*commands to change directory, etc. Once a file is given, it is loaded
and displayed.
The keys are simple. Cursors move up and down. Pressing Shift will jump
one screen at a time. Pressing Ctrl will jump to the ends of the file.
Pressing COPY will flip between extended highlights and plain highlights.
Pressing Escape will leave.
Pressing P and RETURN will let you print out the file. Before you
press RETURN a prompt appears telling you the name of the printout
command. You can change this here by deleting it and typing in another
comand, but Scroll will usually have found a suitable one. The
recommended command *lp comand is created with the MakeLP program.
Pressing 4 will display the file in 40 column teletext mode, if Scroll
has been told what program to use.
The bottom line of the screen shows the filename of the file being
scrolled, a percentage figure showing how far through the file you are,
and a reminder of the keys used.
Scroll will take command line arguments when run as a *command or passed
via the keyboard buffer. The parameters, which are displayed if -? is
given, are:
*Scroll (-lp <name>) (-4 <name>) <afsp>|-chan <num>+<len> (-quit <name>)<afsp> is the file to display. Alternatively, -chan can be used to
tell Scroll to read from an open channel. The <num> is the channel
number in decimal and the +<len> gives the length of the section of file
to use in decimal or hexadecimal preceeded with &. There must be no
spaces in the <num>+<len> part, and the PTR of the open file should be
set to the start of the section to read. This can be used to read through
a file within an archive.
The -lp option gives a command to use to print out the file. If this
option is not given, then a default printout command is looked for as
detailed below.
The -4 option gives a command to use to display the file in 40 column
teletext mode.
The -quit option gives a command to run on exit.
If the <name> starts with a *, then it is called as a *Command,
otherwise it is CHAINed, with any parameters passed via the keyboard
buffer. The options must be in lower case, and only the first letter is
significant.
So, for instance, to call Scroll from another program, you could use the
following:
OSCLI "KEY0 |@-4 $.4to7 "+name$+" -quit Menu"
*FX138,0,192
CHAIN "Scroll"
This would run Scroll and display the file name$, and CHAIN the
program $.3to7 to display in teletext mode. On exit, it would return to
the program Menu.
On starting, if no -lp option is givem, Scroll looks for an *lp
printout program. The order it looks for one is: lp, %.lp, %.lp.#,
%.lp.*, $.lp, :0.$.lp. The recommended place to put the *lp
command is in the library in a subdirectory %.lp, with a file 1 being
a default general purpose printer. With DFS, the best place would be in
the $ directory.
Scroll consists of the following files:
Scroll - The program
disp - Controls screen output giving display effects
T/Scroll - This text file.
NB: The current version will only display files which have each line
terminated with CR.
Version Notes:
V1.09 Better use of memory
V1.08 Relocates in very small memory systems
V1.06 Added -chan option, tweeked command line parsing
V1.03 Added -4 and -lp option
V1.01 Added Archimedes capabilities