.type RUNOFF Changes document being created
.type this document needs the /2p switch
.type
.set paragraph 0,1,2
.FILL.ps 55,78,5,0.header spacing 2.first title BONNER LAB RUNOFF
.flags substitute
.first title Bonner Lab RUNOFF Enhancements $$DATE
.subtitle Spring 84
.display number "Page " d "/$PMAX"
.tt 6
.c;Fall 83 - Spring 84
.s
.LIST 0
.le;_.TEXT DEFERRED allows a block of text to be declared for output on
the next available page.  This is intended for defining captioned figures.
.le;_.ENABLE/DISABLE NUMBERING commands allow page numbering to be suspended.
These are not affected by the _.NUMBER PAGE command.
.le;_.ENABLE/DISABLE NUMBERING CHAPTER allow chapter-page numbering to be
suspended without having it reenabled by _.NUMBER CHAPTER.
.le;_.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 necessary.
.le;/EV,/OD switches allow selection of odd or even page output.
.le;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 attempts to exceed these limits
will cause error messages rather than mysterious errors.
.le;_.TAB STOPS can now be specified as a relative value +n from the previous 
one.  The first tab stop may be specified relative to the current left margin.
This is not compatible with DSR usage, but is much more useful than DSR
usage.
.le;_.TAB PROPORTIONAL command allows tab stops to be evenly proportioned
across a page.
.le;Commands not available in DSR have been marked in the documentation.
In addition parameters which differ from DSR are also noted.
.le;RT-11 support has been added to this version.
.le;_.ELSE has been added in the same fashion as in DSR.
.le;_.LAYOUT has been extended to 15 values from 7.
.le;_.RIGHT TEXT and _.END RIGHT commands have been added.
.le;_.TYPE has been added to allow messages to be typed on
the terminal.
.le;_.HEADERS has been made the standard command and _.HEADER is now
the nonstandard alternate.
.le;_.REQUIRE "TI:" can now be used to get input from the terminal.
Previously, _.REQUIRE "TI:filename" was necessary for input.
.le;Multiple input files are allowed on the RUNOFF command line.
The first input filename is the default output filename.
.le;_.NO VARIANT turns off a variant.
.le;_.FLAGS TAB and _.NO FLAGS TAB have been added to allow redefinition
of the tab flag.
.le;_.PAGING/_.NO PAGING commands have been added.
These are useful in generating help files.
.le;Both _.AUTOHYPHENATION and _.PERIOD commands have been extended to
allow user selectable punctuation rules.
.le;_.DEFINE COMMAND has been extended to allow multiple word labels.
.le;_.DELETE COMMAND/SUBSTITUTE have been added to allow removing
a single entry.
.le;Literal input has been modified to allow imbedded quotes or apostrophes.
.le;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 can contain any flags except for equations and tabs.
.le;_.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.
.le;_.DISPLAY TITLE/SUBTITLE make automatic underlining/bolding
of page titles and subtitles feasable.
.le;_.SAVE and _.RESTORE commands allow the user to quickly change
the current status, and set up automatic status.
.le;_.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)
.le;The new style and display features are illustrated in DISPLA.tst, which
works on a VT-100 terminal, and and DISLEV.tst.
.le;The command syntax has been further loosened to allow a large variety
of command abbreviations in addition to the standard ones.
.le;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.
.le;_.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.
.le;_.ENABLE/DISABLE UNCONDITIONAL allow turning off unconditional
lines of input.  This may be used with _.SEND PAGE TOC to produce
separate table of contents for figures, tables etc.
.le;The _.TOC command was changed to produce better table of contents
output by using the paragraph test text parameter.
.le;A parameter has been added to _.PARAGRAPH, _.TEST PAGE, _.TEST TEXT that
prevents orphan lines on the next page. This also applies to lists, and notes.
.le;Dynamic memory is reclaimed more efficiently to prevent memory
overflow.
.le;_.DO INDEX was changed to conform to DSR usage.
.els 0
.tt 6
.subtitle Fall 84
.s.c;Spring 84 - Fall 84
.s
.list 0
.le;Equations are allowed in chapter/section/note titles.
They are also allowed in titles/subtitles.
This was achieved at the expense of 2kbytes of memory.
.le;Index entries without index numbers do not fill with ellipses.
This is the same as DSR.
.le;The action of the accept flag has been clarified in the documentation.
The accept flag (__) would allow control code output in early versions of
RNO.  This is definitely not valid usage as documented and is not allowed
in the current version.
.le;The limit on the number of tab stops has been removed. The _.TAB commands
have been modified to allow individually set justification on each column and
specifiable ellipses. Centered justification is now possible. 
.le;_.KEEP TABS command has been added to control tab usage with _.FILL.
.le;Several files defining escape sequences are now available for
VT-100, CIT-161, and LA-50.
.le;_.ENABLE/DISABLE FLAGS commands are now available to control
flags in the body of the text without changing their usage in page headers.
The _.FLAGS/_.NO FLAGS commands define flags while _.ENABLE/_.DISABLE FLAGS
turn the flag character on or off.  Other _.ENABLE commands turn features on
or off without affecting the flags.
.le;The /TT switch allows WRITE ALL output for the .DOC file.  This is needed
to bypass operating system checking of control codes.
.le;Switches can now be placed anywhere in the command line.  The restriction
on placing switches only on the output or first input file spec. is removed.
.le;The syntax of the _.DEFINE COMMAND has been changed to make it easier to
use.
.le;Parameter substitution has been added to _.DEFINE COMMAND.
It is very simple, but it works.
This has been requested many times by RUNOFF users.
.le;_.DEFINE NUMBER allows definition of symbols with current value of
a number (chapter,header level etc.).
This allows later parts of a document to reference earlier parts.
This was suggested at the Spring 84 DECUS meeting.
.le;Item numbers have been added to simplify the task of numbering
things.  These might be used for footnotes, references etc.
The new commands are _.NUMBER ITEM and _.DEFINE ITEM.
This was suggested at the Spring 84 DECUS meeting.
.le;Both overlayed and non-overlayed versions are available for RT-11.
.le;/2P switch allows 2 pass operation of RUNOFF.  This is used if you
desire forward and backward references to sections of the document.
This was suggested at the Spring 84 DECUS meeting.
.le;The _.DISPLAY commands now cause a break, in conformance with DSR,
and all of the enable/disable commands do not cause a break.
.le;Extra output has been added to the _.TRACE command to facilitate
fixing problems in RUNOFF input.
.le;_.AUTOTABLE command has been implemented as in DSR.
.le;_.REQUIRE BINARY has been added to aid in adding graphics and
drawings into the text file.
.le;A prefix table has been added to the hyphenation routine
and the parameters have been juggled to reduce errors.
The hyphenation has been adjusted to be correct on the 1000 most
commonly used words in the American English language.
Not as many hyphenation points are found, but a larger percentage are correct.
The hyphenation routine should now be more acceptable.
.le;_.ENABLE CONTINUE allows use of the break or hyphenation characters
as continuation characters at the end of a line.
.le;/WR and /-WR allow warning mesages to be turned on or off.
.le;The period flag has been added in conformance with DSR.
This allows the user to insert 2 spaces after words.
.le;_.! is now allowed as a comment indicator.
.le; Both brief and large documentation and help files are generated.
.le;_.INDENT LEVEL TITLES allows fixed indentation on each level title.
This allows the table of contents to resemble the format from DSR.
.els 0
.subtitle Spring 85
.tt6.s.c;Spring 85
.list 0
.le;Autohyphenation will now work with character widths other than 1.
.if PROP
.le;An attempt at proportional fonts has been made.  The relevant commands
are _.DEFINE CHARACTER WIDTH, _.DEFINE ESCAPE, and _.DEFINE UNITS.
Proportional fonts may not be used with:
.list 0
.le;TABS
.le;Equations
.le;Fill mode in Print index
.le;Table of contents
.els 0
These features are not finished, so no claim is made that it works!!!
They at least do not cause problems with existing features.
.endif prop
.le;_.BREAK LINE has been added to force break at end of next line.
This is useful inside a defined command.
.le;_.ENABLE COMMAND REPLACEMENT allows user defined commands to replace
permanently defined commands.  In addition, either an underscore "__" or
dollar sign "_$" can be used to select user or permanent commands.
.le;_.DISABLE TRAILING ZERO turns off the trailing zero in header levels.
This is needed for compatibility with the newest version of DSR.
.le;Parameters must not be split between 2 levels of substitution.
Previously, a parameter could be split between 2 different levels
of substitution.  Now this is not allowed.  Since splitting a parameter
would have been an error, this should not have a serious impact on current 
text.
.le;_.IMMEDIATE IF/IFNOT allow conditionalizing a single line without
using _.ENDIF.  These are useful inside defined commands.
All IF nestings are checked for errors, and nesting may include the same
label more than once.
.le;3 help and document variants are now available (full,small, and micro).
These allow you to conserve disk space and paper as needed.
.le;_.DISABLE PAGING mirrors the _.PAGING command, but paging is
only restarted by _.ENABLE PAGING, and all _.PAGE commands are ignored.
_.PAGE SIZE cannot enable paging once disabled.
This is more useful for help files than the _.NO PAGING command.
.le;Restrictions on IF/ENDIF/ELSE commands are now enforced, rather than just
being documented.
.le;Traceback has been improved.  It attempts to pinpoint the error for
greater ease in finding it.
.le;Headers were handled with inconsistent status.  The FILL status saved by
the _.SAVE HEADERS command is used for title, subtitle and page number.
.le;User specified change bar is allowed as part of the _.ENABLE#BAR command.
.le;All numbers can now be in the range of 0 to 3999.
.le;All default table sizes can be changed.  By editing RNPRE.MAC
you can increase the number of nested lists, or header levels.
.le;A set of escape sequences for the Hewlett Packard Laset Jet printer
are available compliments of Jack Wenrick, BFGoodrich Co.
He has also tested RNO on the PRO.
.le;_.IF commands and _.VARIANT commands now accept multiple labels.
This is helpful when a variety of conditions are used in processing
text.
.els 0
.subtitle Fall 85
.tt6.s.c;Fall 85 - V8.0
.list 0
.le;RUNOFF now gives an error message if _.LIST is not followed by _.END LIST.
.le;The code has been rewritten in "Machine independent macro" so
that all routines will work on VAX in native mode.  The native mode version
is about a factor of 2 faster on an 11/750 running V4.1 of VMS.  It is
benchmarked as slightly faster than DSR for "plain text".
Of course, special features to support fancy printers will slow RUNOFF down
depending on how often they are used.
.le;Some code has been added for proportional fonts, but it is not complete,
so it is not documented.
.le;Wild characters are allowed in _.VARIANT commands.
In addition, the underscore "__" is a legal character in _.IF labels.
.le;The native mode version has much larger defaults.
.le;Some optimization was done on the index routine to make it faster.
The symbol FASTX determines how much optimization is done.
If undefined, no optimization is done.  Optimization increases the
demands on dynamic memory.
.le;A _.SETUP command has been added to allow easy printer setup.
This sends an initial set of escape sequences to the printer before
all text.
.le;Equation formatting has better error recovery.  If right braces are
missing, RUNOFF attempts to fill them in.
.els 0
.subtitle Spring 86
.tt6.s.c;Spring 86 - V8.1
.p
Unfortunately this version was not released for the spring tape.
.list 0
.le;The slash "/" between numerator and denominator is now optional
in equations.
.le;A new error message notifies the user when text overflows the page
boundaries.  If possible the text is broken.
.le;RNO now allows 1/2 line spacing as well as 1+1/2 etc.
.le;_$_$DATE now produces years as 19xx in conformance with DSR.
.le;The maximum number size has been increased, but Roman Numerals
are not correct if greater than 3999.
This is mainly significant for the VMS native mode version.
RSX,RT have a range of only 4095 while VMS native mode users
have a range of 8,388,607.
.le;_.DISPLAY ELEMENTS, and _.LIST have been extended to allow
character strings of more than 1 character for pre,post fix and
string.  The DISPLAY commands are now fully consistent.
.le;_.DISPLAY PAGE TOC has been added to allow modifying the page numbers
to the right of the chapter, section names in the table of contents.
.le;_.BREAK LINE left a dangling blank at the end of the line.
.els 0
.subtitle Fall 86
.tt6.s.c;Fall 86 - V8.2
.list 0
.le;/2P,/TT now work on the native mode version.
.le;Extendable virtual memory has been added to the native mode version,
 so you should never run out!!
.le;Error messages have been added to tell you if you failed to
END FOOTNOTE,LIST,LITERAL,NOTE, or TEXT at the end of the document.
.le;RT-11 version now has _.REQUIRE BINARY command.
The various RT changes are all from Robert Walraven.
.els 0
.subtitle Fall 87
.tt6.s.c;Fall 87 - V1987.2
.list 0
.le;The command _.SET LEVEL has been added in conformance with DSR.
.els 0
.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 but I will try to be helpful. I can not return long distance calls,
so if I am not in when you call, leave the time when you will call again and I
will try to be in. 
.end note
.test page 6
.r text
.req "author"
.end right
.define number page /PMAX/