.ifnot HLP .if rsx .CHAPTER RSX OPERATING PROCEDURES .endif rsx .if ias .CHAPTER IAS OPERATING PROCEDURES .endif ias .if VMS .CHAPTER VMS OPERATING PROCEDURES .endif VMS .index Operation .hl 1 initiating runoff .else hlp .variant smallhlp .i-1;2 OPERATION .endif hlp .br;If you are using this as a guide to DSR then this entire section should be ignored. .p;RUNOFF can be initiated in several ways. The general formats are: .nofill .if RSX .s.indent +24;MCR>RNO Command__string .i16; ... or .s.indent +24;MCR>RNO .indent +24;RNO>Command__string .endif RSX .if VMS .s.indent +24;_$ RNO Command__string .i16; ... or .s.indent +24;_$ RNO .indent +24;RNO>Command__string .endif VMS .if IAS .s.indent +24;PDS>RNO Command__string .s.i16; ... or .indent +24;PDS>RNO .indent +24;RNO>Command__string .endif IAS .fill .ifnot hlp .hl 1 rno command string .index Command string .endif hlp .if hlp .if RSX.br;Additional help is available on: .br;COMMAND__STRING .ifnot small FILE__SPECIFICATION .endif small OPTIONS .endif RSX .i-1;3 Command__String .p .endif hlp .if small .variant smallhlp .else small System programs usually require a command string to specify such things as input files and various options. A standard command string has one of the following forms: .endif small .skip .nofill .indent 6 output-file,toc-file=input1-file/sw1/...,input2... .x Table of contents .skip .indent 10 or .skip .indent 6 @command-file .skip .fill The output-file, toc-file, and input-file are strings comprising a file specification. The toc-file may be omitted if no table of contents is desired. .skip .ifnot small The second form of command string (@command-file) is used to specify an indirect command file. In this case each record of the file is used as a command string before any commands following the indirect command are accepted. .skip The command string syntax is described more completely in the User's Guide for the relevant operating system. .ifnot hlp .hl 2 file specifications .index File Specifications .endif hlp .if hlp .i-1;3 File__Specification .br .endif hlp .endif small A file specification has the following form: .nofill .skip .indent 6 .IF RSX Dev:[UIC]Filename.Typ;Ver .ENDIF RSX .IF VMS Dev:[Directory.subdir...]Filename.Typ;Ver .endif VMS .IF IAS Dev:[UIC]Filename.Typ;Ver .ENDIF IAS .skip .ifnot small .fill In this specification Dev must be a legal device code. If omitted the default value is SY:, the system disk. .IF RSX UIC must be a valid User Identification Code. If omitted the default is the current UIC. .ENDIF RSX .IF IAS UIC must be a valid User Identification Code. .ENDIF IAS .IF VMS Directory must be a valid directory name of the form [Name1.Name2#.#.#.Namen]. If omitted the default is the current default directory. .endif VMS Filename is any 1- to 9-character alphanumeric string which specifies a file name. Typ is a 1- to 3-character alphanumeric file type. Finally, Ver is a number which is the version number of the file. This field also normally can be omitted since it defaults on input to the highest existing version number for the file and on output to the highest existing version number plus one. Normally you need only specify the Filename. .endif small .skip Default file specifications (any part of which may be overridden): .indent 6 ;Input: SY:name.RNO .i6;Output: SY:name.DOC .i6;Table of contents: SY:name.RNT .s .ifnot small If the name is omitted on the Output or Toc files, it is assumed to be the same as the first Input name. In other words: .i5;SY:,SY:=file .i10;is the same as: .i5;SY:file.DOC,SY:file.RNT=file.RNO .ifNOT HLP .note Editing RUNOFF Output RUNOFF output files may not be edited normally with the standard VMS/RSX/IAS file editors. This version may produce editable output by using the /-CR option, when the text is processed. If You do this /UL:L will not work but the output may easily be edited. If this option is used the ouput text/line must not exceed 256 characters, the output buffer size. If you need to use this feature with more than 256 characters/line see BUILDING RNO on how to change the output buffer size. .EN .endif HLP .endif small .ifnot hlp .HL 2 RNO OPTIONS .X Options A file specification may have one or more options associated with it. .ifnot small A option is an indicator, consisting of a slash and a two-character ASCII name, used to select program options. The options may be used with the Output, TOC, or first Input file specification. The option itself may have three forms. If the option designator, for example, is SW, then: .skip .nofill .indent +16 /SW sets the option action; .indent +16 /-SW negates the option action, and .indent +16 /NOSW also negates the option action. .skip .fill In addition the option identifier may be followed by any number of values. The permitted values are ASCII strings numbers, and decimal numbers. Any numeric value may be preceded with a + or a - sign; The following are valid option specifications. .skip .nofill .indent +16 /SW:27:XXX:29 .INDENT +16 /-SW .INDENT +16 /NOSW:NOOPTION:-50 .skip .fill .PAGE Fourteen options control the RNO program. These options, described below, may be specified on either the input or output file specification. the defaults may be set by the system manager at Task Build time. .skip .endif small .endif hlp .if hlp .i-1;3 OPTIONS .ifnot small .if RSX.br;More information available: .ts +5,+5,+5,+5,+5,+5,+5,+5,+5,+5,+5,+5,+5,+5,+5,+5, .nj;list /AP /CH /CR /DE /EV /FF /HY /OD /PA /PS /RI /SP /TT /UC /UL /WA /WR /2P .j .endif RSX .i-1;4 list .endif small .endif hlp .if smallhlp .ts +9,+8,+8,+8,+8,+8 .br;/AP:l:h --#Output only indicated appendix range. .br;/CH:l:h --#Output only indicated chapter range. .br;/CR --#Output CR,LF in file. .br;/DE --#Type out input lines (debug) .br;/EV --#Output even numbered pages. .br;/FF:n --#Put form-feed at end of page. .br;/HY --#Hyphenate output .br;/OD --#Output odd numbered pages. .br;/PA:l:h --#Output only indicated page range .br;/PS:h:w --#Set page size to H,W (height,width) .br;/RI:n --#Right shift output. n=amount of shift. .br;/SP --#Spool the output file. .br;/TT --#Bypass checks and do a write all on output. .br;/UC --#Force ALL uppercase output .br;/UL:x --#Underline x=[B-backspace, S-simulate, L-line, N-none] .br;/WA --#Wait at beginning of a page. .br;/WR --#Warning message output. .br;/2P --#Two pass operation. .br;DEFAULT: /CR/-DE/EV/OD/PS:58:60 /HY/-SP/UL:L/-WA/WR/-2P .endif smallhlp .ifnot small .left margin +11 .if hlp;.i-12;4 /AP .endif HLP .s .text .ts -3,+8,+8 .i-11;/AP:l:h --#Output only indicated appendix range. .br; l = lowest appendix to print .br; h = highest appendix to print .br; default = print all .br;For example you wish to print appendix 5 so you type: .i5;/AP:5:5 .br;If you wish to print appendices 3 to 6: .i5;/AP:3:6 .br;Appendix numbers may range from 1 to 255 .if hlp;.i-12;4 /CH .endif HLP .s .text .I-11;/CH:l:h --#Output only indicated chapter range. .br; l = lowest chapter to print .br; h = highest chapter to print .br; default = print all .br;If you wish to print chapters 1 to 5 you type: .i5;/CH:1:5 or /CH::5 .br;If you wish to print chapter 4 on: .i5;/CH:4 .br;Chapter numbers may range from 1 to 255 .if hlp;.i-12;4 /CR .endif HLP .s .text .x Carriage-return .i-11;/CR --#Output CR,LF in file. .br;This is the normal operating mode for RNO. The output file will contain the necessary codes to advance the paper. .br;.i-11;/-CR --#Output regular text (No CR,LF). .br;This mode is intended to output text which may be edited by any editor or copied by FLX. This doesn't work if the output line exceeds 256 characters. This mode should never be used if escape sequences, half spacing, or equations are desired. .if hlp;.i-12;4 /DE .endif hlp .s.text .i-11;/DE --#Type all input lines. .i-11;/-DE --#Do not type input lines. (default) .br;This is intended as a debugging aid. .if hlp;.i-12;4 /EV .endif hlp .s.text .i-11;/EV --#Output even numbered pages. This is default. .i-11;/-EV --#Do not output even numbered pages. .br If you wish to print on both sides of you paper, you first print the odd pages by using /-EV. Then you turn the paper over and print the even pages by using /-OD. You may wish to use /RI with /-EV if you need extra margin for binding on odd numbered pages. .if hlp;.i-12;4 /FF .endif HLP .s .text .X Form-feeds .i-11;/FF --#Use form-feed at end of each page. .br;This is the normal operation. Form feeds are only output at the end of a page. When you start printing the paper must be properly adjusted because there is no form feed at the beginning of the first page. Most printers keep track of the paper and automatically advance to the beginning of the next page when given a form-feed. .i-11;/-FF:n --#Simulate Form-feeds with blank lines .br;n is paper length, default (normally 66) set by your system manager. This is usually used with primitive line printers which do not recognize form-feeds, or it may be used to have output text free of Form-feeds. n must be less than 128. If n is 0 then no blank lines separate pages. The end of each page will be padded with sufficient blank lines to advance the paper to the beginning of the next page. .if hlp;.i-12;4 /HY .endif HLP .S .text .I-11;/HY --#Hyphenate output. This is the normal default. .i-11;/-HY --#Do not hyphenate output. This overrides the _.ENABLE HYPHENATION command. .X Hyphenation .if hlp;.i-12;4 /OD .endif hlp .s.text .i-11;/OD --#Output odd numbered pages. This is default. .i-11;/-OD --#Do not output odd numbered pages. .br;This command is used to separate even, from odd pages. .if hlp;.i-12;4 /PA .endif HLP .s .text .i-11;/PA:l:h --#Output only indicated page range. .br; l = lowest page to print .br; h = highest page to print .br; default = print all .br; This option should be used with the /AP,or /CH options for chapter oriented text. Page numbers may range from 1 to 4000 If h is omitted then there is no maximum page number. If l is omitted it is assumed to be page 1. .if hlp;.i-12;4 /PS .endif HLP .s .text .x Page size .I-11;/PS:h:w --#Set page size to h,w (height,width) .br;Default is /PS:58:60 (See PAGE SIZE command). If a _.PAGE SIZE command is used in your _.RNO file it will override this option setting. H must be larger than 15 and less than 128. W must be larger than 15 less than 256. .if hlp;.i-12;4 /RI .endif HLP .s .text .i-11;/RI:n --#Right shift output. n=amount of shift. .X Right shift .br;This adds extra space to the left margin. This shift is in addition to the _.LEFT MARGIN and the _.ENABLE BAR commands. .br;If you wish to add 5 spaces (1/2 inch PICA type): .i5;/RI:5 .if hlp;.i-12;4 /SP .endif HLP .s .text .i-11;/SP --#Spool the output file. .br;The output file will be printed on the line printer. NOTE: This does not apply to the TOC file. .i-11;/-SP --#Inhibit spooling of output file. .X Spooling .bb .if hlp;.i-12;4 /TT .endif HLP .text .i-11;/TT --#Do write all output. The text is output without any changes. This bypasses normal operating system checking of output. This option works only if you send the output directly to a terminal or printer, and not to a file. The device must be defined as a terminal type device. This option affects only the _.DOC output and not the _.RNT file. Sometimes the operating system will swallow control codes sent to the output device. This option insures that this will not happen. .i-11;/-TT --#Normal output. (default) .eb .if hlp;.i-12;4 /UC .endif HLP .s .text .i-11;/UC --#Force ALL uppercase output. The output will all be in caps. .i-11;/-UC --#Allow normal case conversion. (default) .X Case .if hlp;.i-12;4 /UL .endif HLP .s .text .X Underlining .i-11;/UL:B --#Underline with a spacing-backspace. .br;This type of underlining may fail to work properly if sub/superscripts or weird selectable fonts are used in the text. Alternate fonts must have the underscore in the normal ASCII position for this option to work. .i-11;/UL:L --#Underline via line overprint with underline character. This should be the normal default. .i-11;/UL:N --#Underlining suppressed. .br;This overrides the _.ENABLE UNDERLINING command. .i-11;/UL:S --#Simulate underline with hyphen character on next line. .br;This is used for line printers which have no special features. Sometimes this option may add an extra line to a page to accomodate underlining. To avoid this _.LAYOUT n,s with s greater than 0 should be used. This reserves an extra line for possible underlines. .if hlp;.i-12;4 /WA .endif HLP .s .text .i-11;/WA --#Wait at beginning of each page. .br;This is useful if your printer must have some adjustments at the top of each page, or if you must feed in each page manually. RNO will wait for you to press the "return" key on the terminal before printing the next page. .i-11;/-WA --#Print each page with no wait. This is the normal default. .if hlp;.i-12;4 /WR .endif HLP .s .text .bb .i-11;/WR --#Warning message output. .br Output warning messages as well as error messages. This is the normal default. .i-11;/-WR --#No warning message output. .eb .if hlp;.i-12;4 /2P .endif HLP .bb .s .text .i-11;/2P --#Two pass operation. RNO will perform 2 passes so that all substitutions are defined on the first pass, and all text output on the second. This allows both forward and backward references. The _.TYPE commands are executed for the second pass, but not for the first. This option will cause error messages to appear in different places. All multiple substitute definitions appear during pass 1 while all other messages except for fatal messages appear during pass 2. Fatal messages appear only once, and output may be missing. RNO will take about twice as long to execute in 2 pass mode. .index Two pass mode .i-11;/-2P --#One pass operation. This is the default. .etx.FILL .eb .endif small .LEFT MARGIN