home *** CD-ROM | disk | FTP | other *** search
/ Simtel MSDOS 1992 June / SIMTEL_0692.cdr / msdos / editor / gal210a4.arc / APPC.GAL < prev    next >
Encoding:
Text File  |  1987-08-05  |  32.4 KB  |  558 lines

  1. .a js=y nm=1 pn=1 ad=n hy=n lp=12 bo=51 te=12 to=90
  2. .st3,14,1
  3. &dAppendix%C:%%Galahad%Printing%Formatter  .jc .b3
  4. &d[%Appendix%C%] .hc
  5. .t36 C -  .zl
  6.  
  7.  
  8.  
  9. &DINTRODUCTION .jr .b
  10. .st3,11,1 .x-5 .b2
  11.  
  12. .p This Appendix is the complete reference for &iall of the Galahad commands to
  13. control the printed text, i.e, process words.  These are called the Text
  14. Command which are divided into two parts, called Command Symbols, and Command
  15. Words.
  16. .b
  17.  
  18. .p Before we discuss the Text Command we will first amplify on the Printing
  19. Commands discusses in Chapters One and Five. .b4
  20.  
  21.  
  22.  
  23.  
  24.  
  25. .st3,14,1 .b
  26. &DGALAHAD%PRINTING%COMMANDS .jr
  27. .st3,11,1 .x-5 .b2
  28.  
  29. .p Galahad has two commands to print text: PRINT and LIST.  Both of these
  30. commands allow the printed text to be sent to a &iprinter, the &idisplay%screen
  31. or a &idisk%file.  The LIST command simply lists the text as it appears.  That
  32. is, LIST does not cause Galahad to process the dot command.  This printing
  33. command prints the text exactly as it appears while editing, thereby printing
  34. the dot commands themselves.
  35. .b
  36.  
  37. .p The PRINT command is the normal means of printing Galahad text.  This
  38. command causes Galahad to format the text as specified by the Dot and other
  39. formatting commands.  The two printing commands are discussed next. .b2
  40. .std3,13,1
  41.  .p LIST D F L .b .st3,11,1
  42.  .p The command LIST causes the current text to be printed (or displayed on
  43. the screen).  LIST has three arguments, all of which are optional.  .b
  44.  
  45. .p The first argument D, specifies the device upon which the text is to be
  46. printed.  The screen device is CON: and the hard copy printer is either PRN: or
  47. LST:, both act the same.  The device AUX: is the modem port.  Alternatively, a
  48. filename may be specified.  In that case the text will be stored in the
  49. specified file.  If the device is not specified the screen is assumed. .b
  50.  
  51. .p The second argument F, selects the line number in the text where
  52. printing will start.  If F is omitted then printing starts at line 1.  The
  53. third argument specifies the last line number to be printed.  When LISTing is
  54. done to any device except CON: the printer OPTIONS are used.  That is, a left
  55. margin is printed, and a top and bottom margin is provided, these parameters
  56. are specified with the OPTIONS command. .b
  57. .n
  58.  .p When LISTing is done on the screen (CON:), Galahad only allows one screen
  59. full of output to be displayed, and then the printing stops.  The display of
  60. the output may be continued by pressing any key.  While in this paging mode the
  61. display is stopped each time the screen is filled.  Should continous display
  62. be desired, press the CTRL-O key prior to using the LIST commmand.  The CTRL-O
  63. key is a toggle that turns on and off the paging mode of display, thus the
  64. paging mode can be re-entered by again pressing CTRL-O.  When the paging mode
  65. is off, the display may be stopped at any time by pressing the CTRL-S key.  The
  66. display is restarted by pressing any key. .b3 .i25
  67.  
  68. .u &oExamples: .b
  69.  .u15 LIST .t25 All text is printed on the screen. .b
  70.  .u15 LIST PRN: .t25
  71. All text is printed on the MS-DOS PRN: device. .b
  72.  .u15 LIST 5 .t25 Displays the text at line 5 on the screen. .b
  73.  .u15 LIST AUX: 10 .t25 Print the text at line 10 on the MS-DOS modem port.
  74. .b
  75.  .u15 LIST LST:,,50 .t25 Print the text starting at line 1 through line 50 on
  76. the MS-DOS LST: device (LST: is the same as PRN:). .b
  77.  .u15 LIST ,,30 .t25 Display the text starting at line 1 through line 30 on
  78. the screen. .b
  79.  .u15 LIST 30 400 .t25 Display the text from lines 30 through line 400 on the
  80. screen. .b3 .i0
  81. .sto3,11,1
  82. .n NOTE: A "," Is needed only to separate arguments which are not specified.
  83. LIST CON:,3,4 is equivalent to LIST CON: 3 4 but LIST CON: 4 is not the same as
  84. LIST CON:,,4. .b2
  85. The LISTing process can be aborted at any time by pressing the CTRL-C key. .b3
  86.  
  87. .std3,13,1
  88.  .p PRINT D PS PE N .b .st3,11,1
  89.  .p The command PRINT causes the current text to be printed (or displayed on
  90. the screen) according to the commands embedded in the text.  PRINT has three
  91. arguments, all of which are optional. .b
  92.  
  93. .p The first argument D, specifies the device upon which the text is to be
  94. printed.  This argument is identical to that of the LIST command.  The possible
  95. devices are CON:, PRN:, LST:, AUX:.  Alternatively, a filename may be
  96. specified.  In that case the text will be stored in the specified file.  If a
  97. device is not specified the screen is assumed. .b
  98.  
  99. .p The second argument PS, selects where in the text printing will start.  If
  100. PS is greater than 1 printing is suppressed until all pages up to PS have been
  101. processed.  Printing then begins on page PS.  The pages do not have to be
  102. numbered to use this feature.  This option avoids printing unwanted pages in
  103. case of a re-print.  If PS is not specified, page 1 is assumed.  If the third
  104. argument PE is specifed printing will stop after printing page number PE.  If
  105. PE is not specified the entire document is printed. .b
  106.  
  107. .p The fourth argument is used only with the =.F command.  It specifies how
  108. many files are to be printed.  It is useful when less than a full set of files
  109. is to be printed.  Printing will halt after N number of files have been
  110. processed, or there are no more files to process.  .b .i29 .b
  111.  
  112.  .n10 .u &oExamples: .b
  113.  .u19 PRINT .t29 All text is printed on the screen. .b
  114.  .u19 PRINT PRN: .t29 All text is printed on the PRN: (printer) device. .b
  115.  .u19 PRINT 5 .t29 Print the text starting at page 5 to the end, on the
  116. screen. .b 
  117.  .u19 PRINT PRN: 10 20 .t29 Print the text
  118. starting at page 10 on the printer, and stops after page 20. .b
  119.  .u19 PRINT LST:,,,5 .t29 Print the text which is held in 5 files, starting at
  120. the first page, on the LST: device (this is only required when =.F is
  121. specified at the end of each file). .b
  122.  .u19 PRINT ,,,3 .t29 Print the text which is held in 3 files, starting at the
  123. first page, on the screen. .b 
  124.  .u19 PRINT PRN: 3,,4 .t29 Print the text held in 4 files on the PRN:
  125. device, starting at page 3. .b2 .i0
  126. .sto3,11,1
  127. NOTE: A "," Is needed only to separate arguments which are not specified.
  128. PRINT PRN:,3,4 is equivalent to PRINT PRN: 3 4, but PRINT LST: 4 is not the
  129. same as PRINT LST:,,4. .b2
  130. .st3,11,1
  131.  .p When PRINTing is done on the screen, Galahad only allows one screen full
  132. of output to be displayed, and then the printing stops.  The display of the
  133. output may be continued by pressing any key.  While in this paging mode the
  134. display is stopped each time the screen is filled.  Should continous display
  135. be desired, press the CTRL-O key prior to using the PRINT commmand.  The CTRL-O
  136. key is a toggle that turns on and off the paging mode of display, thus the
  137. paging mode can be re-entered by again pressing CTRL-O.  When the paging mode
  138. is off, the display can be stopped at any time by pressing the CTRL-S key.  The
  139. display is re-started by pressing any key. .b
  140.  .p When the print command is to be executed on a hard copy device, before
  141. the command is given, align the top of the page with the top of the print head.
  142. Printing will proceed as soon as the PRINT command is given.  In case printing
  143. from other than the first page has been specified, it will take a while to get
  144. to the desired page.  When the first page to be printed has been reached,
  145. printing will begin immediately. .b
  146. .n .p The PRINTing process can be aborted at anytime by pressing the CTRL-C
  147. key. .b6
  148.  
  149. .st3,14,1
  150. &DGALAHAD%TEXT%COMMANDS .jr .b3
  151. .st3,11,1 .x-5
  152.  .p The Galahad Text Commands consist of symbols entered into the text to
  153. control the printing format.  There are two classes of commands, called Command
  154. Symbols and Command Words.  The command words are identified as a command by a
  155. leading ".", such as =.B, the command symbols are simply symbols placed in the
  156. text.  These commands are described next. .b3
  157.  
  158. .std3,12,1
  159. .n5 Command Symbols .b2
  160. .st3,11,1
  161.  .p The Command Symbols are concatenated with the words of the text to achieve
  162. desired print format.  For example, =&B is a command symbol which when placed
  163. in front of a word causes it to be a subscript: H=&B2  prints as H&B2 .b2
  164. .i8
  165.  
  166.  .u =_ .t8 (=_) Forces the next word to be _underlined&s. .b2
  167.  .u =@ .t8 Forces the previous charac\ter to be overstruck
  168.  with the next charac\ter. .b Both overstrike (=@) and _underline (=_)
  169. can be used on the same line, and the same charac\ters only when =.A IP==Y
  170. and Galahad is configured for the proper printer. .b2
  171.  .u =% .t8 Used to produce a single space in the output.  It is used to
  172. prevent the justification process from adding extra spaces.  When the text is
  173. processed the =% is printed as a space.  It is also used to cause
  174. underline, italics and double-strike to go across multiple words. .b2
  175.  .u =\ .t8 Used to produce, or correct, hyphenation in the printed output
  176. text.  If the hypenation rules produce improper hyphenation a "=\" may be
  177. inserted in the correct position of the word.  In case a "=\" is inserted in a
  178. word and then later through text editing the word is no longer at the right
  179. margin the "=\" will do no harm.  That is, in a word that does not require
  180. hyphenation a "=\" is ignored.  In case a word is not to be hyphenated a
  181. leading "=\" signifies no hyphenation. .b2
  182.  .u == .t8 Forces the following charac\ter to be printed.  This allows the
  183. command charac\ters being described here to be printed as charac\ters in the
  184. text. .b3
  185.  .u =& .t8 Forces the next charac\ter to be interpreted as a
  186. command.  The command may be input in upper or lower case.  .b2
  187.  .u =&P .t8 Forces the rest of the word to be a &psuper&nscript. .b2
  188.  .u =&B .t8 Forces the rest of the word to be a &bsub&nscript. .b2
  189.  .u =&N .t8 Stops &bsub&n/&psuper&n-scripting
  190. before the end of a word. .b2
  191.  .u =&D .t8 Prints the next word by &DBoldfacing it (Double Striking). .b2
  192.  .u =&I .t8 Prints the next word in &IItalics. .b2
  193.  .u =&O .t8 Prints the next word in &OThe%Other format.  This =& symbol effect
  194. may be defined by the user of Galahad.  (See Appendix D). .b2
  195.  .u =&S .t8 Stops the _under&sscoring and &iitalics at any point in a word. .b2
  196.  .u =&T .t8 Stops the &dbold%fac&ting and &oother at any point in a word. .b2
  197.  .u =&U .t8 Start underlining the following word.  The same as =_. .b3
  198. .i0
  199.  
  200. .std3,12,1
  201. .n4 Command Words .b2
  202. .st3,11,1
  203.  .p Command Words may appear on a line by themselves or interspersed between
  204. words. .b3
  205.  
  206. .std3,12,1
  207. The Dot A Command
  208. .st3,11,1
  209. .b2 .i13
  210. .n4 .u10 =.A <command string> .b
  211.  =.A is the symbol that indicates that a string
  212. of control commands follow.  These control commands set the margins, printed
  213. line length, spacing between lines, etc.  A <command string> is a sequence of
  214. commands separated by commas (or spaces) and ended with a semicolon or end of
  215. line.  Each command is two charac\ters followed by "==" followed by a value. 
  216. The value may be a number or else "Y", "N" or "D", meaning YES, NO or DEFAULT
  217. respectively.  A "D" is used to return a command to its default value. An
  218. example of a command is: .b2
  219.  %%=.A SP==2,LM==8,LL==76; .b2
  220.  where: SP==2 means set the spacing between lines to 2, i.e. double spacing,
  221. LM==8 means set the left margin to 8 spaces in from the edge of the paper,
  222. LL==76 means set the printed line length to 76 charac\ters. .b2
  223.  Below is a list for all of the commands, the type of value to be entered, the
  224. value used for the command if the command is not present in the text (i.e. the
  225. default value), and the meaning of the command. .b2
  226.  .u3 AD - Y or N - Y .b AD (Automatic Dot) is set to Y to provide
  227. =.P and =.B automat\ically.  When AD==Y the text is entered as one would on a
  228. typewriter using indenting on the left margin for a paragraph, and using blank
  229. lines to separate paragraphs.  The rules for the use of AD==Y are this: 1) All
  230. spaces are preserved starting at the left margin to the first word on each
  231. line.  Spaces in the rest of the line are not preserved unless PS==Y is used.
  232. 2) A =.B is supplied automatically when a line is not completely filled out.
  233. That is, a =.B is provided whenever the first word on the next line could have
  234. fit at the end of the current line.  When using text written in Galahad Version
  235. 1.0+, set AD==N and Galahad II will process text as Galahad I did. .b2
  236.  .n3 .u3 AH - Number - 3 .b AH (After Heading) is the number of blank lines
  237. after the heading, if present.  If no heading is present a blank line is
  238. printed in its place.  If AH==0 no heading will be printed even is specified
  239. by a =.H command. .b2
  240.  .n3 .u3 AL - Y or N - N .b AL (Automatic Link) is set to Y when multiple text
  241. files are to be PRINTed consecutively.  In case AL==Y and text is being
  242. printed, when the end of the text has been printed, the last charac\ter of
  243. the last file name LOADed is incremented by one.  Then that file name is
  244. searched for in the disk directory.  If it is found that file is automatically
  245. LOADed and PRINTing continues. This process continues until the created file
  246. name is not found, then printing is terminated.  In case the last charac\ter of
  247. the file name is an alphabetic charac\ter, the next letter of the alphabet is
  248. used as the last letter of the file name.  For example: the file printed after
  249. MYFILE is MYFILF. .b2 
  250.  .n3 .u3 AN - number - 3 .b AN (after page Number) is the number of blank
  251. lines after the page number.  If no page number is requested a blank line is
  252. printed in its place. .b2
  253.  .n3 .u3 BE - Number - 0 .b BE (Bottom Even) is the ABSOLUTE printed page
  254. column that the page number is to be placed in the footer.  If both BE
  255. and BO are a number other than 0, BE specifies in which column the even page
  256. numbers are to appear. (See Page Numbering below). .b2
  257.  .n3 .u3 BH - Number - 3 .b BH (Before Heading) is the number of blank lines
  258. printed before the heading line. .b2
  259.  .n3 .u3 BN - Number - 2 .b BN (Before page Number) is the number of blank
  260. lines printed before the page number line. .b2
  261.  .n3 .u3 BO - Number - 50 .b BO (Bottom Odd) is the ABSOLUTE printed page
  262. column that the page number is to be placed in the footer.  If both BE
  263. and BO are a number other than 0, BO specifies in which column the odd page
  264. numbers are to appear. (See Page Numbering below). .b2
  265.  .n3 .u3 C2 - Number - 0 .b C2 (Column 2) enables two column printing, and is
  266. the desired left margin width when printing the second column.  It is similar
  267. to the LP command which sets the left margin for printing in normal single
  268. column mode.  Typically, C2==50.  A 50 character margin would place the second
  269. column near the center of the paper.  Two column mode is disabled when C2==0,
  270. and is active when C2 is greater than 0.  On a Laser printer two column output
  271. will be produced.  On non-laser printers each column will be printed on
  272. separate sheets of paper.  When printed to the screen all columns are printed
  273. at the value of LM, but when the second (or third column) is printed the
  274. command line indicates which column is being displayed. .b2
  275.  .n3 .u3 C3 - Number - 0 .b C3 (Column 3) enables three column printing, and is
  276. the desired left margin width when printing the third column.  Three column
  277. mode can only take place if two column mode has been enabled.  Three column
  278. mode is disabled when C3==0. .b2
  279.  .n3 .u3 CL - Y or N - Y .b CL (Conditional Line) is set to Y when the text
  280. and command words following =.Cn to the end of n of lines are to be PRINTed.
  281. .b2
  282.  .n3 .u3 CT - Y or N - Y .b CT (Conditional Text) is set to Y when the text
  283. between =.[ and =.] is to be PRINTed. .b2
  284.  .n3 .u3 DB - Y or N - N .b DB (DeBug text) when set to Y prints the text
  285. line numbers on the status line as the text is printed.  This allows you to
  286. easily find an error in the text.  (See GoToLine command).  .b2
  287.  .n3 .u3 HL - Number - 0 .b HL (Header Length) is set to the desired length of
  288. the PRINTed header and footer line.  Normally the header/footer line length is
  289. the same as the text length (LL).  Since this is the case if HL==0 the LL is
  290. the printed line length for the text, the header and the footer.  When two and
  291. three column text is printed it is usually necessary to have a different line
  292. length for the header and footer.  HL sets this length. .b2
  293.  .n3 .u3 HY - Y or N - Y .b HY (Hyphenation) is set to Y to produce hyphenated
  294. words at the right margin of the text when required. .b2
  295.  .n3 .u3 IP - Y or N - Y .b IP (Intelligent Printer) is set to Y when the
  296. printer for which Galahad has been configured is to be used as
  297. the printing device, &iotherwise%set%IP==N. This is useful with printing to
  298. a file which is to be printed by some unknown printer at a later time. .b2
  299.  .n3 .u3 JS - Y or N - N .b JS (JuStify) is set to Y if the text is to be
  300. righthand justified.  If N is specified the PRINTed lines are filled up to the
  301. requested line length but not justifed to the right. .b2
  302.  .n3 .u3 LL - Number - 78 .b LL (Line Length) is set to the desired length of
  303. the PRINTed text line. .b2
  304.  .n3 .u3 LM - Number - 0 .b LM (Left Margin) is set to the desired number of
  305. spaces in the text left margin (that is, the width of the left margin) when
  306. displayed on the screen. .b2
  307.  .n3 .u3 LP - Number - 15 .b LP (Line length for Printer) is set to the
  308. desired left margin width when printed on any device except the screen.  This
  309. allows separate control of the left margin when displaying on the screen and
  310. when printing on the hard copy device. .b2
  311.  .n3 .u3 MC - Number - 60 .b ML (Master Character)  is only concerned with Laser
  312. Printers.  It has no effect for normal printers.  MC is a special laser setting
  313. to allow the expert Galahad user to change the meaning of the number of
  314. character positions (columns) across a page.  It is 10 times the number of
  315. points assumed for each column position.  Since 12 characters per inch is
  316. the usual "pitch" for printers and typewriters, MC==60.  That is, 6 points per
  317. character. .b2
  318.  .n3 .u3 ML - Number - 12 .b ML (Master Line) is only concerned with Laser
  319. Printers.  It has no effect for normal printers.  ML is a special laser setting
  320. to allow the expert Galahad user to change the meaning of the number of lines
  321. per page.  It is the number of points assumed for a printed line.  The value of
  322. 12 times 66 lines per page is the length of an 11 inch sheet of paper. .b2
  323.  .n3 .u3 NM - 0,1,2 - 0 .b NM (NuMbering type) is the type of page number to be
  324. printed.  0 indicates no page numbers, 1 indicates Arabic numbers, and 2
  325. indicates lowercase Roman numbers up to x (after x the numbering reverts to
  326. Arabic 0).  See discussion of page numbers below. .b2
  327.  .n3 .u3 PL - Number - 66 .b PL (Page Length) is set to the maximun number of
  328. lines that could be printed on the page if every line was used.  Only in
  329. &overy%rare circumstances should PL be anything but the length of the
  330. &ophysical page. .b2
  331.  .n3 .u3 PN - Number - 0 .b PN (Page Number) is set to the next number to be
  332. printed when the NM command is set to 1 or 2. .b2
  333.  .n3 .u3 PS - Y or N - N .b PS (Preserve Space) is set to Y to cause all
  334. spacing on a line to be preserved.  This is most useful for making column
  335. formatted tables.  It is an alternative to using the =.V commands.  When PS==Y
  336. and dot commands appear on a line there can be conflicts as to the proper
  337. spacing.  Thus a general rule is that when a dot command is processed while
  338. PS==Y, PS is automatically set to N from the remainder of the line in which the
  339. dot command appears, then is reset to Y at the start of the next line. .b2
  340.  .n3 .u3 SP - 1,2,3 - 1 .b SP (SPacing) is set to 1,2 or 3 to indicate single,
  341. double or triple spacing respectively. .b2
  342.  .n3 .u3 SS - Y or N - Y .b SS (Subscript Space) is set to Y to cause
  343. subscripts and superscripts to take space in the print line.  When SS==N 
  344. subscripts and superscripts are over each other when printed. .b2
  345.  
  346.  .n3 .u3 TE - Number - 0 .b TE (Top Even) is the ABSOLUTE printed page
  347. column that the page number is to be placed in the header.  If both TE
  348. and TO are a number other than 0, TE specifies in which column the even page
  349. numbers are to appear. (See Page Numbering below). .b2
  350.  .n3 .u3 TO - Number - 50 .b TO (Top Odd) is the ABSOLUTE printed page
  351. column that the page number is to be placed in the header.  If both TO
  352. and TE are a number other than 0, TO specifies in which column the odd page
  353. numbers are to appear. (See Page Numbering below). .b2
  354.  .n3 .u3 TR - Y or N - N .b TR (Tab Relative) is only concerned with Laser
  355. Printers.  It has no effect for normal printers.  When TR set to Y causes the
  356. column positions across the page to be relative to the size of the Laser
  357. printer font.  Normally the number of columns across the page is considered to
  358. be for a 12 pitch (12 characters per inch printer - controlled by MC).  But
  359. since the Laser printers fonts have a selectable character width, Galahad
  360. adjusts the number of characters that can actually fit on a line across the
  361. page.  When TR==Y the number of columns across the page varies with the fonts.
  362. It is best to leave TR==N until you become a Laser Galahad expert. .b3 .i
  363.  
  364. .n .std3,12,1
  365. Page Numbering. .b2
  366. .st3,12,1
  367. .p Page numbers may be in either or both the header or the footer (See =.H and
  368. =.Z).  The rule of processing is that the header (or footer) is processed as
  369. any other text line each time it is to be printed, and then the page
  370. numbers are placed in the line at the ABSOLUTE page columns.  That is,
  371. page number locations do &inot observe margins and indentation. .b
  372.  
  373. .p Since you may want to put page numbers outside of the margins, it is
  374. necessary that the page numbers be located at absolute printed column
  375. positions.  That is, when a page number is specified, its position is
  376. independent of the printer (LP) or screen margins (LM).  The default value of
  377. BO is 50.  Thus unless changed the page number is located in the footer
  378. starting in the ABSOLUTE page column 50 (the center of a 12 pitch page).  If
  379. both BE and BO are not 0 then the page numbers will alternate between the even
  380. and odd pages at the columns specified by BO and BE.  This would be used when
  381. the printed text is to be duplicated on back-to-back pages. .b
  382. .p When shown on the screen a page number that is outside the margins will
  383. show on the screen at the right or left margin. .b2
  384. .sto3,11,1
  385. NOTE: BO==40 and BE==0 is the same as BO==0 and BE==40; either puts the page
  386. number at column 40 on all pages independent of the page number. .b3
  387. .std3,12,1
  388. The Remaining Dot Commands .b2
  389. .st3,11,1
  390. .i13
  391.  .n .u10 =.Bn .t13 Print the current line with no more filling, go to next
  392. printing line at the current specified spacing.  Do this n times.  In
  393. case n is 0 the =.B0 has no effect when AD==N, and causes the line to 
  394. continue to be filled when AD==Y.  =.B has no effect at the top of a
  395. page.  Default is 1.  (See Appendix I for the use of =.B0, and also see =.K
  396. below).
  397. .b2
  398.  .n .u10 =.Cn .t13 Begin conditional clause.  The text and command words
  399. following =.Cn to the end of n lines  are PRINTed only if CC==Y.  When CC==N
  400. neither the text is printed nor the command words executed.  Default is 1. .b2
  401.  
  402.  .n .u10 =.D .t13 Produce todays date.  Whenever =.D appears in the text the
  403. current date is printed in its place.  When writing a letter one would
  404. normally put =.T50 =.D in the text to print the date near the right
  405. margin. .b2
  406.  .n .u10 =.En .t13 Execute subtext n.  The text defined by =.:n (See =.: below)
  407. is substituted for =.En.  That is, whatever text is defined by =.:n is
  408. processed just as if it had been placed at the location of =.En.  The
  409. advantage is that the same text may be printed-out many times in the same
  410. document without the need to copy it into the text location where it is to be
  411. printed.  (See Appendix I).  .b2
  412.  .n .u10 =.FNAME .t13 Load and execute file 'NAME'.  When =.FNAME is processed
  413. the text from file 'NAME' is loading into the current text buffer and printing
  414. of the document continues.  This loading of new text has no effect on the
  415. current output line.  Therefore, if a new line is to be started, a =.B command
  416. must be included.  Also, none of the =.A parameters are changed.  The total
  417. effect of =.F is as if one very long file was loaded and printed. .b2
  418.  .n .u10 =.Gn .t13 Go to the top of a new page n times; default is 1.  .b2
  419.  .n .u10 =.Ho .t13 The line of text starting at the left margin up to the =.Ho
  420. is considered to be a heading which is to be displayed at the top of each page.
  421. The option  o is L to left justify, R to right justify, C to center.  All
  422. formatting commands are processed but those that have the effect of a =.B will
  423. have indesirable effects, and thus should be avoided.  The header may have a
  424. page number if desired.  (See =.A NM, TE, TO and HL).  .b2
  425.  .n .u10 =.In .t13 Set the indentation to n spaces from the left margin.  All
  426. succeeding lines will be indented n spaces.  Indentation is
  427. ended by =.I0.  Default is 0. .b2
  428.  .n .u10 =.Jo .t13 Similar to the =.H command above, but applies only to a
  429. single line of the text.  Used to center or right justify a line.  A break is
  430. produced. .b2
  431.  .n .u10 =.Kn .t13 Break, print a block of n blank lines to be used as a place
  432. for a figure.  If there are not n lines left on the page, a new page is begun
  433. and then n lines are skipped.  The number of lines skipped is independent of
  434. the specified line spacing.  That is, =.K3 skips three lines even if SP==2.
  435. This differs from =.B.  =.Kn will skip lines at the top of a page, but
  436. =.B will not.  Default is 1.
  437. .b2
  438.  .n .u10 =.Nn .t13 Indicates n lines are needed on the remainder of the current
  439. page; if at least n lines exist then this command is ignored; if n lines do not
  440. exist, a new page is begun before the following text is printed.  Default is 1.
  441.  .b2
  442. .n .n .u10 =.Pn .t13 Break, start a new paragraph with initial indentation n
  443. spaces relative to current indentation value.  Default is 5. .b2
  444.  .n .u10 =.Qn .t13 At the end of this page, skip n pages.  The effect of Q is
  445. additive.  If two =.Q's occur on a page two pages will be skipped.  Default is
  446. 1.  .b2
  447.  .n .u10 =.R .t13 This is a Laser Printer command.  It has no effect on other
  448. printers.  =.R controls the drawing of lines and boxes.  There are three
  449. different forms.  To draw a horizontal line: =.RHn,m -- a line is drawn from
  450. column n to column m.  To draw a vertical line two statements are required.
  451. The line is started with =.RBVm: -- a vertical line is Begun at column m.  To
  452. end the vertical line later in the text use the statement =.REVm: -- the value
  453. of m must be the same for both the start and end commands.  To draw a box two
  454. statements are required.  The box is started with =.RBBn,m: -- a box with
  455. horizontal dimensions from column n to m is Begun.  To end the box later in
  456. the text use the statement =.REBn,m: -- the value of n and m must be the same
  457. for both the start and end commands.  (See Chapter Seven). .b2
  458.  .n .u10 =.Sxyf,s,l .t13 This is a Laser Printer command.  It has no effect on
  459. other printers.  =.S selects the style of the printing.  This is a very brief
  460. description of =.S.  See Chapter Seven for examples.  When printing a page,
  461. there are three different parts that can have different fonts and sizes.  These
  462. are the Text, the Header, and the Footer.  The value of x selects the part to
  463. have its font style and size selected.  x can be T for text, H for Header, and
  464. F for Footer.  y is an optional setting to make the font selected be in D for
  465. Bold, I for Italics, or O for Bold Italics.  If y is missing then the font is
  466. normal.  f is the font number 1 through 6.  The correspondence between font
  467. numbers and the font name is controlled by the =.INI file.  See Appendix D.  s
  468. is the size (height) of the font in &ipoints.  There are 72 points per inch.  l
  469. is the leading.  That is the number of points between the bottom of one line of
  470. text and the start of the next, in points. .b2
  471.  .n .u10 =.Tn .t13 There are two forms of the =.T command.  When it is used as
  472. =.Tn it tabs to column n of text position, counting from the first column in
  473. which charac\ters are printed.  The second usage is for multiple columns tabs.
  474. The command =.Tn1,n2,n3,n4 causes four tab positions to be setup at columns n1,
  475. n2, n3 and n4.  This setup has no effect on printing on the line in which it is
  476. defined.  After the setup, =.T (without a number) tabs to column n1, the next
  477. use of =.T on the same line tabs to n2, and the next to n3, etc.  Each new line
  478. restarts the next tab to be used to n1.  There can be at most 10 tabs defined.
  479. Default is 1. .b2
  480.  .n .u10 =.Un .t13 Change the indentation for the next line only, to n spaces
  481. less than the present indentation; default is left hand margin which is also
  482. the maximum. .b2
  483.  .n .u10 =.Vn .t13 Verbatim mode.  =.V1 causes all of the text which follows to
  484. be printed exactly as it appears.  Both command words and command symbols are
  485. ignored.  This is useful if information from some other source, e.g.,
  486. MULTIPLAN, is to be included in the text.  The =.V1 mode is ended by a line
  487. starting with =.V0 in column 1.  The remainder of the line is processed in a
  488. regular manner (that is with word and symbol commands).  =.V2 is the same as
  489. =.V1 except that command symbols &iare processed, but command words are
  490. ignored.  =.V3 causes all of the text which follows (up to the =.V0) to be sent
  491. to the printer with no processing of any kind.  This is most useful for
  492. including graphics in Laser printer text.  Default is 1.
  493. .b2
  494.  .n .u10 =.Wn .t13 If n==0 then stop printing and wait for a single charac\ter to
  495. be input before continuing printing.  If n==1 then stop printing and wait for a
  496. single charac\ter at the top of every new page.  Default is 0. .b2
  497.  .n .u10 =.Xn .t13 This is a Laser Printer command.  It has no effect on other
  498. printers.  =.X moves the print position up or down the page.  n is the amount
  499. in points.  If n is positive the print position is moved down by n points.  If
  500. n is negative the print position is moved up by n points.  (See Chapter Seven).
  501. .b2
  502.  .n .u10 =.Yn,m .t13 Used to number equations and make right justified columns.
  503. Using the form: =.Yn the rightmost n words prior to the =.Y command are right
  504. justified to the right margin.  The default is 1. .b
  505. Example of =.Y1: .t40 A==LOG(B)/LOG(C) [2.1] .Y .b
  506. Using the form: =.Yn,m the rightmost n words prior to the =.Y command are right
  507. justified to column m.  When n is 1 it may be omitted.  In that case =.Y is
  508. written =.Y,m.  (See Chapter Seven for examples). .b2
  509.  .n .u10 =.Zo .t13 The line of text starting at the left margin up to the =.Zo
  510. is considered to be a footer which is to be displayed at the bottom of each
  511. page.  The option  o is L to left justify, R to right justify, C to center.
  512. All formatting commands are processed but those that have the effect of a =.B
  513. will have indesirable effects, and thus should be avoided.  The footer may have
  514. a page number if desired.  (See =.A NM, BE and BO, and also HL).  .b2
  515. .n .u10 =.[ .t13 Start conditional text (=.]  end conditional text).  When
  516. CT==Y the text and command words between =.[ and =.] are PRINTed and executed.
  517. When CT==N all text and commands are ignored. .b2
  518.  .u10 =.(n .t13 Save the current page number in variable n.  Used primarily to
  519. form a table of contents.  Each heading in the text to be entered in to table
  520. of contents is preceded by =.(1 for the first, =.(2 for the second, etc. The
  521. table of contents page is the last page printed. It contains the headings and a
  522. =.)n for each heading in the table.  NOTE: A maximum of 100 numbers can be
  523. stored.  .b2
  524.  
  525.  
  526. .n .u10 =.)n .t13 Recall a page number.  Where this command appears the page
  527. number stored in variable n is substituted for the command. .b2
  528.  .u10 =.:n .t13 Create subtext numbered n.  The text which follows is treated
  529. as substitution text to be printed in the location of the subtext execution
  530. command "=.E".   The subtext is ended by either the declaration of another
  531. subtext or else the end of all of the text.  Therefore, all subtext definitions
  532. must go at the end of all other text. (See Appendix I) .b3 .i0
  533.  
  534. .st3,14,1 .b
  535. &DSPECIAL%COMMANDS .jr
  536. .st3,11,1 .x-5 .b2
  537.  
  538.      Following are two Galahad Commands which make printing easier.  Theses
  539. command must be entered in the Command Mode. .b2
  540.  
  541.  .p IMMEDIATE <command string> .b
  542.  .p There are times when the =.A command values are to be overridden
  543. temporarily when viewing the PRINTed text on a terminal, or printing it on a
  544. printer.  The IMMEDIATE command allows the user to cause those commands given
  545. in the <command string> to override the same commands following a =.A anywhere
  546. in the text.  The Immediate command can be used multiple times.  Each time it
  547. is used it does not affect previous Immediate commands (unless you specifically
  548. change one).  (See the above list of commands under =.A).
  549. .b2
  550.  
  551. &oExample: .b
  552. .t10 Immediate hy==y ll==68 .b2
  553.  
  554.  .p CLEAR .b
  555.  .p  The CLEAR command causes all previous IMMEDIATE commands to be cancelled.
  556. It has arguments.
  557. .g
  558.