Scroll 1.11
===========
J.G.Harston
70 Camm Street, Walkley, Sheffield, S6 3TR
jgh@arcade.demon.co.uk
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 command, but Scroll will
usually have found a suitable one. The recommended command *lp is created
with the MakeLP program. An example alternative printout command is to press
'+' before pressing RETURN to double-space the printout, this is useful if
your printer does not advance by itself with auto-linefeed.
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 the following command line arguments, which are
displayed if -? is given as a parameter:
*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.
The options must be in lower case, and only the first character is
significant.
So, for instance, to call Scroll from another program, you could use the
following:
CHAIN "Scroll -4 $.4to7 "+name$+" -quit Menu"
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 given, 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.
Version Notes:
V1.11 15-Mar-98 Memory-based command line passing, key repeats set.
V1.10 01-Feb-97 Long filenames displayed correctly, LFs converted to CR
for display. When bottom of the screen is blank, moving back and
then forward displays last few lines correctly. Status line stays
longer.
V1.09 30-Mar-96 Better use of memory
V1.08 28-Mar-96 Relocates in very small memory systems
V1.06 01-Mar-96 Added -chan option, tweeked command line parsing
V1.03 16-Jun-95 Added -4 and -lp option
V1.01 10-Jan-95 Added Archimedes capabilities
V1.00 01-Jul-94 Initial version