home *** CD-ROM | disk | FTP | other *** search
/ ftp.barnyard.co.uk / 2015.02.ftp.barnyard.co.uk.tar / ftp.barnyard.co.uk / cpm / walnut-creek-CDROM / CPM / TURBOPAS / RNF-PAS.LBR / RNFMAN1.RQF / RNFMAN1.RNF
Text File  |  2000-06-30  |  29KB  |  635 lines

  1. .REM LAST REVISED  7 June 1986
  2. .REM This file has many good examples of RNF features.  However, on most
  3. .REM  modern computers, you would use upper and lower case input,
  4. .REM  not upper-case only.
  5. .CASEFLAG .FLAG .FLAGCAPS
  6. .RIGHT 10
  7. .MACRO INPAG   = .SAV .RESPAG .S 3
  8. .MACRO OUTPAG  = .S 2 .RES
  9. .MACRO LPAG    = .IF $LP $$PAGE=$$PAGE+1 .T <RNF .RT .CHTTL
  10. .MACRO RPAG    = .IF #$LP .CHTTL .T <RNF .RT $$PAGE=$$PAGE+1
  11. .MACRO CH *    = .PAGE .RESPAG .BR # .BR .S 4 .CHA .B .CHB .S 3 $$HL=0;
  12. .MACRO CHA     = .C <CHAPTER $$CH=$$CH+1 .BR
  13. .MACRO CHB     = .C .CH1 .BR
  14. .MACRO BDOT = .SAV .P -2 1 5 .LM +5
  15. .MACRO DOT = .PP _.# .X
  16. .MACRO EDOT = .RES .S 1
  17. .VAR $LP
  18. .RM 60
  19. .TABS 30 $$RM .SP 1 .SAVPAG
  20. .PAGESIZE 58 $$RM .LINES 66
  21. .AP .P +0 1 4
  22. .NONMP
  23. ##########
  24. .PAGE
  25. .FIG 20
  26. .C .U <RNF
  27. .B
  28. .C ^TEXT ^PROCESSOR .NOU
  29. .B .B
  30. .C ^REFERENCE ^GUIDE
  31. $$PAGE=0;
  32. .MACRO FRCPAGE = .TOP .INPAG .LPAG .RPAG .OUTPAG .MID $LP=#$LP;
  33. .MACRO CHTTL   = ^INTRODUCTION
  34. .CH <INTRODUCTION
  35.  <RNF IS A TEXT FORMATTING PROGRAM SIMILIAR TO THE
  36. <RUNOFF PROGRAM ON THE <DEC<SYSTEM-20, OR NROFF AND TROFF ON <UNIX.
  37.  <RNF ACCEPTS (MOSTLY) FREE-FORMAT TEXT WHICH HAS BEEN PUT IN
  38. A FILE AND EDITED BY ANY EDITOR, AND PRODUCES OUTPUT SUITABLE FOR
  39. A LINE PRINTER OR A TYPEWRITER-LIKE TERMINAL DEVICE.
  40. .HL 1 ^FEATURES
  41.  <RNF DOES ANY OR ALL OF THE FOLLOWING FOR THE USER:
  42. .SAV .P -16 1 3 .LM 25 .TABS 25
  43.  ^PAGINATION .T <RNF AUTOMATICALLY BREAKS TEXT UP INTO
  44. PAGES, AND BY DEFAULT NUMBERS THEM SEQUENTIALLY.
  45.  ^FILL .T ^USING THE MARGINS SET BY THE USER, <RNF
  46. AUTOMATICALLY "FILLS" EACH LINE OF THE OUTPUT WITH AS MANY WORDS
  47. AS IT CAN HOLD WITHOUT EXCEEDING THE RIGHT MARGIN.  ^FILLING
  48. STOPS AT THE END OF A PARAGRAPH, ETC.
  49.  ^JUSTIFICATION .T <RNF WILL OPTIONALLY JUSTIFY FILLED LINES
  50. ON THE RIGHT, SO THAT THE RIGHT MARGIN "LINES UP" EVENLY.
  51.  ^CHAPTERING .T <RNF WILL FORMAT CHAPTER TITLES, AND
  52. NUMBER CHAPTERS SEQUENTIALLY.
  53.  ^SECTIONING .T <RNF WILL FORMAT SECTION HEADERS AND NUMBER
  54. SECTIONS AND SUBSECTIONS SEQUENTIALLY.
  55.  ^LISTS .T <RNF WILL FORMAT AND NUMBER LISTS AND
  56. SUBLISTS.
  57. .RES
  58.  ^IN ADDITION TO THE FEATURES WHICH ARE BUILT IN,
  59. <RNF PROVIDES AN EASY TO USE MACRO FACILITY WHICH PERMITS
  60. THE USER TO DEFINE COMMANDS WHICH ARE CUSTOMIZED TO A PARTICULAR
  61. APPLICATION.
  62. .HL 1 <WORDS
  63.  <RNF INPUT IS A SERIES OF WORDS, WHERE A WORD IS ANY SEQUENCE
  64. OF NON-BLANK CHARACTERS.
  65.  ^BLANKS IN THE INPUT TEXT ARE NOT (USUALLY) SIGNIFICANT TO
  66. <RNF, EXCEPT THAT THEY DELIMIT WORDS.  <RNF INSERTS ONE
  67. BLANK BETWEEN EACH WORD, AND TWO BLANKS AFTER WORDS WHICH
  68. END SENTENCES.
  69.  ^IF A SEQUENCE OF BLANKS MUST APPEAR IN THE OUTPUT, THE
  70. SIGNIFICANT BLANK CHARACTER _# IS USED.  ^FOR EXAMPLE,
  71. BE_#_#_#_#TWEEN IS OUTPUT AS BE####TWEEN.
  72. .HL 1 <LINES
  73.  ^IN DEFAULT MODE, WORDS ARE
  74. PICKED FROM THE INPUT ONE BY ONE AND PLACED INTO AN OUTPUT
  75. LINE.  ^WHEN AN OUTPUT LINE IS FULL, IT IS WRITTEN INTO THE
  76. OUTPUT FILE.
  77.  ^THE USER SETS THE LEFT AND RIGHT MARGINS OF THE OUTPUT PAGE
  78. BY THE <.LM AND <.RM COMMANDS, RESPECTIVELY.
  79. ^TEXT ON THE OUTPUT LINE IS WRITTEN BEGINNING AT THE LEFT MARGIN
  80. AND NOT PAST THE RIGHT MARGIN.
  81.  ^FILLING MEANS THAT (UNLESS THE USER SPECIFICALLY DIRECTS OTHERWISE)
  82. AS MANY WORDS AS POSSIBLE ARE USED TO FILL EACH OUTPUT LINE.
  83.  ^JUSTIFICATION MEANS THAT BLANK CHARACTERS ARE ADDED BETWEEN
  84. WORDS SO THAT THE LAST CHARACTER ON EACH LINE IS EXACTLY ON THE
  85. RIGHT MARGIN.
  86.  ^THE <.F AND <.J COMMANDS CONTROL FILLING AND JUSTIFICATION.
  87.  ^THE DEFAULT LEFT MARGIN IS 1 AND THE DEFAULT RIGHT MARGIN IS
  88. 72.  ^FOR ^ELITE TYPE (12 CHARACTERS PER INCH) THIS PRODUCES
  89. A 6-INCH WIDE LINE, WHICH ALLOWS 1 AND 1/4 INCH MARGINS ON
  90. STANDARD 8 AND 1/2 INCH PAPER.   ^FOR ^PICA TYPE (10 CHARACTERS
  91. PER INCH) <.LM 1 AND <.RM 60 PROVIDE THE SAME SIZE LINE.
  92.  ^FOR MOST PURPOSES, IT IS RECOMMENDED THAT THE LEFT MARGIN BE
  93. INITIALLY SET TO 1, AS THIS IS EASY TO WORK WITH AND REMEMBER.
  94. ^IF THE TEXT MUST BE SHIFTED TO THE RIGHT FOR OUTPUT ON A
  95. TYPEWRITER PAGE, THE <.RIGHT COMMAND MAY BE USED.
  96. .HL 1 <SPACING
  97.  ^THE INPUT TO <RNF IS SINGLE SPACED.  ^THE OUTPUT MAY BE SINGLE
  98. SPACED, DOUBLE SPACED, OR TRIPLE SPACED AS THE USER CHOOSES.
  99.  ^SPACING IS SET BY THE <.SP COMMAND.
  100. ^ONCE SET, <RNF WILL AUTOMATICALLY
  101. CONTROL SPACING WITHOUT REQUIRING ANY FURTHER ACTION
  102. ON THE PART OF THE USER.  ^IF EXTRA SPACES OR NON-STANDARD SPACING
  103. IS DESIRED, HOWEVER, <RNF PROVIDES COMMANDS FOR THESE, TOO.
  104.  ^THE <.CR COMMAND PROVIDES THE EQUIVALENT OF A CARRIAGE RETURN
  105. KEY ON AN ELECTRIC TYPEWRITER.   ^THE <.CR ENDS THE CURRENT LINE
  106. AND SPACES AS SET BY <.SP.  ^THAT IS, IF SINGLE SPACING IS
  107. SELECTED (<.SP 1), THE <.CR "RETURNS THE CARRIAGE" TO THE NEXT
  108. LINE; IF DOUBLE SPACING IS SELECTED (<.SP 2), THE <.CR LEAVES
  109. A SINGLE BLANK LINE AFTER THE CURRENT LINE, AND SO ON.   ^THROUGHOUT
  110. THIS MANUAL, THE ACTION OF THE <.CR IS REFERRED TO AS A "RETURN".
  111. ^MANY COMMANDS CAUSE A RETURN AS A PRELUDE TO FURTHER ACTION.
  112.  ^THE <.S COMMAND CAUSES A RETURN, FOLLOWED BY ANY NUMBER OF EXTRA
  113. RETURNS.
  114. <.S AND <.S#1 MEAN THE SAME, I.E., A RETURN AND ONE EXTRA RETURN.
  115. <.S#2 PROVIDES TWO EXTRA RETURNS, AND SO ON.
  116.  <.CR AND <.S ALWAYS HONOR THE SPACING SET BY <.SP.  ^THE USER
  117. CAN ESCAPE SPACING BY MEANS OF THE <.BR AND <.B COMMANDS.
  118.  <.BR PROVIDES A "BREAK"; IT RETURNS THE CARRIAGE AND PROCEEDS
  119. ON THE NEXT LINE, REGARDLESS OF SPACING.  <.B CAUSES ANY NUMBER
  120. OF BLANK LINES AFTER THE CURRENT LINE.   <.B AND <.B#1 MEAN THE
  121. SAME: BREAK AND LEAVE ONE BLANK LINE AFTER THE CURRENT LINE.
  122. <.B#2 LEAVES TWO BLANK LINES, AND SO ON.
  123.  ^THUS, THE USER CAN CREATE SPACING INDEPENDENT TEXT BY USING
  124. ONLY <.CR AND <.S COMMANDS FOR SPACING.  <.BR AND <.B ARE USED
  125. WHEN SPACING IS TO BE FIXED REGARDLESS OF THE <.SP SETTING.
  126. .HL 1 <PARAGRAPHS
  127.  <RNF PROVIDES BOTH EXPLICIT AND AUTOMATIC PARAGRAPHING FACILITIES.
  128. ^THE <.P COMMAND CONTROLS THE INDENTATION, SPACING, AND LOCATION
  129. OF EACH PARAGRAPH.  ^THE <.PP COMMAND BEGINS A NEW PARAGRAPH.
  130.  ^AUTOPARAGRAPHING, CONTROLLED BY THE <.AP COMMAND, CAUSES AN
  131. IMPLICIT <.PP COMMAND EACH TIME EITHER A BLANK LINE OR A LINE
  132. BEGINNING WITH BLANK IS ENCOUNTERED IN THE INPUT TEXT.
  133. ^THIS IS A CONVENIENT FORMAT FOR TEXT ENTRY, AND ALLOWS
  134. EASY MODIFICATION.
  135. ^BY USE OF THE <.SP (^S^PACING) AND <.P COMMANDS, THE SAME INPUT
  136. TEXT CAN BE USED FOR PRODUCING BOTH DOUBLE (OR TRIPLE) SPACED DRAFTS
  137. AND SINGLE SPACED FINAL COPY.
  138.  ^PARAGRAPHING IS SUFFICIENTLY FLEXIBLE TO BE USED FOR
  139. "HANGING INDENTS".
  140. ^IN ADDITION, THE FACT THAT PARAGRAPH INDENTATION CAN BE
  141. SPECIFIED RELATIVE TO THE LEFT MARGIN (EVEN IF IT IS LATER
  142. CHANGED) ALLOWS PARAGRAPHING TO BE CONVENIENTLY USED IN
  143. INDENTED TEXT.
  144. .HL 1 <PAGES
  145.  ^LINES ARE AUTOMATICALLY SEPARATED INTO PAGES BY <RNF.
  146. ^TWO COMMANDS CONTROL THE SIZE OF <RNF PAGES: <.PAGESIZE (^PAGE ^SIZE)
  147. AND <.LINES.
  148.  ^THE FIRST ARGUMENT OF <.PAGESIZE SPECIFIES THE NUMBER OF LINES WHICH
  149. ARE ALLOWED ON A PAGE BEFORE AN AUTOMATIC PAGE THROW IS DONE.
  150. ^THIS NUMBER INCLUDES THE LINES IN THE HEADER AT THE TOP OF EACH
  151. PAGE, AND THE NORMAL TEXT ON THE PAGE, BUT DOES NOT INCLUDE THE
  152. LINES IN THE FOOTER (IF ANY) AT THE BOTTOM OF THE PAGE.
  153. ^THE <.LINES COMMAND SPECIFIES THE NUMBER OF LINES ON THE
  154. ENTIRE PAGE.  ^THIS NUMBER IS USED WHEN SIMULATING PAGE EJECTS
  155. ON TERMINALS WITH CONTINUOUS FORMS.
  156.  ^THE DEFAULT <.PAGESIZE FIRST ARGUMENT AND <.LINES ARE 58 AND 66,
  157. RESPECTIVELY.  ^THIS ALLOWS AT LEAST A 1 AND 1/3 INCH BOTTOM
  158. MARGIN WITH 6 LINE PER INCH PRINTING, AND A 1 INCH MARGIN WITH
  159. 8 LINE PER INCH PRINTING ON STANDARD  REDUCED FORMS.
  160.  ^SOME TERMINALS USE REDUCED FORMS BUT PRINT 6 LINES PER INCH.
  161. ^THIS MEANS THERE ARE 51 LINES ON EACH PAGE; A <.PAGESIZE FIRST ARGUMENT
  162. OF 44 WILL ALLOW A 1 INCH BOTTOM MARGIN.
  163. .HL 2 ^EXPLICIT PAGING CONTROL
  164.  ^THE <.PAGE COMMAND ALLOWS THE USER TO ADVANCE TO THE NEXT PAGE
  165. EXPLICITLY.  ^THE <.NMP AND <.PNO COMMANDS CONTROL PAGE NUMBERING,
  166. AND THE <.TITLE, <.ST, AND <.ATITLE COMMANDS PROVIDE FOR PRINTING
  167. TITLES AT THE TOP OF EACH PAGE.
  168. .HL 2 ^PAGE ^FORMAT
  169.  ^A PAGE IS DIVIDED INTO THREE AREAS:
  170. .BDOT .DOT ^THE TOP, WHICH CONTAINS THE UPPER MARGIN AND OPTIONAL
  171. TITLES AND PAGE NUMBER.
  172. .DOT ^THE MIDDLE, WHICH CONTAINS THE TEXT OF THE DOCUMENT.
  173. .DOT ^THE BOTTOM, WHICH MAY CONTAIN A FOOTER.  (^BY DEFAULT, NO
  174. FOOTER IS PRINTED.)
  175. .EDOT
  176.  ^THE DEFAULT HEADER CONSISTS OF AN OPTIONAL TITLE ON THE LEFT AND
  177. THE PAGE NUMBER AS AN ^ARABIC NUMBER ON THE RIGHT OF THE FOURTH
  178. LINE ON THE PAGE.
  179. ^THE SUBTITLE, IF ANY, IS BELOW THE TITLE ON THE FOLLOWING LINE.
  180. ^TWO BLANK LINES ARE LEFT BELOW THE HEADER.
  181.  ^IF THIS DEFAULT FORMAT IS NOT SATISFACTORY FOR A SPECIFIC
  182. DOCUMENT, THE USER MAY SUBSTITUTE ANY ARBITRARY HEADER AND
  183. FOOTER TEXT BY MEANS OF A <.FRCPAGE MACRO DEFINITION (SEE ^CHAPTER 3)
  184. AND USE OF THE PAGING INTRINSICS <.TOP, <.MID, AND <.BOTTOM.
  185.  ^THE PAGE NUMBER USED BY <RNF MAY BE ACCESSED DIRECTLY THROUGH
  186. THE PREDEFINED VARIABLE <$$PAGE (SEE ^CHAPTER 4).
  187. .HL 1 ^UPPER ^CASE ^INPUT ^TEXT
  188.  ^BY DEFAULT, <RNF DOES NOT CHANGE THE CASE OF ALPHABETIC CHARACTERS IN
  189. THE INPUT.
  190. ^THE OPTION _.<CASECONVERT CAN BE USED TO SHIFT UPPER CASE TO LOWER.
  191. ^THE _.<FLAG OPTION ALLOWS
  192. UPPER CASE OUTPUT TO BE INDICATED BY A PRECEDING ^.  ^FOR
  193. EXAMPLE, THE FOLLOWING   INPUT
  194.  .I 9 <_^THIS <IS <AN <_^U_^P_^P_^E_^R/LOWER <CASE <LINE.
  195.  IS OUTPUT BY <RNF AS
  196.  .I 9 ^THIS IS AN <UPPER/<LOWER CASE LINE.
  197.  ^THE _.<FLAGCAPS OPTION CAUSES THE _< CHARACTER TO INVERT THE CASE OF ALL
  198. ALPHABETIC CHARACTERS WHICH FOLLOW IT IN THE SAME WORD.
  199. ^FOR EXAMPLE,
  200.  .I 9 <^SOME <_<UPPER <_<CASE <AND <SOME <LOWER <CASE.
  201.  .I 9 <SOME_<OF_<BOTH
  202.  ARE OUTPUT AS
  203.  .I 9 ^SOME <UPPER <CASE AND SOME LOWER CASE.
  204.  .I 9 SOME<OF<BOTH
  205.  ^WHEN THESE OPTIONS ARE GIVEN, THE CHARACTERS _^ AND _< MUST
  206. BE REPRESENTED IN  INPUT AS ___^ AND ___<, RESPECTIVELY.
  207. .MACRO CHTTL = ^COMMANDS
  208. .CH <COMMANDS
  209.  ^ANY SEQUENCE OF NON-BLANK CHARACTERS BEGINNING WITH A PERIOD
  210. (.) ARE TAKEN BY <RNF TO BE A COMMAND.   ^IF THE COMMAND IS NOT
  211. RECOGNIZED, AN ERROR MESSAGE IS PRODUCED.
  212.  ^MANY COMMANDS REQUIRE ARGUMENTS, I.E., WORDS WHICH FOLLOW
  213. THE COMMAND AND MODIFY ITS ACTION IN SOME WAY.
  214. ^THE ONLY COMMANDS WHICH PERMIT A VARIABLE NUMBER OF ARGUMENTS
  215. ARE <.TAB (OR <.TABS), <.B, AND <.S.
  216. IF ANY OTHER COMMAND REQUIRES AN ARGUMENT, IT MUST BE SPECIFIED.
  217.  ^COMMANDS MAY BE FREELY INTERSPERSED WITH TEXT.  ^SOME COMMANDS
  218. CAUSE A "RETURN" (THAT IS, ACT AS IF THEY WERE PRECEDED BY A
  219. <.CR COMMAND) AS A PART OF THEIR ACTION.  ^IF A COMMAND CAUSES
  220. A RETURN, THIS IS INDICATED IN PARENTHESIS AFTER THE COMMAND
  221. FORMAT.
  222. ^OTHER COMMANDS CAUSE A "BREAK" (THAT IS, ACT AS IF THEY WERE
  223. PRECEDED BY A <.BR COMMAND) AS A PART OF THEIR ACTION.
  224. ^THESE ARE INDICATED BY (^BREAK) IN PARENTHESIS.
  225.  ^NOTE THAT A BLANK MUST FOLLOW A COMMAND IF THERE IS MORE TEXT ON
  226. THE SAME LINE.   ^FOR EXAMPLE, THE SEQUENCE "<.B.I#5" IS IN ERROR;
  227. IT MUST BE WRITTEN AS "<.B#.I#5".
  228. .LM 9
  229. .TAB 60
  230. .P -4 2 4
  231.  <.AP
  232. .B ^ANY BLANK LINE OR ANY LINE BEGINNING WITH A BLANK CHARACTER
  233. BEGINS A NEW PARAGRAPH.  ^SEE THE <.P AND THE <.PP COMMANDS.
  234. <.NOAP TURNS AUTOPARAGRAPHING OFF AND IS THE DEFAULT. ^DO <NOT
  235. USE THIS FEATURE (USE A BLANK LINE, OR BEGIN A LINE WITH A BLANK)
  236. UNTIL AFTER THE FIRST LINE OF TEXT HAS BEEN WRITTEN. ^IF YOU
  237. MUST AUTOPARAGRAPH IMMEDIATELY, WRITE
  238. .NOFLAGSIG ##### .FLAGSIG FIRST.
  239.  <.ARRAY VARIABLENAME N
  240. .B ^THIS COMMAND DECLARES AN ARRAY VARIABLE WITH THE NAME SPECIFIED
  241. AND N+1 ELEMENTS.  ^AN ELEMENT OF THE ARRAY IS LATER ACCESSED OR
  242. CHANGED BY A REFERENCE OF THE FORM:
  243. .B .I 9 VARIABLENAME[EXPRESSION]
  244. .B WHERE EXPRESSION MAY BE IN THE RANGE 0 THROUGH N.
  245. ^THE ZEROETH ELEMENT OF THE ARRAY MAY BE REFERRED TO WITHOUT
  246. A [0] SUBSCRIPT, AND IS COMMONLY USED AS AN INDEX INTO THE
  247. REMAINDER OF THE ARRAY.
  248. .B ^ALL ARRAY ELEMENTS HAVE THE INITIAL VALUE ZERO. ^ARRAY NAMES
  249. MUST BE FORMED AS DEFINED FOR THE <.VAR COMMAND.
  250.  <.ASIS .RT (^RETURN)
  251. .B ^TERMINATES THE CURRENT INPUT LINE AND ENTERS AS IS MODE BEGINNING
  252. WITH THE NEXT INPUT LINE.
  253. .B ^IN AS IS MODE, INPUT LINES ARE COPIED DIRECTLY TO THE OUTPUT
  254. (EXCEPT THAT THE LEFT MARGIN, CHANGE BARS, AND <.RIGHT SPACING
  255. ARE STILL HONORED).
  256. .B ^AS IS MODE IS TERMINATED BY A LINE WITH AN EXCLAMATION MARK
  257. (!) IN COLUMN 1.  ^ALL CHARACTERS AFTER THE EXCLAMATION MARK ARE
  258. IGNORED, AND NORMAL PROCESSING BEGINS WITH THE FOLLOWING LINE.
  259.  <.ATITLE
  260. .B ^ENABLES AUTOTITLING, WHICH MAKES EACH NEW CHAPTER HEADING
  261. THE TITLE FOR ALL BUT THE FIRST PAGE OF THE CHAPTER.  ^THE
  262. DEFAULT IS <.NOATITLE.
  263.  <.B .RT (^BREAK)
  264. .BR .I -4 <.B N .RT (^BREAK)
  265. .B ^ENDS THE CURRENT LINE AND WRITES IT WITHOUT FURTHER FILLING
  266. OR JUSTIFICATION (CAUSES A BREAK), THEN WRITES N BLANK LINES.
  267. <.B AND <.B#1 ARE EQUIVALENT.
  268.  <.BAR
  269. .B ^ENABLES CHANGE BARS.  ^ALL TEXT FOLLOWING THE <.BAR COMMAND
  270. IS SHIFTED RIGHT THREE SPACES.   ^SEE THE <.BB AND <.EB COMMANDS.
  271. ^THE DEFAULT IS <.NOBAR.
  272.  <.BB
  273. .B ^BEGIN PLACING CHANGE BARS IN THE MARGIN
  274. CREATED BY THE <.BAR COMMAND BEGINNING WITH THE LINE WHICH
  275. CONTAINS THE FIRST WORD IN THE TEXT FOLLOWING THE <.BB COMMAND.
  276. ^SEE THE <.EB COMMAND.
  277.  <.BOLD
  278. .B ^MAKE THE SUBSEQUENT WORDS BOLD, USING OVERPRINTING.  ^TERMINATED
  279. BY THE _.<NOBOLD COMMAND.
  280.  <.BOTTOM
  281. .B ^SETS THE BEGINNING OF USER TEXT (ON THE PAGE) TO THE CURRENT
  282. OUTPUT LINE NUMBER
  283. AND RESTORES ANY OUTPUT LINES WHICH MIGHT HAVE
  284. BEEN SAVED ON A FORCED PAGE EJECT (SEE <.FRCPAGE).
  285. ^IF ANY DEFERRED TEXT IS PENDING (SEE THE <.FIG COMMAND), AS MUCH OF IT
  286. AS POSSIBLE IS OUTPUT BY <.BOTTOM.  ^IF AS IS MODE WAS IN EFFECT AT
  287. THE TIME OF THE LAST <.FRCPAGE, IT IS RESTORED.
  288. .B ^THE <.BOTTOM
  289. COMMAND IS TO BE USED ONLY WHEN OVERRIDING THE DEFAULT
  290. HEADER FORMAT VIA MACROS.
  291. .B ^THE <.B AND <.S COMMANDS HAVE NO EFFECT AT THE BEGINNING
  292. OF USER TEXT ON A PAGE.  ^THIS PREVENTS SPURIOUS BLANK LINES AT THE TOP
  293. OF A TEXT PAGE.
  294.  <.BR .RT (^BREAK)
  295. .B ^ENDS THE CURRENT OUTPUT LINE AND WRITES IT WITHOUT FURTHER
  296. FILLING OR JUSTIFICATION.  ^NO EXTRA BLANK LINES ARE LEFT BY
  297. <.BR, REGARDLESS OF SPACING.
  298.  <.C TEXT .RT (^RETURN)
  299. .B ^CENTERS THE TEXT WHICH FOLLOWS THE <.C COMMAND ON THE
  300. SAME LINE.  ^CENTERING IS BETWEEN THE CURRENT LEFT AND RIGHT
  301. MARGINS.
  302.  <.CASECONVERT
  303. .B ^INVERTS CASE OF INPUT LETTERS.  ^FOR USE WITH TERMINALS OR COMPUTERS
  304. WITHOUT LOWER CASE.  ^SEE <.FLAG AND <.FLAGCAPS.
  305.  <.CH TITLE .RT (^RETURN)
  306. .B ^BEGINS A NEW CHAPTER WITH THE TITLE WHICH FOLLOWS ON THE
  307. SAME LINE.  ^A NEW PAGE IS BEGUN, TITLES AND SUBTITLES ARE
  308. CLEARED, A <.FIG 12 IS DONE, FOLLOWED BY THE WORD <CHAPTER
  309. CENTERED, A <.B, FOLLOWED BY THE TITLE CENTERED.  ^PAGE NUMBERING
  310. IS NOT AFFECTED.  ^IF <.ATITLE IS ON, THE CHAPTER TITLE IS
  311. SET AS THE <.TITLE FOR SUCCEEDING PAGES.
  312.  <.CR .RT (^RETURN)
  313. .B ^CAUSES A CARRIAGE RETURN, WHICH IS A <.BR FOLLOWED BY
  314. SPACING MINUS ONE BLANK LINES.
  315. .B ^NOTE THAT <.CR IS IMPLIED BEFORE ANY COMMAND FOR WHICH
  316. (^RETURN) IS INDICATED.
  317.  <.DOT
  318. .B ^CAUSES ALL FOLLOWING <.T OR <.RT COMMANDS TO FILL WITH DOTS
  319. (PERIODS) INSTEAD OF SPACES.  ^A BLANK IS ALWAYS LEFT BEFORE
  320. AND AFTER THE STRING OF DOTS.
  321. <.NODOTS RETURNS TO FILLING TABS WITH SPACES.
  322.  <.EB
  323. .B ^END CHANGE BARS.  ^THE LAST LINE FLAGGED IS THE ONE WHICH
  324. CONTAINS THE WORD JUST PRECEDING THE <.EB COMMAND.
  325.  <.ENDLIST
  326. .B ^END LIST.  ^TERMINATES THE INNERMOST ACTIVE LIST.  ^SEE
  327. THE <.LIST COMMAND.
  328.  <.ESC
  329. .B ^ENABLES THE ESCAPE CHARACTER __ (BACKARROW OR UNDERLINE).
  330. ^WHEN ENABLED, THE ESCAPE CHARACTER CAUSES THE CHARACTER WHICH
  331. FOLLOWS IT TO BE COPIED TO THE OUTPUT TEXT WITHOUT SPECIAL
  332. ACTION. ^FOR EXAMPLE, 23__. CAUSES 23_. TO BE TYPED WITHOUT
  333. AN EXTRA TRAILING BLANK.  ^THE DEFAULT IS <.ESC.
  334.  <.F
  335. .B ^FILLS EACH OUTPUT LINE WITH AS MANY WORDS FROM THE INPUT
  336. AS POSSIBLE WITHOUT EXCEEDING THE RIGHT MARGIN.
  337. ^BLANKS ARE REMOVED FROM THE INPUT.  ^EACH WORD OF THE OUTPUT
  338. IS FOLLOWED BY AT LEAST ONE BLANK, WHILE WORDS WHICH END IN
  339. _., _!, OR _? ARE FOLLOWED BY AT LEAST TWO BLANKS.
  340. <.NOF SUPPRESSES FILL.
  341.  <.FIG N
  342. .B ^RESERVES N LINES FOR A FIGURE.  ^IF THE LINES WILL FIT ON THE
  343. CURRENT PAGE, <.FIG CAUSES A RETURN AND LEAVES N BLANK LINES.
  344. ^IF NOT, N BLANK LINES ARE LEFT AT THE BEGINNING OF THE NEXT
  345. PAGE.
  346.  <.FLAG
  347. .B ^CAUSES ^ TO BE RECOGNIZED AS A FLAG CHARACTER.
  348. <.NOFLAG SUPPRESSES RECOGNITION AND IS THE DEFAULT.
  349.  <.FLAGCAPS
  350. .B ^CAUSES THE _< CHARACTER TO INVERT THE CASE OF ANY LETTERS
  351. IN A WORD WHICH FOLLOW IT.  ^FOR EXAMPLE, <_<UP_<AND_<THEN_<DOWN
  352. IS OUTPUT AS <UP<AND<THEN<DOWN.
  353. <.NOFLAGCAPS SUPPRESSES SPECIAL ACTION FOR THE _< CHARACTER.
  354. <.NOFLAGCAPS IS THE DEFAULT.
  355.  <.FLAGOVER
  356. .B ^THE <.FLAGOVER COMMAND ENABLES RECOGNITION OF _\ (BACKSLASH)
  357. AS THE STRIKEOVER CHARACTER.  ^THE STRIKEOVER CHARACTER
  358. IS WRITTEN BETWEEN THE CHARACTER TO BE OVERSTRUCK AND THE CHARACTER
  359. WHICH IS TO OVERSTRIKE IT.  ^FOR EXAMPLE, <STRIKEO_\/VER IS
  360. OUTPUT AS <STRIKEO\/VER.
  361. .B ^UNDERLINING COUNTS AS ONE OVERSTRIKE.  ^ANY CHARACTER MAY BE
  362. OVERSTRUCK UP TO THREE TIMES.  ^OVERSTRIKING MAY BE USED ONLY
  363. WITHIN A WORD; THE OVERSTRIKE CHARACTER HAS NO MEANING BY ITSELF
  364. OR BEGINNING A WORD.
  365. .B <.FLAGOVER IS THE DEFAULT.  <.NOFLAGOVER TURNS IT OFF.
  366.  <.FLAGSIG
  367. .B ^THE <.FLAGSIG COMMAND ENABLES RECOGNITION OF _# (SHARP)
  368. AS THE SIGNIFICANT BLANK CHARACTER.  <.FLAGSIG IS THE DEFAULT.
  369. <.NOFLAGSIG TURNS IT OFF.
  370.  <.FRCPAGE
  371. .B ^THIS COMMAND IS USED INTERNALLY BY <RNF TO FORCE A PAGE
  372. EJECT.   ^THAT IS, IF A LINE IS ABOUT TO BE WRITTEN WHICH WOULD
  373. EXCEED THE PAGE SIZE, THE LINE IS SAVED, AND A <.FRCPAGE COMMAND
  374. IS EXECUTED AS THOUGH IT HAD BEEN ENCOUNTERED IN THE INPUT
  375. TEXT.
  376.  .B ^THE <.FRCPAGE COMMAND ITSELF INVOKES THE EQUIVALENT OF
  377. <.TOP, PRINTS THE NEXT PAGE HEADER, AND INVOKES THE EQUIVALENT
  378. OF <.MID.
  379. .B ^THE USER MAY ADD A FOOTER OR REFORMAT THE PAGE HEADER BY
  380. DEFINING A MACRO WITH THE NAME <.FRCPAGE.  ^THIS REPLACES THE
  381. <.FRCPAGE COMMAND, AND MUST INVOKE THE <.TOP AND <.MID COMMANDS
  382. (AND OPTIONALLY THE <.BOTTOM COMMAND) EXPLICITLY.   ^FOR CORRECT
  383. OPERATION, THE .U FIRST .NOU WORD IN THE <.FRCPAGE MACRO MUST
  384. BE EITHER <.BOTTOM OR <.TOP, AND THE LAST WORD SHOULD BE <.MID.
  385. .B ^NOTE THAT <.FRCPAGE DOES NOT RETURN, NOR CAN IT, SINCE A
  386. RETURN CAN CAUSE A PAGE EJECT, WHICH WILL CAUSE A <.FRCPAGE
  387. TO BE INVOKED RECURSIVELY.
  388. ^THE <.PAGE COMMAND DOES RETURN, AND IN FACT IS DEFINED AS
  389. <.BR <.FRCPAGE.
  390.  <.FMT N1 N2
  391. .B ^FORMATS THE VALUE OF N2 ACCORDING TO THE FORMAT CODE SPECIFIED
  392. BY N1.   ^N1 AND N2 MAY BE EXPRESSIONS (SEE ^CHAPTER 4).  ^N1 MUST
  393. BE IN THE RANGE 0 THROUGH 4, AND HAS A MEANING AS FOLLOWS:
  394. .SAV .LM +11 .TAB 20 .P -7 1 5
  395. .B
  396. .I -11 .U ^VALUE .T ^FORMATS#N2#AS... .NOU
  397.  0 .T ^ARABIC NUMBERS.   ^THAT IS, <.FMT 0 IS A NO-OP EXCEPT
  398. THAT IT FORCES OUTPUT OF N2.
  399.  1 .T ^ALPHABETIC CHARACTER OF VALUE CHR(N2).  ^IN THE <ASCII
  400. CHARACTER SET, N2=65 PRODUCES THE CHARACTER ^A, N2=66 PRODUCES
  401. ^B, ETC.  ^ON THE <CYBER SET, N2=1 PRODUCES
  402. THE CHARACTER <A, ETC.  ^IN THE <ASCII CHARACTER SET,
  403. THIS METHOD CAN BE USED TO PUT CONTROL CHARACTERS INTO THE OUTPUT,
  404. FOR EXAMPLE, CHARACTERS USED FOR PRINTER CONTROL.
  405.  2 .T ^LOWER CASE ALPHABETIC CHARACTERS.  ^ON THE <CYBER, N2=1 PRODUCES
  406. THE CHARACTER A, ETC.  (^IN THE <ASCII CHARACTER SET,
  407. THE ACTION IS THE SAME AS THAT OF FORMAT 1.)
  408.  3 .T ^UPPER CASE ^ROMAN NUMERALS.  (^THE NUMERALS PRODUCED
  409. ONLY MAKE USE OF THE CHARACTERS <X, <V, AND <I.)
  410.  4 .T ^LOWER CASE ^ROMAN NUMERALS.  (^THE NUMERALS PRODUCED
  411. ONLY MAKE USE OF THE CHARACTERS X, V, AND I.)
  412. .RES
  413.  <.HL N HEADING .RT (^RETURN)
  414. .B ^BEGINS A NEW SECTION WITH THE HEADING SPECIFIED AND AUTOMATICALLY
  415. NUMBERS IT.  ^THE N IN THE <.HL COMMAND MUST BE IN THE RANGE 1 THROUGH
  416. 5. ^SECTION NUMBERS HAVE THE FORM I.J.K.L.M.
  417. ^IF A <.CH COMMAND PRECEEDED THE <.HL COMMAND, I IS THE CHAPTER NUMBER;
  418. OTHERWISE IT IS THE NUMBER OF <.HL 1 COMMANDS.
  419. ^WITHIN ^CHAPTER 2, THE SEQUENCE <.HL#1, <.HL#2, <.HL#3, <.HL#3, <.HL#2,
  420. <.HL#1 PRODUCES SECTIONS NUMBERED 2.1, 2.1.1, 2.1.1.1, 2.1.1.2, 2.1.2,
  421. AND 2.2.
  422. .B ^THREE BLANK LINES ARE LEFT BEFORE EACH SECTION, AND TWO BLANK
  423. LINES FOLLOW THE SECTION HEADER.
  424.  <.I #N .RT (^RETURN)
  425. .BR .I -4 <.I +N .RT (^RETURN)
  426. .BR .I -4 <.I -N .RT (^RETURN)
  427. .B ^INDENT THE FOLLOWING LINE.   ^IF N IS SPEC^IFIED, IT INDICATES THE
  428. COLUMN NUMBER AT WHICH THE LINE IS TO BEGIN.  ^IF +N OR -N ARE
  429. SPECIFIED, THE INDENT IS PLUS OR MINUS N CHARACTERS FROM THE LEFT
  430. MARGIN.
  431.  <.IF EXPRESSION TEXT
  432. .B ^THE <.IF COMMAND TESTS THE VALUE OF THE EXPRESSION. ^IF IT
  433. IS ZERO, THE TEXT ON THE REMAINDER OF THE LINE IS SKIPPED; OTHERWISE
  434. THE TEXT IS SCANNED NORMALLY.  <.IF PROVIDES A SINGLE LINE CONDITIONAL
  435. CAPABILITY.
  436. .B ^FOR A DEFINITION OF EXPRESSIONS ACCEPTABLE TO <.IF, SEE
  437. ^CHAPTER 4, <VARIABLES.
  438.  <.INCLUDE FILENAME
  439. .B ^PROCESS TEXT FROM THE NAMED FILE.  ^WHEN <EOF IS REACHED ON THAT
  440. FILE, RESUME PROCESSING THE CURRENT FILE.  ^INCLUDE FILES CAN BE
  441. ESPECIALLY USEFUL FOR A COMMONLY-USED MACRO LIBRARY.  ^INCLUDE FILES
  442. CANNOT BE NESTED.
  443.  <.J
  444. .B ^JUSTIFY TEXT AT THE RIGHT MARGIN.  ^THIS IS THE DEFAULT.
  445. ^JUSTIFICATION IS ACCOMPLISHED BY INSERTING EXTRA BLANKS BETWEEN
  446. WORDS WHEN NECESSARY.  (^NOTE THAT A SIGNIFICANT BLANK, THE
  447. _# CHARACTER, IS NEVER EXPANDED.)# <.NOJ TURNS JUSTIFICATION OFF.
  448.  <.LE .RT (^RETURN)
  449. .B ^BEGINS A LIST ELEMENT.  ^THE ELEMENT IS AUTOMATICALLY NUMBERED
  450. AND INDENTED.  ^SEE THE <.LIST AND <.ENDLIST COMMANDS.
  451.  <.LINES N
  452. .B ^SETS THE NUMBER OF LINES IN THE OUTPUT PAGE,
  453. INCLUDING THE TOP AND BOTTOM MARGINS.  <DEFAULT N IS 66.  ^THE
  454. CORRECT SETTING FOR 6 LINE PER INCH DEVICES USING 8 LINE PER INCH
  455. PAPER IS 51.
  456.  <.LIST N .RT (^RETURN)
  457. .B ^BEGINS A LIST WITH N SPACING.  ^EACH ELEMENT OF THE LIST
  458. IS AUTOMATICALLY NUMBERED BEGINNING AT 1.  ^LISTS MAY BE NESTED
  459. WITHIN LISTS, FOR UP TO 5 LEVELS.  ^A LIST IS TERMINATED BY
  460. A <.ENDLIST COMMAND.  ^EACH LIST IS INDENTED ON THE RIGHT; THE
  461. OUTERMOST LIST IS INDENTED 9 CHARACTERS, AND EACH INNER LIST
  462. IS INDENTED 4 MORE.
  463.  <.LM N
  464. .B ^SET THE LEFT MARGIN TO N.
  465. ^N MUST BE IN THE RANGE 1 THROUGH 136 (IN PARTICULAR, <.LM 0
  466. IS FLAGGED AS AN ERROR).
  467. ^SEE <.RM ALSO.
  468.  <.MACRO NAME ##= TEXT
  469. .BR .I -4 <.MACRO NAME N = TEXT
  470. .BR .I -4 <.MACRO NAME * = TEXT
  471. .B ^DEFINES A MACRO WITH THE NAME SPECIFIED EQUAL TO THE TEXT ON THE
  472. REMAINDER OF THE SAME LINE.  ^WHEN _.NAME IS ENCOUNTERED LATER, THE TEXT
  473. IS SUBSTITUTED FOR IT.
  474. .B ^IF N, AN INTEGER FROM 1 TO 7, IS SPECIFIED, IT INDICATES THE MACRO
  475. HAS N ARGUMENTS.  ^THIS IMPLICITLY DEFINES MACROS NAME1,NAME2...NAMEN,
  476. WHICH HAVE A TEXT VALUE EQUAL TO THE N WORDS WHICH FOLLOW THE MACRO WHEN
  477. IT IS INVOKED.
  478. .B ^IF * IS SPECIFIED, IT INDICATES THAT THE MACRO HAS ONE ARGUMENT.
  479. ^THE ARGUMENT IS THE IMPLICITLY DEFINED MACRO NAME1, AND HAS A TEXT
  480. VALUE EQUAL TO THE ENTIRE REST OF THE LINE ON WHICH THE MACRO IS
  481. INVOKED.
  482. .B ^FOR AN EXTENDED DISCUSSION AND EXAMPLES, SEE ^CHAPTER 3, <MACROS.
  483.  <.MID .RT (^RETURN)
  484. .B ^THE <.MID COMMAND ENDS A USER-DEFINED <.FRCPAGE MACRO.
  485. <.MID OUTPUTS ANY DEFERRED TEXT, FOLLOWED BY ANY LINES SAVED
  486. PRIOR TO <.FRCPAGE, THEN SETS THE BEGINNING OF USER TEXT
  487. TO THE CURRENT LINE.  ^THIS LATTER SUPPRESSES BLANK LINES
  488. AT THE "TOP OF THE PAGE" CAUSED BY EITHER <.S OR <.B.
  489.  <.NMP
  490. .B ^NUMBER PAGES.  ^THIS IS THE DEFAULT; <.NONMP TURNS IT OFF.
  491.  <.P #N S T
  492. .BR .I -4 <.P +N S T
  493. .BR .I -4 <.P -N S T
  494. .B ^SETS PARAGRAPHING CONVENTIONS.  ^N, S AND T ARE NUMBERS.
  495. ^N SETS THE PARAGRAPH INDENT AND WORKS LIKE THE <.I COMMAND.
  496. ^S SETS THE SPACING BETWEEN PARAGRAPHS, WHERE 1 IS SINGLE SPACED,
  497. 2 IS DOUBLE SPACED, ETC.  ^T SETS AN AUTOMATIC <.TP T BEFORE
  498. EACH PARAGRAPH.  ^SEE ALSO THE <.PP AND <.AP COMMANDS.
  499.  <.PAGE .RT (^RETURN)
  500. .B ^BEGINS A NEW PAGE. ^DO <NOT DO A <.PAGE BEFORE WRITING
  501. TEXT FIRST.  ^IF YOU MUST DO A PAGE EJECT BEFORE
  502. ANY TEXT IS GENERATED USE  .NOFLAGSIG ##### .FLAGSIG   <.PAGE
  503.  <.PERIOD
  504. .B ^LEAVE AN EXTRA BLANK AFTER _., _!, OR _?.  ^THIS IS THE DEFAULT.
  505. ^IT MAY BE SUPPRESSED BY <.NOPERIOD.
  506.  <.PNO N
  507. .B ^NUMBER THE NEXT PAGE N.
  508.  <.PP .RT  (^RETURN)
  509. .B ^BEGIN A NEW PARAGRAPH.
  510.  <.PAGESIZE L R
  511. .B ^SETS THE PAGE SIZE TO L LINES OF TEXT, NOT COUNTING THE LINES
  512. AT THE TOP MARGIN, AND THE PAGE NUMBER RIGHT MARGIN TO R.
  513. ^SEE ALSO THE <.LINES COMMAND.
  514.  <.REM TEXT
  515. .B ^THE <.REM COMMAND AND ALL TEXT WHICH FOLLOWS IT ON THE SAME
  516. INPUT LINE IS TREATED AS A REMARK (COMMENT).  ^THE TEXT IS
  517. NOT COPIED TO THE OUTPUT.
  518.  <.RES .RT (^BREAK)
  519. .B ^RESTORES THE MARGINS, FILL AND JUSTIFY MODES, PARAGRAPH
  520. SETTINGS, SPACING, AND TAB STOPS TO THEIR STATE AS OF THE
  521. LAST <.SAV COMMAND.
  522.  <.RESPAG .RT (^RETURN)
  523. .B ^LIKE <.RES; REPLACES THE MARGINS, FILL AND JUSTIFY MODES,
  524. PARAGRAPH SETTINGS, SPACING, AND TAB STOPS TO THEIR STATE
  525. AS OF THE LAST <.SAVPAG COMMAND.  ^RESTORES THE PAGE ENVIRONMENT,
  526. WHICH IS USED TO ALIGN TITLES AND PAGE NUMBERS.
  527.  <.RIGHT N .RT (^RETURN)
  528. .B ^SHIFT OUTPUT TEXT RIGHT N SPACES.  THE <.RIGHT SPACES PRECEDE
  529. THOSE CAUSED BY THE <.BAR COMMAND.
  530.  <.RM N
  531. .B ^SETS THE RIGHT MARGIN TO COLUMN N.
  532.  <.RT
  533. .B ^RIGHT TAB.   ^CAUSES THE FOLLOWING WORD TO BE RIGHT JUSTIFIED
  534. (END IN) THE NEXT TAB STOP.  ^SEE THE <.TABS AND <.T COMMANDS.
  535. ^THIS IS USEFUL FOR TABLES OF NUMERIC DATA.
  536.  <.S .RT (^RETURN)
  537. .BR .I -4 <.S N .RT (^RETURN)
  538. .B ^LEAVE N+1 TIMES SPACING BLANK LINES, WHERE SPACING IS SET BY THE
  539. <.SP COMMAND.  <.S DOES NOTHING AT THE BEGINNING OF A PAGE.
  540. <.S AND <.S#1 ARE EQUIVALENT.
  541.  <.SAV
  542. .B ^SAVE THE CURRENT MARGINS, FILL AND JUSTIFY MODES, PARAGRAPH
  543. SETTINGS, SPACING, AND TAB STOPS -- WHICH ARE COLLECTIVELY
  544. CALLED THE "ENVIRONMENT".  ^THE ENVIRONMENT IS RESTORED BY
  545. THE <.RES COMMAND.  <.SAV AND <.RES CAN BE NESTED.
  546. .B ^FOR MOST TEXT, THERE ARE TWO ACTIVE ENVIRONMENTS: THE
  547. CURRENT VALUE AND THE "PAGE ENVIRONMENT".  ^THE LATTER CONTROLS
  548. THE PRINTING OF TITLES AND PAGE NUMBERS AT THE HEAD OF EACH
  549. PAGE.
  550. .B
  551. ^NOTE THAT <.HL, <.CH, OR <.RESPAG RESET THE ENVIRONMENT TO
  552. THE PAGE ENVIRONMENT AND DISCARD ANY ACTIVE <.SAV<S.  ^SEE THE
  553. <.SAVPAG AND <.RESPAG COMMANDS.
  554.  <.SAVPAG
  555. .B ^LIKE <.SAV, EXCEPT <.SAVPAG REPLACES THE PAGE ENVIRONMENT.
  556. ^IF NO EXPLICIT <.SAVPAG IS DONE, THE ENVIRONMENT AT THE
  557. FIRST <.HL OR <.CH COMMAND BECOMES THE PAGE ENVIRONMENT.
  558.  <.SIG
  559. .B ^TREAT SUCCESSIVE BLANK CHARACTERS AS WORDS, AND STOP ALL AUTOMATIC
  560. BLANK PLACEMENT.  ^USED IN CONJUNCTION WITH <.NOJ AND <.NOF, IT
  561. PERMITS A SORT OF "AS IS" MODE IN WHICH, HOWEVER, COMMANDS AND FLAGS
  562. ARE RECOGNIZED.
  563. <.NOSIG IS THE DEFAULT.
  564.  <.SP N
  565. .B ^SET THE SPACING BETWEEN LINES FORCED OUT BY FILLING TO N, WHERE
  566. 1 IS SINGLE SPACING, 2 IS DOUBLE SPACING, ETC.
  567.  <.ST TEXT .RT (^RETURN)
  568. .B ^THE TEXT WHICH FOLLOWS THE <.ST COMMAND ON THE SAME LINE IS USED
  569. AS A SUBTITLE ON THE NEXT AND SUCCEEDING PAGES.
  570.  <.STD
  571. .B ^SETS <.F, <.NOFLAG, <.NOFLAGCAPS, <.ESC, <.PERIOD, <.J,
  572. <.UL, <.NOSIG, AND AUTOMATIC RETURNS BEFORE THE <.C, <.TITLE, <.ST,
  573. AND <.I COMMANDS.  <.SIG IS THE DEFAULT; <.NOSIG DOES THE OPPOSITE.
  574.  <.SUP
  575. .B ^SUPPRESSES (THROWS AWAY) ANY TEXT ALREADY IN THE CURRENT OUTPUT
  576. LINE, AND ANY TEXT ON THE SAME INPUT LINE AS THE <.SUP COMMAND.
  577.  <.T
  578. .B ^BEGIN THE NEXT WORD AT THE NEXT TAB STOP.  ^SEE ALSO THE <.TABS
  579. AND <.RT COMMANDS.
  580.  <.TABS T1 T2 _... T15
  581. .B ^SET UP TO 15 TAB STOPS IN COLUMNS T1, T2, ETC.  ^THE TAB STOPS
  582. MUST BE IN ASCENDING ORDER.  ^TABBING IS DONE BY THE <.T AND <.RT
  583. COMMANDS.
  584.  <.TITLE TEXT .RT (^RETURN)
  585. .B ^SETS THE TEXT WHICH FOLLOWS <.TITLE ON THE SAME LINE AS THE
  586. TITLE ON THE NEXT AND SUCCEEDING PAGES.
  587.  <.TOP
  588. .B ^SPACES TO THE TOP OF THE NEXT PAGE
  589. AND RESETS THE LINE COUNTER.
  590. .B <.TOP IS ONLY TO BE USED WHEN OVERRIDING THE DEFAULT PAGE
  591. HANDLING.  ^THE <.PAGE COMMAND IS USED FOR EJECTING A PAGE NORMALLY.
  592.  <.TP N .RT (^RETURN)
  593. .B ^TESTS WHETHER N LINES REMAIN ON THE CURRENT PAGE.  ^IF NOT,
  594. <.TP EJECTS A PAGE.  ^NOTE THAT <.TP IS AFFECTED BY SPACING
  595. IN THAT THE ACTUAL NUMBER OF LINES TESTED FOR IS N TIMES
  596. SPACING MINUS ONE.
  597.  <.U
  598. .B ^UNDERLINE THE NEXT AND SUCCEEDING WORDS IN THE OUTPUT TEXT.
  599. ^TERMINATED BY THE <.NOU COMMAND.
  600.  <.UL
  601. .B <.UL SPECIFIES THAT OUTPUT IS TO BE PRODUCED IN UPPER/LOWER CASE
  602. (<ASCII MODE).   ^THIS IS THE DEFAULT.  <.NOUL PRODUCES OUTPUT
  603. IN ALL UPPER CASE.
  604.  <.VAR VARIABLENAME
  605. .B ^DECLARES A VARIABLE WITH THE NAME SPECIFIED.
  606. ^VARIABLE NAMES MUST BEGIN WITH A _$, AND OTHERWISE CONSIST OF
  607. LETTERS, NUMBERS, OR _$ CHARACTERS.  ^THE SECOND CHARACTER
  608. OF A VARIABLE NAME MAY NOT BE A DIGIT.   ^THE VARIABLE HAS THE
  609. INITIAL VALUE ZERO.
  610.  <.X
  611. .B ^EXTEND THE PRECEDING WORD ON THE OUTPUT LINE WITH THE FOLLOWING
  612. WORD.  ^WORDS JOINED BY <.X ARE OUTPUT ON THE SAME LINE WITH NO
  613. BLANKS BETWEEN THEM.  <.X IS PRIMARILY USEFUL FOR JOINING TEXT
  614. GENERATED BY A MACRO TO PUNCTUATION ON EITHER SIDE OF IT.
  615. .MACRO CHTTL = ^MACROS
  616. .CH <MACROS
  617. ^USER-DEFINED <RNF MACROS PROVIDE A MEANS OF:
  618. .BDOT
  619. .DOT ^EXTENDING THE SET OF <RNF COMMANDS BY ADDING MACROS TAILORED
  620. TO A SPECIFIC APPLICATION.
  621. .DOT ^ABBREVIATING COMMONLY USED SERIES OF <RNF COMMANDS.
  622. .DOT ^ABBREVIATING COMMONLY USED PHRASES OR LONG WORDS.
  623. .EDOT
  624. ^FOR EXAMPLE, THE FOLLOWING MACRO DEFINITIONS WERE USED TO PRODUCE
  625. THE DOTTED LIST ABOVE:
  626. .MACRO EX = .SAV .LM +9 .NOF .NOJ .S 1
  627. .MACRO EEX = .RES .S 1
  628. .EX <.MACRO <BDOT = <.SAV <.P -2 1 5 <.LM +5
  629. <.MACRO <DOT = <.PP __._# <.X
  630. <.MACRO <EDOT = <.RES <.S 1
  631. .EEX
  632. WHILE THE FOLLOWING TWO MACROS WERE USED TO FORMAT THE ABOVE
  633. (AND FOLLOWING) EXAMPLES:
  634. .EX <.MACRO <EX = <.SAV <.LM +9 <.NOF <.NOJ <.S 1
  635.