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.