


                         RUNOFF (Version M3.0)




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).


Submitted by:   Chuck Spalding
		1202 Charleston Road
		Mountain View, CA 94043

		(415) 965-0557






                            FILES SUBMITTED



README.1ST	Introductory comments
README.2ND	This file

RUNOFF.DOC	Printer-ready RUNOFF manual (uses backspace underlining)
RUNOFF.RNO	RUNOFF input file for manual

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.
