SUMMARY OF CHANGES MADE TO RUNOFF (version M3.0X) ------------------------------------------------- This document highlights the changes which have been made to DECUS RUNOFF (version M02) at Unimation West. The RUNOFF manual has been revised to reflect these changes. Thus, you can refer to it for further details on most of the changes listed here. NEW FEATURES 1. Added ability to have task expand itself to increase the index/ footnote buffer. No longer have to install or run RNO with a /INC value. 2. Added ALTERNATE [] to have odd-numbered pages shifted to the right spaces. The initial setting is NO ALTERNATE . If is omitted, it defaults to zero. Added /AL switch to enable/disable ALTERNATE. When ALTERNATE is active, the page numbers and titles appear on alternate sides of the pages. 3. Added ALTERNATING TITLE (AT) and NO ALTERNATING TITLE (NAT) (the default) commands. Causes the title to be output right justified on even-numbered pages and the subtitle to be output left justified on odd-numbered pages. Even if invoked, this command has no effect unless ALTERNATE is in effect (e.g., the effect is disabled by the /-AL switch). 4. Added BLOCK command to make segments of the input appear contiguous in the output even if that requires waiting until a later page in the output document. If deferral is necessary, the current output page continues to fill normally. 5. Added EVEN and ODD commands to force output to an even-numbered or odd-numbered page, respectively. 6. Added ability to specify multiple input files. All parameters are unchanged between consecutive input files. The processing of any input file after the first one will effectively begin with a BREAK. 7. Command-line switches are now processed from left to right, and they are now "sticky." That is, once a switch is applied, its effect continues until explicitly changed. 8. New /AP switch added to allow output to be appended to an existing file. This switch is processed only on the output specification. The appended material will start a new page. 9. Added LAYOUT command to set top margin, page length, base left margin, and default right margin. This command has the following syntax: LAYOUT ,,, The initial values are 0, 56., 0, and 60., respectively. If any argument is omitted (all are optional), its value is unchanged. SUMMARY OF CHANGES TO RUNOFF Page 2 New Features 10. The left and right margins are now defined relative to the base left margin. 11. Added /DO , /LO , /LE , /WI switches to allow LAYOUT parameters to be set via the command line. If any of these switches are used, and the corresponding argument is present in a LAYOUT command in the input, a warning message is output and the value is not changed. 12. Added ENTRY command. This command is similar to the INDEX command except that it does not cause the page number to be stored. 13. Added ability to specify subindexing. Added optional indent parameter to PRINT INDEX command. Added [NO] FLAGS SUBINDEX commands (initial setting is "enable"). As an example, use the following commands .entry Main .index Main>minor1 .index Main>minor1>minor2 to produce these index entries (using default indentation) Main minor 1 . . . . . . . . . . . . . minor 2 . . . . . . . . . . . . 14. Added AUTOSUBTITLE [] (AS) command to have HEADER LEVEL commands up to given level (default is 1) automatically set subtitle. Level value of zero disables automatic setting of subtitle (initial setting). 15. Added ability to selectively include or exclude segments of input file based on setting of a "switch". Related commands are: INCLUDE (IN) -- Turns on switch , EXCLUDE (EX) -- Turns off switch , OPTION (OPT) -- Marks start of optional segment , ELSE -- Inverts logic of active option , END OPTION (ENDO) -- Marks end of optional segment . Options can be nested to any depth, with "excluded" options overriding any inclosed "included" options. (Currently up to 32. switches are allowed.) Negative logic applies if a negative option number is supplied. Added /IN and /EX switches to permit setting of up to 5 options each from command line. Any options which are set this way cannot be changed within the input file. 16. Added RIGHT JUSTIFY [][;] (RJ) command to force (or the next line) against requested column (defaults to right margin). can be a signed value to indicate an offset relative to the right margin. SUMMARY OF CHANGES TO RUNOFF Page 3 New Features 17. Added FOOTNOTE LINE [][,][] (FNL) to provide for having footnotes automatically set off from the body of the text by a blank line and a line with characters . (The initial condition is equivalent to "FOOTNOTE LINE 15,_".) 18. Added PAGE NAME command to enable setting a name to be used as the prefix for page numbers (in place of chapter number or appendix letter if there is one). Maximum length for is 40. characters. 19. Added /CH:m:n switch to limit output to chapters m through n , inclusive. 20. Added TEST LINES (TL) command; has the same syntax and function as TEST PAGE but does not consider the current SPACING. 21. Added QUOTE CHARACTER [] command to allow the user to set the special character to be used as the quote character. If no character is provided, the default ("_") is selected. 22. Added "!" as comment flag. Appearance of exclamation mark on command line terminates command and causes remainder of line to be ignored. Also, any line beginning with a "!" is now ignored. 23. The number of blank lines output ahead of chapter and appendix headings has been made a variable which can be set at task build, and can be set with a command-line switch (/BL:). The default is currently 7 lines (it was 12). FEATURE ENHANCEMENTS 1. Added arguments to TEST PAGE command to control number of lines output together at the end of a group of lines. The new command format is TEST PAGE ,[],[] where "start" is the number of lines to be kept together at the beginning of a group of lines; "block" is the total number of lines in the group in the output (default is infinity); "end" is the number of lines to be kept together at the end of the group of lines (default is ). 2. Changed TEST PAGE and related functions of LIST ELEMENT and PARAGRAPH to consider the current SPACING. That is, these commands now check whether there is space for lines of text rather than simply lines in the output. SUMMARY OF CHANGES TO RUNOFF Page 4 Feature Enhancements 3. Added arguments to PARAGRAPH command to control number of lines output together at the _e_n_d of a group of lines. The new command format is PARAGRAPH [],[],[],[],[] where the first three parameters have the old meanings, and the last two parameters have the same meaning as the last two parameters for the current TEST PAGE command. 4. Made PARAGRAPH permissible in footnotes (default arguments are saved/restored). 5. Added text argument to FIGURE command to make it possible to have a caption output with the figure space even if it is deferred. 6. Made level parameter to HEADER LEVEL optional--defaults to current level (initially 1). Argument can also now be relative (i.e., a signed number). By making all level specifications relative (e.g., default or "+0" for the current level or "+1" for the next level) the insertion and removal of levels is simplified. 7. Expanded meaning of "=" character to include specification of hyphenation points to be used instead of those RUNOFF would pick. Then, when activated by the FLAGS HYPHENATE command, one can use "=" to indicate desired hyphenation points as well as to disable completely hyphenation for a word. 8. Made "=" work even if "word" begins with non-alphabetic character. 9. Modified hyphenation to have words which are already hyphenated (e.g., "even-numbered") broken at the hyphen (and only there or at any other user-specified points) if necessary. 10. Allow negative arguments to SKIP and BLANK to mean move down to that many lines from the bottom of the page. 11. Added warning message if footnotes over fill page, or if more than two blank lines are at bottom of page after footnotes are output. (The manual claimed that if there isn't room on the current page for the requested footnote space, it would be put on the next page. This is not true--the page just ends up being very long.) 12. Added "BLANK" HEADER type in which the word "Page" is not output. 13. Added size parameters to the HEADER command. The syntax now is: HEADER