-*-TAGS-*-  File: RNO2, Node: Commands, Up: (RNO)Top, Prev: (RNO)Special Characters, Next: Sample Any line in a source file beginning with a period in the first column is assumed to be an RNO command. If it is not, an error diag- nostic will be typed and the line will be ignored. Some commands take one or more decimal number arguments. These are separated from the command by a space. More than one command may be entered on a single line by separating the commands with a semicolon (;) or a period. Most commands can be abbreviated. * Menu: INFO on the more useful RNO commands * Text Formatting:: * Page Formatting:: * Mode Setting:: * Parameter Setting:: For a complete listing of RNO commands, see the full documentation. For A sample of RNO input and output, use the "N" command  File: RNO2, Node: Text Formatting, Up: Commands, Next: Page Formatting .BREAK .BR Causes a BREAK. That is, the current line will be output with no jus- tification, and the next word of the source text will be placed at the beginning of the next line. .SKIP n .S n Causes a BREAK after which n is multiplied by the number of spaces between lines. (see the SPACING command). The result is the number of lines skipped. Output is advanced to the top of the next page if there is no room on the current page. The n can also have a negative value. Thus, a final footnote can be set by a command such as .SKIP -5. .BLANK n .B n Causes the current line to be output with no justification, skips n line spaces, and then starts output of the current source text. The n can be negative to move the line n lines from the end of the page. BLANK is like SKIP, except that the space to be left is independent of line spacing. .INDENT n .I n 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. .PARAGRAPH n, v, t .P n, v, t Causes a BREAK and begins a new paragraph. The arguments, n,v, and t are optional. The n sets the number of spaces the paragraph is to be indented. The default value for n is 5 (n can also have a negative value). The v sets the vertical spacing between paragraphs. It can range in value from 0 to 5. The default value for v is 1. The t causes an automatic TEST PAGE (see the TEST PAGE command). .CENTER n;text .CENTRE n;text .C n;text Causes a BREAK and centers the text. The centering is over column n/2, independent of the setting of the left and right margins. If n is not given, it is assumed to be the page width. .FOOTNOTE n .FN n Saves n lines at the bottom of the current page for a footnote. The n is multiplied by the number of spaces set with the SPACING command. If insufficient room remains on the current page, space is allocated at the bottom of the following page. Indentation, case lock, justify, margins, spacing, and fill are preserved around footnotes. Such par- ameters may be set within the footnote itself, without changing the settings in the body of the source file. However, commands that af- fect page formatting are illegal in a footnote. Resetting of tab stops is illegal because they are not preserved. A footnote within a footnote is also illegal. The actual space taken by a footnote can be more or less than speci- fied by n. If necessary, adjust n after examining a draft printout. The footnote is terminated with a line beginning with an exclamation point (the remainder of which is ignored). .LIST n .LS n Starts an indented list with n spacing, moves the left margin 9 spaces to the right for the first LIST command, and 4 more spaces for each subsequent nested LIST. The normal FILL and JUSTIFY modes remain in effect. Therefore, you must disengage them just after the LS command if you want an uneven right margin. This command is used in conjunc- tion with the LIST ELEMENT and END LIST commands. .LIST ELEMENT;text .LE;text Starts an item in the list, used in conjunction with the LIST command. The elements are numbered sequentially and the number is given a nega- tive indent so that the list lines up with its other elements. The list elements are separated by the standard paragraph spacing and TEST PAGE. .END LIST .ELS Terminates listing and returns to settings in effect before the previ- ous list command. .COMMENT text Causes the line to be ignored. The text is not printed in the output file but serves as a comment line in the source file.  File: RNO2, Node: Page Formatting, Up: Commands Prev: Text Formatting, Next: Mode Setting .CHAPTER text .CH text Starts a new chapter using the text as the title of the chapter. This command acts as if the following command string were entered: .BREAK;.PAGE;.BLANK 12;.CENTER CHAPTER n followed by, .BLANK 2:.CENTER;text;.BLANK 3 The n is incremented by 1 automatically after each CHAPTER command. This command then resets the case, margins, spacing, and justify/fill modes to their default settings. It also clears any subtitles and sets the chapter name as the title. .HEADERLEVEL n text .HL n text Starts a section at the level specified and takes the following text as the header. The n can range from 1 to 5. The sections are incre- mented by 1 automatically, and the number is output in the form "i.j.k.l.m." If this is a chapter-oriented document, the i is the chapter number. Otherwise, it is the number of the .HL 1 level. This command acts as a .BREAK;.TEST PAGE 9;.BLANK 3 followed by the section number, two spaces, and the section name. HEADER LEVELS 1 and 2 end with a BREAK. HEADER LEVELS 3,4, and 5 end with a space-dash-space combination (#-#).  File: RNO2, Node: Mode Setting, Up: Commands Prev: Page Formatting, Next: Parameter Setting .JUSTIFY .J Causes a break and sets subsequent output lines to be justified. This is the default setting. The command increases the spaces between words until the last word exactly meets the right margin. .NOJUSTIFY .NJ Causes a break and prevents justification of subsequent output, creat- ing a ragged right margin. .UPPER CASE .UC Sets the output mode to upper case. This is the default mode. There is no need to type this command unless the mode was previously altered to lower case. .LOWER CASE .LC Sets the output mode to lower case. All upper case letters appearing in the source text will be converted to lower case in the output file, unless they are preceded by certain special case mode characters. (See the complete documentation for more information.) .LITERAL .LIT Disengages FILL/JUSTIFY to permit printing of text exactly as entered in source file. .END LITERAL .ELI Used after LITERAL command to re-engage FILL/JUSTIFY.  File: RNO2, Node: Parameter Setting, Up: Commands, Prev: Mode Setting .LEFT MARGIN .LM n Sets the left margin to n. The n must be less than the right margin but not less than 0. The default setting is 0. .RIGHT MARGIN n .RM n Sets the right margin n. The n must be greater than the left margin. The default setting is 60. .SPACING n .SP n Sets the number of spaces between lines. The n can range from 1 to 5. The default setting is 1. SPACING 1 is like single spacing on a ty- pewriter while SPACING 2 is like double spacing. SPACING 2 puts one blank line between lines of text. .TAB STOPS n,n,... .TS n,n,... Sets tabs. The n must be greater than 0 and listed in ascending order. If tabs already exist, the issuing of another TAB STOPS com- mand clears all previous tabs before setting new ones. The default tabs are set at eight-column intervals to match the Digital hardware standard. These tabs are at columns 9, 17, 25, 33, 41, 49, 57, and 65.  File: RNO2, Node: Sample, Up: (RNO)Top, Prev: Commands The menu below contains two entries. The first shows a sample of text prepared for running through RNO. This is called Source. The second entry shows the results of running the "source" through RNO * Menu: * Source:: The INPUT (or .RNO file) * Results:: The OUTPUT (or .DOC file)  File: RNO2, Node: Source, Up: Sample, Next: Results .COMMENT SOURCE.RNO, A SAMPLE RNO SOURCE FILE .COMMENT TO GENERATE DOC COPY TYPE, RUN $RNO .COMMENT FILESPEC IS...KB:/WA/UL:L=SOURCE .UPPER CASE;.LEFT MARGIN 0;.RIGHT MARGIN 60 .CHAPTER SAMPLE RNO SOURCE/DOC FILES .HEADERLEVEL 1 ^&INTRODUCTION\& .PARAGRAPH;This page represents a sample RNO DOC file corresponding to the source file listed above. It was produced on a ^&TELERAY\& terminal with both upper and lower case letters. An attempt will be made here to demonstrate the use of as many features as possible. These include the following: .LIST .LE;RNO##COMMANDS .LE;SPECIAL##CHARACTERS .LE;FILE##SPECIFICATION##SWITCHES * .FOOTNOTE 4;______________________________ .BREAK;* See the source file .COMMENT lines for use. ! .END LIST .HEADERLEVEL 1 ^&COMMANDS\& .PARAGRAPH;Several commands which have not been used in the formatting of this text up to this point will now be demonstrated. .PARAGRAPH;The .LITERAL command is extremely useful to new and old RNO users alike. Difficult or time consuming text formatting may be avoided, .TEST PAGE 3 .LITERAL IF YOU WISH TO FORMAT YOUR OWN TEXT MATERIAL! .COMMENT THE FOLLOWING COMMAND HAS BEEN SHIFTED ONE COLUMN .COMMENT TO THE RIGHT FROM ITS POSITION IN THE REAL SOURCE .COMMENT FILE...WHY? .END LITERAL .BLANK 1;.LEFT MARGIN 5 .INDENT -5;Note that indenting may be done with a negative argument to allow beginning a line to the left of the left margin. However, a line cannot begin to the left of column 0. .LEFT MARGIN 0 .NOJUSTIFY;.PARAGRAPH;Of course it is entirely possible to get "normal" output at the right margin. By disabling line justification, a "ragged" right margin results. Note that RNO is still filling lines normally. .JUSTIFY .PARAGRAPH;Several particularly interesting commands are not used here due to lack of space. A short list of such commands follows. .BLANK 1 .TAB STOPS 7,25 PAGE 14 ^&COMMAND\& ^&FUNCTION\& .LEFT MARGIN 25 .BLANK 1 .INDENT -25; .INDEX TEXT Takes the remaining text on the line as a keyword and adds it, along with the current page number, to the internal index buffer. .BLANK 1;.INDENT -18; .DO INDEX TEXT####Forces a new page, centers the text, if given, otherwise it centers the word "INDEX". This command prints the entire contents of the index buffer. .LEFT MARGIN 0 .HEADERLEVEL 1 ^&CONCLUSION\& .P;RNO is a useful tool for people of widely differing backgrounds. Like anything good, it is complex. However, it offers the knowledgable user tremendous rewards in flexibility and quality text output.  File: RNO2, Node: Results, Up: Sample Prev: Source CHAPTER 1 SAMPLE RNO SOURCE/DOC FILES 1.1 INTRODUCTION This page represents a sample RNO DOC file correspond- ing to the source file listed above. It was produced on a TELERAY terminal with both upper and lower case letters. An attempt will be made here to demonstrate the use of as many features as possible. These include the following: 1. RNO COMMANDS 2. SPECIAL CHARACTERS 3. FILE SPECIFICATION SWITCHES * 1.2 COMMANDS Several commands which have not been used in the for- matting of this text up to this point will now be demon- strated. The .LITERAL command is extremely useful to new and old RNO users alike. Difficult or time consuming text format- ting may be avoided, IF YOU WISH TO FORMAT YOUR OWN TEXT MATERIAL! Note that indenting may be done with a negative argument to allow beginning a line to the left of the left margin. However, a line cannot begin to the left of column 0. _______________ * See the source file .COMMENT lines for use. SAMPLE RNO SOURCE/DOC FILES PAGE 1-2 Of course it is entirely possible to get "normal" output at the right margin. By disabling line justification, a "ragged" right margin results. Note that RNO is still filling lines normally. Several particularly interesting commands are not used here due to lack of space. A short list of such commands follows. COMMAND FUNCTION .INDEX TEXT Takes the remaining text on the line as a keyword and adds it, along with the current page number, to the internal index buffer. .DO INDEX TEXT Forces a new page, centers the text, if given, otherwise it centers the word "INDEX". This command prints the entire contents of the index buffer. 1.3 CONCLUSION RNO is a useful tool for people of widely differing backgrounds. Like anything good, it is complex. However, it offers the knowledgable user tremendous rewards in flexi- bility and quality text output.  TAGS: :SGAT Commands:15 Text Formatting:855 Page Formatting:4821 Mode Setting:6105 Parameter Setting:7228 Sample:8272 Source:8637 Results:11297