.ifnot hlp .subtitle .left margin .page .HL 1 BASIC TEXT FORMATTING .endif hlp .lm .LEFT MARGIN +5 .if hlp .i-6;3 BREAK .br .endif hlp .skip.test page5.indent-5; _.BREAK .i-5; _.BR .p.x BREAK causes a break, i.e.#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. .if hlp .i-6;3 SKIP .br .endif hlp .q _.SKIP [-n] .i-5; _.S [-n] .x SKIP .paragraph Skips n spaced lines. The actual space on the page is determined by the current spacing. The number of blank lines is n times the spacing. If n is larger than the number of lines left on the page a new page is started, but no lines are skipped on it. If you are currently at the top of a page _.SKIP does nothing. The maximum value of n is 127 for normal spacing and 255 for half spacing. If n is negative RUNOFF will skip n lines from the bottom of the page. Negative skips will work if you are already at the top of a page. Skip can not be used to leave room for artwork or figures. To do this you must use _.FIGURE or _.FIGURE DEFERRED. Negative skips or skips greater than 6 are not allowed during footnotes or text sections. If n is not specified it is assumed to be 1. _.SKIP 6 will leave 1 inch of space if the spacing is 1. If the spacing is 2 or 3 then 2 or 3 inches will be left. .if hlp.i-6;3 BLANK .br .endif hlp .q _.BLANK [-n] .i-5; _.B [-n] .p.x BLANK Skips n absolute lines. BLANK is like SKIP, except that the space to be left 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. The maximum value of n is 127 for normal spacing and 255 for half spacing. Blank can not be used to skip lines to leave room for artwork or figures because no lines will be skipped at the top of a page. Negative n or n greater than 6 are not allowed in footnotes or text sections. If n is not specified it is assumed to be 1. _.BLANK 6 will always leave 1 inch of space on the page. .if hlp.i-6;3 FIGURE .endif hlp .q _.FIGURE [n] .i-5; _.FG n .p.x FIGURE 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. If n is greater than the number of lines/page an entirely blank page is produced. This command guarantees your having n blank lines for a figure, while blank will only guarantee n or fewer blank lines. If a figure caption follows the figure command it may not appear on the same page as the reserved space unless _.TEST TEXT has been used to guarantee enough space. To guarantee the caption and figure are on the same page, use _.TEXT. This command is not allowed during footnotes. This command has the unfortunate side effect that if the current page doesn't have enough space for the figure, the page is left with a number of blank lines at the bottom of it. The maximum value of n is 127 for normal spacing and 255 for half spacing. If n is not specified it is assumed to be 1. .if hlp .if RSX.i5;ADDITIONAL HELP AVAILABLE: DEFERRED .endif rsx .i-6;4 DEFERRED .endif hlp .q _.FIGURE DEFERRED [n] .i-5; _.FGD [n] .p.x FIGURE>DEFERRED This command is similar to figure. It will reserve n lines on the current page or if there is not enough room n lines at the top of the next page. If there is not enough room on the next page for all the lines requested an error message is produced and the next page will be entirely blank. This differs from _.FIGURE in that the current page will be filled with text right to the bottom line if there is no room for the figure on this page. This command can not have the figure caption follow the _.FIGURE command, unlike _.FIGURE. Captioned figures may be reserved using _.TEXT DEFERRED. This command may not be used inside a footnote, note, or text section. The maximum value of n is 127 for normal spacing and 255 for half spacing. This command is identical to: .i5;_.TEXT DEFERRED _.BLANK n _.END TEXT .ifnot hlp .NOTE _.BLANK, _.SKIP, and _.FIGURE are very similar commands. If you are intending to leave 1 inch of space _.BLANK 6 would be appropriate. If you need 3 lines of space _.SKIP 3 is the correct command. If you need to leave space at the top of a page, or need a guaranteed amount of space use _.FIGURE or _.FIGURE DEFERRED. When choosing between _.SKIP and _.BLANK remember that _.SKIP is appropriate if you are concerned with the number of text lines to skip, where text lines may be more than 1 physical line. _.BLANK is appropriate when the space to be left is an absolute value, for example .5 inches which is normally 3 physical lines. .end note .endif hlp .if hlp .i-6;3 INDENT .br .endif hlp .s.tt7.i-5; _.INDENT [-n] .i-5; _.I [-n] .x INDENT .i-5; _.LEFT [-n] .i-5; _.L [-n] .p.x LEFT causes a BREAK and sets the next line to begin n spaces to the right of the left margin. The n can be negative to allow beginning a line to the left of the left margin. However, a line cannot begin to the left of column 0. If n is not supplied, the current paragraph indent is used. .if hlp.i-6;3 RIGHT .br .endif hlp .q _.RIGHT [-n] .i-5; _.R [-n] .p.x RIGHT breaks the line and places the following text flush with the right margin if n is zero or unspecified. If n is specified the text is placed n spaces to the left of the margin (n positive) or n to the right (n negative). If _.RIGHT is issued after _.CENTER or _.CENTER TEXT, but before _.END CENTER, the command will be rejected with a Conflicting command message. .q_.RIGHT TEXT [-n] .i-5;_.R TEXT [-n] .p.x RIGHT>TEXT This command begins a section of text all of which is right justified. After this command each input line causes a break, until _.END RIGHT. .q_.END RIGHT .i-5;_.ER .p.x END>RIGHT This command ends a section of right justified text. .if hlp.i-6;3 PARAGRAPH .endif hlp .s.tt5.i -5; _.PARAGRAPH [-n], [v], [t], [b] .i-5; _.P [-n], [v], [t], [b] .p.x PARAGRAPH CAUSES A BREAK and starts a paragraph. The n is optional and, if present, sets 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 remaining on the page then a new page is started. B is the bottom test value. This specifies the minimum number of lines allowed on the next page. B is ignored during a text section. If B is set to 2 then any paragraph which is split between 2 pages will have at least 2 lines on the second page. T and B are ignored during a text section or footnote. This command is equivalent to: .i5; _.SKIP v _.INDENT n _.TEST TEXT t,b .i5;(parameter b is not available in DSR) .if hlp .if RSX.s.i5;ADDITIONAL HELP AVAILABLE: SET .endif rsx .i-6;4 SET .endif hlp .s.tt5.i -5; _.SET PARAGRAPH [-n], [v], [t], [b] .i-5; _.SPR [-n], [v], [t], [b] .p.x SET PARAGRAPH This command sets the paragraph parameters without actually starting a paragraph. This is often used to set the parameters before starting to process the text. The parameters specifed in this command also have an effect on the following commands: .lm+5.nj.DHY _.PARAGRAPH _.LIST#ELEMENT _.NOTE _.PRINT#INDEX _.DO#INDEX .lm-5.j.EHY .s.i5;The inital setting is: _.SET#PARAGRAPH#5,1,2,2 .if hlp.i-6;3 CENTER .br .endif hlp .q _.CENTER [LINE][+-n] .i-5; _.CENTRE [+-n] .i-5; _.C [LINE] [+-n] .p.x CENTER LINE .x CENTRE causes a BREAK and centers the following line of text in the source file. The centering is halfway between the right and left margins if n is not specified. If n is specified as an absolute argument (no sign) then the centering is over column n. If n is a relative argument the centering is over the default center plus the relative value of n. If a _.RIGHT command has been already specified for the current line the _.CENTER command will be treated as an error. .note The definition of n differs from the previous version of RUNOFF and DSR. .end note .if hlp .if rsx.i5;ADDITIONAL HELP AVAILABLE: TEXT END .endif rsx .i-6;4 TEXT .endif hlp .q _.CENTER TEXT [+-n] .I-5; _.C TEXT [+-n] .p.x CENTER TEXT centers the following lines of text until a _.END CENTER command. This differs from _.CENTER LINE in that it centers more than 1 line of text. Centering automatically prevents filling and justification. The argument n has the same meaning as for _.CENTER LINE. (NOT available in DSR) .if hlp.i-6;4 END .endif hlp .q _.END CENTER .I-5; _.ECN .p.x END>CENTER stops centering the text. This must be given only after a _.CENTER TEXT command. .ifnot hlp .lm .rm .HL 1 FOOTNOTE / NOTE .LM+5 .endif hlp .if hlp.i-6;3 FOOTNOTE .br .endif hlp .q _.FOOTNOTE .i-5; _.FN .p.x FOOTNOTE saves lines for a footnote. When the bottom of the page is reached the text following the _.FOOTNOTE command will be printed. If insufficient room remains on the current page, the footnote continues at the bottom of the following page. The text of the footnote should begin on the line following the _.FOOTNOTE command and ends with _.END FOOTNOTE. Indentation, case lock, justify, margins, spacing, bar, and fill are preserved around footnotes. In addition all status is preserved. See _.SAVE STATUS. However, commands that affect page formatting are illegal in a footnote. A footnote within a footnote is also illegal. If the footnote overflows from the current page onto the next page, it is possible that the line referring to the footnote will also be printed on the next page. To prevent this either preface the _.FOOTNOTE command by a command that causes a break, or place enough text between the reference and the command to guarantee a full line of text. Normally this command does not draw a line between the body of the text and the footnotes. If you want it to automatically draw a line you must use _.PERMANENT FOOTNOTE. .if hlp .if rsx.i5;ADDITIONAL HELP AVAILABLE: END PERMANENT .endif rsx .i-6;4 END .endif hlp .q _.END FOOTNOTE .I-5; _.EFN .p.x END>FOOTNOTE ends the footnote. The previous version of RUNOFF used an exclamation point (#!#) to do this. The exclamation point is not supported in this version. Each _.FOOTNOTE or _.PERMANENT FOOTNOTE command must be followed by a _.END FOOTNOTE command. .if hlp.i-6;4 PERMANENT .endif hlp .q _.PERMANENT FOOTNOTE .i-5; _.PFN .p.x PERMANENT FOOTNOTE This command may only be issued before other footnote commands. If this command is issued and a footnote command has already been given for the current page, the command will be flagged as an error. The text following this command is taken a permanent footnote which is then printed between the body of text on a page, and the footnotes at the bottom. This also sets up permanent margins, spacing, and fill/justify mode for footnotes. The left and right margins, and the spacing may be set during the permanent footnote, and they will be restored for every subsequent _.FOOTNOTE command. For example you may wish to separate the footnote from the text by a blank line, and a divider. You also wish to indent both margins by 2 on footnotes with no justification. To do this you might use the following sequence of instructions. .i5;(NOT available in DSR) .s.i+5; _.PERMANENT FOOTNOTE .i5;_.LEFT MARGIN +2 .RIGHT MARGIN -2 .NO JUSTIFY .i5; _.SKIP 2;------- footnote ------- .i5; _.END FOOTNOTE .s The permanent footnote will not be printed at the bottom of the page if no regular footnotes are declared. .bb If the permanent footnote is longer than 6 lines it is rejected with an error message. .eb .s .if hlp.i-6;3 NOTE .br .endif hlp .q _.NOTE [;][title] .i-5; _.NT [;][title] .p.x NOTE This command is used to format notes. A note is text set off from the rest of the text by reduced margins and a centered title. The text of the note is follows the _.NOTE command, and is ended by a _.END NOTE command. First this command command SKIPs 2, reduces both margins, centers the title text (if no text is given, it centers the word "NOTE"), and then SKIPS 1 and issues a .bb _.TEST#TEXT#t,b where t,b are determined by the last _.PARAGRAPH or _.SET .eb PARAGRAPH command. The text of the note is then printed. The same indentation is applied to both the left and right margins. The indentation is either 20,15,10, or 5 whichever produces no more than a 25% reduction in the text line. If the indentation produces a text line less than the minimum, no indentation is used, and an error message is typed. .i5;Unlike DSR notes may not be imbedded inside other notes. .q _.END NOTE [n] .i-5; _.EN [n] .p.x END>NOTE terminates the NOTE command, SKIPs n, and resets the margins and spacing modes to their settings before the last NOTE command. If n is not specified it will be 2 as the default.