1 RNO Bonner Lab Runoff (RNO) VERSION: 1987.2 22 Dec 1987 This is a document formatter with similar syntax to Digital Standard Runoff (DSR). Helpful test files (*.TST,*.RNO) are Available In SYS_RUNOFF:. You may also use this to give you help on DSR syntax. 2 OPERATION RUNOFF can be initiated in several ways. The general formats are: $ RUNOFF command_string/options ... or $ RUNOFF The operating system will ask you for the input file name. 3 COMMAND_STRING input1-file,input2-file,... A file specification has the following form: Dev:[Directory.subdir...]Filename.Typ;Ver Default file specifications (any part of which may be overridden): Input: SY:name.RNO Output: SY:name.DOC Table of contents: SY:name.RNT 3 OPTIONS A command string may have one or more options associated with it. TABLE of RNO OPTIONS [NO] indicates the option may be negated. The negative of /CR is /NOCR /APPENDIX=([l],[h]) -- Output only indicated appendix range. /CHAPTER=([l],[h]) -- Output only indicated chapter range. /[NO]CR -- Output CR,LF in file. /[NO]DEBUG -- Type out input lines (debug) /[NO]EP -- Errors printed in .DOC file /[NO]EVEN -- Output even numbered pages. /[NO]FF=[n] -- Put form-feed at end of page. /[NO]HYPHENATE -- Hyphenate output /[NO]ODD -- Output odd numbered pages. /OUTPUT=file -- Specify output file name /PAGES=([l],[h]) -- Output only indicated page range /PS=([h],[w]) -- Set page size to H,W (height,width) /RIGHT=n -- Right shift output. n=amount of shift. /[NO]SPOOL -- Spool the output file. /TOC[=file] -- Create an intermediate table of contents file /[NO]TT -- Bypass checks and do a write all on output. /[NO]UC -- Force ALL uppercase output /UL=x -- Underline x=[B-backspace, S-simulate, L-line, N-none] /[NO]WAIT -- Wait at beginning of a page. /[NO]WR -- Warning message output. /[NO]2P -- Two pass operation. DEFAULT: /CR/NODE/NOEP/EV/OD/PS=(58,60) /HY/NOSP/TT/UL=L/NOWA/WR/NO2P 2 FORMAT_OF_COMMANDS All commands begin with a period(.). Most commands have arguments follow- ing them. An argument is a number or string of text that controls how the command works. Multiple arguments can be separated by spaces, tabs, or commas. If the arguments are separated by commas, any number of tabs or spaces can appear before or after the comma. Certain conventions are used to describe the arguments of a command. If the argument is enclosed inside square brackets [], it can be omitted. Most arguments are numbers. If the number is preceded by a minus sign (-), it will be entered as a negative value. If it is preceded by +-, it is a relative argument. A relative ar- gument changes the old value by + or - the value specified. Some commands have literal arguments. A literal is a string of text enclosed in either apostrophes (') or quotes ("). If quotes are used to delimit the string and you wish to use a quote inside the string, you must use two quotes in a row. More than one command can be entered on a single line. The commands can be optionally separated by a semicolon ";", spaces, or tabs. If a semicolon is used as a separator, the next command must immediately follow with no intervening spaces or tabs. A command that is followed by text must be the last command on a line, and cannot have other commands after it on the same line. 2 COMMANDS 3 BLANK .BLANK [-n] .B [-n] skips n absolute lines. .BLANK is like .SKIP, except that the number of lines skipped is independent of line spacing. If the page is empty, .BLANK does nothing. n can be negative to move to n lines from the end of the page. DEFAULT: .BLANK 1 3 BREAK .BREAK .BR causes a break. That is, the current line will be output with no justification, and the next word of the source text will be placed at the beginning of the next line. .BREAK LINE .BRL causes a break at the end of the next line. (Useful when defining commands.) 3 CENTER .CENTER [LINE][+-n] .CENTRE [+-n] .C [LINE] [+-n] causes a break, and centers the following line of text in the source file. If n is not specified, the centering will be halfway between the right and left margins. If n is specified as an absolute argu- ment (no sign), the centering will be over column n. .CENTER TEXT [+-n] .C TEXT [+-n] .END CENTER .ECN centers lines of text that follow until an .END CENTER command is encountered. 3 FIGURE .FIGURE [n] .FG n leaves n lines blank to make room for a figure or diagram. If fewer than n lines remain on the current page, the page is advanced and n blank lines are left at the top of the next page. .FIGURE guaran- tees that n blank lines will be generated, while .BLANK will does not if the position happens to be at the top or bottom of the page. DEFAULT: .FIGURE 1 .FIGURE DEFERRED [n] .FGD [n] reserves n lines on the current page, or, if there is not enough room, n lines at the top of the next page. This command differs from .FIGURE in that if there is no room for the figure on the cur- rent page, the current page will be filled with text right to the bottom line. 3 INDENT .INDENT [-n] .I [-n] .LEFT [-n] .L [-n] causes a break, and sets the next line to begin n spaces to the right of the left margin. DEFAULT: .INDENT paragraph-indentation 3 PARAGRAPH .PARAGRAPH [-n], [v], [t], [b] .P [-n], [v], [t], [b] causes a break, and starts a paragraph. If n is present, it speci- fies the number of spaces the paragraph is to be indented. (n can also have a negative value). v is the vertical spacing, or number of lines between paragraphs. v can range from 0 to 5. t is the TEST TEXT value. If there is not room for t lines on the page, a new page is started. b is the bottom test value. It specifies the minimum number of lines allowed on the next page. .SET PARAGRAPH [-n], [v], [t], [b] .SPR [-n], [v], [t], [b] sets the paragraph parameters without actually starting a paragraph. 3 RIGHT .RIGHT [-n] .R [-n] breaks the line, and places the text that follows flush with the right margin if n is zero or unspecified. If n is specified, the text is placed n spaces to the left (n positive) or n to the right (n negative) of the right margin. .RIGHT TEXT [-n] .R TEXT [-n] .END RIGHT .ER begins a section of text all of which is to be right justified. Each input line after this command causes a break, until an .END RIGHT is encountered. 3 SKIP .SKIP [-n] .S [-n] skips n spaced lines. The number of blank lines produced is n times the spacing. If the position is currently at the top of a page, .SKIP does nothing. DEFAULT: .SKIP 1 3 FOOTNOTE .FOOTNOTE .FN saves space for a footnote. When the bottom of the page is reached, the text following the .FOOTNOTE command will be printed. If insuf- ficient room remains on the current page, the footnote continues at the bottom of the following page. .END FOOTNOTE .EFN causes a break, and ends a footnote. .PERMANENT FOOTNOTE .PFN Text following this command is taken as a permanent footnote header that is printed between the body of text on a page and the footnotes at the bottom. Permanent margins, spacing, and fill/justify mode are also set up for footnotes. 3 NOTE .NOTE [;][title] .NT [;][title] formats notes. A note is text set off from the rest of the document by reduced margins and a centered title. .END NOTE [n] .EN [n] terminates the .NOTE command, skips n lines, and resets the margins and spacing modes to their settings before the last .NOTE command. DEFAULT: .END NOTE 2 3 PAGE .PAGE .PG causes a BREAK and an advance to a new page. If the current page is empty, a page advance is not performed. .PAGE EVEN .PGE causes a page advance to the next even numbered page, skipping an odd numbered page if necessary. .PAGE ODD .PGO causes a page advance to the next odd numbered page, skipping an even numbered page if necessary. 3 SUBPAGE .SUBPAGE .SPG .END SUBPAGE .ES produces a new page, but the page number is unchanged and letters are appended to the page number until an .END PAGE command is encountered. 3 PAGING .PAGING .PA .NO PAGING .NPA turns document paging on or off and causes a break in the text. DEFAULT: PAGING 3 TEXT .TEXT .TX .END TEXT .ETX specifies a text section that is to be kept all on one page. The text section is ended by a .PAGE, .END TEXT, or another .TEXT command. .TEXT DEFERRED .TXDEF starts a text section that will be printed later if it doesn't fit on the current page. The normal .TEXT command leaves the bottom of the current page blank if the text section doesn't fit. The .TEXT DEFERRED command will save the text for printing on later pages if necessary. If text is deferred, the current page will be filled with the text that follows the next .END TEXT or .PAGE command. .FLUSH flushes out all deferred text. 3 TEST The test commands check to see if there is enough room on the current page for more text. .TEST PAGE [t] [,b] .TP [t] [,b] causes a BREAK followed by a conditional page advance. If there are fewer than t lines left on the page, an advance to the next page is performed. When you specify b, test page operates slightly differently: the text following the test page up to the next com- mand that causes a break is treated as a block. Thus, b is useful in preventing orphan lines. t specifies the minimum number of lines at the top of the block and b the minimum number of lines at the bottom. .IMMEDIATE TEST PAGE [t] [,b] .ITP [t] [,b] performs a .TEST PAGE, but doesn't cause a break. .TEST TEXT [t] [,b] .TT [t] [,b] causes a break and tests to see if there is enough room on the cur- rent page for t lines of text. If not, a new page is started. This command differs from .TEST PAGE in that the actual space required will depend on the current spacing. (not available in DSR) .IMMEDIATE TEST TEXT [t] [,b] .ITT [t] [,b] performs a .TEST TEXT without causing a break. (not available in DSR) 3 TITLE .TITLE [;][text] .T [;][text] .NO TITLE break the text and set the title for the top of the page. .FIRST TITLE [;][text] .FT [;][text] is similar to .TITLE, but is used to specify the title to be printed on the first page of the document. This command must precede all text in the source file. Use of the FIRST TITLE command is the only way to print a title line on the first page of the document. 3 SUBTITLE .SUBTITLE [;][text] .ST [;][text] specifies the text to be used as the subtitle that appears directly under the title. 3 LAYOUT .LAYOUT [code] [,spacing] .LO [code] [,spacing] breaks the current line and changes the layout of the title and page numbers on the page. CODE PAGE LAYOUT ---- ---- ------ 0 Title flush left, page number flush right 1 Title center ,number bottom center 2 Title right odd page/left even ,number bottom center 3 Title left, number bottom center 4 Title left, number bottom right 5 Title center, number bottom right 6 Title center, number bottom right odd/left even 7 Title top, number bottom, both right odd/left even 8 Title left, number right odd/left even 9 Title right odd/left even, number bottom right 10 Title center, number bottom left 11 Title right odd/left even, number bottom left 12 Title left, number bottom left 13 Title right, number bottom left 14 Title right, number bottom center 15 Title right, number bottom right odd/left even 16 Title right, number bottom right .CHAPTER LAYOUT [code] [,spacing] .CHLO [code] [,spacing] changes the layout for the first page of a chapter or appendix without having any effect on other pages. 3 HEADERS .HEADERS [on] .HD [on] .NO HEADERS [on] .NHD control whether the page header (title, subtitle, and page number) is printed. .HEADERS SPACING [n] .HDSP [n] sets the spacing between the title and the first line of text. The value n is the number of lines to skip. If n is not specified, the current spacing per line of text is used as the default. The minimum value for n is 1. If 0 is specified, the value of 1 is assumed. DEFAULT: .HEADER SPACING 3 (Not available in DSR) 3 CHAPTER .CHAPTER [;][title] .CH [;][title] indicates the beginning of a chapter with the specified title. Suc- cessive .CHAPTER commands number the following chapters sequentially. .STYLE CHAPTER [n1],[-n2],[-n3],[-n4],[-n5] .STCH [n1],[-n2],[-n3],[-n4],[-n5] changes the style of the chapter and appendix headers. 1. n1 = Number of lines to skip before the word CHAPTER. 2. n2 = Number of lines to skip after the word CHAPTER. If n2=-1, the title and the word CHAPTER will appear on the same line. 3. n3 = Number of lines between the title and text. If n3=-1, the title and any following text will be placed on the same line. 4. n4 = Number of spaces to indent the word CHAPTER. 5. n5 = Number of spaces to indent the title. If n4 or n5 are -1, the line will be centered. If n4 or n5 are -2, the line will be right justified. DEFAULT: .STYLE CHAPTER 12,1,3,-1,-1. (Not available in DSR) 3 APPENDIX .APPENDIX [;][title] .AX [;][title] indicates the start of an appendix with the specified title. Suc- cessive .APPENDIX commands assign identifying letters in alphabeti- cal order. 3 sections A section header consists of a section number of the form n1.n2.n3... followed by a section title. If either the .CHAPTER or .APPENDIX command has been used, then the current chapter or appendix number is attached to the front of the section number, giving it the form n0.n1.n2.n3... .HEADER LEVEL [+-n] [;][title] .HL [+-n] [;][title] starts a section with the specified section number and section title. n can range from 1 to 6. .STYLE HEADERS [n1],[n2],...[n9],[n10] .STHL [n1],...[n10] changes the format used for various levels of section headers. .STYLE HEADERS also causes a line break. If a value is not sup- plied, the default is used. Default values are shown below in (). n1 = Lowest level at which text starts on same line as title. (3) n2 = Lowest level with title capitalized. (1) n3 = Highest level with first letter of title in CAPS. (6) n4 = Lowest level with no level number. (7) n5 = Lowest level with centered title and number. If the title and text are on the same line, no centering occurs. (7) n6 = Number of blank lines before the header. (2) n7 = Number of blank lines after the title. (1) n8 = Implicit test page value (7) n9 = Number of spaces between section number and title. (2) n10= Largest level printed as n.m.... (6) (n10 not available in DSR) DEFAULT: STYLE HEADERS 3,1,6,7,7,2,1,7,2,6 .INDENT LEVELS n1,n2 causes the header levels to be indented by n1 from the left margin and n2 from the right margin. .INDENT LEVEL TITLES [n1],[n2]...[n6] causes the section titles to be indented from the normal level in- dention by an additional fixed amount. DEFAULT: .INDENT LEVEL TITLES 0,0,0,0,0,0 3 AUTOBREAK .AUTOBREAK ["characters-to-test"] .AB ["characters-to-test"] .NO AUTOBREAK ["characters-to-disable"] .NAB enables or disables automatic optional breaks after selected characters. The selected characters are specified in a literal string. DEFAULT: .NO AUTOBREAK 3 AUTOHYPHENATE .AUTOHYPHENATE [size],[begin],[end],[mode][,"chars"] .AH [size],[begin],[end],[mode][,"chars"] .NO AUTOHYPHENATE [,"chars"] .NAH [,"chars"] controls automatic hyphenation. 1. size = The minimum number of characters/word. 2. begin = The minimum number of characters at the beginning of a line. 3. end = The minimum number of characters at end of a line. 4. mode = The hyphenation mode. 0 produces maximum hyphena- tion with possibly some inaccuracy. 1 hyphenates according to the suffix/prefix tables only, for maximum accuracy. 5. "chars"= Special characters allowed in hyphenated words. DEFAULT: .AH 5,2,3,0,'\/.,()"@' 3 AUTOPARAGRAPH .AUTOPARAGRAPH .AP .NO AUTOPARAGRAPH .NAP controls whether any blank line or a line starting with a space or tab is to be considered the start of a new paragraph. DEFAULT: .NO AUTOPARAGRAPH 3 AUTOTABLE .AUTOTABLE .AT .NO AUTOTABLE .NAT controls whether or not lines starting with a space or tab are con- sidered to be the start of a new paragraph. DEFAULT: .NO AUTOTABLE 3 AUTOTITLE .AUTOTITLE .ATI .NO AUTOTITLE .NATI controls the generation of automatic titles. When AUTOTITLE is enabled, then each time a .CHAPTER or .APPENDIX command is given, the chapter or appendix title will be used as the title at the top of the page. DEFAULT: .AUTOTITLE (Not available in DSR) 3 AUTOSUBTITLE .AUTOSUBTITLE [+-n] .AST [+-n] .NO AUTOSUBTITLE .NAST controls the automatic changing of subtitles. When AUTOSUBTITLE is enabled, each header level command lower than n sets the subtitle to the current header level title. DEFAULT: .NO AUTOSUBTITLE The default for n is 1 3 BEGIN_BAR .BEGIN BAR .BB .END BAR .EB controls whether the change bar is printed in the document. 3 FILL .FILL .F .NO FILL .NF controls whether or not subsequent output lines are filled. The .FILL command causes a break in the text, and sets the justification mode to be that specified by the last appearance of .JUSTIFY or .NO JUSTIFY. When FILL is enabled, successive words from the source text are added to the output line until the adding of one more word would exceed the right margin. DEFAULT: .FILL 3 JUSTIFY .JUSTIFY .J .NO JUSTIFY .NJ controls whether or not a line is filled out with additional spaces so that the last word ends exactly on the right margin. 3 KEEP .KEEP [LINES] .K [LINES] .NO KEEP [LINES] .NK [LINES] controls whether or not blank lines are kept in .NO FILL mode. DEFAULT: .NO KEEP LINES .KEEP TABS .K TABS .NO KEEP TABS .NK TABS controls whether or not tabs at the beginning of a line are kept in .FILL mode. DEFAULT: .KEEP TABS 3 LITERAL .LITERAL .LT .END LITERAL .ELI allows text to appear literally as typed. .LITERAL turns off fill and all flags to permit printing of text exactly as it appears in the source file. In addition, all commands are disabled until an .END LITERAL. 3 PERIOD .PERIOD ["chars"] .PR ["chars"] .NO PERIOD ["chars"] .NPR ["chars"] controls whether or not additional spaces are printed after every terminal punctuation that is followed by at least one space or tab character. .PERIOD causes two spaces to be printed after terminal punctuation. DEFAULT: .PERIOD ".:;?!" 3 SEPARATED_EQUATION .SEPARATED EQUATION .SEQ .END SEPARATED EQUATION .ESEQ enables or disables separated equation mode. If separated equation mode is enabled, an equation will automatically generate extra lines to separate it properly from other equations or text. 3 UNDERLINE .UNDERLINE "chars to underline" .UN "chars to underline" .NO UNDERLINE "chars to not underline" .NUN "chars to not underline" specifies which characters are underlinable. DEFAULT: .NO UNDERLINE " " 3 VARIABLE_SPACING .VARIABLE SPACING .VARSP .NO VARIABLE SPACING .NVARSP controls the variable spacing mode. If variable spacing mode is enabled, microspaces are used to pad out room between words in order to create a justified line. To use this feature with your printer, it must either be a DIABLO compatible or you must define an appropriate escape sequence for variable spacing with the .DEFINE VARIABLE SPACE command. DEFAULT: .NO VARIABLE SPACING 3 MARGINS 4 LEFT .LEFT MARGIN [+-n] .LM [+-n] sets the left margin to n, where n must be at least 16 less than the right margin but not less than 0. The initial left margin setting is 0. If n is not specified, the permanent margin is restored. If the margin is specified with a + or - sign, n is ad- ded to or subtracted from the current margin. .RIGHT MARGIN [+-n] .RM [+-n] sets the right margin to n, where n must be 16 greater than the left margin. .TOP MARGIN [+-n] .TM [+-n] sets the top margin (the number of blank lines at the top of the page) to n. .PAPER SIZE [+-h],[+-w],[+-l],[+-t],[s] .PAGE SIZE [+-h],[+-w],[+-l],[+-t],[s] .PS [+-h],[+-w],[+-l],[+-t],[s] sets the size of the page to h lines high by w characters wide. Also, the LEFT MARGIN is set to l, the TOP MARGIN to t and the spacing to s. These settings are permanent since they are now the new default for the duration of the document. DEFAULT: .PAGE SIZE 58,60,0,0,1. 3 SPACING .SPACING [lines] .SP [lines] sets the number of spaces between lines. Spacing can range from 1 to 5 lines. DEFAULT: .SPACING 1 .HALF SPACING [half lines] .NO HALF SPACING is similar to the spacing command except that it turns on half spacing. "half lines" is the number of half lines per line of text. text. Once half spacing is enabled, every command that specifies spacing will work in increments of half lines. DEFAULT: .NO HALF SPACING 3 LOCK .LOCK locks a number of page formatting parameters. While locked, these parameters cannot be changed. All commands that change the page format are locked. The following commands will give error messages if issued after a .LOCK command: .ENABLE NUMBERING .DISABLE NUMBERING .ENABLE NUMBERING CHAPTER .DISABLE NUMBERING CHAPTER .HEADERS UPPER .HEADERS LOWER .HEADERS MIXED .HEADERS PAGE .HEADERS NO PAGE .HEADERS SPACING .NO HEADERS .HEADERS .INDENT LEVELS .PAGE SIZE .TOP MARGIN .STYLE (all commands) .STANDARD .NO NUMBER .NO NUMBER CHAPTER .NO TITLE .LAYOUT .DISPLAY (all commands) 3 TABS Lists of items can be conveniently expressed in tabular form using the tab key and the .TAB STOPS command. Every time you press the "tab" key you have entered a tab into the text. Just as on a typewriter, a tab will make the text begin at the next tab stop. 4 STOPS .TAB STOPS ["ell"][+n1],["ell"][+n2], . . . .TS ["ell"][+n1],["ell"][+n2], . . . clears all previous tabs, and sets new ones. Each n specifies the column number for a tab stop. That is, n2 must be bigger than n1, and so on. If a tab stop is +n, then it will be n more than the previous one. If the first stop is +n, then it will be n more than the left margin. If n is prefaced by either R, C, or L, then the text is right, center, or left justified. If the number is preceded by a literal, then the text inside the literal is used as an ellipse to fill in the space generated by the tab. 4 PROPORTIONAL .TAB PROPORTIONAL n,["ell"][+-n1],["ell"][+-n2],,, .TABP n,["ell"][+-n1],["ell"][+-n2],,, sets the tab stops to create n columns across the page between the left and right margins. The first column begins at the left margin and ends at the first tab stop. The second column begins at the first tab stop and ends at the second one. The last column ends at the right margin. n must be 2 or larger. Tab stops are set so that all unspecified columns have equal width. The column 1 position is specified by n1, column 2 by n2, and so on. When you omit a column, it is unspecified. If you specify a column as either + or -n, then it is n larger or smaller than the unspeci- fied ones. Using + or -, you can increase or decrease each column width from an evenly spaced one. 4 LEFT .TAB LEFT .TL sets unspecified tabs to left justification. If you do not specify either .TAB LEFT or RIGHT, then .TAB LEFT is assumed. 4 RIGHT .TAB RIGHT .TR causes the text following an unspecified tab to be right justified. The text is right justified at the next tab terminator. The text is considered to be terminated by either a space, tab, end of line, break character, or autobreak character. 3 ELLIPSES .ELLIPSES .ELL .NO ELLIPSES .NELL causes tabbed text to be filled with ellipses rather than spaces. 3 COMMENT .COMMENT text .; text .! text causes the line to be ignored. The text is not printed in the output. 3 NO_SPACE .NO SPACE .NSP joins 2 filled lines without the normal space between them. If .FILL is engaged and you issue .NO SPACE after a line, a space will not be automatically generated in the output .DOC file. 3 REQUIRE .REQUIRE 'filespec' .REQ 'filespec' allows input text to be taken from the specified file. A .REQUIRE command can be imbedded in files that have been required. DEFAULT: file type=.RNO .REQUIRE BINARY [spacing] 'file-specification' .REQ BIN 'file-spec' transfers input from the specified file directly to the .DOC output file with no interpretation. Before the transfer, a break is per- formed and a test page is executed with the specified spacing. 3 SAVE These commands save and restore the current status of various variables. The status is restored automatically under certain conditions, or can be restored on demand with the RESTORE command. .SAVE APPENDIX saves the status. Restored automatically by an .APPENDIX command. .SAVE CHAPTER saves the status. Restored automatically by a .CHAPTER command. .SAVE HEADERS saves the status. Restored automatically whenever a page header or page number are printed. .SAVE LEVELS saves the status. Restored automatically by a .HEADER LEVEL command. .SAVE STATUS saves the status. Restored automatically by the .RESTORE STATUS command. .RESTORE STATUS immediately restores the status saved by the last SAVE STATUS command. 3 SETUP .SETUP escape sequences sends the specified escape sequence to the output file without in- terpretation before any other text. 3 TRACE .TRACE generates an error message to aid in debugging your .RNO file. 3 TYPE .TYPE text causes the "text" to be typed on your terminal. 3 DEFINE Not available in DSR. 4 COMMAND .DEFINE COMMAND /label/command string allows the user to define new commands. The label consists of up to 40 letters. 4 ESCAPE .DEFINE ESCAPE "escape label" [,modifiers] definition Modifiers LCK - specifies that escape sequence is a lock/unlock pair. VSP,spacing - indicates that the escape sequence will change the vertical position by the specified spacing. HSP,spacing - indicates that the escape sequence will change the horizontal position by the specified spacing. PSP - indicates that the horizontal spacing specified by HSP is applied to all printable characters following the escape sequence. CHR - indicates that the lock/unlock pair is used to change only 1 printable character. 4 ITEM .DEFINE ITEM /name/ [format],[n] defines a numbered item that can be included in your text. "name" is a substitution label for the item, and "format" is the format used to display the item; see .DISPLAY PAGE. The initial value for the item, n, must be specified in the range 0 to 8,388,607 or as a series of letters from A to RIFZW. DEFAULT: .DEFINE ITEM /item/ D 1 4 NUMBER .DEFINE NUMBER parameter /label/ defines a numeric substitution. The parameter determines what number is used in the substitution. Normally the number must be defined before you use the label. You can reference the label be- fore the .DEFINE NUMBER statement if you use the /2P option. Parameters are: Param. Number substituted APPENDIX Current Appendix or chapter CHAPTER Current Chapter or appendix LIST Current List element LEVEL Current Header level PAGE Current Page-subpage number ITEM /name/ Item named 4 SUBSTITUTE .DEFINE SUBSTITUTE /label/ text defines a substitution to be made in the text. The label is preceded and followed by a delimiter of your choice. The label must be no more than 40 characters long, and should not contain spaces or tabs. 4 SUBSCRIPT .DEFINE SUBSCRIPT [parameters] allows the user to define the subscript escape sequence, which is an escape sequence that moves the text down 1/2 space on the page. The se- quence must not exceed a maximum of 40 numbers or characters. The parameters can be either numbers or literals. 4 VARIABLE_SPACE .DEFINE VARIABLE SPACE n,[parameters] defines a micro space value, n, in microspaces/unit, for im- plementing variable spacing between words. Normally 1 unit is 1 space. The parameters define the escape sequence that produces a microspace. The escape sequence can have up to 20 numbers or characters. 3 DELETE (Not available in DSR) 4 COMMAND .DELETE COMMAND /label/ deletes an already defined command. Only commands defined by .DEFINE COMMAND can be removed. 4 SUBSTITUTE .DELETE SUBSTITUTE /label/ deletes an already defined substitution. Only commands defined by .DEFINE SUBSTITUTE can be removed. This command is illegal in 2 pass mode. 3 RESET (Not available in DSR) 4 ESCAPE .RESET ESCAPE resets all escape sequences. The internal table of all escape se- quences is cleared so that you can enter new ones with the .DEFINE ESCAPE command. After giving this command no escape sequences are any longer defined. If you need to reset escape sequences, this should be done only once at the beginning of your input file. 4 SUBSTITUTE .RESET SUBSTITUTE resets the table of substitutions so that all the previously de- fined substitutions and commands are no longer available. The permanently defined substitutions ($$DATE...) and defined commands are also no longer defined. To remove a single entry, use .DELETE SUBSTITUTE or .DELETE COMMAND. This command can be dangerous, so use with caution. It should done only once at the beginning of your input file. This command is illegal in 2 pass mode. 3 DISPLAY The display commands control how numbers such as the page number, chapter number, and so on, are displayed. Numbers can be displayed as normal (decimal) numbers, letters, or Roman numerals. Extra text can be added to the numbers as pre- or post-fixes. Table of Formats The format code produces numbers in the specified format: Format Description ------ ----------- D Decimal numbers (1,2,3,....) LU Letters uppercase (A,B,C,....,Z,AA,AB,AC....) LL Letters lowercase (a,b,c,....,z,aa,ab,ac....) LM Letters mixed (first is uppercase) (A,B,C,....,Z,Aa,Ab,...) RU Roman numerals uppercase (I,II,III,IV,....) RL Roman lowercase (i,ii,iii,iv,....) RM Roman mixed (I,Ii,Iii,Iv,....) .DISPLAY APPENDIX ["pre-fix",] [format] [,"post-fix"] .DAX ["pre-fix",] [format] [,"post-fix"] DEFAULT: .DISPLAY APPENDIX "APPENDIX " , LU , "" .DISPLAY CHAPTER ["pre-fix",] [format] [,"post-fix"] .DCH ["pre-fix",] [format] [,"post-fix"] DEFAULT: .DISPLAY CHAPTER "CHAPTER " , D , "" .DISPLAY ELEMENTS ["pre-fix",] [format] [,"post-fix"] .DLE ["prefix",] [format] [,"post-fix"] DEFAULT: .DISPLAY ELEMENTS "" , D , "." .DISPLAY LEVELS [fm1,][fm2,][fm3,][fm4,][fm5,][fm6,] .DISPLAY LEVELS [level,]["pre-fix",] [form,] ["post-fix"] .DHL [fm1,][fm2,][fm3,][fm4,][fm5,][fm6,] DEFAULT: .DISPLAY LEVELS D,D,D,D,D,D .DISPLAY NUMBER ["pre-fix",] [format] [,"post-fix"] .DNM ["pre-fix",] [format] [,"post-fix"] DEFAULT: .DISPLAY NUMBER "Page " , D , "" .DISPLAY SUBPAGE [format] .DSP [format] DEFAULT: .DISPLAY SUBPAGE "" LU "" .DISPLAY SUBTITLE ["pre-fix"] [,"post-fix"] DEFAULT: .DISPLAY SUBTITLE "" "" .DISPLAY TITLE ["pre-fix"] [,"post-fix"] DEFAULT: .DISPLAY TITLE "" "" 4 TOC_PAGE .DISPLAY TOC PAGE ["pre-fix"] [,"post-fix"] This command sets pre- and post-fixes that are to appear with the page number in the .RNT file. 3 DISABLE See ENABLE 3 ENABLE 4 INTRODUCTION These commands enable or disable various actions. 4 BAR .ENABLE BAR [n1] [,n2] [,"c"] .EBB [n1] [,n2] [,"c"] .DISABLE BAR .DBB controls the printing of change bars. DEFAULT: .DISABLE BAR 4 COMMAND .ENABLE COMMAND REPLACEMENT .DISABLE COMMAND REPLACEMENT controls the ability to replace permanently defined commands with user defined commands. (Not supported in DSR) Default: .DISABLE COMMAND REPLACEMENT 4 CONTINUE .ENABLE CONTINUE .ECO .DISABLE CONTINUE .DES controls the action at the end of a line when a break or hyphena- tion flag occurs. When CONTINUE is enabled, the line will not au- tomatically break at the end of the input line when in NO FILL mode. DEFAULT: .DISABLE CONTINUE 4 ESCAPE .ENABLE ESCAPE .EES .DISABLE ESCAPE .DES controls the output of escape sequences. When ESCAPE is diabled, the escape sequence flags will be recognized but not executed. DEFAULT: .ENABLE ESCAPE (Not supported in DSR) 4 EQUATION .ENABLE EQUATION n .EEQ n .DISABLE EQUATION .DEQ controls the action of the equation formatting flag. The parame- ter n is the number of half lines to allocate above and below each character. DEFAULT: .ENABLE EQUATION 4 FLAGS .ENABLE FLAGS [flag] .DISABLE FLAGS [flag] controls whether or not flags are enabled. 4 HYPHENATION .ENABLE HYPHENATION .EHY .DISABLE HYPHENATION .DHY Controls hyphenation. DEFAULT: .ENABLE HYPHENATION 4 INDEXING .ENABLE INDEXING .EIX .DISABLE INDEXING .DIX controls the collection and printing of index entries. DEFAULT: .ENABLE INDEXING 4 LEVELS .ENABLE LEVELS [+-n1],[+-n2] enables output of header levels up to n1, and TOC output up to n2. DEFAULT: .ENABLE LEVELS 6,6 4 NUMBERING .ENABLE NUMBERING .ENMPG .DISABLE NUMBERING .DNMPG controls whether page numbers are printed. Numbering does not start if it has been turned off by a .NO NUMBER command. DEFAULT: .ENABLE NUMBERING .ENABLE NUMBERING CHAPTER .ENMCH .DISABLE NUMBERING CHAPTER .DNMCH controls the form of page numbering. When enabled, pages are num- bered in the chapter form N-M, where N is the chapter number and M is the page number. DEFAULT: .ENABLE NUMBERING CHAPTER 4 ODD .ENABLE ODD .EODD .DISABLE ODD .DODD controls whether or not the first page of each chapter is forced to be an odd number. If enabled, and a page must be skipped, an intermediate numbered page with with no text will be produced to force the chapter onto the proper page. (Not supported in DSR) DEFAULT: .DISABLE ODD 4 OVERSTRIKING .ENABLE OVERSTRIKING .EOV .DISABLE OVERSTRIKING .DOV enables or disables the overstriking flag. DEFAULT: .ENABLE OVERSTRIKING 4 PAGING .ENABLE PAGING .EPAG .DISABLE PAGING .DPAG enables or disables pagination. When PAGING is disabled, the .PAGE SIZE command will not turn paging on, and the .PAGE command will not produce a page. See .PAGING. DEFAULT: .ENABLE PAGING (Not available in DSR) 4 SUBSTITUTION .ENABLE SUBSTITUTION .ESST .DISABLE SUBSTITUTION .DSST enables or disables the substitute flag. When recognition of the substitute flag is turned on, but the flag is disabled, the sub- stitution will be recognized, but no substitution will be made. DEFAULT: .ENABLE SUBSTITUTION (Not available in DSR) 4 TABS .ENABLE TABS .ETB .DISABLE TABS .DTB controls how the tab key is interpreted for producing tabulated or columnar output. DEFAULT: .ENABLE TABS 4 TOC .ENABLE TOC .ETC .DISABLE TOC .DTC controls whether or not output is sent to the table of contents file. DEFAULT: .ENABLE TOC 4 TRAILING_ZERO .ENABLE TRAILING ZERO .DISABLE TRAILING ZERO controls whether or not header levels are printed with trailing zeroes. For a non-chapter-oriented document, the command .HL 1 will print a header level number in the form 1.0 If trailing zeroes are disabled, the number appear as 1 (Not available in DSR) DEFAULT: .ENABLE TRAILING ZERO 4 UNCONDITIONAL .ENABLE UNCONDITIONAL .EUNC .DISABLE UNCONDITIONAL .DUNC controls the printing of unconditional text. When enabled, all text that is not preceded by an .IF command will appear in the output. DEFAULT: .ENABLE UNCONDITIONAL 4 UNDERLINING .ENABLE UNDERLINING .EUL .DISABLE UNDERLINING .DUL enables or disables the underline flag. .DEFAULT: .ENABLE UNDERLINING 3 FLAGS A flag is a character that performs some special action. For example, the ampersand (&) flag causes the next character to be underlined. The predefined flags and their default characters are ACCEPT (_), BREAK (|), CAPITALIZE (<), CONTROL (.), EQUATION ({, }), LOWERCASE (\), HYPENATE (=), INDEX/SUBINDEX (>), OVERSTRIKE (%), PERIOD (+), SPACE(#), SUBSTITUTE ($), UNDERLINE (&), and UPPERCASE (^). .FLAGS ACCEPT [new flag] .FL ACCEPT [new flag] .NO FLAGS ACCEPT .NFL ACCEPT .FLAGS [ALL] .FL [ALL] .NO FLAGS [ALL] .NFL [ALL] .FLAGS BREAK [new flag] .FL BREAK [new flag] .NO FLAGS BREAK .NFL BREAK .FLAGS CAPITALIZE [new flag] .FL CAPITALIZE [new flag] .NO FLAGS CAPITALIZE .NFL CAPITALIZE .FLAGS CONTROL [new flag] .FL CONTROL [new flag] .NO FLAGS CONTROL .NFL CONTROL Warning: once a .NO FLAGS CONTROL has been issued, you can no longer give any more commands, including .FLAGS CONTROL. So this is a non-reversable command. .FLAGS ESCAPE [escape flag] .FL ESCAPE [escape flag] .NO FLAGS ESCAPE .NFL ESCAPE .FLAGS EQUATION .FL EQUATION .NO FLAGS EQUATION .NFL EQUATION .FLAGS LOWERCASE [new flag] .FL LOWERCASE [new flag] .NO FLAGS LOWERCASE .NFL LOWERCASE .FLAGS HYPHENATE [new flag] .FL HYPHENATE [new flag] .NO FLAGS HYPHENATE .NFL HYPHENATE .FLAGS INDEX [new flag] .FL INDEX [new flag] .NO FLAGS INDEX .NFL INDEX .FLAGS OVERSTRIKE [new flag] .FL OVERSTRIKE [new flag] .NO FLAGS OVERSTRIKE .NFL OVERSTRIKE .FLAGS PERIOD [new flag] .FL PERIOD [new flag] .NO FLAGS PERIOD .NFL PERIOD .FLAGS SPACE [new flag] .FL SPACE [new flag] .NO FLAGS SPACE .NFL SPACE .FLAGS SPECIAL [flag1][flag2][flag3] . . . .FL SPECIAL [flag1][flag2][flag3] . . . .NO FLAGS SPECIAL [flag1][flag2][flag3] . . . .NFL SPECIAL [flag1][flag2][flag3] . . . .FLAGS SUBINDEX [new flag] .FL SUBINDEX [new flag] .NO FLAGS SUBINDEX .NFL SUBINDEX .FLAGS SUBSTITUTE [new flag] .FL SUBSTITUTE [new flag] .NO FLAGS SUBSTITUTE .NFL SUBSTITUTE Suppose the current date and time is January 17,1983 15:23:51 then the permanent substitutions are Symbol Resulting output $$DATE 17 Jan 83 $$TIME 15:23:51 $$YEAR 1983 $$MONTH January $$DAY 17 $$HOURS 15 $$MINUTES 23 $$SECONDS 51 .FLAGS TAB [new flag] .FL TAB [new flag] .NO FLAGS TAB .NFL TAB .FLAGS UNDERLINE [new flag] .FL UNDERLINE [new flag] .NO FLAGS UNDERLINE .NFL UNDERLINE .FLAGS UPPERCASE [new flag] .FL UPPERCASE [new flag] .NO FLAGS UPPERCASE .NFL UPPERCASE 3 LIST .LIST [n] ["char"] .LS [n] ["char"] specifies the beginning of a list of items. The left margin is moved 9 spaces to the right for the first .LIST command, and 4 addi- tional spaces for each subsequent nested LIST. n specifies the number of blank lines to appear before each item. The .LIST ELEMENT command is used to specify each item in the list, and the .END LIST command is used to end the list. DEFAULT: .LIST paragraph-spacing .LIST ELEMENT [;]text .LE [;]text specifies the start of each item in the list. If the text of the item appears on the same line as the command, the text must be separated from the command with any number of intervening spaces or tabs, or (optionally) one semicolon. .END LIST n .ELS n terminates a list and restores the margins to their previous set- tings before the last .LIST command. The optional value n causes a .SKIP n after the last item in the list. DEFAULT: END LIST paragraph-spacing 3 IF .IF aaa [bbb] ... causes the following text down to the next .END aaa or .ELSE aaa to be processed only if one or more of the labels aaa, bbb, ... have been defined by a .VARIANT command. Otherwise the text is ignored. .IF NOT aaa [bbb] ... causes the following text down to the next .END aaa or .ELSE aaa to be ignored if one or more of the labels aaa, bbb, ... have been de- fined by a .VARIANT command. Otherwise the text is processed. .ELSE aaa changes true conditionals to false and false to true. .ENDIF aaa terminates the range of an .IF or .IF NOT statement. .VARIANT aaa [bbb] ... .NO VARIANT aaa [bbb] ... defines a label aaa that is used to control the action of subsequent .IF commands. If the label is present in the VARIANT statement, then .IF aaa will cause text to be printed and .IF NOT aaa will suppress text. .NO VARIANT undefines the label aaa. The .VARIANT command only affects subsequent IF/IFNOT commands, and has no affect on previous IF/IFNOT commands. Multiple labels can be specified with one variant command. A label can contain a "*" as the last character to indicate that the rest of the label is wild. If a label is wild, only the characters up to the "*" are matched; the rest of the label is ignored. For example, "A*" will define all la- bels beginning with A as variants. 4 IMMEDIATE .IMMEDIATE IF label .IIF label .IMMEDIATE IFNOT label .IIFNOT label are similar to .IF and .IFNOT except that they apply only to the rest of the current line and they are not followed by .ELSE or .ENDIF. This command can be used inside a defined command, and need not be the first command on a line. 4 WARNING Warning If IF/ELSE/ENDIF commands are not the first command on a line, or if they are inside a defined command, they will be ignored and an error message will result. 3 INDEX .INDEX [text] .X [text] adds an index entry along with the current page number to the inter- nal index buffer. The command does not cause a break. .ENTRY index term .Y index term puts an index term into the index, but doesn't include the current page number. This command requests optimization for subindex entries. .DO INDEX [;][text] .DX [;][text] clears the title and subtitle, uses the text as a header, and starts a new page. The entire contents of the internal index buffer is printed and the buffer is reset. .PRINT INDEX ["entry"] .PX ["entry"] prints the specified entry in the internal index buffer. If no entry is specified, the entire index buffer is printed and the buffer is reset. .DELETE INDEX "entry" deletes an index entry from the internal index buffer. .RESET INDEX resets the internal index buffer so that it contains no entries. 3 NUMBER These commands set numbers for various items. The number can be speci- fied either as a decimal number or a string of letters. The letter A corresponds to 1, B to 2, Z to 26, AA to 27, AB to 28, and so on. If the number is preceded by a plus sign "+", the new value is the old value plus the specified increment. If the number is omitted, it is assumed to be 1. No number should exceed 8,388,607 or RIFZW. DSR allows larger numbers, but both RNO and DSR incorrectly handle Roman numerals larger than 3999. .NUMBER APPENDIX [+-n] .NUMBER CHAPTER [+-n] .NMCH [+-n] .NUMBER LEVEL [+-n1],[+-n2],[+-n3],[+-n4],[+-n5],[+-n6] .NMLV [+-n1],[+-n2],[+-n3],[+-n4],[+-n5],[+-n6] .NUMBER ITEM /name/ [+-n1] .NMIT /name/ [+-n1] 4 LIST .NUMBER LIST [+-n] .NMLS [+-n] .NUMBER [PAGE] [+-n] .NMPG [+-N] .NO NUMBER .NNM .NUMBER SUBPAGE [+-n] .NMSPG [+-n] 2 TABLE_OF_CONTENTS RUNOFF can produce a table of contents (TOC) for your document that in- cludes all chapters and and section headers at level 1. .SEND TOC [;]text .STC text sends the "text" to the .RNT file. .SEND PAGE TOC [n] [;text] sends text and the current page number to the .RNT file. If n is specified, the text is preceded by .IF TOCn and followed by .ENDIF TOCn. The parameter n must be in the range 1 to 9. .TOC .END TOC are not normally used. They are automatically placed in the .RNT file by RUNOFF. .TOC enables formatting for the table of contents. 2 SPECIAL_CHARACTERS 3 FLAGS Flag characters Below is a list of RUNOFF's flag characters. To cause a flag to appear in the text as a normal character, it must be preceded by the underscore character "_" (itself a special character). Since the special characters can be changed by the .FLAGS commands, this list may not represent the actual usage for your document. ^ UPPERCASE the next character, or LOCK a function. ^^ No case conversion. \ LOWERCASE the next character, or UNLOCK a function. \\ Lowercase all text. < CAPITALIZE word. * ^< capitalize all text. * # SPACE character (non expandable or quoted space). = HYPHENATE specification, or continue mark. * & UNDERLINE the following character (also "^&,/&"). _ ACCEPT the following character. % OVERSTRIKE the previous character by the next character. * $ SUBSTITUTE defined text for abbreviation. * > INDEX/SUBINDEX flags. * | BREAK text with no spaces, or continue. * + PERIOD will add extra space if followed by space. * { EQUATION flag 1. * (Not in DSR) } EQUATION flag 2. * (Not in DSR) "tab" TAB flag character causes tabulation. (Not a flag in DSR) * Only becomes a special character if the FLAG is engaged. 3 PUNCTUATION Terminal punctuation . : ; ? ! These characters, if followed by a separator (space or tab), will appear in the output with 1 extra space after them. This feature works only when both .FILL and .PERIOD are engaged. These characters can be changed with the .PERIOD command. Valid punctuation / \ . , " ( ) @ These characters are valid in a hyphenated word. Any other non-alphabetic character will prevent autohyphenation. These characters can be changed by the .AUTOHYPHENATE command. 2 LIST_OF_COMMANDS * Indicates the command causes a line BREAK. $ Indicates a command forbidden during a FOOTNOTE. D Indicates the default setting ~ Indicates not available in DSR Type A to see all commands beginning with A... 3 A Command - - - - - - - - - - - - Abbreviation - Opt. ------- ------------ ---- APPENDIX [;][title] - - - - - - - - AX - - - - *$ Start an appendix AUTOBREAK ["chars"] - - - - - - - - AB - - - - $ ~ The characters may cause a line break AUTOHYPHENATE [n1,...n4][,"chars"] - - - AH - - - - $D~ (n1=size, n2=begin, n3=end, n4=mode) Enable automatic hyphenation "chars" are allowed in hyphenated word until NO AUTOHYPHENATE AUTOPARAGRAPH - - - - - - - - - - AP - - - - $ Begin paragraphs for lines with leading spaces, tabs, or blank lines until NO AUTOPARAGRAPH AUTOSUBTITLE - - - - - - - - - - AST - - - - $ Subtitle is same as current section (header level) until NO AUTOSUB- TITLE AUTOTABLE - - - - - - - - - - - AT Enable automatic table format until NO AUTOTABLE AUTOTITLE - - - - - - - - - - - ATI - - - - $D~ Enable title is same as current chapter/appendix 3 B Command - - - - - - - - - - - - Abbreviation - Opt. ------- ------------ ---- BEGIN BAR - - - - - - - - - - - BB - - - - Left hand margin will have a bar in it until .END BAR BLANK [-space] - - - - - - - - - B - - - - * Skip lines independently from spacing, except at top of page. BREAK - - - - - - - - - - - - BR - - - - * Start a new line BREAK LINE - - - - - - - - - - - BRL - - - - * Break at end of next line. 3 C Command - - - - - - - - - - - - Abbreviation - Opt. ------- ------------ ---- CENTER [LINE][+-n] - - - - - - - - C [LINE] - - * Center 1 line CENTER TEXT [+-n] - - - - - - - - C TEXT - - - * ~ Center a section until END CENTER CENTRE [+-n] - - - - - - - - - - C - - - - * CHAPTER [;][title] - - - - - - - - CH - - - - *$ Start a chapter CHAPTER LAYOUT [code][,spacing] - - - - CHLO - - - $ ~ Change the layout of first page of chapter COMMENT [comment text] - - - - - - - ; - - - - - - ! The comment is not included in the output 3 D Command - - - - - - - - - - - - Abbreviation - Opt. ------- ------------ ---- DEFINE - Defines a command or macro COMMAND /command/text - - - - - - - - - - - $ ~ Define a new command ESCAPE escape definition - - - - - - - - - - $ ~ Define special characters to output control codes. ITEM /label/ [format],[+-n] - - - - - - - - - ~ The label is a number to appear in text SUBSTITUTE /label/text - - - - - - - - - - - $ ~ Set up text to be substituted for label DEFINE NUMBER - Defines a substitution label for a current "number" APPENDIX /label/ - - - - - - - - - - - - - ~ CHAPTER /label/ - - - - - - - - - - - - - ~ ITEM /item/ /label/ - - - - - - - - - - - - ~ LEVEL /label/ - - - - - - - - - - - - - - ~ LIST /label/ - - - - - - - - - - - - - - ~ PAGE /label/ - - - - - - - - - - - - - - ~ SUBSCRIPT escape def - - - - - - - - - - - ~ Define subscript for equation formatting SUPERSCRIPT escape def - - - - - - - - - - - ~ Define superscript for equation formatting VARIABLE SPACE escape def - - - - - - - - - - ~ Define how to do variable spacing DELETE INDEX "entry" - - - - - - - - - - - - ~ Remove an entry from index table DELETE SUBSTITUTE /label/ - - - - - - - - - - - ~ Remove a substitution label from table of subst. DISABLE - Turns off features turned on by .ENABLE BAR - - - - - - - - - - - - DBB - - - - D ESCAPE - - - - - - - - - - - DES - - - - ~ COMMAND REPLACEMENT - - - - - - - $D~ EQUATION - - - - - - - - - - DEQ - - - - ~ FLAGS [flag] - - - - - - - - - DFL - - - - D~ HYPHENATION - - - - - - - - - DHY - - - - INDEXING - - - - - - - - - - DIX - - - - NUMBERING - - - - - - - - - - DNMPG - - - $ ~ NUMBERING CHAPTER - - - - - - - DNMCH - - - $ ~ ODD - - - - - - - - - - - - DOD - - - - D~ SUBSTITUTION - - - - - - - - - DSST - - - PAGING - - - - - - - - - - - DPAG - - - ~ TABS - - - - - - - - - - - - DTB - - - - ~ TOC - - - - - - - - - - - - DTC - - - - DISBLE TRAILING ZERO - - - - - - - $ ~ OVERSTRIKING - - - - - - - - - DOV - - - - UNCONDITIONAL - - - - - - - - - DUNC - - - *$ ~ UNDERLINING - - - - - - - - - DUL - - - - DISPLAY - Change format of specified number (form = D,LU,LL,LM,RU,RL,RM) APPENDIX ["pre",][form][,"post"] - - DAX - - - - *$ CHAPTER ["pre",][form][,"post"] - - - DCH - - - - *$ ELEMENTS ["pre",][form][,"post"] - - DLE - - - - *$ LEVELS [f1],...[f6] - - - - - - - DHL - - - - *$ LEVELS [level,]["pre",][format,]["post"] - - - - - * ~ NUMBER ["pre",][form][,"post"] - - - DNM - - - - *$ SUBPAGE [form] - - - - - - - - DSP - - - - *$ SUBTITLE ["pre"],["post"] - - - - - - - - - - ~ TITLE ["pre"],["post"] - - - - - - - - - - - ~ TOC PAGE ["pre"],["post"] - - - - - - - - - - ~ DO INDEX [title] - - - - - - - - - DX - - - - *$ Print the index as an appendix 3 E Command - - - - - - - - - - - - Abbreviation - Opt. ------- ------------ ---- ELLIPSES - - - - - - - - - - - ELL - - - - $ ~ Unspecified tabs are converted to ellipses ELSE aaaa Follows IF aaaa command ENABLE - Enables features turned off by disable BAR n1,n2 - - - - - - - - - - EBB - - - - D Allow change bars in left margin n1,n2 are spaces before, after bar COMMAND REPLACEMENT - - - - - - - $ ~ Allow user commands to replace permanent commands ESCAPE - - - - - - - - - - - ESC - - - - D~ Allow control code output FLAGS [flag] - - - - - - - - - EFL - - - - D~ Allow specified flag to be used EQUATION n - - - - - - - - - - EEQ - - - - D~ Allow equation formatting HYPHENATION - - - - - - - - - EHY - - - - D Allow hyphenation INDEXING - - - - - - - - - - EIX - - - - D Entries will be made in index table LEVELS [+-out],[+-toc] - - - - - - - - - - - $ ~ Enables header levels for output and table of contents NUMBERING - - - - - - - - - - ENMPG - - - $ ~ Page numbers are produced NUMBERING CHAPTER - - - - - - - ENMCH - - - $ ~ Page numbers include chapter number (1-2) ODD - - - - - - - - - - - - EOD - - - - ~ Chapters start only on odd page numbers PAGING - - - - - - - - - - - EPAG - - - D~ Pages are formatted TABS - - - - - - - - - - - - ETB - - - - D~ Tabs are converted to multiple spaces TOC - - - - - - - - - - - - ETC - - - - D Entries are made in table of contents file TRAILING ZERO - - - - - - - - - $D~ Enable trailin zero for header level 1 (1.0...) OVERSTRIKING - - - - - - - - - EOV - - - - D The overstrike flag is obeyed SUBSTITUTION - - - - - - - - - ESST - - - D Text may be substituted for a defined label UNCONDITIONAL - - - - - - - - - ENUNC - - - *$D~ Unconditional commands are obeyed and text is output UNDERLINING - - - - - - - - - EUL - - - - D Text may be underlined END - Ends a feature BAR - - - - - - - - - - - - EB - - - - CENTER - - - - - - - - - - - ECN - - - - ~ FOOTNOTE - - - - - - - - - - EFN - - - - IF aaaa LIST [space] - - - - - - - - - ELS - - - - *$ LITERAL - - - - - - - - - - - EL - - - - *$ NOTE - - - - - - - - - - - - EN - - - - *$ RIGHT - - - - - - - - - - - ER - - - - * ~ SEPARATED EQUATION - - - - - - - ESEQ - - - D~ SUBPAGE - - - - - - - - - - - ES - - - - *$ TEXT - - - - - - - - - - - - ETX - - - - *$ ~ ENTRY index term - - - - - - - - - Y - - - - Defines index term without page number 3 F Command - - - - - - - - - - - - Abbreviation - Opt. ------- ------------ ---- FIGURE [space] - - - - - - - - - FG - - - - *$ Skips lines independently of spacing. Works at top of page. FIGURE DEFERRED [space] - - - - - - FGD - - - - *$ Skips lines independently of spacing, where space permits. FILL - - - - - - - - - - - - F - - - - D Starts fill mode until NO FILL (normal mode of usage) FIRST TITLE - - - - - - - - - - FT - - - - $ Defines title to appear on all pages including first. FLAGS - Turns on and defines a special character to do something. ACCEPT [new flag] - - - - - - - FL ACCEPT - - $D [ALL] - - - - - - - - - - - FL [ALL] - - $ BREAK [new flag] - - - - - - - - FL BREAK - - $ CAPITALIZE [new flag] - - - - - - FL CAPITALIZE $ CONTROL [new flag] - - - - - - - FL CONTROL - $D ESCAPE [new flag] - - - - - - - FL ESCAPE - - $ ~ EQUATION - - - - - - - - - - FL EQUATION - ~ HYPHENATE [new flag] - - - - - - FL HYPHENATE - $ INDEX [new flag] - - - - - - - - FL INDEX - - $ PERIOD [new flag] - - - - - - - FL PERIOD - - $ LOWERCASE [new flag] - - - - - - FL LOWERCASE - $D OVERSTRIKE [new flag] - - - - - - FL OVERSTRIKE $ SUBINDEX [new flag] - - - - - - - FL SUBINDEX - $ SUBSTITUTE [new flag] - - - - - - FL SUBSTITUTE $ TAB [new flag] - - - - - - - - FL TAB - - - $ ~ UNDERLINE [new flag] - - - - - - FL UNDERLINE - $D UPPERCASE [new flag] - - - - - - FL UPPERCASE - $D FLUSH - - - - - - - - - - - - - - - - - * ~ Flushes out all deferred text FOOTNOTE - - - - - - - - - - - FN - - - - $ Start a footnote until END FOOTNOTE 3 H Command - - - - - - - - - - - - Abbreviation - Opt. ------- ------------ ---- HALF SPACING [spacing] - - - - - - - - - - - - ~ Enable and define half spacing HEADERS [on] - - - - - - - - - - HD [on] - - $D Enable output of headers (title/subtitle) at top of page HEADER LEVEL [+-level][;][title] - - - HL - - - - *$ Starts a numbered section in document HEADERS LOWER - - - - - - - - - - - - - - - $ HEADERS MIXED - - - - - - - - - - - - - - - $D HEADERS NO PAGE - - - - - - - - - - - - - - $ ~ HEADERS PAGE - - - - - - - - - - - - - - - $D~ HEADERS SPACING [spacing] - - - - - - HDSP - - - ~ Sets spacing between title and first line of text. HEADERS UPPER - - - - - - - - - - - - - - - $ 3 I Command - - - - - - - - - - - - Abbreviation - Opt. ------- ------------ ---- IF aaaa [bbbb]... Text following is output if aaaa is "true" until ELSE or ENDIF IF NOT aaaa [bbbb]... Text following is not output if aaa is "false"until ELSE or ENDIF IMMEDIATE IF aaaa - - - - - - - - IIF - - - - ~ Rest of line ignored if aaaa is false IMMEDIATE IF NOT aaaa - - - - - - - IIFNOT - - - ~ Rest of line ignored if aaaa is true IMMEDIATE TEST PAGE [n] - - - - - - ITP - - - - $ ~ Starts new page if fewer than n line remain on page IMMEDIATE TEST TEXT [n] - - - - - - ITT - - - - $ ~ Starts new page if fewer than n lines of text can be put on page INDENT [-spaces] - - - - - - - - - I - - - - * Indent line from left margin INDENT LEVELS [-l],[-r] - - - - - - - - - - - $ ~ Secify left, right indentation for header levels (sections) INDEX entry - - - - - - - - - - X - - - - Specify term to be indexed with page number 3 J Command - - - - - - - - - - - - Abbreviation - Opt. ------- ------------ ---- JUSTIFY - - - - - - - - - - - - J - - - - D Output text is left and right justified 3 K Command - - - - - - - - - - - - Abbreviation - Opt. ------- ------------ ---- KEEP [LINES] - - - - - - - - - - K - - - - Blank lines in input also appear in output in NO FILL mode KEEP TABS - - - - - - - - - - - - - - - - ~ Tabs at beginning of lines are kept and not removed in FILL mode 3 L Command - - - - - - - - - - - - Abbreviation - Opt. ------- ------------ ---- LAYOUT [code] [,spacing] - - - - - - LO - - - - *$ Change overall page layout of title/subtite and page number (0=all at top 1-15=Header top,number bottom) ( 1=C,C 2=LR,C 3=L,C 4=L,R 5=C,R 6=C,LR) ( 7=LR,LR 8=L,LR 9=LR,R 10=C,L 11=LR,L 12=L,L) (13=R,L 14=R,C 15=R,LR 16=R,R) LEFT MARGIN [+-n] - - - - - - - - LM - - - - * Sets the left margin LIST [lines] ["string"] - - - - - - LS - - - - *$ Begin a numbered list of items separated by blank lines until end list LIST ELEMENT [;]text - - - - - - - LE - - - - *$ Print current number in list LITERAL - - - - - - - - - - - - LT - - - - * Text following this command appears in output exactly as typed until END LITERAL LOCK - - - - - - - - - - - - - - - - - - $ ~ Lock some parameters so they can not be changed LOWER CASE - - - - - - - - - - - LC - - - - All text will be in same case as input 3 N Command - - - - - - - - - - - - Abbreviation - Opt. ------- ------------ ---- NO - turns off selected features AUTOBREAK ["chars"] - - - - - - - NAB - - - - $D~ AUTOHYPHENATE "chars" - - - - - - NAH - - - - $ AUTOPARAGRAPH - - - - - - - - - NAP - - - - $D AUTOSUBTITLE - - - - - - - - - NAST - - - $D AUTOTABLE - - - - - - - - - - NAT AUTOTITLE - - - - - - - - - - NATI - - - $ ~ ELLIPSES - - - - - - - - - - NELL - - - $D~ FILL - - - - - - - - - - - - NF - - - - * FLAGS [flag name] - - - - - - - NFL - - - - $ HALF SPACING - - - - - - - - - - - - - - D~ HEADERS [on] - - - - - - - - - NHD JUSTIFY - - - - - - - - - - - NJ - - - - KEEP - - - - - - - - - - - - NK - - - - D NUMBER - - - - - - - - - - - NNM - - - - $ NUMBER CHAPTER - - - - - - - - - - - - - $ ~ PAGING - - - - - - - - - - - NPA - - - - $ PERIOD ["chars"] - - - - - - - - NPR SPACE - - - - - - - - - - - NSP - - - - TITLE - - - - - - - - - - - - - - - - $ ~ UNDERLINE "characters" - - - - - - NUN - - - - ~ VARIANT aaaa [bbbb]... - - - - - - - - - - - ~ NOTE [;title] - - - - - - - - - - N - - - - *$ Starts an indented note until END NOTE NUMBER - Sets the new number APPENDIX [+-n] - - - - - - - - NMAX - - - $ CHAPTER [+-n] - - - - - - - - - NMCH - - - $D ITEM [+-n] - - - - - - - - - - NMIT - - - ~ LEVEL [+-n1],....,[+-n6] - - - - - NMLV - - - $ LIST [+-n] - - - - - - - - - - NPLS - - - $ [PAGE] [+-n] - - - - - - - - - NMPG - - - $D SUBPAGE [+-n] - - - - - - - - - NMSPG - - - $ 3 P Command - - - - - - - - - - - - Abbreviation - Opt. ------- ------------ ---- PAGE - - - - - - - - - - - - - PG - - - - *$ Starts a new page if paging enabled PAGE EVEN - - - - - - - - - - - PGE - - - - *$ ~ Starts a new even numbered page PAGE ODD - - - - - - - - - - - PGO - - - - *$ ~ Starts a new odd numbered page PAGE SIZE [+-h],[+-w],[+-l],[+-t],[s] - - PS - - - - $ Sets page size, permanent margins, sets PAGING PAGING - - - - - - - - - - - - PA - - - - * D Text will be divided into pages PAPER SIZE - - - - - - - - - - PS - - - - $ Synonym for page size PARAGRAPH [-n],[v],[t],[b] - - - - - P - - - - * Starts a new paragraph until command causing break (n=indent, v=skip, t=test, b=bottom test) PERIOD "characters" - - - - - - - - PR - - - - $D Enables specified characters to end sentence (produce 2 spaces) PERMANENT FOOTNOTE - - - - - - - - PFN - - - - $ ~ Starts a section of text to begin each footnote until END FOOTNOTE PRINT INDEX "entry" - - - - - - - - PX - - - - *$ Prints the index and clear it 3 R Command - - - - - - - - - - - - Abbreviation - Opt. ------- ------------ ---- RESET - Removes all entries in a table ESCAPE - - - - - - - - - - - - - - - - $ ~ INDEX - - - - - - - - - - - - - - - - ~ SUBSTITUTE - - - - - - - - - - - - - - - $ ~ RESTORE STATUS - - - - - - - - - - - - - - ~ Restores status saved by SAVE STATUS REQUIRE 'file spec' - - - - - - - - REQ - - - - $ Input now is taken from specified file REQUIRE BINARY [spacing ]'file-spec' - - REQ BIN - - * ~ The specified file is transferred to output file RIGHT [-indent] - - - - - - - - - R - - - - *$ Line is right but not left justified RIGHT MARGIN [+-n] - - - - - - - - RM - - - - * Set right margin RIGHT TEXT [-indent] - - - - - - - R TEXT - - - * ~ Section of text is right, but not left justified until END RIGHT 3 S Command - - - - - - - - - - - - Abbreviation - Opt. ------- ------------ ---- SAVE - Saves the current status CHAPTER - - - - - - - - - - - - - - - - ~ Current status is restored at each CHAPTER command HEADER - - - - - - - - - - - - - - - - ~ Current status is restored at each page header LEVEL - - - - - - - - - - - - - - - - ~ Current status is restored at each HEADER LEVEL command STATUS - - - - - - - - - - - - - - - - ~ Current status is restored at each RESTORE command SEND PAGE TOC [n;]text - - - - - - - - - - - - ~ Text followd by page number will appear in table of contents SEND TOC [;]text - - - - - - - - - STC - - - - Text will appear in table of contents SEPARATED EQUATION - - - - - - - - SEQ - - - - ~ Begins separated equation mode until END SEPARATED EQUATION SET LEVEL [+-n] - - - - - - - - - SL - - - - Sets the level for the next .HL command. SET PARAGRAPH [-n],[v],[t],[b] - - - - STP - - - - $ Sets paragraph params (n=indent, v=skip, t=test, b=bottom test) SETUP escape sequence - - - - - - - - - - - - ~ Setup printer before text SKIP [lines] - - - - - - - - - - S - - - - * Skips lines depending on spacing except at top of page SPACING [s] - - - - - - - - - - SP - - - - $ Sets line spacing STYLE CHAPTER [n1],...[n5] - - - - - STCH - - - $ ~ Changes style of first chapter page (1-3 = spacing, 4,5=indent (-1 centered,-2 right just) STYLE HEADERS [n1],...[n10] - - - - - STHL - - - *$ Changes style of header levels (sections) (line,CAPS,Cap,number,center,skip1,skip2,test,indent,[n.m]) SUBPAGE - - - - - - - - - - - - SPG - - - - *$ Starts a subpage until END SUBPAGE SUBTITLE [subtitle] - - - - - - - - ST - - - - $ Sets line of text to appear in subtitle 3 T Command - - - - - - - - - - - - Abbreviation - Opt. ------- ------------ ---- TAB LEFT - - - - - - - - - - - TL - - - - $D~ Unspecified tabs left justify TAB PROPORTIONAL n,["ell"][R/C/L][+-n1],.. TABP - - - $ ~ Sets up proportionally spaced tab stops TAB RIGHT - - - - - - - - - - - TR - - - - $ ~ Unspecified tabs right justify TAB STOPS ["ell"][R/C/L]+n1,... - - - - TS - - - - $ Sets up ellipses, justification and location of tab stops TEST PAGE [n] - - - - - - - - - - TP - - - - *$ Starts new page if fewer than n lines remain on this page TEST TEXT [n] - - - - - - - - - - TT - - - - *$ ~ New page if fewer than n lines of text may be output on this page TEXT - - - - - - - - - - - - - TX - - - - *$ ~ Starts a block of text that may not be split between pages until TEXT, END TEXT, or PAGE TEXT DEFERRED - - - - - - - - - - TXD - - - - *$ ~ Starts a block of text to appear on a later page until TEXT, END TEXT, or PAGE TITLE [title] - - - - - - - - - - T - - - - $D Sets line of text to appear as page title TOP MARGIN [+-n] - - - - - - - - - TM - - - - *$ ~ Sets top margin for the next page 3 U Command - - - - - - - - - - - - Abbreviation - Opt. ------- ------------ ---- UNDERLINE "characters" - - - - - - - UN - - - - ~ The specified characters may be underlined UNDERLINE SPACES - - - - - - - - - - - - - - ~ Spaces may be underlined UNDERLINE NO SPACES - - - - - - - - - - - - - D~ Disables underlining of spaces UPPER CASE - - - - - - - - - - - UC - - - - D All text will be output in upper case 3 V Command - - - - - - - - - - - - Abbreviation - Opt. ------- ------------ ---- VARIABLE SPACING - - - - - - - - - VARSP - - - * ~ Enable variable spacing VARIANT aaaa - - - - - - - - - - - - - - - ~ Sets aaaa to be true until NO VARIANT 2 AUTHOR --- VMS/RSX --- John Clement T. W. Bonner Lab Rice University P.O. Box 1892 Houston, Tx, 77251 Tel (713) 527-8101x2037 Arpanet: CLEMENT@PHYSICS.RICE.EDU or: @RICE.EDU:CLEMENT@PHYSICS.RICE.EDU Bitnet: BONNER@RICE --- Rt-11 --- Robert Walraven Multiware, Inc. 437 F Street Davis, CA 95616