

			    RUNOFF (Version S1.4)



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

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

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.
