8-Bit Software Online Conversion

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