Trailing-Edge
-
PDP-10 Archives
-
ap-c796e-sb
-
rnf10.rnd
There are no other files named rnf10.rnd in the archive.
.SPACING 1
\\
.TITLE ^^RUNOFF.DOC\\ -- ^CHANGES FROM VERSION 7^B TO 10
^^RUNOFF.DOC\\ -- ^CHANGES FROM VERSION 7^B TO 10
.BREAK
^JANUARY, 1975
.SKIP 1
^COPYRIGHT 1974, 1975, ^DIGITAL ^EQUIPMENT ^CORP., ^MAYNARD, ^MASS.
.SKIP 5
.TAB STOPS 5
.LEFT MARGIN 5
.PARAGRAPH -5
1.0 ^^SUMMARY\\
.PARAGRAPH
1.1 ^THE PURPOSE OF THIS RELEASE IS TO CORRECT SEVERAL BUGS AND
TO INCLUDE MANY NEW FEATURES. ^THE OLD DIALOGUE COMMAND SCANNER
HAS BEEN REPLACED BY ^^SCAN\\ AND ^^WILD\\, SO FULL WILD-CARD
CAPABILITIES HAVE BEEN IMPLEMENTED. ^TEXT COMMANDS CAN NOW BE
ABBREVIATED; FOOTNOTES HAVE BEEN CLEANED UP; AND THE INDEXING
CAPABILITIES HAVE BEEN IMPROVED. ^MULTIPLE COMMANDS CAN BE
INCLUDED IN ONE LINE AND COMMENTS MAY ALSO BE INCLUDED. ^ALL
ERROR MESSAGES HAVE BEEN IMPROVED SUBSTANTIALLY. ^COMMAND SWITCHES
HAVE BEEN INCLUDED TO ENSURE FULL COMPATABILITY
(EXCEPT IN SOME FOOTNOTE HANDLING), BUT SHOULD NOT
NORMALLY BE NEEDED.
^NEW CAPABILITIES HAVE BEEN ADDED TO SELECT DOCUMENTATION
FROM SOURCE FILES, TO CONTROL THE APPLICATION AND
SELECTION OF THE SPECIAL TEXT FLAG CHARACTERS, TO ENTER
WORDS IN THE INDEX EASILY, AND TO FULLY CAPITALIZE A SINGLE WORD.
^OPTIONS HAVE BEEN ADDED TO LIST THE INPUT FILE SEQUENCE
NUMBERS IN THE OUTPUT MARGIN AND TO HANDLE UNDERLINING
ON A SEPARATE LINE FOR PRINTERS WITHOUT AN UNDERLINE CAPABILITY.
^^RUNOFF\\ NOW HAS THE ABILITY TO NUMBER AND FORMAT
SECTIONS AND CHAPTERS. ^THE USER NOW HAS
THE CAPABILITY OF INCLUDING CONDITIONAL COMMANDS AND TEXT
AND CAUSING DIFFERENT VARIATIONS OF THE DOCUMENT TO
BE PRODUCED DEPENDING UPON SWITCHES IN THE COMMAND STRING.
.PARAGRAPH
1.2 ^THIS VERSION OF ^^RUNOFF\\ MUST BE LOADED WITH ^^SCAN\\ VERSION 7
AND ^^WILD\\ VERSION 7. ^THERE ARE NO OTHER DEPENDENCIES. ^IT
FULLY SUPERSEDES ALL PREVIOUS VERSIONS AND HAS NO KNOWN
DEFICIENCIES.
^THIS RELEASE FIXES ALL BUGS REPORTED IN ^^SPR\\S THROUGH
10-13,170 (^MAY, 1974), AND RUNS ON ALL MONITORS. ^IT HAS BEEN TESTED
ON 5.05, 5.06, AND 5.07/6.01.
^^RUNOFF\\ VERSION 10 FULLY SUPPORTS THE ^^DATE75\\
CONVENTION AND THE ERROR MESSAGE STANDARD.
.PARAGRAPH
1.3 ^^RUNOFF\\ IS DOCUMENTED IN THE PROGRAMMING SPECIFICATION,
"^^RUNOFF.RNO".\\
.PAGE
.PARAGRAPH
2.0 ^^EXTERNAL\\ ^^CHANGES\\
.PARAGRAPH
2.1 (^^SPR\\ 10-3950) : ; ! AND ? FOLLOWED BY SPACE ARE TREATED LIKE
PERIOD. ^THIS MEANS THAT THEY NORMALLY PRECEDE A
DOUBLE SPACE. ^IF THIS IS NOT DESIRED, THEN THE : ; . ! OR
? SHOULD BE QUOTED BY A __.
^THIS BEHAVIOUR OF ALL FIVE CHARACTERS (:;!.?) CAN BE
SUPPRESSED WITH THE COMMAND .^^NOPERIOD\\ AND RESTORED WITH
THE COMMAND .^^PERIOD.\\
.PARAGRAPH
2.2 (^^SPR\\ 10-4826) ^ALL COMMANDS CAN BE ABBREVIATED. ^THE FULL SPELLING WILL
BE CHECKED. ^IN MULTIPLE WORD COMMANDS, EACH WORD CAN BE
ABBREVIATED.
^ALSO, INTRODUCE UNIQUE, PERMANENT ONE-THREE LETTER ABBREVIATIONS
FOR EACH COMMAND. ^THESE ARE DETAILED IN THE ^^RUNOFF\\ INPUT
FORMAT HELP FILE, ^^RUNINP.HLP.\\
^WARNING, EXCEPT FOR THE PERMANENT ONE-THREE LETTER ABBREVIATIONS,
IT IS A BAD IDEA TO MAKE EXTENSIVE USE OF THE ABBREVIATION
FACILITY BECAUSE THE ABBREVIATIONS ARE
NOT GUARANTEED UNIQUE FOR FUTURE VERSIONS. ^THESE ABBREVIATIONS
SHOULD BE USED TO SHORTEN EXTREMELY LONG COMMANDS (E.G., ^^AUTOTAB\\
FOR ^^AUTOTABLE\\), BUT NOT SHORT ONES (E.G.,
^^JU\\ FOR ^^JUSTIFY\\).
.PARAGRAPH
2.3 (^^SPR\\ 10-7122) ^ADD THE FOLLOWING SYNONYMS FOR COMMANDS:
^^.PAGE SIZE\\ FOR
^^.PAPER SIZE\\ AND ^^.SUBTTL\\ FOR ^^.SUBTITLE\\.
.PARAGRAPH
2.4 (^^SPR\\ 10-5999) ^ADD COMMAND .^^SUBINDEX\\ (WITH SYNONYM .^X) WHICH IS THE
SAME AS .^^INDEX\\ EXCEPT THAT ; AND ! ARE MULTIPLE COMMANDS AND
COMMENTS RESPECTIVELY. > SEPARATES SUB-INDEX SECTIONS. ^WHEN
THE INDEX IS PRINTED, SUB-INDEX SECTIONS ARE INDENTED AND NOT
REPEATED.
^THUS, FOR EXAMPLE, IF THREE SUB-INDEX ENTRIES HAVE BEEN MADE BY
THE COMMANDS:
.LEFT MARGIN 10
^^_.X FOO>BAR
.BREAK
_.X FOO>DOG
.BREAK
_.X FOO>CAT\\
.LEFT MARGIN 5
^THEN, WHEN THE INDEX IS PRINTED, ^^FOO\\ WILL BE INDEXED, AND
UNDER IT WILL BE INDEXES OF ^^BAR,\\ ^^CAT,\\ AND ^^DOG.\\ ^THUS,
.LEFT MARGIN 10
.TAB STOPS 5,15
^^FOO
.BREAK
BAR#.#.#.#.#.#PAGES
.BREAK
CAT#.#.#.#.#.#PAGES
.BREAK
DOG#.#.#.#.#.#PAGES\\
.LEFT MARGIN 5
.PARAGRAPH
2.5 (^^SPR\\ 10-7122) ^ADD A NEW MESSAGE TO WARN OF INDENTS TO THE LEFT OF 0.
THE MESSAGE IS "?^^RNFNIA NEGATIVE INDENT ATTEMPTED\\".
.PARAGRAPH
2.6 ^ADD DEFENSIVE CODE TO FOOTNOTE ROUTINE TO RECOVER
INSTEAD OF ^^HALT.\\
.PARAGRAPH
2.7 (^^SPR\\ 10-4928) ^^.PAGE\\ ^^SIZE\\ NOW CLEARS CURRENT LINE BEFORE CHANGING PAGE WIDTH AND
COUNTS AS A BREAK.
.PARAGRAPH
2.8 (^^SPR\\ 10-7122) ^IN PAUSE MODE, THE BELL WILL BE RUNG TO NOTIFY THE USER
THAT THE PAPER SHOULD BE ADVANCED.
(^^SPR\\S 10-4818, 5172, 7122) ^FINISH OUTPUTTING THE BUFFER
BEFORE PAUSING.
(^^QAR\\ 2493, 2494) ^CLEAR THE ^^TTY:\\ BUFFER BEFORE PAUSING.
^IF OUTPUT IS TO A ^^TTY:\\, SUPPRESS ECHO OF THAT TERMINAL'S
INPUT.
.PARAGRAPH
2.9 ^BLANK PAGES WILL BE SUPPRESSED. ^THEY CAN BE INCLUDED
WHEN NEEDED BY GIVING A ^^.FIGURE\\ COMMAND.
.PARAGRAPH
2.10 (^^SPR\\ 10-6102) ^WHEN PRINTING THE INDEX, MANY ENTRIES WILL NOW OCCUPY SEVERAL
LINES INSTEAD OF OVERFLOWING THE LINE WIDTH.
.PARAGRAPH
2.11 (^^SPR\\ 10-3018) ^FOOTNOTE WITHIN A FOOTNOTE IS ILLEGAL. ! AS FIRST CHARACTER
OF A LINE OUTSIDE A FOOTNOTE IS TREATED AS A VALID TEXT CHARACTER.
^ADD A COMMAND, ^^.END FOOTNOTE\\, WHICH HAS THE SAME EFFECT
AS "!", I.E., IT ENDS A FOOTNOTE DEFINITION.
.PARAGRAPH
2.12 (^^SPR\\S 10-5896, 7630) ^AROUND FOOTNOTES, PRESERVE INDENTATION, CASE LOCK, JUSTIFY,
MARGINS, SPACING,
AND FILL. ^AT THE START OF EACH FOOTNOTE, CLEAR INDENTATION,
SET JUSTIFY AND SET FILL.
^SET SPACING AND MARGINS TO THE SAME AS THE START OF THE FILE
AND THE PAGE WIDTH. ^INITIALIZE THE CASE OF THE FOOTNOTE TO BE
THE SAME AS THE CASE LOCK AT THE TIME OF FOOTNOTE DEFINITION.
^MAKE COMMANDS WHICH AFFECT THINGS SUCH AS PAGE FORMATTING
BE ILLEGAL IN A FOOTNOTE. ^THE MESSAGE IS ^^"ILLEGAL
IN FOOTNOTE"\\. ^ALSO, MAKE ^^.TAB STOPS\\ ILLEGAL
IN A FOOTNOTE BECAUSE THEY ARE NOT PRESERVED.
.PARAGRAPH
2.13 ^INDICATE CORE EXPANSION WITHIN [ AND ] UNLESS THE OUTPUT
IS TO THE ^^TTY:.\\ ^WHEN THE INDEX IS PRINTED, RECLAIM
CORE.
.PARAGRAPH
2.14 (^^SPR\\ 10-5498) ^REPORT FILE NAME AND THE NUMBER OF OUTPUT PAGES AT END OF EACH FILE.
^IN ^^CCL\\ MODE, PREFIX THE MESSAGE WITH "^^RUNOFF\\:#".
.PARAGRAPH
2.15 ^DISREGARD STRANGE CONTROL CHARACTERS IN THE INPUT FILE.
ISSUE A WARNING MESSAGE "^^%RNFIIF "_^\X" IGNORED IN INPUT FILE\\".
^THIS BEHAVIOUR CAN BE OVERRIDDEN BY QUOTING THE CONTROL CHARACTER
OR BY USE OF THE COMMANDS ^^.CONTROL\\ ^^CHARACTERS\\
AND ^^.NO CONTROL CHARACTERS\\ OR THE SWITCHES ^^/CONTROL\\ AND
^^/NOCONTROL.\\
.PARAGRAPH
2.16 ^SUPPRESS THE LEADING AND TRAILING FORM-FEED EXCEPT IN PAUSE
MODE OR WHEN THE OUTPUT IS TO THE ^^TTY:.\\
.PARAGRAPH
2.17 ^CLEAR OUT ANY FINAL FOOTNOTES AT END-OF-FILE.
.PARAGRAPH
2.18 ^CONVERT COMMAND SCANNER TO USE ^^SCAN \\AND ^^WILD.\\ ^FULL INPUT
AND OUTPUT WILD-CARDING IS NOW SUPPORTED. ^VARIOUS OPTIONS WERE MADE SWTICHES
AS FOLLOWS:
.NOFILL
.LEFT MARGIN 10
.TAB STOPS 5,25
^L#UNDERSCORE ^^/UNDERLINE:LINE\\
^C#UNDERSCORE ^^/UNDERLINE:CHARACTER\\
^B#UNDERSCORE ^^/UNDERLINE:BACKSPACE\\
^N#UNDERSCORE ^^/UNDERLINE:NONE\\ OR ^^/NOUNDERLINE\\
^SIMULATE#^^FF /SIMULATE\\
^PAUSE ^^/PAUSE\\
.LEFT MARGIN 5
.FILL
^ALSO ADD SWITCHES /^^NOSIMULATE\\ AND /^^NOPAUSE,\\ WHICH ARE
THE DEFAULTS, FOR COMPLETENESS.
^IN ADDITION, ^^RUNOFF\\ WOULD RESPOND TO THE MONITOR COMMAND
^^RUNOFF\\ IF THERE WERE ONE. ^IT WILL ALSO SUPPORT MONITOR
COMMANDS OF THE FORM:
.INDENT 5
^^R RUNOFF\\ (COMMAND)
.BREAK
IN WHICH ONE COMMAND LINE IS GIVEN TO ^^RUNOFF\\ AND
IT RETURNS TO MONITOR MODE AFTER COMPLETING ITS WORK.
.PARAGRAPH
2.19 ^MAKE DEFAULT INPUT FILE SPECIFICATION BE ^^DSK\\: IN THE
USERS'S DEFAULT DIRECTORY. ^THE EXTENSION WILL DEFAULT TO THE
FIRST OF ^^.RNO, .RNB, .RNC, .RND, .RNE, .RNH, .RNL, .RNM, .RNP, .RNS,\\ AND .#WHICH ARE SEEN FOR
THE SPECIFIED FILE NAME. ^THE DEFAULT OUTPUT FILE SPECIFICATION
IS ^^DSK\\: IN THE USER'S DEFAULT DIRECTORY WITH THE FILE
NAME MATCHING THE INPUT FILE'S AND THE OUTPUT EXTENSION
DETERMINED BY THE INPUT EXTENSION AS FOLLOWS:
.LEFT MARGIN 15
.NOFILL
^^_.RNO .MEM
_.RNB .BLB
_.RNC .CCO
_.RND .DOC
_.RNE .ERR
_.RNH .HLP
_.RNL .PLM
_.RNM .MAN
_.RNP .OPR
_.RNS .STD
_. .MEM\\
.LEFT MARGIN 5
.FILL
.PARAGRAPH
2.20 ^CHANGE THE DEFAULT SPACING TO BE SINGLE SPACING. ^THIS CAN BE
ALTERED BY THE /^^SPACING\\:N SWITCH. ^THIS SWITCH AFFECTS
THE SPACING FROM THE START OF THE FILE UNTIL THE
FIRST ^^.SPACING\\ COMMAND.
.PARAGRAPH
2.21 (^^SPR\\ 10-5354, 6102) ^ADD A SWITCH TO SPECIFY THE CHARACTER USED FOR UNDERLINING.
^THIS SWITCH IS ^^/UNDERLINE\\:OOO WHERE OOO IS THE OCTAL REPRESENTATION
OF THE ASCII CHARACTER TO BE USED.
^THE VALUE CAN ALSO BE GIVEN AS A QUOTED ASCII CHARACTER (E.G., "X").
^THE DEFAULT IS 137 WHICH IS __. ^IN /^^UNDERLINE:SEPARATE\\ MODE
(SEE BELOW), THE DEFAULT IS -.
.PARAGRAPH
2.22 ^CONVERT ALL MESSAGES TO LOWER CASE. ^IMPROVE
MOST OF THEM IN THE PROCESS. ^ALL ERROR MESSAGES NOW SPECIFY THE
OUTPUT PAGE NUMBER OF THE ERROR. ^THEY ALSO INCLUDE
THE INPUT PAGE AND LINE WITHIN PAGE COUNTS. ^IF THE
INPUT FILE IS LINE-SEQUENCE NUMBERED, THEN THAT NUMBER IS
INCLUDED.
.PARAGRAPH
2.23 (SEVERAL ^^SPR\\S) ^USE LINE-FEED, VERTICAL TAB, AND FORM-FEED
AS END OF LINE CHARACTERS INSTEAD OF CARRIAGE RETURN. ^THIS
AFFECTS PRIMARILY WHEN COMMANDS ARE RECOGNIZED.
^STRINGS OF CONSECUTIVE SUCH CHARACTERS ARE CONSIDERED
AS ENDING ONE LINE UNLESS SEPARATED BY A CARRIAGE RETURN.
^IN .^^CONTROL CHARACTER\\ MODE, IF VERTICAL TAB, FORM FEED,
OR CARRIAGE RETURN ARE QUOTED, THEY WILL BE PASSED AS DATA.
.PARAGRAPH
2.24 ^ALLOW MULTIPLE COMMANDS ON ONE LINE BY SEPARATING
THEM BY ;. ^COMMENTS MUST BE
PRECEDED BY ! EXCEPT FOR THE COMMENT
COMMAND WHICH CAN BE EITHER ! OR ; FOR COMPATABILITY.
^DISALLOW JUNK (UNUSED ARGUMENTS) AFTER ALL COMMANDS WITH
THE MESSAGE "%^^RNFJEC JUNK AT END OF COMMAND\\". ^THE ONLY COMMANDS
WHICH CANNOT HAVE ANOTHER COMMAND ON THE SAME
LINE ARE .^^TITLE, .SUBTITLE, \\AND .^^INDEX\\ FOR WHICH ALL
CHARACTERS MAY BE PART OF THE TEXT. ^^.SUBINDEX\\, HOWEVER,
CAN HAVE FOLLOWING MULTIPLE COMMANDS.
^IN COMMANDS WHICH TAKE TEXT STRINGS AS TEXT, "." AND "!" ARE
CONSIDERED PART OF THE TEXT. ^THESE COMMANDS CAN BE TERMINATED
ONLY BY ";" AND END OF LINE.
^IN ANY CASE, FOLLOWING THE SEMI-COLON, EITHER TEXT OR ANOTHER
COMMAND (STARTING WITH .) MAY BE GIVEN.
^THUS, FOR EXAMPLE, THE FOLLOWING CHANGES THE
LEFT MARGIN AND TAB STOPS IN ONE LINE:
.BREAK
^^.LEFT MARGIN 10 \\!COMMENT;^^.TAB STOPS 15,20,30 \\!COMMENT\\
^FOR CONVENIENCE, WHEN SEVERAL COMMANDS ARE BEING RUN TOGETHER
THEY CAN BE SEPARATED BY JUST A "." UNLESS THE FIRST COMMAND
HAS A COMMENT OR TAKES TEXT AS ITS ARGUMENT.
.PARAGRAPH
2.25 ^DETECT ILLEGAL NEGATIVE ARGUMENTS IN ALL APPROPRIATE
COMMANDS. ^THESE ARE .^^NUMBER, .LEFT MARGIN, .TESTPAGE, .SKIP,
_.BLANK, .TAB STOPS, .CENTER, .FOOTNOTE\\.
^ALSO, DETECT INDENTS AND PARAGRAPHS TOO FAR TO THE LEFT AS
ERRORS. ^IF A LEFT MARGIN CHANGES SUCH THAT THE PARAGRAPH INDENT
CAUSES A NEGATIVE POSITION, CHANGE THE INDENT TO FIT.
.PARAGRAPH
2.26 ^CENTERED LINES WILL NOW BE KEPT WITHIN THE PAGE SIZE.
^THUS, CENTERING CAN NOT BE USED TO EXCEED THE RIGHT MARGIN.
.PARAGRAPH
2.27 (^^SPR\\ 10-6912) ^FIX INDEXING OF ITEMS OF VARIOUS CASE
COMBINATIONS BUT THE SAME SPELLING TO WORK CORRECTLY.
^ITEMS WHICH ARE IDENTICAL EXCEPT FOR CASE OR UNDERLINING
WILL APPEAR TOGETHER BUT DISTINCTLY. ^UNDERLINED ITEMS COME
FIRST WITH UPPER CASE BEFORE LOWER CASE BEING LESS SIGNIFICANT.
^IN PARTICULAR, THE ORDER OF IDENTICALLY SPELLED
ENTRIES IS:
.LEFT MARGIN 10
.NOFILL
UNDERLINED CAPS
UNDERLINED LOWER CASE
CAPS
LOWER CASE
.LEFT MARGIN 5
.FILL
.PARAGRAPH
2.28 ^INCLUDE THE SUBPAGE LETTER IN ERROR MESSAGES. ^ALSO,
INCLUDE IT IN THE INDEX.
.PARAGRAPH
2.29 ^CORRECT .^^SUBPAGE\\ LOGIC TO ALLOW .^^PAGE\\ COMMANDS BETWEEN
^^_.SUBPAGE\\ AND ^^.END SUBPAGE\\.
.PARAGRAPH
2.30 ^ISSUE A WARNING MESSAGE IF THERE ARE MORE THAN
26 SUBPAGES. ^THE MESSAGE IS "^^%RNFSPO SUBPAGE OVERFLOW\\".
^IT IS ASSUMED THAT THIS IS AN ERROR AND NO ATTEMPT IS MADE TO CORRECT IT.
.PARAGRAPH
2.31 (^^SPR\\ 10-6710) ^PUT OUT SERIES OF PAGES IN THE INDEX WITH
A HYPHEN. ^THUS, IF THE INDEX INCLUDES REFERENCES
ON PAGE 4, 5, AND 6, THE ENTRY WILL BE 4-6.
.PARAGRAPH
2.32 ^ADD COMMAND .^^AUTOPARAGRAPH\\ AND SWITCH ^^/AUTOPARAGRAPH\\ WHICH CAUSES ANY BLANK LINE OR ANY LINE WHICH STARTS WITH
A SPACE TO BE CONSIDERED AS THE START OF A NEW PARAGRAPH.
^THIS ALLOWS NORMALLY TYPED TEXT TO BE JUSTIFIED WITHOUT ANY
SPECIAL COMMANDS.
^BLANK LINES ARE NOT CONSIDERED TO START A PARAGRAPH IF THEY
ARE FOLLOWED BY A COMMAND INSTEAD OF TEXT.
^THE SWITCH /^^NOAUTOPARAGRAPH\\ AND COMMAND .^^NOAUTOPARAGRAPH\\
HAVE THE OPPOSITE EFFECT, WHICH IS TO HAVE PARAGRAPHING
INVOKED ONLY BY COMMANDS.
^ALSO ADD COMMAND .^^AUTOTABLE\\ WHICH CAUSES EACH LINE
NOT STARTING WITH A BLANK TO BE INDENTED. ^THIS NORMALLY WOULD BE
USED WITH A PREVIOUS .^^PARAGRAPH\\ HAVING SET A NEGATIVE INDENT.
^THUS, INPUT WHICH WAS "BACK-DENTED"
WILL CONTINUE TO BE. ^THIS IS CANCELLED BY .^^NOAUTOTABLE\\.
^NEITHER MODE IS EFFECTIVE IN ^^.NOFILL\\ MODE.
.PARAGRAPH
2.33 ^ADD TWO NEW COMMANDS TO BRACKET A SERIES OF LINES WHICH
ARE TO BE TAKEN LITERALLY. ^IF N LINES ARE TO BE USED
AS A LITERAL (E.G., AN EXAMPLE), THEN THEY SHOULD BE
PRECEEDED BY ".^^LITERAL \\N" AND FOLLOWED BY
".^^END LITERAL\\". ^THIS REDUNDANCY GUARANTEES THAT
ANY LINES OF TEXT MAY BE INSERTED.
^NOTE THAT THE "END" IN "END LITERAL" CAN NOT BE
ABBREVIATED.
^IF THE "N" IS OMITTED FROM THE .^^LITERAL\\ COMMAND,
THEN THE LITERAL BLOCK IS TERMINATED BY A .^^END LITERAL\\
COMMAND AND THE REDUNDANCY OF THE COUNT IS LOST.
^FOR THIS PURPOSE, EACH LINE FEED, VERTICAL TAB, AND FORM FEED
ENDS ONE LINE. ^THIS IS SIMILAR TO .^^NOFILL\\ EXCEPT THAT
BLANK LINES, AND LINES STARTING WITH "." ARE
REPRODUCED AS IN THE INPUT FILE.
^IF TABS ARE ENCOUNTERED AND NO TAB STOPS ARE CURRENTLY
SET, E.G. IF THE .^^LITERAL\\ IS PRECEEDED BY A
^^.TAB STOPS\\ WITH NO ARGUMENTS, THEN THE TABS ARE
REPRODUCED LITERALLY IN THE FILE. ^OTHERWISE, THE
SPECIFIED TAB SETTINGS ARE USED (I.E., EACH TAB WILL BE
EXPANDED INTO THE APPROPRIATE NUMBER OF SPACES).
.PARAGRAPH
2.34 ^INITIALIZE THE CASE SETTING FOR THE FILE
TO /^^CASE:UPPER\\ OR /^^CASE:LOWER\\. ^THE DEFAULT IS
/^^CASE:UPPER\\. ^NOTE THAT LOWER CASE IS NEVER ALTERED, SO
THE DEFAULT MEANS TO LEAVE THE CASE AS TYPED.
^NOTE THAT THIS DEFAULT IS CHANGED FROM THAT OF
PREVIOUS VERSIONS OF ^^RUNOFF\\-10.
.PARAGRAPH
2.35 (^^SPR\\ 10-6102) ^ADD /^^HEADER\\:X AND .^^HEADER\\ X (WHERE X IS ^^UPPER, LOWER,
\\OR^^ MIXED\\) TO CONTROL THE CASE OF "PAGE" IN THE HEADERS. ^THE DEFAULT
IS ^^MIXED.\\
^THE COMMAND .^^NOHEADER\\ SUPPRESSES THE TITLE, SUBTITLE,
PAGE NUMBER, AND SPACING AT THE TOP OF EACH PAGE. ^THE
COMMAND .^^HEADER\\ RESTORES THE RUNNING HEAD.
^FILES WITH EXTENSION .^^RNH\\ DEFAULT TO THE MODE
^^.NOHEADER\\.
.PARAGRAPH
2.36 ^ADD A SECOND .^^HLP\\ FILE NAMED ^^RUNINP\\ WHICH SUMMARIZES
THE COMMANDS WHICH CAN APPEAR IN THE INPUT FILE.
.PARAGRAPH
2.37 ^IMPLEMENT OUTPUT WILDCARDING VIA THE NEW ROUTINE .^^SCWLD\\
IN ^^WILD\\ VERSION 5. ^THUS, FOR EACH WILD CARD CHARACTER ON THE
OUTPUT SIDE, THE VALUE MATCHING THE CORRESPONDING WILD CHARACTER
FROM THE INPUT SIDE IS SELECTED. "^CORRESPONDING" IS DEFINED
AS THE N-TH WILD CHARACTER IN THE CANONICAL FORMAT OF
FILE.EXT[DIRECTORY]. ^THUS, THE FOLLOWING EXAMPLES:
.SKIP 1
.TEST PAGE 5
.NOFILL
.TAB STOPS 5,15,27,44
INP SPEC INP FILE OUT SPEC OUT FILE
.SKIP 1
^^*.RNO FOO.RNO *.MEM FOO.MEM
FOO.RN? FOO.RND FOO?.LST FOOD.LST
*.RNO FOO.RNO XYZ.LST[5,6,*] XYZ.LST[5,6,FOO]\\
.SKIP 1
.FILL
^IN ADDITION, .^^SCWLD\\ IMPLEMENTS THE STANDARD DIRECTORY DEFAULTS
(INCLUDING ^^SFD\\S) AND THE SWITCHES: /^^PROTECTION\\ (WHICH TAKES AN OCTAL
VALUE), ^^/PARITY, /DENSITY, \\AND^^ /PHYSICAL\\. ^THE DEFAULTS IN 2.19
APPLY.
.PARAGRAPH
2.38 ^ALLOW THE __ CONSTRUCTION TO WORK IN ALL CONTEXTS EXCEPT
LITERALS. ^THUS, __> , __; , AND __! CAN BE
USED TO PLANT > ; AND ! IN SUBINDEX LINES.
^THIS ALSO WORKS TO ALLOW ARBITRARY CONTROL CHARACTERS TO
BE PASSED THROUGH ^^RUNOFF\\. ^THESE CONTROL
CHARACTERS WILL BE ASSUMED TO BE NON-SPACING.
.PARAGRAPH
2.39 ^ADD COMMANDS .^^UPPER CASE\\ AND .^^LOWER CASE\\
WHICH HAVE THE SAME EFFECT AS _^_^ AND _\_\ RESPECTIVELY.
^THEY ARE STRONGER, HOWEVER, IN THAT THEY SET THE
DEFAULT CASE WHICH IS SET AT THE START OF CHAPTERS.
.PARAGRAPH
2.40 (^^SPR\\ 10-7442) ^ADD "."
AS THE ULTIMATE ABBREVIATION FOR .^^BREAK\\. ^IN PARTICULAR,
".#;TEXT" IS A NEW LINE.
.PARAGRAPH
2.41 ^ADD NEW COMMANDS .^^PAGING\\ AND .^^NOPAGING\\
WHICH CONTROL WHETHER ^^RUNOFF\\ FORMS PAGES OR NOT. ^THE
DEFAULT FOR ^^.RNH\\ FILES IS .^^NOPAGING\\ BECAUSE ^^.HLP\\
FILES NORMALLY DON'T HAVE PAGE BREAKS. ^ALSO, FOR .^^RNH\\
SET THE DEFAULT RIGHT MARGIN AT 72 INSTEAD OF THE NORMAL 60.
.PARAGRAPH
2.42 ^ADD A COMMAND, .^^COMMENT\\ WHICH TREATS THE REST OF
THE LINE AS A COMMENT.
.PARAGRAPH
2.43 ^ADD AN OPTIONAL SECOND ARGUMENT TO .^^PARAGRAPH\\ WHICH
SPECIFIES THE VERTICAL PARAGRAPH SPACING. ^LEGAL VALUES ARE
1-5 AND -1 (WHICH IS THE DEFAULT OF <SPACING+1>/2).
^ALSO ADD AN OPTIONAL THIRD ARGUMENT TO .^^PARAGRAPH\\
WHICH SPECIFIES THAT AN AUTOMATIC .^^TEST PAGE\\ BE
PERFORMED BEFORE STARTING THE PARAGRAPH.
^THIS ARGUMENT IS MULTIPLIED BY THE SPACING AND USED
AFTER THE INTER-PARAGRAPH SPACING. ^THE INITIAL
VALUE OF THIS IS 2, SO THAT PARAGRAPHS WILL NOT NORMALLY
HAVE LESS THAN TWO LINES AT THE BOTTOM OF A PAGE. ^IF THIS
FEATURE IS NOT DESIRED, AN ARGUMENT OF 0 SHOULD BE GIVEN.
^THIS WILL RESULT IN NO SPECIAL TEST.
.PARAGRAPH
2.44 ^ADD SWITCH /^^SEQUENCE\\ TO SPECIFY
THAT THE CLOSEST INPUT FILE LINE AND PAGE NUMBER SHOULD BE LISTED
ON THE OUTPUT FILE IN COLUMNS 1-16 (THE REGULAR LISTING IS
SHIFTED RIGHT 16 POSITIONS).
.PARAGRAPH
2.45 (^^SPR\\ 10-7442) ^ALLOW THE .^^TITLE\\ AND .^^SUBTITLE\\
COMMANDS TO APPEAR AFTER THE .^^PAGE\\ TO WHICH THEY APPLY.
^ADD A .^^FIRST TITLE\\ COMMAND WHICH CAUSES THE TITLING
TO APPEAR ON THE FIRST PAGE AS WELL. ^THESE COMMANDS MUST BE
THE FIRST COMMAND ON THE NEW PAGE (I.E., BEFORE ANY TEXT).
.PARAGRAPH
2.46 ^ADD .^^NO\\ XXX COMMANDS FOR EACH .^^NO\\XXX COMMAND.
.PARAGRAPH
2.47 (^^SPR\\ 10-7442) ^ADD AN INPUT SELECTION
MECHANISM TO ALLOW DOCUMENTATION TO BE IMBEDDED IN SOURCE FILES.
^THE COMMANDS .^^SELECT\\ (4 CHARS) AND .^^NO SELECT\\ CONTROL THIS
MODE OF OPERATION. ^THE SWITCHES ^^/SELECT\\:"(4 CHARS)"
AND /^^NOSELECT\\ SET THE INITIAL BEHAVIOUR. ^IF THE INPUT
FILE'S EXTENSION IS A KNOWN SOURCE FILE (.^^ALG, .BAS, .BLI,
_.B10, .B11, .FAI, .FOR, .F40, .MAC, .N, .PAL, \\OR .^P11), THEN THE DEFAULT
OUTPUT EXTENSION IS .^^PLM\\ (^PROGRAM ^LOGIC ^MANUAL)
AND A DEFAULT SELECTION IS CHOSEN TO MATCH THE LANGUAGE'S
COMMENTING CONVENTIONS.
^THE ^^SELECT\\ SWITCH AND COMMAND TAKE A FOUR CHARACTER
ARGUMENT STRING WHICH ARE THE COMMENT CHARACTER FOR THE
LANGUAGE, THE SELECT CHARACTER, THE START BLOCK CHARACTER,
AND THE END BLOCK CHARACTER. ^WHEN ^^RUNOFF\\ IS IN
^^SELECTION\\ MODE, IT IGNORES ALL INPUT (DISCARDS IT
COMPLETELY) UNLESS IT MEETS ONE OF THE FOLLOWING
TWO PATTERNS. ^THE FIRST IS A LINE WITH THE SEQUENCE
COMMENT-SELECTION (TYPICALLY ";_&" OR "!_&"), THEN THE
REST OF THE LINE IS TAKEN AS INPUT (TO LINE FEED). ^THE
OTHER PATTERN IS FOR A BLOCK OF DOCUMENTATION AS FOLLOWS:
IT CONSISTS OF ALL DATA FROM THE FIRST COMMENT CHARACTER ON EACH
LINE THROUGH END OF LINE AS LONG AS THESE COMMENT LINES ARE
WITHIN A SEQUENCE OF COMMENT-START CHARACTER (TYPICALLY
";+" OR "!+") LINE AND A COMMENT-END CHARACTER
(TYPICALLY ";-" OR "!-"). ^THUS, FOR EXAMPLE, THE DEFAULT
STRING FOR MOST COMPILERS IS "!_&+-" AND FOR
MOST ASSEMBLERS IS ";_&+-".
^IN ORDER TO DECLARE ";" OR "!", THEY MUST BE QUOTED.
^IF THEY ARE NOT, THEN THEY WOULD BE TAKEN AS COMMAND
TERMINATORS (SEE 2.24).
^ANY ASSEMBLER FILE CAN CONTAIN ITS DOCUMENTATION
AS FOLLOWS:
.LEFT MARGIN 10
.TAB STOPS 5,15,20,30
.NOFILL
;THIS IS A NORMAL COMMENT
;_&THIS IS ^^RUNOFF\\ INPUT
;
OP ARG ;+THIS STARTS A BLOCK
OP ARG ;THIS CONTINUES IT
OP ARG
OP ARG ;MORE
OP ARG ;-THIS ENDS THE BLOCK
.LEFT MARGIN 5
.FILL
WHICH, WHEN PROCESSED, WOULD RESULT IN THE FOLLOWING OUTPUT FROM ^^RUNOFF\\:
.LEFT MARGIN 10
THIS IS ^^RUNOFF\\ INPUT
THIS STARTS A BLOCK
THIS CONTINUES IT
MORE
THIS ENDS THE BLOCK
.LEFT MARGIN 5
.PARAGRAPH
2.48 ^SUPPRESS TRAILING SPACES ON A LINE BEING CENTERED.
^IN CENTERED LINES, TREAT TABS AS SPACES. ^THESE CHANGES
ALLOW CARD INPUT TO WORK. ^IF THE TRAILING SPACES ARE REALLY
NEEDED, THEY CAN BE QUOTED. ^ADD COMMANDS .^^LEFT\\ AND .^^RIGHT\\
WHICH LEFT AND RIGHT ADJUST A LINE. ^THEY HAVE AN OPTIONAL
ARGUMENT WHICH SPECIFIES HOW MANY COLUMNS IN FROM THE MARGIN THEY
ARE TO BE POSITIONED.
.PARAGRAPH
2.49 ^CONVERT ALL MESSAGES TO AGREE WITH THE NEW ERROR
MESSAGE STANDARD. ^THUS, THE ? OR % ARE FOLLOWED
BY "^^RNF\\" AND A THREE LETTER MESSAGE CODE. ^THESE CODES
INCLUDE:
.SKIP 1
.TAB STOPS 5,10
.NOFILL
^^CJL\\ ^CAN'T ^JUSTIFY ^LINE
^^ELD\\ ^END ^LITERAL ^DOESN'T FOLLOW LITERAL
^^FIF\\ ^FOOTNOTE ^INSIDE ^FOOTNOTE
^^IBO\\ ^INPUT ^BUFFER ^OVERFLOW
^^ICC\\ ^INSUFFICIENT ^CORE FOR ^COMMAND
^^IIF\\ ^IGNORED IN ^INPUT ^FILE
^^ILC\\ ^I^LLEGAL ^COMMAND
^^JEC\\ ^JUNK AT ^END OF ^COMMAND
^^KCF\\ ^K ^CORE - ^FOOTNOTE
^^KCI\\ ^K ^CORE - ^INDEX
^^LDE\\ ^LITERAL ^DOESN'T ^END WITH END LITERAL
^^NEC\\ ^NOT ^ENOUGH ^CORE
^^NFS\\ ^NO ^FILE ^SPECIFIED
^^NIA\\ ^NEGATIVE ^INDENT ^ATTEMPTED
^^NID\\ ^NO ^INPUT ^DEVICE
^^ODE\\ ^OUTPUT ^ERROR
^^SPO\\ ^SUB^PAGE ^OVERFLOW
.FILL
.SKIP 1
^INTERNALLY, ALL ERROR MESSAGES HAVE A LABEL OF THE
FORM "^E$$" FOLLOWED BY THE THREE LETTER CODE SO THEY CAN
BE IDENTIFIED EASILY.
^SEE THE END OF THIS DOCUMENT FOR A LISTING OF ALL ERROR MESSAGES
AND THEIR MEANING.
.PARAGRAPH
2.50 ^CLEAN UP THE LOGIC IN COMMAND SCANNING TO ALLOW
MULTIPLE TABS AND SPACES BETWEEN ARGUMENTS. ^CONSECUTIVE
NUMERIC ARGUMENTS CAN BE SEPARATED BY
SPACES OR ONE COMMA. ^IF COMMA, THEN ANY NUMBER OF SPACES
OR TABS CAN BE ON EITHER SIDE OF IT. ^IN MULTIPLE
ARGUMENT COMMANDS (^^.TAB STOPS\\ AND ^^.PARAGRAPH\\)
ALLOW NULL VALUES BY CONSECUTIVE COMMAS; NULL ARGUMENTS
CAUSE THE PREVIOUS VALUE TO BE LEFT UNCHANGED.
.PARAGRAPH
2.51 ^ALLOW RELATIVE SPECIFICATIONS ON THE COMMANDS:
^^.CENTER, .NUMBER, .LEFT MARGIN, .RIGHT MARGIN, \\AND
^^.PAGE SIZE\\. ^WHEN THE ARGUMENT IS PRECEDED
BY A + OR -, THE ARGUMENT IS TAKEN AS RELATIVE. ^FOR .^^NUMBER,
_.LEFT MARGIN, .RIGHT MARGIN, \\AND ^^.PAGE SIZE\\, THIS
RAISES OR LOWERS THE PREVIOUS SETTING BY THE SPECIFIED
AMOUNT. ^FOR .^^CENTER\\, IT SPECIFIES THE NUMBER OF
HALF SPACES FROM THE CENTER TO CENTER ON (I.E.,
IF THE PAGE WIDTH IS 60, A .^^CENTER +6\\ WILL CENTER ON
33).
.PARAGRAPH
2.52 ^ALLOW A NEGATIVE ARGUMENT ON THE .^^BLANK\\ AND
^^.SKIP\\ COMMANDS. ^THIS SPECIFIES TO MOVE TO
N LINES FROM THE BOTTOM OF THE PAGE. ^THUS, A FINAL FOOTNOTE
COULD BE SET BY A COMMAND SUCH AS ".^^SKIP\\ -5".
.PARAGRAPH
2.53 ^ON A LINE WITH TABS, CONSIDER ANY SPACES PRECEEDING
THE TABS ON THE LINE AS QUOTED, SO THAT THEY WILL NOT
BE EXPANDED DURING JUSTIFICATION.
.PARAGRAPH
2.54 ^ADD SWITCH /^^UNDERLINE:SEPARATE\\ WHICH DEFINES A NEW MODE
OF UNDERLINING AS FOLLOWS: ANY LINE WHICH INCLUDES
UNDERLINED TEXT WILL BE FOLLOWED BY AN EXTRA LINE WHICH
HAS THE UNDERLINE CHARACTER (DEFAULT -) IN IT. ^THUS, FOR
OLDER ^^TTY\\S AND THE ^^LP10C\\ AND ^^LP10D\\, THE
UNDERLINE FACILITY IS STILL AVAILABLE.
.PARAGRAPH
2.55 ^WHEN PRINTING THE INDEX, USE THE SAME SPACING WHICH
WAS IN EFFECT AT THE TIME OF THE .^^PRINT INDEX\\
COMMAND.
.PARAGRAPH
2.56 ^WHEN ENTERRING TEXT INTO THE INDEX, DEFAULT THE
CASING TO BE CAPITAL FIRST LETTER, LOWERCASE
SUCCEEDING LETTERS, AND NO UNDERLINING. ^PRESERVE
CASE LOCK AND UNDERLINE LOCK ACROSS THE
_.^^SUB/INDEX\\ COMMAND.
.PARAGRAPH
2.57 ^PRESET TAB STOPS TO THE STANDARD -10 HARDWARE
SETTINGS OF 9,17,25,...
.PARAGRAPH
2.58 ^ADD A DEFER OPTION TO THE FIGURE COMMAND.
^IF THE USER SPECIFIES .^^FIGURE DEFERRED\\ N, THEN
IF THE FIGURE DOES NOT FIT, DEFER IT TO THE NEXT PAGE, BUT
CONTINUE FILLING TEXT ON THIS PAGE. ^IF MORE THAN ONE SUCH
ARE SEEN, THE RESULT IS CUMMULATIVE (I.E., ENOUGH SPACE
IS RESERVED FOR ALL THE DEFERRED
FIGURES).
.PARAGRAPH
2.59 ^ADD THE ABILITY TO CONTROL THE SELECTION OF
AND THE MEANING OF THE SPECIAL FLAG CHARACTERS WHICH CAN BE
IMBEDDED IN THE TEXT. ^THE COMMAND ".^^NOFLAGS\\"
OR ".^^NOFLAGS ALL\\" WILL SUPPRESS THE RECOGNITION OF ALL
NON-COLUMN ONE FLAG CHARACTERS (I.E., ALL BUT . AND !).
^THE COMMAND ".^^FLAGS\\" OR ".^^FLAGS ALL\\" WILL RESTORE
THE PREVIOUSLY ACTIVE FLAG CHARACTERS.
^THE COMMAND ".^^NOFLAG \\X" WILL SUPPRESS THE ACTION
OF THE X FLAG CHARACTER. ^THE COMMAND ".^^FLAG\\ X"
WILL RESTORE THE ACTION OF THE X FLAG CHARACTER. ^THE
COMMAND ".^^FLAG\\ X C" WILL SET C AS THE X FLAG
CHARACTER AND ENABLE THAT FLAG.
^TO SPECIFY ";" OR "!", IT MUST
BE QUOTED. ^OTHERWISE, IT WOULD BE TAKEN AS A
COMMAND TERMINATOR (SEE 2.24).
^THE VARIOUS VALUES OF X ARE:
.SKIP 1
.NOFILL
.TAB STOPS 5,15
^^CONTROL\\ COL. 1 COMMAND FLAG (.)
^^ENDFOOTNOTE\\ COL. 1 END OF FOOTNOTE (!)
^^LOWERCASE\\ LOWER CASE AND UNLOCK (_\)
^^QUOTE\\ QUOTING CHARACTER (__)
^^SPACE\\ QUOTED SPACE (_#)
^^SUBINDEX\\ SEPARATOR IN SUBINDEX COMMAND (>)
^^UNDERLINE\\ UNDERLINING (_&)
^^UPPERCASE\\ UPPER CASE AND LOCK (_^)
.SKIP 1
.FILL
^ALL FURTHER SPECIAL FLAGGING CHARACTERS WILL BE
DEFINED WITH NEW WORDS AND WILL BE INITIALLY
TURNED OFF FOR COMPATIBILITY.
^IT IS RECOMMENDED TO STAY WITH THE STANDARD CHARACTERS
IF POSSIBLE BECAUSE IT WILL AVOID LATER
EDITTING CONFUSION.
.PARAGRAPH
2.60 ^ADD A NEW FLAG CHARACTER, ^^INDEX\\, WHICH
DEFAULTS TO ">". ^WHEN THIS IS ENABLED AND IT IS SEEN
IN THE REGULAR TEXT (NOT TITLES, .^^INDEX\\ COMMANDS, ETC.)
INCLUDING IN FOOTNOTES, THE FOLLOWING WORD WILL BE ENTERRED
INTO THE INDEX AT THIS POINT. ^THE INDEX ENTRY ENDS WITH
THE FIRST SPACE, NEW LINE, OR SECOND OCCURANCE OF THE
INDEX FLAG CHARACTER. ^NOTE THAT THIS
FLAG MUST IMMEDIATELY PRECEED THE WORD (EXCEPT FOR OTHER
FLAG CHARACTERS) AND NOT BE SET OFF BY SPACES. ^THUS, FOR
EXAMPLE,
.INDENT 5
FOR >EXAMPLE THIS >PAR-3-^FOO BAR
.BREAK
WOULD RESULT IN INDEX ENTRIES FOR "^EXAMPLE" AND FOR
"^PAR-3-^FOO". ^NOTE THAT THE DEFAULT CASE RULES FOR
INDEX ENTRIES APPLIES.
.PARAGRAPH
2.61 ^ADD A NEW FLAG CHARACTER, ^^CAPITALIZE\\, WHICH
IS NORMALLY NOT ENABLED BUT DEFAULTS TO "<", WHICH
WORKS JUST LIKE THE INDEX FLAG EXCEPT THAT THE NEXT WORD
IS FULLY CAPITALIZED. ^IT IS JUST LIKE "_^_^" EXCEPT THAT
THE ORIGINAL CASE LOCK IS RESTORED AT THE END OF THE WORD OR THE
NEXT OCCURANCE OF THE CAPITAL FLAG.
^IT CAN BE USED IN COMBINATION WITH THE INDEXING FLAG TO
ENTER A FULLY CAPITALIZED WORD INTO THE INDEX.
.PARAGRAPH
2.62 ^ADD CONVENIENCE COMMANDS WHICH PERFORM A SET
OF FUNCTIONS WHICH RECUR FREQUENTLY. ".^^LIST\\ N" WILL START
A TEXT INDENT WITH N SPACING WHICH MOVES THE LEFT MARGIN 9 SPACES TO THE RIGHT FOR THE FIRST
_.^^LIST\\ COMMAND, AND 4 MORE SPACES TO THE RIGHT FOR EACH
SUBSEQUENT NESTED .^^LIST\\ COMMAND. ^THE NORMAL FILL AND JUSTIFY
MODES REMAIN IN EFFECT.
^^.LS\\ IS AN ACCEPTABLE ABBREVIATION FOR .^^LIST\\.
.BREAK
^^.LIST ELEMENT\\ COMMAND WILL START AN ITEM
IN THE LIST SPECIFIED BY THE CURRENT ^^.LIST\\ COMMAND.
^THE ELEMENTS ARE NUMBERED SEQUENTIALLY AND THE NUMBER
GIVEN A NEGATIVE INDENT SO THE LIST TEXT LINES UP. ^THE NUMBER
IS FOLLOWED BY "._#_#", SO TYPICALLY THE INDENT WILL BE -4.
^THE LIST ELEMENTS ARE SEPARATED BY THE STANDARD PARAGRAPH
SPACING AND TEST PAGE.
.BREAK
".^^NOTE\\ TEXT" WILL START A NOTE WHICH IS INDENTED.
^THIS COMMAND BLANKS 2, THEN REDUCES BOTH MARGINS
BY 15, THEN CENTERS THE TEXT ON THIS COMMAND (IF NONE, IT CENTERS
"^^NOTE\\"), AND THEN BLANKS 1. ^IT ALSO SETS UP SO THAT THE
MATCHING .^^END NOTE\\ WILL DO A BLANK 2.
.BREAK
".^^END\\" OR ".^^END NOTE\\" OR "^^.END LIST\\" ("^^EN"\\ AND "^^ELS\\" ARE ACCEPTABLE ABBREVIATIONS) HAVE THE EFFECT OF REVERTING
THE MARGINS AND SPACING MODES TO THEIR
SETTINGS BEFORE THE LAST ^^.LS\\ OR .^^NOTE\\
COMMAND. ^THESE CAN BE NESTED UP TO 5 DEEP. ^THREE NEW
MESSAGES ARE INTRODUCED BY THIS CHANGE:
.SKIP 1
.TAB STOPS 5,10
^^TFE\\ ^TOO ^FEW ^END COMMANDS
.BREAK
^^TNN\\ ^TOO MANY ^NESTED ^NOTES
.BREAK
^^UME\\ ^UN^MATCHED ^END COMMAND
.TAB STOPS 5
.PARAGRAPH
2.63 ^INTRODUCE THE CONVENIENCE SETUP COMMAND "^^.STANDARD\\ N".
^THIS CAN BE ABBREVIATED "^^.SD\\ N".
^THIS SETS SINGLE SPACING, FILL, JUSTIFY, RESETS MARGINS,
AND SETS THE PAPER SIZE TO A WIDTH OF N. ^THIS COMMAND ALSO
SETS THE PARAGRAPH INDENT TO 0. _#N IS NORMALLY
60 (THE INITIAL SETTING) OR 70 (IN WHICH
CASE THE PAGE LENGTH IS CHANGED TO 64 LINES). ^THESE ARE
THE TWO STANDARD ^^DEC\\ PAGE FORMATS FOR MEMOS AND FOR
MANUALS.
.PARAGRAPH
2.64 ^INTRODUCE THE SWITCHES /^^DOWN:\\N AND /^^RIGHT:\\N. ^THE
^^DOWN:\\N SWITCH MOVES THE TEXT OF EACH OUTPUT PAGE DOWN N LINES
ON THE PAGE. ^THE /^^RIGHT:\\N SWITCH MOVES THE TEXT OF EACH
OUTPUT PAGE TO THE RIGHT N SPACES ON THE PAGE.
.PARAGRAPH
2.65 ^CORRECT A BUG WHICH CAUSED A LINE WITH NO EMBEDDED
SPACES TO PROVOKE AN ERROR MESSAGE TO THE EFFECT THAT THE LINE COULD NOT
BE JUSTIFIED. ^^RUNOFF\\ NOW CHECKS ONLY THAT THE NUMBER OF
CHARACTERS IN THE LINE FIT WITHIN THE STATED MARGINS, WHETHER OR
NOT THERE ARE SPACES IN THE LINE.
.PARAGRAPH
2.66 ^ADD COMMANDS WHICH HANDLE AUTOMATIC CHAPTER
AND SECTION NUMBERING AND FORMATTING. ^THERE ARE TWO FORMS OF
DOCUMENTS, THOSE WHICH ARE CHAPTER NUMBERED, AND THOSE
WHICH ARE NOT. ^A DOCUMENT IS CONSIDERED TO BE A CHAPTER
ORIENTED DOCUMENT IF THERE IS A .^^CHAPTER\\ COMMAND IN IT.
^THE COMMAND ".^^CHAPTER\\ TEXT" STARTS A NEW CHAPTER WITH
TEXT AS ITS TITLE. ^THIS COMMAND ACTS AS
^^.BREAK.PAGE.BLANK 12.CENTER\\ OF THE LABEL "^^CHAPTER\\ N" (WHERE
N IS COUNTED AUTOMATICALLY BY 1),
^^.BLANK 2.CENTER\\ TEXT ^^.BLANK\\ 3. ^IT THEN RESETS THE
CASE, MARGINS, SPACING, AND THE JUSTIFY/FILL MODES.
^THIS COMMAND ALSO CLEARS OUT A SUBTITLE AND SETS THE
CHAPTER NAME AS THE TITLE.
^THE COMMAND ".^H^L N TEXT" AUTOMATICALLY STARTS
THE NEXT SECTION AT DEPTH N WHERE N IS IN THE RANGE 1-5.
^THE TEXT BECOMES THE HEADING FOR THIS SECTION. ^THE
SECTIONS ARE COUNTED AUTOMATICALLY AND THE NUMBER IS
OUTPUT IN THE FORM "I.J.K.L.M" WHERE TRAILING 0s ARE
DISCARDED (THE SAME FORMAT AS, FOR EXAMPLE, THE
MONITOR CALLS MANUAL). ^IF THIS IS A CHAPTER
NUMBERED DOCUMENT, THE I IS THE CHAPTER NUMBER, OTHERWISE
IT IS THE NUMBER OF THE .^H^L 1 LEVEL.
^THIS COMMAND ACTS AS ^^.BREAK.TEST PAGE 9.BLANK 3\\
FOLLOWED BY THE SECTION NUMBER THEN _#_# THEN THE SECTION
NAME (CAPITALIZED IF .^H^L1). ^IF THIS IS A .^H^L1 OR 2,
THEN A .^^BLANK 1\\ IS SIMULATED, OTHERWISE, A _#-_# IS
SIMULATED SO THAT THE FOLLOWING
CONTENTS WILL APPEAR ON THE SAME LINE. ^FINALLY, THE
CASE IS RESET AND JUSTIFY AND FILL ARE RESUMED.
^A .^H^L 1 ALSO SETS THE SUBTITLE TO THE NAME OF THE
SECTION. ^NOTE THAT THIS SUBTITLE WILL ONLY BE OUTPUT IF A
^^.SUBTITLE\\ COMMAND HAS APPEARRED TO ENABLE SUBTITLES.
^ALSO, ADD A COMMAND ".^^APPENDIX\\ TEXT" WHICH IS JUST LIKE
^^.CHAPTER\\ EXCEPT THAT IT STARTS AN APPENDIX. ^APPENDIX PAGES
ARE NUMBERED WITH THE APPENDIX LETTER FOLLOWED BY THE PAGE NUMBER.
^ALSO, ADD A COMMAND ".^^DO INDEX\\ TEXT" WHICH MERGES THE
ABOVE IDEA (TEXT IS THE INDEX TITLE) WITH THE .^^PRINT
INDEX\\. ^IN PARTICULAR, IN A CHAPTER NUMBERRED DOCUMENT, THIS
FORCES A NEW PAGE AND CENTERS TEXT. ^THE INDEX PAGES ARE NUMBERED
WITH "^^INDEX-"\\ FOLLOWED BY THE PAGE NUMBER. ^IF THIS COMMAND
APPEARS IN A NON-CHAPTER DOCUMENT, THEN IT IS IDENTICAL
TO .^^PRINT INDEX.\\
^BEWARE WHEN ENTERRING THE TEXT PORTIONS OF THESE COMMANDS THAT
A "." WILL TERMINATE THE COMMAND UNLESS IT IS QUOTED. ^THIS IS
NOT FELT TO BE A NORMAL PROBLEM SINCE SECTION AND CHAPTER HEADERS
DO NOT NORMALLY CONTAIN A DOT.
.PARAGRAPH
2.67 ^IF THE ^^.RIGHT MARGIN\\ COMMAND SETS
THE MARGIN TO THE RIGHT OF THE PAGE WIDTH, UP THE PAGE
WIDTH TO THIS NEW VALUE. ^THIS WILL AFFECT ONLY
^^.CENTER\\ COMMANDS FROM OLD FILES. ^THIS WILL
ENSURE THAT THE VARIOUS RIGHT SIDE PROTECTIVE TESTS
WORK CORRECTLY.
.PARAGRAPH
2.68 ^ADD THE ABILITY TO HAVE ALTERNATE VERSIONS OF
A DOCUMENT GENERATED FROM ONE FILE. ^TEXT WHICH IS TO
APPEAR IN ALL VERSIONS SHOULD BE ENTERED AS BEFORE. ^TEXT
AND COMMANDS WHICH ARE TO APPEAR IN ONLY ONE VARIANT SHOULD
BE BRACKETTED BY .^^IF\\ AND .^^ENDIF\\ COMMANDS. ^IN PARTICULAR
THE FOLLOWING COMMANDS ARE INTRODUCED:
.LEFT MARGIN 20
.TAB STOPS 5,20
.INDENT -10
^^.IF\\ VARIABLE START TEXT TO BE INCLUDED IF VARIABLE
IS TRUE
.INDENT -10
^^.IFNOT\\ VARIABLE START TEXT TO BE EXCLUDED IF VARIABLE
IS TRUE (I.E., INCLUDE IF THE VARIABLE IS FALSE)
.INDENT -10
^^.ELSE\\ VARIABLE START TEXT TO BE INCLUDED ONLY IF THE
PREVIOUS TEXT WAS EXCLUDED
.INDENT -10
^^.ENDIF\\ VARIABLE END OF CONDITIONAL TEXT
.INDENT -10
^^.VARIABLE\\ NAME,FLAGON,FLAGOFF####DECLARE
THE EXISTENCE OF A VARIABLE NAMED "NAME". ^FLAGON AND FLAGOFF
ARE SINGLE CHARACTERS TO BE USED TO INDICATE INCLUDED AND
EXCLUDED TEXT WHEN A DRAFT IS PRINTED
.LEFT MARGIN 5
^IF THE STANDARD VERSION OF OUTPUT IS REQUESTED BY
NOT SPECIFYING A ^^/VARIANT\\ SWITCH, ALL THE
VARIABLES ARE DECLARED TO BE FALSE. ^VARIABLES CAN
BE DECLARED TO BE TRUE BY LISTING THEM AS VALUES OF THE
^^/VARIANT\\ SWITCH (E.G., ^^/VARIANT:A\\ FOR JUST VARIANT
A; ^^/VARIANT:A/VARIANT:B \\OR ^^/VARIANT:(A,B)\\ FOR
VARIANTS ^A AND ^B TOGETHER).
^ALSO, ADD SWITCH ^^/DRAFT.\\ ^THIS SPECIFIES THAT ALL CONDITIONALS
ARE TO BE PROCESSED IN BOTH MODES SO THAT ALL VERSIONS
OF THE MANUAL CAN BE REVIEWED. ^IT IMPLICITLY
SETS ^^/SEQUENCE\\ UNLESS ^^/NOSEQUENCE\\ WAS SPECIFIED. ^IF
SEQUENCES ARE BEING OUTPUT, THEN THE FLAG CHARACTERS FROM THE
^^.VARIABLE\\ COMMAND ARE USED IN THE LEFT MARGIN TO INDICATE ALL
CONDITIONAL TEXT.
.PARAGRAPH
2.69 ^ADD OPTIONS TO THE ^^.NUMBER\\ COMMAND TO ALLOW THE
USER TO SPECIFY THE CURRENT NUMBER OF VARIOUS TYPES.
^IN PARTICULAR:
.TAB STOPS 29
.LEFT MARGIN 29
.INDENT -24
^^.NUMBER APPENDIX\\ N SETS THE APPENDIX
.INDENT -24
^^.NUMBER CHAPTER\\ N SETS THE CHAPTER NUMBER
.INDENT -24
^^.NUMBER LEVEL\\ A,B,C... SETS THE NUMBER OF THE NEXT ^^.HL\\ (SECTION) TO A.B.C...
.INDENT -24
^^.NUMBER\\ ^^LIST\\ D,A SETS THE LIST COUNTER AT DEPTH D TO VALUE A
.INDENT -24
^^.NUMBER INDEX\\ SETS THE CHAPTER TO "^^INDEX\\"
.INDENT -24
^^.NUMBER PAGE\\ N SETS THE PAGE NUMBER
.INDENT -24
^^.NUMBER SUBPAGE\\ N SETS THE SUBPAGE LETTER
.INDENT -24
^^.NUMBER\\ N STILL SETS THE PAGE NUMBER
.LEFT MARGIN 5
.TAB STOPS 5
^NOTE THAT THESE SET THE NUMBER FOR THE NEXT APPROPRIATE COMMAND.
^THUS, THEY ACTUALLY SET THE NUMBER TO ONE LESS THAN SPECIFIED.
^ADD ^^.NONUMBER\\ WHICH SUPPRESSES THE PAGE NUMBERS FROM THE
DOCUMENT. ^ANY ^^.NUMBER\\ COMMAND WILL RESTORE THEM.
.TAB STOPS 5
.PARAGRAPH
2.70 ^ADD COMMAND ^^.NOSUBTITLE.\\ ^ANY ^^.SUBTITLE\\
COMMAND WILL RESTORE THE SUBTITLE. ^THE ^^.NOSUBTITLE\\
COMMAND SUPPRESSES SUBTITLES AND IS PRIMARILY USEFUL TO
SUPPRESS THE AUTOMATIC SUBTITLES GENERATED BY THE ^^.HL\\ 1
COMMANDS. ^ALSO, CLEAN UP THE HEADER LOGIC SO THAT IF THERE
IS NO SUBTITLE, THE LINE IT WOULD APPEAR ON IS ELIMINATED.
^IF BOTH THE TITLE IS MISSING AND ^^.NONUMBER\\ HAS BEEN
SPECIFIED, THEN THE LINE CONTAINING THEM WILL ALSO BE OMITTED.
^ELIMINATE THE BLANK LINE BEFORE THE TITLE. ^THE EFFECT OF THESE
CHANGES IS TO MAKE MORE LINES FIT ON THE PAGE:
.LEFT MARGIN 10
.TAB STOPS 40
.NOFILL
IF TITLE _& SUBTITLE 1 MORE LINE
IF NO SUBTITLE 2 MORE LINES
IF NEITHER 3 MORE LINES
.FILL
.LEFT MARGIN 5
.TAB STOPS 5
^IF COMPATIBILITY WITH OLD DOCUMENTS IS DESIRED, START WITH A
^^.PAGE SIZE\\ N WHERE N IS 58-THE NUMBER OF NEW LINES SHOWN ABOVE.
^ADD A NEW SWITCH, ^^/LINES\\ WHICH SPECIFIES THE INITIAL
PAGE LENGTH. ^ALSO ADD A NEW SWITCH, ^^/WIDTH\\ WHICH SPECIFIES
THE INITIAL PAGE WIDTH.
.PARAGRAPH
2.71 ^ADD A NEW CAPABILITY, TO CREATE INPUT TO ^^TYPESET-10.\\
^THREE FORMATS OF TYPESETTING DEVICE ARE AVAILABLE, THE ^^TXT\\ DRIVEN
6-POINTS, THE ^^CAT\\, AND THE LINE PRINTER DRIVEN AT A 1:1 RATIO. ^THIS IS
INVOKED BY THE FOLLOWING SWITCHES:
.LEFT MARGIN 10
.TAB STOPS 25
.NOFILL
^^/TYPESET:CAT\\ COPY TO ^^CAT\\
^^/TYPESET:LPT\\ COPY TO ^^LPT:\\
^^/TYPESET:TXT\\ COPY TO ^^TXT\\
.LEFT MARGIN 5
.TAB STOPS 5
.FILL
^EXCEPT WHEN OUTPUTTING FOR THE ^^LPT,\\ ALL HORIZONTAL SPACING IS MULTIPLIED BY 36/PAGE WIDTH. ^CHARACTERS
WHICH ARE NOT NORMALLY AVAILABLE ARE TURNED INTO MACROS, SO THEY CAN BE
DEFINED IN THE ^^TXT6\\ SETUP TO PRODUCE THE CORRECT RESULTS.
^ALL ^^RUNOFF\\ FORMATTING IS SIMULATED. ^ALL PAGE CONTROLS ARE TURNED INTO
MACROS WHICH WILL BE IMPLEMENTED IN ^^TYPESET\\ AT SOME FUTURE TIME. ^THE
FOOTNOTES ARE ISSUED AT THE NEXT BREAK AND ARE SET OFF FROM THE MAIN-LINE
TEXT BY A ROW OF HYPHENS. ^THEY ARE ISSUED IN A REDUCED POINT SIZE.
^CHAPTER AND SECTION HEADERS ARE ISSUED AS MACROS TO ALLOW SPECIAL
FONTS TO BE USED. ^UNDERLINING IS CONVERTED TO ITALICS.
^ALSO ADD A COMMAND, ^^.TYPESET\\ WHICH ALLOWS DIRECT INPUT
TO ^^TYPESET\\-10. ^THIS COMMAND SUPPRESSES THE IMPLIED SPACE
AT END OF LINE SO IT CAN BE GIVEN IN THE MIDDLE OF A WORD.
^IT IS FILLED WITH A SERIES OF ONE OR MORE OF THE FOLLOWING
OBJECTS:
.LEFT MARGIN 29
.TAB STOPS 29
.INDENT -24
[T-10 COMMAND] ^^TYPESET\\-10 COMMAND
.INDENT -24
<COMMENT> COMMENT STRING
.INDENT -24
"STRING" ARBITRARY STRING (QUOTES GET STRIPPED;
QUOTE IS REPRESENTED AS A DOUBLE QUOTE)
.INDENT -24
/CHAR ^^TYPESET\\-10 COMMAND
.INDENT -24
+CHAR ^^PI\\ CHARACTER
.INDENT -24
^^SPACE\\ SPACE TO OUTPUT HERE
.INDENT -24
^^BOLD, ITALICS, SMALLCAP, SLANT\\ SWITCH TO THIS
FONT; IF FOLLOWED BY SOMETHING, REGULAR FACE
WILL BE RESTORED AT END OF THIS COMMAND; IF AT
END OF COMMAND, FACE STICKS UNTIL NEXT ^^.TYPESET\\
.INDENT -24
^^REGULAR\\ SWITCH TO REGULAR FACE
.LEFT MARGIN 5
.TAB STOPS 5
.PARAGRAPH
2.72 ^ADD THE USER ABILITY TO EXTRACT ONLY PORTIONS
OF THE OUTPUT. ^THIS CAN BE DONE BY SPECIFYING EITHER THE INPUT
OR OUTPUT RANGES TO BE INCLUDED. ^IF BOTH ARE SPECIFIED, THEN BOTH
CONSTRAINTS MUST BE SATISFIED SIMULTANEOUSLY. ^THE INPUT AND OUTPUT
RANGES CAN BE GIVEN AS SEVERAL RANGES, IN WHICH CASE, EACH OF THE
RANGES WILL BE PRODUCED (IN THE DOCUMENT ORDER). ^THE NEW SWITCHES
ARE ^^/IRANGE\\ TO SPECIFY THE INPUT RANGE AND ^^/ORANGE\\ TO
SPECIFY THE OUTPUT RANGE. ^EACH TAKES AS ARGUMENTS THE FOLLOWING:
.LEFT MARGIN 20
.TAB STOPS 20
.INDENT -10
"A/B:C/D" PAGE B LINE A THROUGH PAGE D LINE C
.INDENT -10
"/B:/D" PAGE B LINE 1 THROUGH PAGE D LAST LINE
.INDENT -10
"A/B" PAGE B LINE A THROUGH THE END
.INDENT -10
"/B" PAGE B LINE 1 THROUGH THE END OF THE FILE
.INDENT -10
":C/D" START THROUGH PAGE D LINE C
.INDENT -10
":/D" START THROUGH PAGE D LAST LINE
.INDENT -10
"A/B:C" PAGE B LINES A THROUGH C
.LEFT MARGIN 5
.TAB STOPS 5
^THE PAGE NUMBERS ("B" AND "D") CAN BE A SIMPLE DECIMAL NUMBER FOR
NON-CHAPTER DOCUMENTS OR A COMPOUND CHAPTER-PAGE NUMBER IF
CHAPTER DOCUMENT. ^COMPOUND NUMBERS ARE TWO DECIMAL
NUMBERS SEPARATED BY "-" IN WHICH THE FIRST NUMBER IS THE CHAPTER
NUMBER. ^THE CHAPTER NUMBER FIELD CAN ALSO BE A STRING
OF ALPHABETICS (USUALLY ONE) WHICH IS THE APPENDIX. ^THE CHAPTER
NUMBER FIELD CAN ALSO BE "INDEX" TO REPRESENT THE
INDEX. ^PAGE AND LINE NUMBERS CAN ALSO BE
"_^" TO MEAN TOP (1) OR "*" TO MEAN BOTTOM (INFINITY).
^IF MORE THAN ONE RANGE IS NEEDED, THEY CAN BE SEPARATED BY COMMAS
AND THE SET ENCLOSED IN PARENTHESES.
.PARAGRAPH
2.73 ^CLEAR ANY HANGING INDENT ON COMMANDS SUCH AS ^^.PARAGRAPH,\\
^^.PAGE,\\ AND ^^.HL.\\
.PARAGRAPH
2.74 ^DETECT ILLEGAL COMMANDS INSIDE A FOOTNOTE. ^MOSTLY, THESE ARE
ONES WHICH AFFECT THE PAGING BEHAVIOUR OF ^^RUNOFF.\\ ^HOWEVER, THERE IS
ONE RESTRICTION, THE TAB STOPS CAN NOT BE CHANGED INSIDE A FOOTNOTE.
.PARAGRAPH
2.75 (^^SPR\\ 10-13004) ^IF THERE IS A STRING OF THE FLAG CHARACTERS
WHICH CONTROL CASE (_^ AND _\), USE THE LAST ONE. ^ALSO, MAKE A SINGLE
_^ FORCE A LOWER CASE CHARACTER TO UPPER CASE.
.PARAGRAPH
2.76 ^WHEN UNDERLINING, INCLUDE THE UNDERLINE UNDER SPACES
WHICH ARE QUOTED BY "__".
.PARAGRAPH
2.77 ^SPEED UP OUTPUT SLIGHTLY BY REMOVING THE EXTRA
CARRIAGE RETURNS (LEAVE JUST LINE FEEDS) ON THE BLANK LINES
INTRODUCED BY ^^.SKIP\\ AND SIMILAR COMMANDS.
.PARAGRAPH
2.78 ^CLEAN UP THE PROCESSING OF ^^.NOFILL\\ WHEN THE INPUT
LINE IS LONGER THAN THE OUTPUT. ^ALSO CLEAN UP THE HANDLING
OF ^^.NOFILL .JUSTIFY\\ TO IN FACT WORK.
.PARAGRAPH
2.79 ^ADD A NEW CAPABILITY TO PRODUCE CHANGE BARS. ^THIS
IS ENABLED BY THE COMMAND ^^.ENABLE BAR\\ AND CAN BE DISABLED AGAIN
BY ^^.DISABLE BAR\\ IF NEEDED. ^THESE SHOULD PROBABLY ONLY BE
GIVEN AT PAGE BREAKS. ^WHENEVER CHANGE BARS ARE ENABLED, THE
LEFT EDGE OF THE PRINTED PAGE IS SHIFTED RIGHT THREE COLUMNS TO MAKE ROOM
FOR THE POTENTIAL CHANGE BAR. ^THE RANGE OF A CHANGE BAR
IS BRACKETTED BY ^^.BEGIN BAR\\ AND ^^.END BAR\\. ^THE
DEFAULT CHANGE BAR IS THE ^^ASCII\\ VERTICAL BAR (174).
^THIS CAN BE CHANGED BY THE SWITCH ^^/BAR:\\CH WHERE CH IS
EITHER OCTAL OR A SINGLE CHARACTER IN QUOTES. ^IF THE TERMINAL
DOES NOT SUPPORT 174, THE MOST COMMON ALTERNATE IS 134 (BACKSLASH)
WHICH CAN BE OBTAINED BY JUST SAYING ^^/BAR\\. ^IF CHANGE BARS
ARE TO BE SUPPRESSED, THE SWITCH ^^/BAR:0\\ OR ^^/NOBAR\\ WILL DO THIS.
.PARAGRAPH
2.80 ^ADD COMMAND ^^.NO#SPACE\\ WHICH IS EQUIVALENT TO
CONCATENATING TWO LINES TOGETHER WITHOUT THE SPACE WHICH
^^RUNOFF\\ NORMALLY ASSUMES FOR THE CARRIAGE-RETURN
LINE-FEED. ^THIS IS USEFUL WHEN A COMMAND MUST BE
INSERTED WHERE THERE IS NOT BLANK IN A LINE (E.G., AN
^^.IF\\ OR BAR COMMAND).
.PARAGRAPH
2.81 ^ADD SWITCHES ^^/NUMBER\\ TO ENABLE PAGE NUMBERRING
(DEFAULT), ^^/PAGING\\ TO ENABLE SPLITTING INTO PAGES (DEFAULT),
^^/PERIOD\\ TO INITIALIZE TO ^^.PERIOD\\
MODE (DEFAULT) AND COMPLEMENTARY SWITCHES ^^/NONUMBER,
/NOPAGING\\, AND ^^/NOPERIOD\\.
.PAGE
.PARAGRAPH
3.0 ^^KNOWN WARNINGS, BUGS, AND DEFICIENCIES\\
.PARAGRAPH
3.1 ^SINCE PREVIOUS VERSIONS OF ^^RUNOFF\\ DID LITTLE
ERROR CHECKING, THIS VERSION WILL FREQUENTLY DETECT
LATENT ERRORS IN OLD ^^RUNOFF\\ FILES. ^IN PARTICULAR,
FILES WHICH INDENTED TO THE LEFT OF THE LEFT MARGIN SUCH
THAT THE LEFT EDGE OF THE PAGE IS EXCEEDED WILL NOW
PRODUCE THE WARNING ^^RNFNIA\\.
.PARAGRAPH
3.2 ^SINCE PREVIOUS VERSIONS OF ^^RUNOFF\\ ALLOWED JUNK
TO FOLLOW THE VALID ARGUMENTS OF A COMMAND, THIS VERSION
WILL FREQUENTLY PRODUCE THE WARNING ^^RNFJEC\\.
.PARAGRAPH
3.3 ^SINCE THIS VERSION FITS MORE LINES TO A PAGE IF THERE
IS NO SUBTITLE THE PAGE BREAKS OCCUR AT DIFFERENT PLACES. ^IN
ADDITION, SINCE ^^.PARAGRAPH\\ NOW DOES AN IMPLIED
^^.TEST PAGE\\, PAGE BREAKS OCCUR AT DIFFERENT PLACES.
.PARAGRAPH
3.4 ^^WILD\\ DOES NOT FULLY SUPPORT THE NOTATION "+" AS
MEANING FILE CONCATENATION. ^AS A RESULT, THIS SHOULD NOT
BE USED WITH ^^RUNOFF\\ SINCE IT WILL PRODUCE UNDESIRED
RESULTS. ^SIMILARLY, COMMANDS OF THE
FORM:
.INDENT 3
^^*RS = R, S\\
.BREAK
WILL PLACE ^R ONTO ^R^S AND THEN ^S ONTO ^R^S, SUPERSEDING
THE ^R. ^THE COMMAND PROCESSOR IS
DESIGNED TO WORK BEST ON A STRING SUCH AS:
.INDENT 3
^^* = R, S\\
.BREAK
IN WHICH EACH INPUT FILE NAME WILL BE COPIED TO THE
OUTPUT FILE NAME IN TURN.
.PARAGRAPH
3.5 ^AVOID USING THE UNGUARANTEED ABBREVIATIONS TO GET
SHORT COMMANDS SINCE THEY MAY STOP WORKING IN FUTURE VERSIONS
AS ADDITIONAL COMMANDS ARE DEFINED. ^INSTEAD, ADOPT THE GUARANTEED
ONE-THREE LETTER ABBREVIATIONS. ^THUS,
FOR EXAMPLE, IT IS OK TO ABBREVIATE ^^AUTOPARAGRAPH\\ AS
^^AUTOPARAG\\ OR ^^PARAGRAPH\\ AS ^^PARAG\\ OR ^^TAB STOPS\\
AS ^^TAB STOP\\ SINCE THE ABBREVIATION
IS STILL LONG, BUT IT IS A POOR IDEA TO ABBREVIATE ^^JUSTIFY\\
AS ^^JU\\; BETTER WOULD BE TO USE THE GUARANTEED ABBREVIATION
OF ^^J\\.
.SKIP 4
.PARAGRAPH
4.0 ^^CHANGES IN INSTALLATION INSTRUCTIONS\\
.SKIP 1
^^RUNOFF\\ IS NOW ASSEMBLED WITH THE ^^UNIVERSAL\\ FILES
^^JOBDAT, C,\\ AND ^^SCNMAC\\ WHICH ARE ASSUMED
TO BE ON ^^UNV:\\. ^IT IS LOADED WITH ^^SCAN, HELPER,\\ AND
^^WILD\\, WHICH ARE ASSUMED TO BE ON ^^REL:\\.
^THE COMMAND IS SIMPLY:
.INDENT 5
^^.LOAD RUNOFF\\
.BREAK
AND THESE FILES ARE FETCHED AUTOMATICALLY BY ^^SEARCH\\
AND ^^.REQUEST\\ PSEUDO-OPS TO ^^MACRO\\.
^REPLACE ^^RUNOFF.SAV\\ WITH ^^RUNOFF.SHR\\ ON ^^SYS:\\.
^ADD THE FILES ^^RUNOFF.HLP\\ AND ^^RUNINP.HLP\\ TO ^^HLP:\\.
^OTHER RELATED FILES INCLUDE ^^RUNOFF\\ AND ^^RUNINP .RNH\\
FILES WHICH PRODUCE THESE ^^.HLP\\ FILES WHEN
PROCESSED THROUGH ^^RUNOFF\\ VERSION 10. ^SINCE THE
COMMANDS WHICH AUTOMATICALLY FORMAT THE OUTPUT ARE BASED
PRIMARILY ON THE ^^DEC\\ DOCUMENTATION FORMAT CONVENTIONS,
THEY ARE INCLUDED HERE IN A FILE NAMED ^^RNFDOC.RNS\\ WHICH IS
A PRELIMINARY, AND INCOMPLETE DRAFT.
.SKIP 2
^^INCOMPATIBILITIES WITH PREVIOUS VERSIONS\\:
.BREAK
1. ^DEFAULT CASE IS ^^UPPER\\, USED TO BE ^^LOWER\\. ^CAN USE
^^/CASE:LOWER\\ FOR COMPATIBILITY.
.BREAK
2. ^DEFAULT SPACING IS 1, USED TO BE 2. ^CAN USE ^^/SPACING:2\\
FOR COMPATIBILITY.
.BREAK
3. ^NUMBER OF LINES PER PAGE IS CHANGED (SEE SECTION 2.70) FOR
DETAILS.
.BREAK
4. ^CONTROL CHARACTERS ARE DISCARDED, USED TO BE ACCEPTED. ^CAN
USE ^^/CONTROL\\ FOR COMPATIBILITY.
.BREAK
5. ^DEFAULT UNDERLINE CHARACTER IS CHANGED. ^CAN
USE ^^/UNDERLINE:\\CH FOR COMPATIBILITY.
.BREAK
6. ^THE WORD "^^PAGE\\" IS NO LONGER IN UPPER CASE. ^CAN USE
^^/HEADER:UPPER\\ FOR COMPATIBILITY.
.BREAK
7. ^DOUBLE SPACE IS INSERTED AFTER MORE THAN JUST ".". ^NO SPECIFIC
COMPATIBILITY SWITCH.
.SKIP 1
^ALL THE ABOVE SWITCHES CAN BE PLACED IN ^^SWITCH.INI\\,
AS CAN ALL OTHER SWITCHES.
.SKIP 4
.PARAGRAPH
5.0 ^^INTERNAL CHANGES\\
.PARAGRAPH
5.1 ^CHANGE TO USE ^^TWOSEG\\ MACRO.
.PARAGRAPH
5.2 ^RUN THROUGH ^^PGMFMT\\ TO TIDY UP THE LISTING.
^CHANGE THE NAMES OF THE CHARACTERS AND FLAGS FOR
CONSISTENCY. ^MOVE SOME OF THE FLAGS TO CORE TO KEEP THE
FLAG ^^AC\\ FOR HI-SPEED ONES. ^ELIMINATE UNNECESSARY FLAGS.
^REARRANGE MOST SUBROUTINES TO BRING THE LISTING INTO
A RATIONAL ORDER. ^ADD A ^^REVISION HISTORY\\ SECTION TO TRACK
ALL CHANGES. ^CLEAN UP THE LISTINGS TO PRODUCE A CLEAN
PROGRAM LOGIC MANUAL USING THE .^^SELECTION\\ FEATURE.
^STANDARDIZE THE NAMES OF COMMAND SUBROUTINES.
.PARAGRAPH
5.3 ^FIX ERROR MESSAGES TO PRINT THE FIRST 30 CHARACTERS OF
THE COMMAND IN ERROR BY SAVING THE COMMAND IN A SPECIAL
BUFFER.
.PARAGRAPH
5.4 ^COPY .^^RBVER\\ FROM THE INPUT FILE TO THE OUTPUT FILE.
.PARAGRAPH
5.5 ^ESTIMATE THE SIZE OF THE OUTPUT FILE (.^^RBEST\\) AS THE
SAME AS THE INPUT FILE.
.PARAGRAPH
5.6 ^CHANGE THE INTERNAL END-OF-FILE CODE TO -1 TO
SIMPLIFY THE TESTS ON IT. ^ADD A MACRO SO THE ^^JUMPL\\S
APPEAR IN THE ^^CREF\\.
.PARAGRAPH
5.7 ^ADD FLAG ^^LCHPVT\\ ON THE CHARACTER ^A^C TO
KEEP QUOTED CHARACTERS FROM MATCHING ANY OF THE LOGIC. ^ADD
THE INTERNAL CODE ^^C.QUTI\\ TO STORE THE QUOTE IN INTERNAL
STRINGS.
.PARAGRAPH
5.8 ^ADD DEFENSIVE CODE TO ALL BUFFERS TO PREVENT
OVERFLOW WITH THE RESULTING ERROR MESSAGE "?^^ INPUT BUFFER OVERFLOW\\".
.SKIP 4
.PARAGRAPH
6.0 ^^SUGGESTIONS\\
.PARAGRAPH
^THERE ARE MANY SUGGESTIONS INCLUDING SEVERAL ^^SPR\\S WHICH HAVE
INCLUDED CODE IN THE FORM OF ^^SOUP .COR\\ FILES.
^NOT ALL OF THESE HAVE YET BEEN IMPLEMENTED.
^SOME OF THESE SUGGESTIONS ARE LISTED HERE:
.PARAGRAPH
6.1 (^^SPR\\ 10-6215) ^ALLOW THE USER TO SPECIFY
MULTIPLE COPIES OF THE OUTPUT (/^^COPIES\\:N).
.PARAGRAPH
6.2 (^^SPR\\ 10-6215) ^TURN ^^RUNOFF\\ INTO AN ^^MTST\\
SIMULATOR BY ADDING A COMMAND ^^.INSERT\\ WHICH PROMPTS
THE USER WITH THE REST OF THIS COMMAND AND THEN TAKES
INPUT FROM THE TERMINAL. ^THE INSERT TEXT SHOULD PROBABLY
CONTINUE UNTIL _^^Z IS INPUT. ^PERHAPS THERE SHOULD BE AN
OPTION TO INPUT JUST ONE LINE.
^THERE SHOULD BE AN OPTION TO EXCLUDE COMMANDS FOR INPUT.
.PARAGRAPH
6.3 ^ADD A COMMAND ^^.OUTLINE\\ WHICH CAUSES THE
SECTION NUMBERING LOGIC TO BUILD AN OUTLINE INSTEAD OF
NUMBERED SECTIONS.
.PARAGRAPH
6.4 ^IMPLEMENT HYPHENATION AS AN OPTION. ^ALSO RECOGNIZE
"-" AS A LEGITIMATE BREAK WITHIN A WORD. ^ADD A FLAG CHARACTER
WHICH ALLOWS A LINE BREAK BUT DOES NOT APPEAR IN THE OUTPUT
TEXT.
.PARAGRAPH
6.5 (^^SPR\\ 10-4522) ^AUTOMATICALLY GENERATE A TABLE
OF CONTENTS AND ALLOW CROSS-PAGE AND CROSS-SECTION REFERENCES
SYMBOLICALLY.
.PARAGRAPH
6.6 ^ADD A ^^KWIC\\ FACILITY TO AUTOMATICALLY INCLUDE
SPECIFIC OR MOST WORDS IN THE INDEX.
.PARAGRAPH
6.7 ^ADD A MODE TO AUTOMATICALLY CAPITALIZE THE
FIRST WORD OF EACH SENTENCE.
.PARAGRAPH
6.8 ^OPTIONS SHOULD BE ADDED TO TAKE ADVANTAGE OF SPECIAL
TERMINALS (SUCH AS RED/BLACK SHIFT) AND TO GENERATE
BOLD-FACE BY OVERPRINTING.
.PARAGRAPH
6.9 ^ADD AN OPTION TO LIST COMMANDS (ON RIGHT?) TO AID
IN REVIEWING DRAFTS. ^PERHAPS TEACH ^^RUNOFF\\ TO EAT ITS
OWN OUTPUT.
^ALSO, ERROR MESSAGES SHOULD BE INCLUDED IN THE OUTPUT.
.PARAGRAPH
6.10 ^ADD A PICTURE BUILDING OPTION FOR THINGS
LIKE THE ^^FOROTS \\DESIGN SPEC, THE ^^LOKUUO\\ SPECIFICATION,
AND ^^FILSER.FLO\\.
.PARAGRAPH
6.11 (^^SPR\\ 10-4164) ^ADD A MECHANISM TO TAB TO THE
RIGHT OF THE RIGHT MARGIN.
.PARAGRAPH
6.12 ^ADD THE ABILITY TO HANDLE MULTIPLE COLUMNS AND TO
CARRY TABLE HEADINGS ACROSS PAGE BREAKS.
.PARAGRAPH
6.13 ^ADD A MECHANISM FOR FORMATTING EXAMPLES WHICH
DOES STANDARDIZED INDENTING AND USES THE ^^.LITERAL\\ LOGIC.
.PARAGRAPH
6.14 ^IF THE WORDS IN THE INDEX ENTRY ARE TOO LONG, GO TO
A SECOND LINE AND INDENT 4 SPACES.
.PARAGRAPH
6.15 ^IN ^^.STANDARD\\ 70 MODE, PLACE THE INDEX IN TWO COLUMNS.
.PARAGRAPH
6.16 ^ADD THE ABILITY TO READ FROM ANOTHER FILE INCLUDING
REPEATEDLY SELECTING CONSECUTIVE PORTIONS OF THE FILE.
.PARAGRAPH
6.17 ^ADD AN OPTION (DEFAULT ON ^^.RNH)\\ TO OUTPUT TABS.
.PARAGRAPH
6.18 ^MODIFY ^^FILCOM\\ TO PRODUCE A ^^RUNOFF\\ INPUT FILE WHICH
INDICATES CHANGES FROM A PREVIOUS VERSION. ^USE THIS TO
IMPLEMENT CHANGE BARS, ETC., IN A RELIABLE FORM.
^ALSO, ADD OPTION TO OUTPUT ONLY THOSE PAGES WITH CHANGE BARS.
.PARAGRAPH
6.19 ^GIVE FULL CONTROL OVER THE FORMAT AND CONTENT OF PAGE HEADERS
AND TRAILERS.
.PARAGRAPH
6.20 ^IMPLEMENT A MULTIPLE COLUMN FACILITY. ^INCLUDE TABLE HEADERS
AT THE TOP OF PAGES HAVING CONTINUATIONS OF THE TABLE.
.PARAGRAPH
6.21 ^INTRODUCE FOOTNOTES WHICH CAN BE REFERENCED SEVERAL
TIMES ON A PAGE AND APPEAR ONLY ON PAGES WHERE REFERENCED.
.PARAGRAPH
6.22 ^ADD A SWITCH (DEFAULT IF ^^/DRAFT?)\\ WHICH INDICATES PAGES
WITH A ROW OF ***** INSTEAD OF A FORM FEED. ^THIS WOULD CONSERVE PAPER.
.PARAGRAPH
6.23 ^EXPAND NOTION OF TAB TO ALLOW RIGHT JUSTIFIED AND CENTER
JUSTIFIED COLUMNS.
.PARAGRAPH
6.24 ^ADD AN OPTION TO PRESERVE THE INPUT BUT JUST CLEAN UP LINE
BREAKS AND CAPITALIZATIONS. ^THIS WOULD BE NICE BOTH FOR NORMAL
FILES AND ESPECIALLY FOR ^^PLM\\S THAT ARE IMBEDDED IN SOURCE
FILES.
.PARAGRAPH
6.25 ^ADOPT A STANDARD (CONTROLLABLE) IDENTIFICATION WHICH SEPARATES
FOOTNOTES FROM THE PRECEEDING TEXT AND INDENTS AND NUMBERS THEM
ACCORDING TO SOME STANDARD FORMAT.
.PARAGRAPH
6.26 (^^QAR\\ 2479) ^ADD ^^/UNDERLINE:PROOF\\ TO FLAG CAPS
AND ALWAYS DOUBLE SPACE. ^DON'T AFFECT THE PAGE NUMBERING BY
THIS.
.PARAGRAPH
6.27 (^^QAR\\ 2632) ^USE COMMA NOT HYPHEN FOR INDEX ENTRIES
WHICH RANGE OVER ONLY TWO PAGES.
.PARAGRAPH
6.28 (^^QAR\\ 2632) ^HANDLE OVERFLOWS ON ^^.HL2\\.
.PARAGRAPH
6.29 (^^QAR\\ 2632) ^IN ^^.NOSELECT\\ MODE, WHEN ^^.SELECTION\\
HAS BEEN SET, NOTICE A ^^.SELECT\\ FOLLOWING THE COMMENT CHARACTER.
.PARAGRAPH
6.30 (^^QAR\\ 2496) ^ADD A MODE (^^KEEP\\) OF ^^.NOFILL\\ WHICH
KEEPS BLANK LINES. ^THIS MODE WOULD CONTINUE EACH TIME
_.NOFILL WAS SET.
.PARAGRAPH
6.31 (^^QAR\\ 2497) ^ADD SWITCHES TO SET THE PHYSICAL
AND DEFAULT LOGICAL PAGE LENGTHS. ^ADD A SWITCH TO ALLOW PRINTING
ACCROSS THE LINE PRINTER PAGE FOLD.
.PARAGRAPH
6.32 (^^QAR\\ 2498) ^ADD A CAPABILITY TO STORE TEXT TO
BE OUTPUT LATER. ^IN PARTICULAR, ALLOW ^^.FIGURE DEFER\\ TO
HAVE TEXT CONTENTS.
.PARAGRAPH
6.33 (^^QAR\\ 2500) ^TO AID CONVERSION FOR ^^SOS\\
USERS, ADD ^^.JUSTIFY RIGHT, .JUSTIFY LEFT (=NOFILL),
_.JUSTIFY CENTER, .JUSTIFY WORD (=FILL+NOJUSTIFY),
\\ AND ^^.JUSTIFY TEXT (=FILL+JUSTIFY).\\
.PARAGRAPH
6.34 (^^QAR\\ 2728) ^ADD A SUPERSCRIPTING AND
SUBSCRIPTING FACILITY.
.PARAGRAPH
6.35 (^^QAR\\ 2728) ^ADD A MACRO FACILITY.
.PARAGRAPH
6.36 ^EXPAND THE ^^TYPESET-10\\ FACILITY TO GENERATE
COMMANDS FOR THE FOLLOWING ^^RUNOFF\\ COMMANDS:
^^B-\N, ELT, ES, FG DEFER, HD, LE (\\USE /^G INSTEAD OF /^^N),
LT, NHD, NNM, NPA, NST, NM, PA, PS, PX, SPG, ST, T,\\ AND ^^X\\.
.PARAGRAPH
6.37 ^DO A LARGER ^^.TP\\ FOR ^^HL\\2 THAN FOR ^^HL3\\.
.PAGE
.CENTER
^SUMMARY OF ^ERROR ^MESSAGES
.SKIP 3
.PARAGRAPH
?^^RNFCJL CAN'T JUSTIFY LINE\\
.BREAK
^THE STRING OF INPUT BETWEEN SPACES (AND END OF LINE) IS
GREATER THAN THE SEPARATION BETWEEN LEFT AND RIGHT MARGINS AND
THEREFORE DOES NOT FIT IN THE OUTPUT EVEN BEFORE ANY ATTEMPT
TO EXPAND SPACES.
.PARAGRAPH
?^^RNFDVN DUPLICATE VARIABLE NAME\\: ".COMMAND"
.BREAK
^THIS VARIABLE COMMAND IS ATTEMPTING
TO DECLARE A VARIABLE WHICH HAS ALREADY BEEN DECLARED. ^THIS
DECLARATION WILL BE IGNORED.
.PARAGRAPH
?^^RNFEFD END FOOTNOTE DOESN'T FOLLOW FOOTNOTE: ".command"
.BREAK
This end footnote command appears at a place in the
file which is not immediately following a footnote
command and the corresponding footnote data.\\
.PARAGRAPH
?^^RNFELD END LITERAL DOESN'T FOLLOW LITERAL\\: ".COMMAND"
.BREAK
^THIS END LITERAL COMMAND APPEARS AT A PLACE IN THE FILE
WHICH IS NOT IMMEDIATELY FOLLOWING A LITERAL COMMAND AND THE
CORRESPONDING LITERAL TEXT. ^IT PROBABLY REFLECTS THAT THE
COUNT ON THE LITERAL COMMAND IS INCORRECT.
.PARAGRAPH
?^^RNFEVL EXCEEDING VARIABLE LIST\\: ".COMMAND"
.BREAK
^ONLY A MAXIMUM OF 20 VARIABLES CAN BE DECLARED. ^THIS COMMAND IS
ATTEMPTING TO DECLARE THE 21-ST VARIABLE. ^THIS AND ALL
FURTHER VARIABLE DECLARATIONS WILL BE IGNORED, ALTHOUGH
THE MESSAGE WILL NOT BE REPEATED.
.PARAGRAPH
?^^RNFFIF FOOTNOTE INSIDE FOOTNOTE\\: ".COMMAND"
.BREAK
^THIS COMMAND IS ATTEMPTING TO START A FOOTNOTE DEFINITION
ONLY IT OCCURS WITHIN A FOOTNOTE DEFINITION, WHICH IS ILLEGAL.
^IT PROBABLY INDICATES THAT THE PREVIOUS FOOTNOTE DEFINITION
WAS NEVER TERMINATED.
.PARAGRAPH
?^^RNFIBO INPUT BUFFER OVERFLOW\\
.BREAK
^A STRING OF CHARACTERS HAS BEEN INPUT WHICH IS SO LONG BETWEEN
SPACES (OR THE RIGHT MARGIN IS SO LARGE) THAT IT HAS OVERFLOWED
THE INTERNAL LINE BUFFER STORAGE AREA.
.PARAGRAPH
?^^RNFIFT ILLEGAL IN FOOTNOTE\\: ".COMMAND"
.BREAK
^THIS COMMAND IS ILLEGAL WITHIN A FOOTNOTE.
.PARAGRAPH
%^^RNFIIF _^\X IGNORED IN INPUT FILE\\
.BREAK
^CONTROL CHARACTERS ARE NOT NORMALLY ALLOWED IN THE INPUT FILE.
^THIS CHARACTER WAS INPUT AND IS BEING IGNORED. ^IF IT
SHOULD BE INPUT, THEN DECLARE "^^.CONTROL CHARACTERS"\\
IN ORDER TO MAKE IT LEGAL.
.PARAGRAPH
?^^RNFILC ILLEGAL COMMAND\\: ".COMMAND"
.BREAK
^THIS COMMAND IS ILLEGAL FOR SOME REASON. ^MOST REASONS ARE
THAT A KEY WORD WAS NOT RECOGNIZED OR THAT AN ARGUMENT
WAS OUT OF RANGE.
.PARAGRAPH
%^^RNFJEC JUNK AT END OF COMMAND: ".\\COMMAND"
.BREAK
^THE COMMAND, AFTER ALL ITS ARGUMENTS, STILL HAS SOME OTHER
CHARACTERS WHICH ARE NOT BLANKS OR COMMENTS.
.PARAGRAPH
[^^RNFKCF \NK CORE - FOOTNOTE]\\
.BREAK
^CORE WAS EXPANDED BECAUSE OF GROWTH IN THE FOOTNOTE STORAGE
AREA. ^IF THIS REPEATS INDEFINITELY IT PROBABLY INDICATES
THAT THE FOOTNOTE WAS IMPROPERLY TERMINATED.
.PARAGRAPH
[^^RNFKCI \NK CORE - INDEX]\\
.BREAK
^CORE WAS EXPANDED BECAUSE OF GROWTH IN THE INDEX STORAGE
AREA. ^IN A WELL INDEXED DOCUMENT THIS MESSAGE SHOULD
BE OUTPUT OCCASIONALLY AS PROCESSING PROGRESSES.
.PARAGRAPH
?^^RNFLDE LITERAL DOESN'T END WITH .END LITERAL\\: ".COMMAND"
.BREAK
^AFTER A COUNTED LITERAL, THE NEXT LINE IS NOT AN END LITERAL
COMMAND. ^THIS PROBABLY INDICATES THAT THE COUNT IS WRONG.
.PARAGRAPH
?^^RNFNEC NOT ENOUGH CORE \NK\\
.BREAK
^CORE HAS BEEN EXPANDED TO THE LIMIT OF WHAT THE
MONITOR IS ALLOWED TO ASSIGN TO THIS JOB. ^THE PROCESSING
IS ABORTED AT THIS POINT.
.PARAGRAPH
?^^RNFNFS NO FILE SPECIFIED\\
.BREAK
^THE USER HAS SPECIFIED SOME SWITCHES OR AN OUTPUT FILE,
BUT HAS NOT SPECIFIED AN INPUT FILE.
.PARAGRAPH
%^^RNFNIA NEGATIVE INDENT ATTEMPTED\\
.BREAK
^THE SUM OF THE INDENT AND THE LEFT MARGIN IS LESS THAN ZERO,
MEANING THAT THE LINE SHOULD START TO THE LEFT OF THE LEFT
EDGE OF THE PAPER. ^EITHER THE LEFT MARGIN HAS BEEN
MISSET OR THE INDENT IS WRONG. ^THE INDENT MIGHT BE
IMPLICIT IN A PARAGRAPH OR TABLE REQUEST. ^THIS MESSAGE IS
OUTPUT ONLY ONCE UNTIL THE NEXT LEFT MARGIN OR ^^SD\\
COMMAND.
.PARAGRAPH
%^^RNFNIC ANOTHER \N NEGATIVE INDENTS COUNTED\\
.BREAK
^THIS MESSAGE INDICATES HOW MANY ADDITIONAL NEGATIVE INDENTS
WERE DISCOVERED SINCE THE LAST ^^NIA\\ MESSAGE.
.PARAGRAPH
?^^RNFNID NO INPUT DEVICE\\
.BREAK
^THE USER HAS FAILED TO SPECIFY EITHER AN INPUT
DEVICE OR FILE.
.PARAGRAPH
?^^RNFODE OUTPUT ERROR \\XXXXXX
.BREAK
^THE OUTPUT FILE HAS AN ^^I/O\\ ERROR WHOSE OCTAL CODE IS INCLUDED
IN THE MESSAGE.
.PARAGRAPH
%^^RNFSPO SUBPAGE OVERFLOW\\
.BREAK
^WHILE INCREMENTING THE SUBPAGE COUNTER, IT GOT LARGER THAN
26. ^THIS PROBABLY INDICATES THAT THE END SUBPAGE COMMAND IS
MISSING.
.PARAGRAPH
%^^RNFTFE TOO FEW END COMMANDS\\
.BREAK
^WHEN THE END OF THE INPUT WAS REACHED THERE WERE NOT THE SAME
NUMBER OF END (OR END LIST OR END NOTE) COMMANDS AS THERE HAD
BEEN LIST AND NOTE COMMANDS. ^THIS PROBABLY INDICATES THAT
AN END COMMAND IS MISSING.
.PARAGRAPH
?^^RNFTMI INSUFFICIENT CORE FOR COMMAND\\
.BREAK
^THE USER HAS SPECIFIED SO MANY INPUT FILE SPECIFICATIONS
THAT ^^RUNOFF\\ COULD NOT FIT THEM INTO CORE. ^THE COMMAND SHOULD
BE SPLIT INTO SEVERAL COMMANDS.
.PARAGRAPH
?^^RNFTMR TOO MANY RANGES\\
.BREAK
^THE USER HAS SPECIFIED TOO MANY ^^IRANGE\\ OR ^^ORANGE\\ PAIRS TO
FIT IN THE STORAGE SPACE ASSIGNED (20 PAIRS EACH). ^FEWER
RANGES SHOULD BE SPECIFIED.
.PARAGRAPH
?^^RNFTMV TOO MANY /VARIANTS\\
.BREAK
^THE USER HAS SPECIFIED TOO MANY ^^VARIANTS\\ IN THE COMMAND. ^ONLY
20 VARIANTS CAN BE SPECIFIED IN ONE COMMAND.
.PARAGRAPH
%^^RNFTNN TOO MANY NESTED NOTES\\
.BREAK
^MORE THAN 6 NESTED NOTES AND LISTS HAS OCCURED. ^THIS PROBABLY
INDICATES THAT ONE OR MORE END COMMANDS IS MISSING.
.PARAGRAPH
?^^RNFUKV UNKNOWN VARIABLE\\: ".COMMAND"
.BREAK
^ON AN IF, IFNOT, ELSE, OR ENDIF COMMAND A VARIABLE WAS
REFERENCED WHICH WAS NOT DECLARED IN A VARIABLE COMMAND.
^THIS USUALLY INDICATES A SPELLING ERROR OR A MISSING VARIABLE
COMMAND.
.PARAGRAPH
%^^RNFUME UNMATCHED END COMMAND\\
.BREAK
^MORE END COMMANDS HAVE OCCURED THAN LIST OR NOTE COMMANDS.
.PARAGRAPH
?^^RNFVVZ /VARIANT VALUE ZERO\\
.BREAK
^IN A ^^VARIANT\\ SWITCH, THE VALUE WAS NULL OR ZERO. ^VARIANTS
ALWAYS HAVE NAMES.
.SKIP 2
.INDENT -5
[^END OF ^^RNF10.DOC\\]