File Name
README.md
BONNER LAB RUNOFF Page 1
ABSTRACT






ABSTRACT

Bonner Lab Runoff (RNO)

Bonner Lab Runoff is a text formatter which when used with your favorite
editor makes a complete word processor. Its syntax is almost a complete
emulation of DSR (Digital Standard Runoff) and it is very compatible with
previous versions of Runoff. The intent of this program is to support
complete scientific word processing to produce publication quality
output. It has been used to produce thesis, progress reports, and
scientific papers here at Rice University.

This version allows complete control of any special printer available via
user definable escape sequences. In addition a macro facility allows
text or sequences of commands to be abbreviated to a single label. If
the printer has the correct features then variable spacing,subscripting,
superscripting, and equation formatting are possible. By properly defin-
ing escape sequences the user may support different printers in a
transparent fashion. In other words the same input text will print in
identical fashion on different printers with different control codes and
escape sequences.

Table of contents, indexing and sub-indexing are all supported. Multiple
table of contents or multiple indexing may be constructed from the avail-
able commands. A variety of LAYOUT and STYLE commands may completely
change the look of the pages. Table layout is simplified by right
justified and 'decimal' justified tabs. Permanent margins which apply to
the page headers are available. These simplify the setting of header and
text margins.

This runs under VMS, RSX, IAS, RT11, TSX, and probably RSTS. RNO oc-
cupies a minimum of 31 to 37 kbytes depending on the operating system.
BONNER LAB RUNOFF Page 2
Distribution

DISTRIBUTION

This distribution of BONNER LAB RUNOFF contains all the .MAC, .RNO, .TST,
.CMD, .COM and .DOC files necessary to build and test RNO. BUILD.DOC or
RUNOFF.DOC give the necessary preceedures to build RNO. The distributed
RUNOFF.DOC file refers to the VMS version, but in the process of building
RNO you may generate documentation suitable for the target operating
system. The following are enhancements since the Fall '83 version.

ENHANCEMENTS

1. .TEXT DEFERRED allows a block of text to be declared for
output on the next available page. This is intended for defin-
ing captioned figures.
2. .ENABLE/DISABLE NUMBERING commands allow page numbering to
be suspended. These are not affected by the .NUMBER PAGE com-
mand.
3. .ENABLE/DISABLE NUMBERING CHAPTER allow chapter-page number-
ing to be suspended without having it reenabled by .NUMBER
CHAPTER.
4. .ENABLE ODD forces the first page of each chapter onto an
odd page by skipping pages if necessary. .PAGE ODD,.PAGE EVEN
force page numbers to be odd or even by skipping pages if neces-
sary.
5. /EV,/OD switches allow selection of odd or even page output.
6. Limits have been set on parameters so that the maximum page
size is 127 lines by 255 spaces. This limitation has been in
previous versions even though not explicitly stated. Now at-
tempts to exceed these limits will cause error messages rather
than mysterious errors.
7. .TAB STOPS may now be specified as a relative value +n from
the previous one. The first tab stop may be specifed relative
to the current left margin. This is not compatible with DSR
usage, but is much more useful than DSR usage.
8. .TAB PROPORTIONAL command allows tab stops to be evenly
proportioned across a page.
9. Commands not available in DSR have been marked in the docu-
mentation. In addition parameters which differ from DSR are
also noted.
10. RT-11 support has been added to this version.
11. .ELSE has been added the same as in DSR.
12. .LAYOUT has been extended to 15 values from 7.
13. .RIGHT TEXT and .END RIGHT commands added.
14. .TYPE command has been added to allow messages to be typed
on the terminal.
15. .HEADERS has been made the standard command and .HEADER is
now the nonstandard alternate.
16. .REQUIRE "TI:" may now be used to get input from the termi-
nal. Previously .REQUIRE "TI:filename" was necessary for input.
17. Multiple input files are allowed on the RNO command line.
The first input filename is the default output filename.
BONNER LAB RUNOFF Page 3
Enhancements

18. .NO VARIANT turns off a variant.
19. .FLAGS TAB and .NO FLAGS TAB have been added to allow
redefinition of the tab flag.
20. .PAGING/.NO PAGING commands have been added. These are
useful in generating help files.
21. Both .AUTOHYPHENATION and .PERIOD commands have been ex-
tended to allow user selectable punctuation rules.
22. .DEFINE COMMAND has been extended to allow multiple word
labels.
23. .DELETE COMMAND/SUBSTITUTE have been added to allow remov-
ing a single entry.
24. Literal input has been modified to allow imbedded quotes or
apostrophes.
25. The .DISPLAY commands have been enhanced to allow automatic
underlining, bolding or use of any special feature of your
printer. The pre and post-fixes may contain any flags except
for equations and tabs.
26. .DISPLAY LEVELS now supports level numbers with separate
pre and post-fixes for each level. This allows possible
autotmatic underlining, bolding etc. of header levels.
27. .DISPLAY TITLE/SUBTITLE make automatic underlining/bolding
of page titles and subtitles feasable.
28. .SAVE and .RESTORE commands allow the user to quickly
change the current status, and set up automatic status.
29. .STYLE HEADERS has been extended to allow for section
header numbers in the form of lists (a or b or c instead of
a.b.c)
30. The new style and display features are illustrated in DIS-
PLA.tst which works on a VT-100 terminal and DISLEV.tst.
31. The command syntax has been further loosened to allow a
large variety of command abbreviations in addition to the
standard ones.
32. A parameter has been added to the .PRINT INDEX "entry" to
allow printing only a specific entry (subindex). .DELETE INDEX
"entry" allows deleting an index entry, and .RESET INDEX clears
the entire index buffer.
33. .SEND PAGE TOC allows text to be inserted into the table of
contents with a page number. The text may be braketed by .IF
commands.
34. .ENABLE/DISABLE UNCONDITIONAL allow turning off uncondi-
tional lines of input. This may be used with .SEND PAGE TOC to
produce separate table of contents for figures, tables etc.
35. The .TOC command was changed to produce better table of
contents output by using the paragraph test text parameter.
36. A parameter has been added to .PARAGRAPH, .TEST PAGE, .TEST
TEXT which prevents orphan lines on the next page. This also
applies to lists, and notes.
37. Dynamic memory is reclaimed more efficiently, to prevent
memory overflow.
38. .DO INDEX was changed to conform to DSR usage.


BONNER LAB RUNOFF Page 4
Enhancements

NOTE

If you find any bugs I would appreciate getting a copy of both
the .RNO and .DOC files containing these bugs. If you could
isolate the bug and demonstrate it in just a few lines of input
I would appreciate the effort. I will try to fix bad bugs or
at least create a workaround. I do not guarantee anything.


John Clement
Bonner Nuclear Lab
Rice University
Box 1892
Houston Tx, 77251
(713) 527-4018