This version of DECUS RUNOFF is basically compatible with the previous
text processing SIG's version M02 and the current DECUS library version
(M02.4). Scores of enhancements and fixes have been made, as summarized
in SUMMARY. and described in CHANGES. The RUNOFF manual has been
extensively modified, including documentation of all the new features.
This release of RUNOFF is a further development of the versions
submitted to the Spring and Fall 1982 DECUS Symposia. (The current
release includes 94 listed changes. The Spring '82 submission covered
up to change 62 and Fall '82 included up to change 80 [unfortunately,
change 78 was bug ridden in that submission].) The most notable change
made since Fall '82 is the implementation of the ability to have up to
three tables of contents in the output document, one of which can be
created automatically from chapter and header-level titles.
This version of RUNOFF is currently supported by a Working Group of the
RSX Special Interest Group. The working group intends to continue
adding features to this version of RUNOFF, including features available
in "other versions out there" and features not known to be available in
any version.
Users are encouraged to report any problems encountered and to provide
feedback on the features present and those desired. When reporting a
problem, please save copies of the input and output which demonstrate
the problem.
NOTE
This version of RUNOFF cannot be used under RT-11
(version M02.4 can).
SUMMARY. Summary of new/changed features of version M3.0
(comparison with versions M02 and M02.4)
CHANGES. Complete list of all changes incorporated in version M3.0
FILES. List of all changes indicating source files affected
RNPRE.MAC Source prefix file which defines all assembly switches
DATA.MAC Source for all global data
CMTAB.MAC Source for command tables
START.MAC Source for task initiation code
COMND.MAC Source for command parser
ERMSG.MAC Source for initialization and error processing
RNCMD.MAC Source for commands
FMTCM.MAC Source for commands
SETUP.MAC Source for infrequent commands
QUEUE.MAC Source for commands for deferring output
RUNOFF.MAC Source for main text processing
RNFIO.MAC Source for input and output
RNORSX.MAC Source for RSX data structures
INDEX.MAC Source for index accumulation
PINDX.MAC Source for index outputting
PRTOC.MAC Source for outputting tables of contents
HYPHEN.MAC Source for hyphenation
MAKRNO.CMD Do-it-all command file for generating a RUNOFF task file.
This file asks the user for selections for all the
task build options.
RNOIAS.CMD Commands for IAS task builder (NOT TESTED)
RNOIAS.ODL Overlay description for IAS (NOT TESTED)
RSTASM.CMD Command file for assembling under RSTS (NOT TESTED)
RSTBLD.CMD Command file for RSTS task builder (NOT TESTED)
RSTBLD.ODL Overlay description for RSTS (NOT TESTED)
BUILDING RUNOFF (M3.0)
RSX-11M and RSX-11M-PLUS
Procedure:
1. You do NOT need to be a privileged user, although the last
two steps below may require privileged status.
2. Transfer all files to the UFD you want to work in.
3. Type @MAKRNO and respond to the questions asked. You can
press the ESCAPE key in response to any question to get
information which will help you decide how to answer.
4. Copy RNO.TSK to the system UFD.
5. If desired, install RNO. It is built to run in GEN partition.
* * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * *
* *
* NOTE *
* *
* The following instructions are adapted from those provided with *
* version M02.4. THESE INSTRUCTIONS HAVE NOT BEEN CHECKED. *
* *
* * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * *
RSX-11M UNMAPPED SYSTEMS
Users of unmapped systems should follow the procedure outlined for
mapped systems. Before beginning the building process, edit the
file MAKRNO.CMD to delete the /MM switch and to change the PAR
directive to match your system requirements (other changes may be
required).
RSX-11D/IAS
Users of RSX-11D/IAS should follow the procedure outlined for users
of RSX-11M Mapped systems. Since the conventions for source and
object files are installation dependent, MAKRNO.CMD should be edited
as required. For example, RSX-11D/IAS users should change the /MM
switch to /MU and change the PAR directive as needed.
Building RUNOFF Page 2
Alternatively, IAS users may use command file RNOIAS.CMD to build
RUNOFF. The command file contains definitions for the default
parameter values and switch settings. The file RNOIAS.ODL contains
an overlay description for use with IAS. (THESE FILES HAVE NOT BEEN
TRIED!)
RSTS/E
Before assembling the source files, you must edit the file RNPRE.MAC
and change the definitions of symbols RSTS and RSX to "1" and "0",
respectively. (Note that some of the features claimed for version
M3.0 will no longer be present then--e.g., automatic task extension
and exit with status.)
The command file RSTASM.CMD can be used to assemble all the source
files. (THIS FILE HAS NOT BEEN TRIED!)
The files RSTBLD.CMD and RSTBLD.ODL are provided for building RUNOFF
for use under RSTS. (THESE FILES HAVE NOT BEEN TRIED!)
RNO.TSK is not a privileged program. It should, however, be
installed with an <104> protection code if it is desirable for all
users on the system to access it.
To get a RSTS version of the manual, edit page one of RUNOFF.RNO
changing "INCLUDE 1" to "EXCLUDE 1", and "EXCLUDE 2" to "INCLUDE 2".
RT-11
This version of RUNOFF does not support use under RT-11.