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.DOC 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 under UIC 307,50 to the Spring and Fall 1982 (version M3.0X),
and Spring 1983 DECUS Symposia (version M3.0). (The current release
includes 99 listed changes. The Spring '82 submission covered up to
change 62, Fall '82 included up to change 80 [unfortunately, change 78
was bug ridden in that submission], and Spring '83 included up to change
94.)
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. The changes since Spring '83 consist mostly of minor
refinements and bug fixes; a notable addition is the ability to call for
another input file from within the input (nesting of input files).
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 and features not known to be available in any version.
Users are encouraged to provide their comments and thoughts on RUNOFF to
the submitter. The Working Group is particularly interested in knowing
which new features should be given highest priority. For example, are
there features in other versions which are badly needed in this version?
NOTE
This version of RUNOFF cannot be used under RT-11
(the library version [M02.4] can).
Submitted by: Chuck Spalding
Adept Technology, Inc.
1202 Charleston Road
Mountain View, CA 94043
(415) 965-0557
FILES SUBMITTED
README.1ST Introductory comments
README.2ND This file
SUMMARY.DOC Summary of new/changed features of version S1.4
(includes comparison with versions M02 and M02.4)
CHANGES. Complete list of all changes incorporated in version S1.4
LOG. Dated log of changes
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 (version S1.4)
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 for partition GEN).
* * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * *
* *
* 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 BY THE SUBMITTER!)
RSTS/E
Before assembling the source files, you must edit the file RNPRE.MAC
and change the definitions of symbols RSTS and RSX11M to "1" and
"0", respectively. (Note that some of the features claimed for
version S1.4 will no longer be present then--e.g., automatic task
extension, exit with status, and the REQUIRE command.)
The command file RSTASM.CMD can be used to assemble all the source
files. (THIS FILE HAS NOT BEEN TRIED BY THE SUBMITTER!)
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.