Scroll 1.11
				===========
				J.G.Harston
		70 Camm Street, Walkley, Sheffield, S6 3TR
			   jgh@arcade.demon.co.uk

BScrollb is a scrolling textfile reader. You can scroll upwards and
aadownwards through text files of any length. Extended View highlight codes
as used by B*lpb and B*lpSb are acted on to give Bboldb, Iitalicsi, Ssuperscripts,
Wwidew, Ysubscripty and underline effects. These can be turned off to give
plain View extensions of *bold* and underline. BScrollb will also run on RISC
OS.

If there is enough memory, BScrollb uses shadow mode 0, otherwise mode 3 is
used. Unless a command line file is given, BScrollb shows the current
directory and asks for a filename. At this prompt you can also give
B*bcommands to change directory, etc. Once a file is given, it is loaded
and displayed.

The keys are simple. Cursors move up and down. Pressing BShiftb will jump
one screen at a time. Pressing BCtrlb will jump to the ends of the file.
Pressing BCOPYb will flip between extended highlights and plain highlights.
Pressing BEscapeb will leave.

Pressing BPb and BRETURNb will let you print out the file. Before you press
BRETURNb 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
BScrollb will usually have found a suitable one. The recommended command
B*lpb is created with the BMakeLPb program. An example alternative printout
command is to press '+' before pressing BRETURNb to double-space the
printout, this is useful if your printer does not advance by itself with
auto-linefeed.

Pressing B4b will display the file in 40 column teletext mode, if BScrollb
has been told what program to use.

The bottom line of the screen shows the filename of the file being
displayed, a percentage figure showing how far through the file you are,
and a reminder of the keys used.

BScrollb will take the following command line arguments, which are
displayed if B-?b is given as a parameter:

B*Scroll (-lp <name>) (-4 <name>) <afsp>|-chan <num>+<len> (-quit <name>)b

B<afsp>b is the file to display. Alternatively, B-chanb can be used to tell
BScrollb to read from an open channel. The B<num>b is the channel number in
decimal and the B+<len>b gives the length of the section of file to use in
decimal or hexadecimal preceeded with B&b. There must be no spaces in the
B<num>+<len>b 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 B-lpb 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 B-4b option gives a command to use to display the file in 40 column
teletext mode.

The B-quitb option gives a command to run on exit.

If the B<name>b starts with a B*b, then it is called as a B*bCommand, otherwise
it is BCHAINbed.

The options must be in lower case, and only the first character is
significant.

So, for instance, to call BScrollb from another program, you could use the
following:

B	CHAIN "Scroll -4 $.4to7 "+name$+" -quit Menu"b

This would run BScrollb and display the file Bname$b, and CHAIN the program
I$.3to7i to display in teletext mode. On exit, it would return to the
program BMenub.

On starting, if no B-lpb option is given, BScrollb looks for an B*lpb printout
program. The order it looks for one is: Ilpi, I%.lpi, I%.lp.#i, I%.lp.*i, I$.lpi,
I:0.$.lpi. The recommended place to put the B*lpb command is in the library
in a subdirectory I%.lpi, with a file I1i being a default general purpose
printer. With DFS, the best place would be in the I$i directory.

BScrollb consists of the following files:
	IScrolli   - The program
	Idispi	 - Controls screen output giving display effects
	IT/Scrolli - 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