.he INSTRUCTIONS FOR RUN80 FORMATTING PROGRAM ; Copyright (C) 1981, T. Shapin, Orange, CA. This documentation may not be sold but may be distributed without charge. .FO Page # RUN80 is a text formatting program that runs on an 8080 microprocessor system under CP/M. It is useful in writing reports, manuals, etc. It will automatically break text into pages, number the pages, add headings and footings and justify the right margin. You prepare your text by using any standard editor that runs under the CP/M operating system. You give your text file a name and an extension of "RNO" (which stands for RUNOFF). For example, "REPT1.RNO". You then type the CP/M command "RUN80 REPT1". This starts the RUN80 program, reads a REPT1.RNO file from your disk and produces a formatted file with the name "REPT1.MEM" (where the "MEM" extension stands for memo). This file can be typed by giving the CP/M command "TYPE REPT1.MEM" if your hard copy terminal is connected to your terminal. While you are typing your text, you add formatting commands that tell RUN80 how you want your test formatted. Each formatting command is put on a line by itself and starts with a period. These commands can be in either upper or lower case. .ul Formatting Commands The standard page layout is 60 characters wide and 66 lines high. This fits nicely on an 8-1/2 by 11 inch sheet. If you want to print a shorter page, say 8-1/2 inches high, put the command .pl 51 in your text file. The page format is set up for a header and a footer. This page was prepared with a header command like this: .he INSTRUCTIONS FOR RUN80 FORMATTING PROGRAM Both the header and the footer are optional and can be changed at any time. If the character"`#" appears in the header or footer command line, it will be replaced by the page number. The footer command line to prepare this page looks like this: .FO Page `# If you want to start the header or footer with blanks, start with a quote, "'", which will prevent leading blanks from being discarded. By default, the formatting program fills output lines by packing as many input words as possible onto an output line before printing it. The lines are also justified (right margins are made even) by inserting extra spaces into the line before output. People normally want filled text, which is why it is the default. It can be turned off however by the no-fill command: .nf and thereafter lines will be printed without any rearrangement. Filling can be turned back on with the fill command: .fi When .nf is encountered, there may be a partial line collected but not yet output. The .nf will force this line out before anything else happens. This action is called a "break". Many commands cause a break as part of their action. To force a break explicitly, use: .br To get extra blanks lines, you can use the skip command: .sk To skip more than one blank line, follow this with a number. (A space is always required between the command and the number.) For example: .sk 2 will skip 2 blank lines. A line that begins with spaces is a special case. If there is nothing except spaces on the line, the line causes a break and produces a number of blank lines equal to the current line spacing. These lines are never discarded regardless of where they appear, so they provide a way to get blank lines at the top of a page. If there are "n" leading spaces followed by text, it it causes a break and a temporary indent of "+n". These actions will cause a document that contains no formatting commands at all to be reasonably formatted. The default line spacing is single space. To change to double spacing, use the command: .sp 2 Or use three for triple spacing, etc. The page command causes a skip to the top of a new page and also causes a break. If you add a number to this command, the new page will be given that number: .pg 15 To center the next line of output use: .ce and you can center the next five lines of output by adding a number: .ce 5 or if you don't like to count lines use a big number: .ce 5 .ce 500 lots of lines to be centered .ce 0 (to cancel the centering) Underlining operates much like centering: .ul n causes the text on the next n lines to be underlined upon output. But .ul does not cause a break, so words in filled text may be underlined by: words and words and .ul lots more words. to produce: words and words and .ul lots more words. The indent command controls the left margin. .in n causes all subsequent lines to be indented by "n" positions. The normal default indent is "0". The command: .rm n sets the right margin to n. The line length of filled lines is the difference between the right margin and indent values. These margin commands do not cause a break. The temporary indent sets the indent to position "n" for one output line only. .ti n If "n" is less than the current indent, the indent is backwards (a hanging indent). We will show some examples of this. Since absolute numbers are often awkward, RUN80 allows relative values to be used as command arguments. All commands that allow a numeric argument "n" also allow "+n" or "-n" instead, to signify a change in the current value. For instance, .rm -10 .in +10 shrinks the right margin by 10 from its current value and moves the indent 10 places farther to the right. Thus, .rm 10 and .rm +10 are quite different. Relative values are particularly useful with ".ti" to temporarily indent relative to the current indent. .in +5 .ti +5 produces a left margin indented by 5, with the first line indented by a further 5 spaces. And .in +5 .ti -5 produces a hanging indent as in a numbered paragraph: .in +5 .ti -5 1.##Now is the time for all good people .br to come to the aid of their party. .in 0 Normally tabs in the input file are converted to single spaces. Tab stops can be set with a tabs command, e.g. you can set tab stops at column 9, 17, 25 and 35 by the command .ta 9,17,25,35 in your text file. Then when you type a tab key in your text (or control-I for terminals that do not have a tab key), enough spaces will be added in the line to move the following characters to the next tab position. Tab stops are cancelled by a ".ta 0" command, where the first number is zero. .ul Special Characters The use of "`#" in headers and footings to get a page number was already mentioned. When it is typed in text, it is used to get a non-expandable blank in filled and justified lines. For example, 3.`#`#This is the reason ... will always have exactly two blanks after the "3." even though the program may add extra blanks to this line in order to make the right margin even. When TABS and tab stops are used in justified text, non-expanding blanks are inserted. In unfilled text, plain blanks are inserted. A special escape character "``" is used to mean print the following character and ignore and special meaning it otherwise has. It can be used to print itself or the "`#" character. .nf .he SUMMARY OF RUN80 FORMATTING COMMANDS .PG COMMAND BREAK? DEFAULT FUNCTION ------- ------ ------- -------- .BR YES CAUSE A LINE BREAK .CE N YES N= 1 CENTER THE NEXT N LINES .FI YES START FILLING (MOVE WORDS TO FILL LINES) .FO NO EMPTY FOOTER TITLE .HE NO EMPTY HEADER TITLE .IN N NO N=0 INDENT N SPACES .NF YES STOP FILLING .PG N YES N=+1 BEGIN PAGE NUMBERED N .PL N NO N=66 SET PAGE LENGTH TO N .RM N NO N=60 SET RIGHT MARGIN TO N .SK N YES N=1 SPACE DOWN N LINES .SP N NO N=1 LINE SPACING IS N .TA N,N... NO CLEARS SET TAB STOPS (10 MAX) .TI N YES N=0 TEMPORARY INDENT OF N .UL N NO NO N=1 UNDERLINE WORDS IN NEXT N LINES .fi .ul Special Characters "`#" in a heading or footing will be changed to the page number. "`#` in filled text will be changed to blank (non-expandable). The escape character "``" means to print the next character literally. .sk 20 @