.FILL.ps 63,79,0,0.header spacing 1
.c ;BONNER LAB RUNOFF
.s
This distribution of BONNER LAB RUNOFF contains all the _.MAC, _.RNO, _.TST,
_.CMD and _.DOC files necessary to build and test RNO.  The distribution _.DOC
file gives the necessary preceedures in the section on BUILDING RNO. The
distributed _.DOC file refers to the VMS version, but in the process of
building RNO you may generate documentation suitable for the target operating
system.  If the _.DOC file is trashed the file BUILDING.RNO is the how to 
manual for building a working version.
.s
The following is documentation on the revisions to the BONNER LAB RUNOFF. This
revision will be available on the Fall 83 DECUS tape.. The previous
versions were available from the Fall 82 and Spring 83 DECUS tapes [332,12]
and from the HOUSTON LUG. This version of RNO includes most of the features of
DSR, and as a bonus escape sequence handling, a macro facility (substitution),
and may other features documented in the RUNOFF.DOC manual. 
.s
.c;ENHANCEMENTS
.s
.LIST 0
.LE _.SEPARATED EQUATION command sets the mode so that the equation formatting
will automatically add extra lines to account for the levels of fractions.
.le Separate help files for VMS and RSX are included with the documentation.
These are part of the _.RNO files and are conditionalized with the RSX or
HLP key words.
.le Hyphenation improvements:
.list 0 "o"
.le Hyphenation of 3 lines in a row is inhibited.  If 2 consecutive lines
are hyphenated the third line will not be hyphenated.
.le Options to control hyphenation have been added to the _.AUTOHYPHENATE
command.  These may improve the hyphenation, or at least make it more 
pleasing.  The default settings follow recommended hyphenation rules.
.le Hyphen has been rewritten with copious comments and a number of changes:
.le Several words have been added to the suffix table.
.le Umlauts or dipthongs are prevented from being hyphenated.  Unfortunately
words like reinitialize will not be hyphenated after the re. No 
hyphenation is much superior to obviously wrong hyphenation.
.le A differential hyphenation test has been added to DIGRAM.
.le The hyphenation routine has been made faster.
.els0
.le The _.AUTOBREAK command has been added to make hyphenation and tabulation
more convenient.
.le FLAGS SPECIAL may specify multiple flags in 1 command.
.le Undefined escape sequences are tagged as errors when they are used.
This is only done if the escape sequence is triggered by an
escape flag or a special flag.
.le _.KEEP has been added as a command the same as in DSR.
.le _.FLAGS INDEX and _.FLAGS SUBINDEX have been added.  Both autoindexing
and subindexing are available as options.
.le _.UNDERLINE command has been added to declare any arbitrary character
underlinable.  _.NO UNDERLINE declares characters not underlinable.
.le Error messages now list the input file name and line number
for all currently open files in which the error occurrs.
Essentially full traceback is now provided.
.le _.LIST command may now specify a character to output rather than a number.
.le Two new define commands make this version completely printer independent.
The half spacing and equations will work on any printer capable of 
sub/superscripting whatever the escape sequences necessary to do this.
.le The command table has been shortened and command parsing made faster.
.le The _.VARIABLE SPACING and _.DEFINE VARIABLE SPACE commands
have been added to RNO to allow variable spacing between words.
.LE _.DEFINE COMMAND allows new commands to be defined.  No parameters
are passed.
.els 0
.s.c;BUGS in the Spring 83 version now FIXED
.s
.LIST 0
.le Equations imbedded inside text were not handled properly if the line had
to be split.  They are now properly moved to the next line.
.le Lines did not properly justify if they included equations.  _.NJ was the
only solution in previous versions.
.le If _.FILL is enabled and a printable escape sequence is braketed by
a pair of spaces the final space was removed.  This no longer happens
if the HSP attribute is defined for the escape sequence.
.le If an escape sequence changed the pitch of the printer, improper
underlining may result.  If the pitch change can be specified by the PSP and
HSP attributes then the underlining will be correct, otherwise the user
must use /UL:B instead of UL:L.
.le Module RNOIF was in the wrong overlay.  It must be in the same overlay
with OPEN,CLOSE or an overlay that calls OPEN,CLOSE.  This has been fixed.
RNO would bomb when a _.IF statement was not folowed by the appropriate _.ENDIF
inside a "required file".
.le If hyphenation is enabled and escape sequences are used occasionally
RNO will hyphenate the output in strange places.  The workaround is to _.DHY
during escape sequences.
.le Strange hyphenation may occurr after tabs have been used.  In general
hyphenation only worked properly for normal text.  Now it should work
properly for all text.  Authohyphenation has been restricted to
normal text, but user specified hyphenation may be used in any text
except equations.
.le Roman numerals were incorrectly converted for 9,90-99,900-999. _. _.
.le _.NUMBER LIST n started numbering at n+1 rather than n.
 _.NUMBER LEVEL also worked incorrectly.  The defaults have been modified for
the _.NUMBER commands to correspond exactly to DSR.
.le _.LITERAL or _.NO FLAGS ALL would turn off SPECIAL FLAGS permanently
never to turn on again.
.le The LCK attribute did not work unless the .FLAGS ESCAPE command was used.
.le Some versions of RNO may have difficulties when a footnote spills from
one page to the next.  Symptoms include multiple pages, and Can't justify
text messages.
.le The /WA switch would cause RNO to wait at the beginning of each page
even when pages are suppressed by the /PA switch.
.els 0
.s
.C;BUGS NOT YET FIXED
.s
There are currently a few bugs which have not yet been fixed.  Any help from
other users in fixing them is gratefully appreciated.
.s
.list0
.le Indirect command files do not work as input to RNO under IAS.  They
work for RSX-11M and VMS under compatibility mode!  Since the documentation
for RSX and IAS I/O routines and parsing is identical the problem is
very maddening.  This may actually be a bug in IAS!
.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
.tt 2
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.
.end note
.test page 6
.R;John Clement
.r;Bonner Nuclear Lab
.r;Rice University
.r;Box 1892
.r;Houston Tx, 77251
.r;(713) 527-4018