/contrib/groff/contrib/mom/momdoc/docelement.html

https://bitbucket.org/freebsd/freebsd-head/ · HTML · 5041 lines · 4616 code · 379 blank · 46 comment · 0 complexity · 94cb9ffdba54505b8afea218276b3f23 MD5 · raw file

Large files are truncated click here to view the full file

    

  1. <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 3.2 Final//EN">
    2. 

  2. <html>
    3. 

  3. <head>
    4. 

  4. <meta http-equiv="content-type" content="text/html;charset=iso-8859-1">
    5. 

  5. <title>Mom -- Document Processing, element tags</title>
    6. 

  6. </head>
    7. 

  7. <body bgcolor="#dfdfdf">
    8. 

  8. 

  9. <!====================================================================>
    10. 

  10. 

  11. <a href="headfootpage.html#TOP">Next</a>&nbsp;&nbsp;
    12. 

  12. <a href="docprocessing.html#TOP">Prev</a>&nbsp;&nbsp;
    13. 

  13. <a href="toc.html">Back to Table of Contents</a>
    14. 

  14. <p>
    15. 

  15. <a name="TOP"></a>
    16. 

  16. <a name="DOCELEMENT">
    17. 

  17. 	<h1 align="center"><u>THE DOCUMENT ELEMENT TAGS</u></h1>
    18. 

  18. </a>
    19. 

  19. 

  20. <ul>
    21. 

  21. 	<li><a href="#DOCELEMENT_INTRO">Introduction to the document element tags</a>
    22. 

  22. 	<ul>
    23. 

  23. 		<li><a href="#DOCELEMENT_CONTROL">Control macros -- changing defaults for document element tags</a>
    24. 

  24. 		<li><a href="#CONTROL_MACRO_ARGS">Arguments to the control macros</a>
    25. 

  25. 	</ul>
    26. 

  26. 	<li><a href="#INDEX_DOCELEMENT">Index of document element tags</a>
    27. 

  27. </ul>
    28. 

  28. 

  29. <a name="DOCELEMENT_INTRO">
    30. 

  30. 	<h2><u>Introduction to the document element tags</u></h2>
    31. 

  31. </a>
    32. 

  32. 

  33. Once you've completed the setup for a document (see
    34. 

  34. <a href="docprocessing.html#DOCPROCESSING_TUT">Setting up a mom document</a>),
    35. 

  35. formatting it is a snap.  Simply invoke the appropriate tag for
    36. 

  36. each document element as you need it.  The tags are macros that
    37. 

  37. tell <strong>mom</strong>, &quot;This is a paragraph, this
    38. 

  38. is a subhead, this is a footnote,&quot; and so on.
    39. 

  39. <p>
    40. 

  40. The list of tags is actually quite small -- ideal for the users
    41. 

  41. <strong>mom</strong> brought herself into being for (see
    42. 

  42. <a href="intro.html#INTRO_INTRO">Who mom is meant for</a>).
    43. 

  43. However, the list of macros that control the appearance of the
    44. 

  44. tags upon output is extensive.  Generally, for each tag,
    45. 

  45. there are
    46. 

  46. <a href="definitions.html#TERMS_CONTROLMACRO">control macros</a>
    47. 

  47. for the tag's family, font and point size.  Where appropriate, there
    48. 

  48. are macros to control leading, indents, quad and special features
    49. 

  49. as well.
    50. 

  50. <p>
    51. 

  51. <strong>Mom</strong> has tasteful defaults for all the tags, hence you
    52. 

  52. only use the control macros when you want to change the way
    53. 

  53. she does things.  This is usually done prior to
    54. 

  54. <a href="docprocessing.html#START">START</a>,
    55. 

  55. but can, in fact, be done at any time in the course of a document.
    56. 

  56. Any change to a tag's style affects all subsequent invocations of
    57. 

  57. the tag.
    58. 

  58. <p>
    59. 

  59. 

  60. <a name="DOCELEMENT_CONTROL"><h3><u>Control macros -- changing defaults</u></h3></a>
    61. 

  61. 

  62. <p>
    63. 

  63. The control macros for document processing tags let you
    64. 

  64. &quot;design&quot; the look of all the parts of your documents --
    65. 

  65. should you wish.  At a bare minimum, all tags have macros to change
    66. 

  66. <strong>mom</strong>'s defaults for family, font, point size and
    67. 

  67. colour.  Where appropriate, there are macros to control leading,
    68. 

  68. indents and quad as well.
    69. 

  69. <p>
    70. 

  70. In addition, many tags have special macros to control features that
    71. 

  71. are pertinent to those tags alone.  Have a look at the section dealing
    72. 

  72. with any particular tag to find out what macros control the tag,
    73. 

  73. and what <strong>mom</strong>'s defaults for the tag are.
    74. 

  74. <p>
    75. 

  75. The control macros may be used at any time during the course of
    76. 

  76. a document (i.e. before or after
    77. 

  77. <a href="docprocessing.html#START">START</a>).  The changes you
    78. 

  78. make alter all subsequent invocations of the affected tag until
    79. 

  79. you make another change, either by passing new arguments to the
    80. 

  80. tag's control macro, or toggling a particular feature of the tag on
    81. 

  81. or off.
    82. 

  82. <p>
    83. 

  83. And don't forget: the
    84. 

  84. <a href="typesetting.html#MACROS_TYPESETTING">typesetting macros</a>
    85. 

  85. can be used at any time, including inside
    86. 

  86. <a href="definitions.html#TERMS_TOGGLE">toggle</a>
    87. 

  87. tags (affecting only that particular invocation of the tag).
    88. 

  88. Equally,
    89. 

  89. <a href="definitions.html#TERMS_INLINES">inline escapes</a>
    90. 

  90. can be used in tags that take
    91. 

  91. <a href="definitions.html#TERMS_STRINGARGUMENT">string arguments.</a>
    92. 

  92. <p>
    93. 

  93. <strong>IMPORTANT NOTE:</strong> The family, font, point size,
    94. 

  94. colour and leading control macros have no effect in
    95. 

  95. <a href="docprocessing.html#PRINTSTYLE">PRINTSTYLE TYPEWRITE</a>,
    96. 

  96. which sets EVERYTHING in Courier roman, 12/24 (i.e. 12-point type on
    97. 

  97. a linespace of 24 points).
    98. 

  98. <p>
    99. 

  99. Please also note that the defaults listed
    100. 

  100. with the control macros apply only to
    101. 

  101. <a href="docprocessing.html#PRINTSTYLE">PRINTSTYLE TYPESET</a>
    102. 

  102. unless a default for <strong>TYPEWRITE</strong> is also given.
    103. 

  103. <p>
    104. 

  104. <strong>A WORD OF ADVICE:</strong> Get familiar with
    105. 

  105. <strong>mom</strong> at her default settings before exploring the
    106. 

  106. control macros.  Put her through her paces.  See how she behaves.
    107. 

  107. Get to know what she feels like and how she looks, both in your text
    108. 

  108. editor and on the printed page.  Then, if you don't like something,
    109. 

  109. use this documentation to find the precise macro you need to change it.
    110. 

  110. There are tons of control macros.  Reading up on them and trying to
    111. 

  111. remember them all might lead you to think that <strong>mom</strong>
    112. 

  112. is complex and unwieldy, which is not only untrue, but would offend
    113. 

  113. her mightily.
    114. 

  114. <p>
    115. 

  115. 

  116. <a name="CONTROL_MACRO_ARGS"><h3><u>Arguments to the control macros</u></h3></a>
    117. 

  117. 

  118. <h3>Family and font</h3>
    119. 

  119. The arguments to the control macros that end in
    120. 

  120. <strong>_FAMILY</strong> or <strong>_FONT</strong> are the same
    121. 

  121. as for
    122. 

  122. <a href="typesetting.html#FAMILY">FAMILY</a>
    123. 

  123. and
    124. 

  124. <a href="typesetting.html#FONT">FT</a>.
    125. 

  125. 

  126. <h3>Point size</h3>
    127. 

  127. Control macros that end in <strong>_SIZE</strong> always take
    128. 

  128. the form <kbd>+digit</kbd> or <kbd>-digit</kbd> where digit is
    129. 

  129. the number of
    130. 

  130. <a href="definitions.html#TERMS_PICASPOINTS">points</a>
    131. 

  131. larger (+) or smaller (-) than the point size of paragraphs
    132. 

  132. you want the document element to be.  For example, to change
    133. 

  133. subheads to 1-1/2 points larger than the type in paragraphs, do
    134. 

  134. <p>
    135. 

  135. <pre>
    136. 

  136. 	.SUBHEAD_SIZE +1.5
    137. 

  137. </pre>
    138. 

  138. 

  139. There's no need for a
    140. 

  140. <a href="definitions.html#TERMS_UNITOFMEASURE">unit of measure</a>
    141. 

  141. with the <strong>_SIZE</strong> control macros; points is assumed.
    142. 

  142. 

  143. <h3>Colour</h3>
    144. 

  144. Control macros that end in <strong>_COLOR</strong> take as their
    145. 

  145. argument a colour name pre-defined (or &quot;initialized&quot;)
    146. 

  146. with
    147. 

  147. <a href="color.html#NEWCOLOR">NEWCOLOR</a>
    148. 

  148. or
    149. 

  149. <a href="color.html#XCOLOR">XCOLOR</a>.
    150. 

  150. For example, if you want your heads to be red, once you've defined
    151. 

  151. or initialized the color, red,
    152. 

  152. <p>
    153. 

  153. <pre>
    154. 

  154. 	.HEAD_COLOR red
    155. 

  155. </pre>
    156. 

  156. 

  157. will turn your heads red.
    158. 

  158. 

  159. <h3>Lead/linespacing</h3>
    160. 

  160. Control macros that end in <strong>_AUTOLEAD</strong> take the
    161. 

  161. same argument as
    162. 

  162. <a href="typesetting.html#AUTOLEAD">AUTOLEAD</a>,
    163. 

  163. viz. a digit that represents the number of points to add to the
    164. 

  164. tag's point size to arrive at its
    165. 

  165. <a href="definitions.html#TERMS_LEADING">lead</a>.
    166. 

  166. For example, to set footnotes
    167. 

  167. <a href="definitions.html#TERMS_SOLID">solid</a>, do
    168. 

  168. <p>
    169. 

  169. <pre>
    170. 

  170. 	.FOOTNOTE_AUTOLEAD 0
    171. 

  171. </pre>
    172. 

  172. 

  173. To set footnotes with a 1-point lead (i.e. with the line spacing
    174. 

  174. one point greater than the footnote's point size), do
    175. 

  175. <p>
    176. 

  176. <pre>
    177. 

  177. 	.FOOTNOTE_AUTOLEAD 1
    178. 

  178. </pre>
    179. 

  179. 

  180. <h3><a name="CONTROL_INDENTS">Indents</a></h3>
    181. 

  181. Except for <strong>PARA_INDENT</strong>, the argument to the control
    182. 

  182. macros that end
    183. 

  183. in <strong>_INDENT</strong> is always a single digit (whole numbers
    184. 

  184. only; no decimal fractions) with no
    185. 

  185. <a href="definitions.html#TERMS_UNITOFMEASURE">unit of measure</a>
    186. 

  186. appended to it.  The digit represents by how much you want the
    187. 

  187. size of the paragraph first-line indent multiplied to achieve the
    188. 

  188. correct indent for a particular tag.
    189. 

  189. 

  190. <h3>Quad/justification style</h3>
    191. 

  191. Control macros that end in <strong>_QUAD</strong> take the same
    192. 

  192. arguments as
    193. 

  193. <a href="typesetting.html#QUAD">QUAD</a>.
    194. 

  194. <p>
    195. 

  195. <hr>
    196. 

  196. 

  197. <a name="INDEX_DOCELEMENT"><h3><u>Document element tags list</u></h3></a>
    198. 

  198. <ul>
    199. 

  199. 	<li><a href="#EPIGRAPH_INTRO">Epigraphs</a>
    200. 

  200. 	<ul>
    201. 

  201. 		<li><a href="#EPIGRAPH">EPIGRAPH</a>
    202. 

  202. 		<li><a href="#EPIGRAPH_CONTROL">Epigrah control</a>
    203. 

  203. 	</ul>
    204. 

  204. 	<li><a href="#PP_INTRO">Paragraphs</a>
    205. 

  205. 	<ul>
    206. 

  206. 		<li><a href="#PP">PP</a>
    207. 

  207. 		<li><a href="#PP_CONTROL">Paragraph control</a>
    208. 

  208. 	</ul>
    209. 

  209. 	<li><a href="#HEAD_INTRO">Main heads</a>
    210. 

  210. 	<ul>
    211. 

  211. 		<li><a href="#HEAD">HEAD</a>
    212. 

  212. 		<li><a href="#HEAD_CONTROL">Head control</a>
    213. 

  213. 	</ul>
    214. 

  214. 	<li><a href="#SUBHEAD_INTRO">Subheads</a>
    215. 

  215. 	<ul>
    216. 

  216. 		<li><a href="#SUBHEAD">SUBHEAD</a>
    217. 

  217. 		<li><a href="#SUBHEAD_CONTROL">Subhead control</a>
    218. 

  218. 	</ul>
    219. 

  219. 	<li><a href="#PARAHEAD_INTRO">Paragraph heads</a>
    220. 

  220. 	<ul>
    221. 

  221. 		<li><a href="#PARAHEAD">PARAHEAD</a>
    222. 

  222. 		<li><a href="#PARAHEAD_CONTROL">Parahead control</a>
    223. 

  223. 	</ul>
    224. 

  224. 	<li><a href="#LINEBREAK_INTRO">Linebreaks (author linebreaks, section breaks)</a>
    225. 

  225. 	<ul>
    226. 

  226. 		<li><a href="#LINEBREAK">LINEBREAK</a>
    227. 

  227. 		<li><a href="#LINEBREAK_CHAR">Linebreak character</a>
    228. 

  228. 		<li><a href="#LINEBREAK_COLOR">Linebreak colour</a>
    229. 

  229. 	</ul>
    230. 

  230. 	<li><a href="#QUOTE_INTRO">Quotes (line for line)</a>
    231. 

  231. 	<ul>
    232. 

  232. 		<li><a href="#QUOTE">QUOTE</a>
    233. 

  233. 		<li><a href="#QUOTE_CONTROL">Quote control</a>
    234. 

  234. 	</ul>
    235. 

  235. 	<li><a href="#BLOCKQUOTE_INTRO">Blockquotes (cited material)</a>
    236. 

  236. 	<ul>
    237. 

  237. 		<li><a href="#BLOCKQUOTE">BLOCKQUOTE</a>
    238. 

  238. 		<li><a href="#BLOCKQUOTE_CONTROL">Blockquote control</a>
    239. 

  239. 	</ul>
    240. 

  240. 	<li><a href="#LIST_INTRO">Nested lists</a>
    241. 

  241. 	<ul>
    242. 

  242. 		<li><a href="#LIST">LIST</a>
    243. 

  243. 		<ul>
    244. 

  244. 			<li><a href="#ITEM">ITEM</a>
    245. 

  245. 		</ul>
    246. 

  246. 		<li><a href="#LIST_CONTROL">List control</a>
    247. 

  247. 	</ul>
    248. 

  248. 	<li><a href="#NUMBER_LINES_INTRO">Line numbering</a>
    249. 

  249. 	<ul>
    250. 

  250. 		<li><a href="#NUMBER_LINES">NUMBER_LINES</a>
    251. 

  251. 		<li><a href="#NUMBER_LINES_CONTROL">Control macros</a> (for QUOTE and BLOCKQUOTE)
    252. 

  252. 	</ul>
    253. 

  253. 	<li><a href="#FOOTNOTE_INTRO">Footnotes</a>
    254. 

  254. 	<ul>
    255. 

  255. 		<li><a href="#FOOTNOTE">FOOTNOTE</a>
    256. 

  256. 		<li><a href="#FOOTNOTE_CONTROL">Footnote control</a>
    257. 

  257. 	</ul>
    258. 

  258. 	<li><a href="#ENDNOTE_INTRO">Endnotes</a>
    259. 

  259. 	<ul>
    260. 

  260. 		<li><a href="#ENDNOTE">ENDNOTE</a>
    261. 

  261. 		<li><a href="#ENDNOTE_CONTROL">Endnote control</a>
    262. 

  262. 	</ul>
    263. 

  263. 	<li><a href="#MARGIN_NOTES_INTRO">Margin notes</a>
    264. 

  264. 	<ul>
    265. 

  265. 		<li><a href="#MN_INIT">MN_INIT</a> -- initialize margin notes
    266. 

  266. 		<li><a href="#MN">MN</a> -- start and end a margin note
    267. 

  267. 	</ul>
    268. 

  268.     <li><a href="refer.html#TOP">Bibliographies and references</a>
    269. 

  269.     <ul>
    270. 

  270.         <li><a href="refer.html#REF">REF</a>
    271. 

  271.         <li><a href="refer.html#ENDNOTE_REFS">ENDNOTE_REFS</a>
    272. 

  272.         <li><a href="refer.html#FOOTNOTE_REFS">FOOTNOTE_REFS</a>
    273. 

  273.         <li><a href="refer.html#BRACKET_REFS">Embedded references</a>
    274. 

  274.         <li><a href="refer.html#BIBLIOGRAPHY">BIBLIOGRAPHY</a>
    275. 

  275.         <li><a href="refer.html#BIBLIOGRAPHY_TYPE">BIBLIOGRAPHY_TYPE</a>
    276. 

  276.     </ul>
    277. 

  277. 	<li><a href="#BLANK_PAGE_TITLE">Blank pages</a>
    278. 

  278. 	<li><a href="#TOC_INTRO">Table of contents</a>
    279. 

  279. 	<ul>
    280. 

  280. 		<li><a href="#TOC">TOC</a>
    281. 

  281. 		<li><a href="#TOC_CONTROL">Table of contents control</a>
    282. 

  282. 	</ul>
    283. 

  283. 	<li><a href="#FINIS_INTRO">Document termination</a>
    284. 

  284. 	<ul>
    285. 

  285. 		<li><a href="#FINIS">FINIS (Document termination)</a>
    286. 

  286. 	</ul>
    287. 

  287. 	<ul>
    288. 

  288. 		<li><a href="#FINIS_STRING">Changing the FINIS string</a>
    289. 

  289. 		<li><a href="#FINIS_COLOR">Changing the FINIS colour</a>
    290. 

  290. 	</ul>
    291. 

  291. </ul>
    292. 

  292. <hr>
    293. 

  293. 

  294. 

  295. <!====================================================================>
    296. 

  296. 

  297. <a name="EPIGRAPH_INTRO"><h2><u>Epigraphs</u></h2></a>
    298. 

  298. <ul>
    299. 

  299. 	<li><a href="#EPIGRAPH">Tag: EPIGRAPH</a>
    300. 

  300. 	<li><a href="#EPIGRAPH_CONTROL">Epigraph control macros</a>
    301. 

  301. </ul>
    302. 

  302. <p>
    303. 

  303. <a href="definitions.html#TERMS_EPIGRAPH">Epigraphs</a>
    304. 

  304. colour, flavour, or comment on the document they precede.  Typically,
    305. 

  305. they are centred at the top of a document's first page (underneath the
    306. 

  306. title) and set in a smaller point size than that of paragraph text.
    307. 

  307. <p>
    308. 

  308. By default, <strong>mom</strong> sets epigraphs centred and
    309. 

  309. <a href="definitions.html#TERMS_NOFILL">unfilled</a>;
    310. 

  310. this lets you input them on a line for line basis.  This behaviour
    311. 

  311. can be changed to accomodate
    312. 

  312. <a href="definitions.html#TERMS_FILLED">filled</a>
    313. 

  313. epigraph &quot;blocks.&quot;
    314. 

  314. <p>
    315. 

  315. 

  316. <!---EPIGRAPH--->
    317. 

  317. 

  318. <hr width="66%" align="left">
    319. 

  319. <p>
    320. 

  320. <a name="EPIGRAPH">
    321. 

  321. 	<nobr>Macro: <strong>EPIGRAPH</strong> &lt;toggle&gt; | [ BLOCK ]</a></nobr>
    322. 

  322. </a>
    323. 

  323. 

  324. <p>
    325. 

  325. <strong>EPIGRAPH</strong> is a toggle, used like this:
    326. 

  326. <p>
    327. 

  327. <pre>
    328. 

  328. 	.EPIGRAPH
    329. 

  329. 	&lt;text of epigraph&gt;
    330. 

  330. 	.EPIGRAPH OFF
    331. 

  331. </pre>
    332. 

  332. 

  333. <strong>OFF</strong>, above, could be anything -- say, Q or X --
    334. 

  334. since any argument other than <strong>BLOCK</strong> turns it off.
    335. 

  335. <p>
    336. 

  336. If given the argument <strong>BLOCK</strong>, <strong>EPIGRAPH</strong>
    337. 

  337. sets epigraphs
    338. 

  338. <a href="definitions.html#TERMS_FILLED">filled</a>,
    339. 

  339. justified or quadded in the same direction as paragraphs, indented
    340. 

  340. equally from both the left and right margins.
    341. 

  341. <p>
    342. 

  342. If a block-style epigraph runs to more than one paragraph (unlikely,
    343. 

  343. but conceivable), you <strong>MUST</strong> introduce every paragraph
    344. 

  344. -- <u>INCLUDING THE FIRST!!!</u> -- with the
    345. 

  345. <a href="#PP">PP</a>
    346. 

  346. tag.
    347. 

  347. <p>
    348. 

  348. <strong>NOTE:</strong> <strong>EPIGRAPH</strong> should only be
    349. 

  349. used at the top of a document (i.e. just after
    350. 

  350. <a href="docprocessing.html#START">START</a>)
    351. 

  351. or after
    352. 

  352. <a href="#HEAD_INTRO">heads</a>.  The latter is not especially
    353. 

  353. recommended, but it does work.  In all other places where you
    354. 

  354. want quotes or cited text, use
    355. 

  355. <a href="#QUOTE">QUOTE</a>
    356. 

  356. or
    357. 

  357. <a href="#BLOCKQUOTE">BLOCKQUOTE</a>.
    358. 

  358. <p>
    359. 

  359. 

  360. <a name="EPIGRAPH_CONTROL"><h3><u>Epigraph control macros</u></h3></a>
    361. 

  361. <p>
    362. 

  362. See
    363. 

  363. <a href="#CONTROL_MACRO_ARGS">Arguments to the control macros</a>.
    364. 

  364. <p>
    365. 

  365. <pre>
    366. 

  366. .EPIGRAPH_FAMILY    default = prevailing document family; default is Times Roman
    367. 

  367. .EPIGRAPH_FONT      default = roman
    368. 

  368. .EPIGRAPH_SIZE      default = -1.5 (points)
    369. 

  369. .EPIGRAPH_COLOR     default = black
    370. 

  370. .EPIGRAPH_AUTOLEAD  default = 2 points
    371. 

  371. 

  372. (The next two apply to &quot;block&quot; style epigraphs only)
    373. 

  373. 

  374. .EPIGRAPH_QUAD      default = same as paragraphs
    375. 

  375. .EPIGRAPH_INDENT*   default = para indent x 3 (for typeset), x 2 (for typewrite)
    376. 

  376. 

  377. *Indent here refers to the indent from both the left and right margins
    378. 

  378.  that centres the block style epigraph on the page.
    379. 

  379. </pre>
    380. 

  380. <hr>
    381. 

  381. 

  382. <!====================================================================>
    383. 

  383. 

  384. <a name="PP_INTRO"><h2><u>Paragraphs</u></h2></a>
    385. 

  385. <ul>
    386. 

  386. 	<li><a href="#PP">Tag: PP</a>
    387. 

  387. 	<li><a href="#PP_CONTROL">Paragraph control macros</a>
    388. 

  388. </ul>
    389. 

  389. <p>
    390. 

  390. The paragraph macro is the one you use most often.  Consequently,
    391. 

  391. it's one of most powerful, yet simplest to use -- just the letters
    392. 

  392. <strong>PP</strong>.  No arguments, nothing.  Just <kbd>.PP</kbd>
    393. 

  393. on a line by itself any time, in any document element, tells
    394. 

  394. <strong>mom</strong> you want to start a new paragraph.  The spacing
    395. 

  395. and indent appropriate to where you are in your document are taken
    396. 

  396. care of automatically.
    397. 

  397. <p>
    398. 

  398. By default, <strong>mom</strong> does not indent the first paragraph
    399. 

  399. of a document, nor paragraphs that fall immediately after
    400. 

  400. <a href="#HEAD_INTRO">heads</a>
    401. 

  401. or
    402. 

  402. <a href="#SUBHEAD_INTRO">subheads</a>.
    403. 

  403. The first paragraphs of blockquotes and block-style epigraphs are
    404. 

  404. also not indented.  This behaviour can be changed with the control
    405. 

  405. macro
    406. 

  406. <a href="#PARA_INDENT_FIRST">INDENT_FIRST_PARAS</a>.
    407. 

  407. <p>
    408. 

  408. In contrast to some other macro packages, <strong>mom</strong> does not
    409. 

  409. deposit a blank line between paragraphs.  If you want her to do so, use
    410. 

  410. the control macro <strong>PARA_SPACE</strong>.  (I don't recommend
    411. 

  411. using this macro with
    412. 

  412. <a href="typesetting.html#PRINTSTYLE">PRINTSTYLE TYPEWRITE</a>.)
    413. 

  413. <p>
    414. 

  414. Note that <strong>mom</strong> does not provide &quot;orphan
    415. 

  415. control&quot; for paragraphs (i.e. even if only one line of a paragraph
    416. 

  416. fits at the bottom of a page, she will set it on that page).  The
    417. 

  417. reason for this is that writers of fiction often have single-line
    418. 

  418. paragraphs (e.g. in dialogue).  Groff's simplistic orphan control
    419. 

  419. will break these one-liners -- if they fall at the bottom of the page
    420. 

  420. -- to a new page, which is not what you want.
    421. 

  421. <p>
    422. 

  422. <strong>TIP:</strong> The last thing you want while you're writing
    423. 

  423. and editing drafts of a document (particularly stories and chapters)
    424. 

  424. is a text file cluttered up with <strong>PP</strong>'s.  The visual
    425. 

  425. interruption in the flow of text is a serious obstacle to creativity
    426. 

  426. and critiquing.
    427. 

  427. <p>
    428. 

  428. I use the tab key on my keyboard to indent paragraphs when I'm writing,
    429. 

  429. producing a text file that looks pretty much like what you see on
    430. 

  430. a printed page.  When it comes time to format and print the file,
    431. 

  431. I run it through a sed script that (amongst other things) converts
    432. 

  432. the character generated by the tab key (<kbd>^I</kbd>) into <code>.PP</code>
    433. 

  433. (plus a new line), and pipe the output to groff for processing and
    434. 

  434. printing.
    435. 

  435. <p>
    436. 

  436. Another solution is to insert a blank line between paragraphs.
    437. 

  437. The blank lines can then be sedded out at print time as above, or,
    438. 

  438. more conveniently, you can use the <code>.blm</code>
    439. 

  439. <a href="definitions.html#TERMS_PRIMITIVES">primitive</a>
    440. 

  440. (blank line macro) to instruct groff (and <strong>mom</strong>)
    441. 

  441. that blank lines should be interpreted as <strong>PP</strong>'s.
    442. 

  442. <p>
    443. 

  443. <pre>
    444. 

  444. 	.blm PP
    445. 

  445. </pre>
    446. 

  446. tells groff that all blank lines are really the macro <strong>PP</strong>.
    447. 

  447. <p>
    448. 

  448. 

  449. <!---PP--->
    450. 

  450. 

  451. <hr width="66%" align="left">
    452. 

  452. <p>
    453. 

  453. <a name="PP">
    454. 

  454. 	Macro: <strong>PP</strong>
    455. 

  455. </a>
    456. 

  456. 

  457. <p>
    458. 

  458. <strong>PP</strong> (on a line by itself, of course) tells mom to
    459. 

  459. start a new paragraph.  See
    460. 

  460. <a href="#PP_INTRO">above</a>
    461. 

  461. for more details.  In addition to regular text paragraphs, you can
    462. 

  462. use <strong>PP</strong> in
    463. 

  463. <a href="#EPIGRAPH_INTRO">epigraphs</a>,
    464. 

  464. <a href="#BLOCKQUOTE_INTRO">blockquotes</a>
    465. 

  465. and
    466. 

  466. <a href="#FOOTNOTE_INTRO">footnotes</a>.
    467. 

  467. 

  468. <a name="PP_CONTROL"><h3><u>Paragraph control macros</u></h3></a>
    469. 

  469. <p>
    470. 

  470. The <strong>PP</strong> being so important, and representing, as
    471. 

  471. it were, the basis of everything that goes on in a document, its
    472. 

  472. control is managed in a manner somewhat different from other document
    473. 

  473. element tags.
    474. 

  474. <p>
    475. 

  475. <ol>
    476. 

  476. 	<li><a href="#PP_FAMILY">Family control</a>
    477. 

  477. 	<li><a href="#PP_FONT">Font control</a>
    478. 

  478. 	<li><a href="#PP_COLOR">Paragraph colour</a>
    479. 

  479. 	<li><a href="#PP_LEADING">Leading/linespacing control</a>
    480. 

  480. 	<li><a href="#PP_JUST_QUAD">Justification/quad control</a>
    481. 

  481. 	<li><a href="#PARA_INDENT">First-line indent control</a>
    482. 

  482. 	<li><a href="#PARA_INDENT_FIRST">Initial paragraphs indent control</a>
    483. 

  483. 	<li><a href="#PP_SPACE">Paragraph spacing control</a>
    484. 

  484. </ol>
    485. 

  485. 

  486. <a name="PP_FAMILY"><h3><u>1. Family</u></h3></a>
    487. 

  487. <p>
    488. 

  488. The paragraph
    489. 

  489. <a href="definitions.html#TERMS_FAMILY">family</a>
    490. 

  490. is set with
    491. 

  491. <a href="typesetting.html#FAMILY">FAMILY</a>
    492. 

  492. prior to
    493. 

  493. <a href="docprocessing.html#START">START</a>,
    494. 

  494. or
    495. 

  495. <a href="docprocessing.html#DOC_FAMILY">DOC_FAMILY</a>
    496. 

  496. afterwards.  Please note that both globally affect the family of
    497. 

  497. every element in the document.
    498. 

  498. <p>
    499. 

  499. If you wish to change the family for regular
    500. 

  500. text paragraphs only, invoke <strong>FAMILY</strong> immediately
    501. 

  501. after <strong>PP</strong> in EVERY paragraph whose family you wish
    502. 

  502. to differ from the prevailing document family.
    503. 

  503. <p>
    504. 

  504. <strong>Mom</strong>'s default paragraph (and document) family
    505. 

  505. is Times Roman.
    506. 

  506. <p>
    507. 

  507. 

  508. <a name="PP_FONT"><h3><u>2. Font -- PP_FONT</u></h3></a>
    509. 

  509. <p>
    510. 

  510. To change the
    511. 

  511. <a href="definitions.html#TERMS_FONT">font</a>
    512. 

  512. used in regular text paragraphs, use <code>.PP_FONT</code>,
    513. 

  513. which takes the same argument as
    514. 

  514. <a href="typesetting.html#FONT">FT</a>.
    515. 

  515. <strong>PP_FONT</strong> may be used before or after
    516. 

  516. <a href="docprocessing.html#START">START</a>.
    517. 

  517. Only regular text paragraphs are affected; paragraphs in
    518. 

  518. <a href="#EPIGRAPH_INTRO">epigraphs</a>,
    519. 

  519. <a href="#BLOCKQUOTE_INTRO">blockquotes</a>
    520. 

  520. and
    521. 

  521. <a href="#FOOTNOTE_INTRO">footnotes</a>
    522. 

  522. remain at their default setting (medium roman) unless you change them
    523. 

  523. with the appropriate control macros.
    524. 

  524. <p>
    525. 

  525. <strong>Mom</strong>'s default paragraph font is medium roman.
    526. 

  526. <p>
    527. 

  527. 

  528. <a name="PP_COLOR"><h3><u>3. Paragraph colour</u></h3></a>
    529. 

  529. <p>
    530. 

  530. <strong>Mom</strong> has no special control macro for colourizing
    531. 

  531. paragraphs.  If you wish a colourized paragraph, you must use the
    532. 

  532. macro,
    533. 

  533. <a href="color.html#COLOR">COLOR</a>,
    534. 

  534. or the
    535. 

  535. <a href="definitions.html#TERMS_INLINE">inline escape</a>,
    536. 

  536. <a href="color.html#COLOR_INLINE">\*[&lt;colorname&gt;]</a>,
    537. 

  537. <em>after</em> <strong>.PP</strong>.  The colour must be one
    538. 

  538. pre-defined (or &quot;initialized&quot;) with
    539. 

  539. <a href="color.html#NEWCOLOR">NEWCOLOR</a>
    540. 

  540. or
    541. 

  541. <a href="color.html#XCOLOR">XCOLOR</a>.
    542. 

  542. <p>
    543. 

  543. Please note that unless you change the colour back to it's default
    544. 

  544. (usually black) at the end of the paragraph, all subsequent
    545. 

  545. paragraphs will be set in the new colour, although most other
    546. 

  546. elements of your document will continue to be set in the default
    547. 

  547. colour (usually black).
    548. 

  548. <p>
    549. 

  549. For example, assuming you have defined the colour, blue,
    550. 

  550. <p>
    551. 

  551. <pre>
    552. 

  552. 	.PP
    553. 

  553. 	.COLOR blue
    554. 

  554. 	&lt;first paragraph&gt;
    555. 

  555. 	.HEAD "Monty Python"
    556. 

  556. 	.SUBHEAD "The Origins of Spam"
    557. 

  557. 	.PP
    558. 

  558. 	&lt;second paragraph&gt;
    559. 

  559. </pre>
    560. 

  560. 

  561. the first paragraph will be blue, the head and subhead will be in
    562. 

  562. the document's default colour (usually black), and the second
    563. 

  563. paragraph will be in blue.
    564. 

  564. <p>
    565. 

  565. The one document element that is affected by changing the colour
    566. 

  566. of paragraphs are
    567. 

  567. <a href="#PARAHEAD">paraheads</a>,
    568. 

  568. since they are attached directly to the body of paragraphs.  In
    569. 

  569. other words, if you change the colour of a paragraph and do not
    570. 

  570. reset the paragraph colour back to its default, subsequent paraheads
    571. 

  571. will appear in the same colour as your paragraphs unless you have
    572. 

  572. explicitly told <strong>mom</strong> you want a pre-defined (or
    573. 

  573. &quot;initialized&quot;) color (usually black) for your paraheads.
    574. 

  574. <p>
    575. 

  575. See the footnote to
    576. 

  576. <a href="#PARAHEAD_COLOR">.PARAHEAD_COLOR</a>.
    577. 

  577. 

  578. <a name="PP_LEADING"><h3><u>4. Leading</u></h3></a>
    579. 

  579. <p>
    580. 

  580. The paragraph
    581. 

  581. <a href="definitions.html#TERMS_LEADING">leading</a>
    582. 

  582. is set with
    583. 

  583. <a href="typesetting.html#LEADING">LS</a>
    584. 

  584. prior to
    585. 

  585. <a href="docprocessing.html#START">START</a>,
    586. 

  586. or
    587. 

  587. <a href="docprocessing.html#DOC_LEAD">DOC_LEAD</a>
    588. 

  588. afterwards.  Please note that either method globally affects the
    589. 

  589. leading and spacing of every document element (except
    590. 

  590. <a href="definitions.html#TERMS_HEADER">headers</a>
    591. 

  591. and
    592. 

  592. <a href="definitions.html#TERMS_FOOTER">footers</a>).
    593. 

  593. <p>
    594. 

  594. If you wish to change the leading of regular text paragraphs only,
    595. 

  595. invoke <strong>LS</strong> immediately after <strong>PP</strong> in
    596. 

  596. EVERY paragraph whose leading you wish to change.
    597. 

  597. <p>
    598. 

  598. <strong>HYPER-IMPORTANT NOTE:</strong> It is extremely unwise to change
    599. 

  599. paragraph leading with <strong>LS</strong>, as it will, in all cases,
    600. 

  600. screw up <strong>mom</strong>'s ability to balance the bottom margin
    601. 

  601. of pages.  Should you absolutely need to change paragraph leading
    602. 

  602. with <strong>LS</strong>, and subsequently want <strong>mom</strong>
    603. 

  603. to get back on the right leading track, use the
    604. 

  604. <a href="docprocessing.html#SHIM">SHIM</a>
    605. 

  605. macro.
    606. 

  606. <p>
    607. 

  607. <strong>Mom</strong>'s default paragraph leading (document leading)
    608. 

  608. is 16 points, adjusted to fill the page.
    609. 

  609. <p>
    610. 

  610. 

  611. <a name="PP_JUST_QUAD"><h3><u>5. Justification/quad</u></h3></a>
    612. 

  612. <p>
    613. 

  613. The justification/quad-direction of regular text paragraphs (i.e.
    614. 

  614. <a href="definitions.html#TERMS_JUST">justified</a>,
    615. 

  615. or
    616. 

  616. <a href="definitions.html#TERMS_FILLED">filled</a>
    617. 

  617. and
    618. 

  618. <a href="definitions.html#TERMS_QUAD">quadded</a>
    619. 

  619. left/right/centre) is set with
    620. 

  620. <a href="typesetting.html#JUSTIFY">JUSTIFY</a>
    621. 

  621. or
    622. 

  622. <a href="typesetting.html#QUAD">QUAD</a>
    623. 

  623. prior to
    624. 

  624. <a href="docprocessing.html#START">START</a>,
    625. 

  625. and with
    626. 

  626. <a href="docprocessing.html#DOC_QUAD">DOC_QUAD</a>
    627. 

  627. afterwards.
    628. 

  628. <p>
    629. 

  629. Please note that either method of setting the paragraph
    630. 

  630. justification/quad-direction also affects
    631. 

  631. <a href="#EPIGRAPH_INTRO">epigraphs</a>
    632. 

  632. and
    633. 

  633. <a href="#FOOTNOTE_INTRO">footnotes</a>,
    634. 

  634. but not
    635. 

  635. <a href="#BLOCKQUOTE_INTRO">blockquotes</a>
    636. 

  636. (whose default is QUAD LEFT unless you change it with
    637. 

  637. <a href="#BLOCKQUOTE">BLOCKQUOTE_QUAD</a>).
    638. 

  638. The justification/quad-direction of epigraphs and footnotes may
    639. 

  639. be changed with their own control macros.
    640. 

  640. <p>
    641. 

  641. If you wish to change the justification/quad-direction of
    642. 

  642. individual paragraphs, use <strong>JUSTIFY</strong> or
    643. 

  643. <strong>QUAD</strong> immediately after <strong>PP</strong>.
    644. 

  644. Only the paragraph in question gets justified or quadded
    645. 

  645. differently;  subsequent paragraphs remain unaffected.
    646. 

  646. <p>
    647. 

  647. <strong>Mom</strong>'s default justification/quad-direction for
    648. 

  648. paragraphs is
    649. 

  649. <br>
    650. 

  650. <ul>
    651. 

  651.     <li>justified, for
    652. 

  652.         <a href="docprocessing.html#PRINTSTYLE">PRINTSTYLE_TYPESET</a>
    653. 

  653.     <li>quad left, for
    654. 

  654.         <a href="docprocessing.html#PRINTSTYLE">PRINTSTYLE_TYPEWRITE</a>
    655. 

  655. </ul>
    656. 

  656. <p>
    657. 

  657. <a name="PARA_INDENT"><h3><u>6. First-line indent -- PARA_INDENT</u></h3></a>
    658. 

  658. <p>
    659. 

  659. The first-line indent of paragraphs is controlled by
    660. 

  660. <strong>PARA_INDENT</strong>, which takes one argument: the size
    661. 

  661. of the indent.  <strong>PARA_INDENT</strong> may be used before
    662. 

  662. or after
    663. 

  663. <a href="docprocessing.html#START">START</a>.
    664. 

  664. A
    665. 

  665. <a href="definitions.html#TERMS_UNITOFMEASURE">unit of measure</a>
    666. 

  666. is required; fractional sizes are allowed.  Thus, to set the paragraph
    667. 

  667. indent to 4-1/2
    668. 

  668. <a href="definitions.html#TERMS_EM">ems</a>, do
    669. 

  669. <p>
    670. 

  670. <pre>
    671. 

  671. 	.PARA_INDENT 4.5m
    672. 

  672. </pre>
    673. 

  673. 

  674. In addition to establishing the basic first line-indent of
    675. 

  675. paragraphs, <strong>PARA_INDENT</strong> also affects
    676. 

  676. <a href="#EPIGRAPH_INTRO">epigraphs</a>,
    677. 

  677. <a href="#QUOTE_INTRO">quotes</a>
    678. 

  678. and
    679. 

  679. <a href="#BLOCKQUOTE_INTRO">blockquotes</a>,
    680. 

  680. whose overall indenting from the left and (where applicable) right
    681. 

  681. margins is relative to <strong>PARA_INDENT</strong>.  Furthermore, the
    682. 

  682. first-line indent of paragraphs within these document elements (as well
    683. 

  683. as footnotes) is also relative to <strong>PARA_INDENT</strong> (always
    684. 

  684. 1/2 of <strong>PARA_INDENT)</strong>), hence they are also affected.
    685. 

  685. <p>
    686. 

  686. <strong>Mom</strong>'s default <strong>PARA_INDENT</strong> is 2
    687. 

  687. ems for
    688. 

  688. <a href="docprocessing.html#PRINTSTYLE">PRINTSTYLE_TYPESET</a>
    689. 

  689. and 3 picas (1/2 inch) for
    690. 

  690. <a href="docprocessing.html#PRINTSTYLE">PRINTSTYLE_TYPEWRITE</a>.
    691. 

  691. <p>
    692. 

  692. 

  693. <a name="PARA_INDENT_FIRST"><h3><u>7. Indenting initial paragraphs -- INDENT_FIRST_PARAS</u></h3></a>
    694. 

  694. <p>
    695. 

  695. By default, <strong>mom</strong> does not indent the first paragraph
    696. 

  696. of a document, nor the first paragraph after a head or
    697. 

  697. subhead, nor the first paragraphs of 
    698. 

  698. <a href="#EPIGRAPH_INTRO">epigraphs</a>,
    699. 

  699. <a href="#BLOCKQUOTE_INTRO">blockquotes</a>
    700. 

  700. or
    701. 

  701. <a href="#FOOTNOTE_INTRO">footnotes</a>
    702. 

  702. that run to more than one paragraph.
    703. 

  703. <a name="INDENT_FIRST_PARAS"></a>
    704. 

  704. <p>
    705. 

  705. If you wish to have first paragraphs indented, invoke the macro
    706. 

  706. <strong>.INDENT_FIRST_PARAS</strong> with no argument, either
    707. 

  707. before or after
    708. 

  708. <a href="docprocessing.html#START">START</a>.
    709. 

  709. <strong>INDENT_FIRST_PARAS</strong> is a toggle macro, therefore
    710. 

  710. passing it any argument (<strong>OFF, QUIT, Q, X</strong>...) cancels
    711. 

  711. its effect, meaning that first paragraphs will once again NOT be
    712. 

  712. indented.
    713. 

  713. <p>
    714. 

  714. 

  715. <a name="PP_SPACE"><h3><u>8. Spacing paragraphs -- PARA_SPACE</u></h3></a>
    716. 

  716. <p>
    717. 

  717. By default, <strong>mom</strong> does not insert a blank line
    718. 

  718. between paragraphs.  If you would like her to do so, invoke the
    719. 

  719. macro <code>.PARA_SPACE</code> with no argument, either
    720. 

  720. before or after
    721. 

  721. <a href="docprocessing.html#START">START</a>.
    722. 

  722. <strong>PARA_SPACE</strong> is a toggle macro, therefore passing
    723. 

  723. it any argument (<strong>OFF, QUIT, Q, X</strong>...) cancels its
    724. 

  724. effect, meaning that paragraphs will once again NOT be separated by
    725. 

  725. a blank line.
    726. 

  726. <p>
    727. 

  727. <strong>NOTE:</strong> If <strong>PARA_SPACE</strong> is on,
    728. 

  728. <strong>mom</strong> spaces only those paragraphs that come after
    729. 

  729. an &quot;initial&quot; paragraph.  Initial paragraphs are those
    730. 

  730. that come immediately after the
    731. 

  731. <a href="definitions.html#TERMS_DOCHEADER">docheader</a>,
    732. 

  732. <a href="#EPIGRAPH_INTRO">epigraphs</a>,
    733. 

  733. <a href="#HEAD_INTRO">heads</a>,
    734. 

  734. <a href="#SUBHEAD_INTRO">subheads</a>
    735. 

  735. and
    736. 

  736. <a href="#LINEBREAK_INTRO">linebreaks</a>.
    737. 

  737. (The first paragraph after these document elements requires no
    738. 

  738. blank line to separate it from other paragraphs.)
    739. 

  739. <p>
    740. 

  740. Sometimes, you can be fairly deep into a document before using
    741. 

  741. <strong>.PP</strong> for the first time, and when you do, because
    742. 

  742. <strong>mom</strong> is still waiting for that &quot;initial&quot;
    743. 

  743. paragraph, she doesn't space it with a blank line, even though
    744. 

  744. you expect her to.  The simple workaround for this is to invoke
    745. 

  745. <strong>.PP</strong> <em>twice</em> (in succession) at the point you
    746. 

  746. expect the blank line to appear.
    747. 

  747. <br>
    748. 

  748. <hr>
    749. 

  749. 

  750. <!====================================================================>
    751. 

  751. 

  752. <a name="HEAD_INTRO"><h2><u>Main heads</u></h2></a>
    753. 

  753. <ul>
    754. 

  754. 	<li><a href="#HEAD">Tag: HEAD</a>
    755. 

  755. 	<li><a href="#HEAD_CONTROL">Head control macros</a>
    756. 

  756. </ul>
    757. 

  757. <p>
    758. 

  758. Main heads -- or, in this documentation, just &quot;heads&quot;
    759. 

  759. -- should be used any place you want titles to introduce major
    760. 

  760. sections of a document.  If you wish, <strong>mom</strong> can number
    761. 

  761. your heads for you.  Head numbers can also be included
    762. 

  762. hierarchically in numbered
    763. 

  763. <a href="#SUBHEAD_INTRO">subheads</a>
    764. 

  764. and
    765. 

  765. <a href="#PARAHEAD_INTRO">paraheads</a>.
    766. 

  766. <p>
    767. 

  767. By default, heads are centred on the page, underlined,
    768. 

  768. all in caps.  A double linespace precedes each head.  In <a
    769. 

  769. href="docprocessing.html#PRINTSTYLE">PRINTSTYLE TYPESET</a>, heads
    770. 

  770. are bold, slightly larger than paragraph text.
    771. 

  771. <p>
    772. 

  772. If these defaults don't suit you, you can change them with the
    773. 

  773. head control macros.
    774. 

  774. <p>
    775. 

  775. 

  776. <!---HEAD--->
    777. 

  777. 

  778. <hr width="66%" align="left">
    779. 

  779. <p>
    780. 

  780. <a name="HEAD">
    781. 

  781. 	<nobr>Macro: <strong>HEAD</strong> &quot;&lt;text of head&gt;&quot; [ &quot;&lt;2nd line&gt;&quot; [ &quot;&lt;3rd line&gt;&quot; ... ] ]</nobr>
    782. 

  782. </a>
    783. 

  783. 

  784. <p>
    785. 

  785. The argument to <strong>HEAD</strong> is the text of the head,
    786. 

  786. surrounded by double-quotes.  If you need additional lines for a
    787. 

  787. head, simply surround each line with double-quotes.
    788. 

  788. <p>
    789. 

  789. <strong>NOTE:</strong> If a head falls near the bottom of an output page
    790. 

  790. and <strong>mom</strong> is unable to fit the head <em>plus at least
    791. 

  791. one line of text underneath it</em>, she will set the head at the
    792. 

  792. top of the next page.
    793. 

  793. <p>
    794. 

  794. <strong>ADDITIONAL NOTE:</strong> If an
    795. 

  795. <a href="definitions.html#TERMS_INPUTLINE">input line</a>
    796. 

  796. in a head (i.e. one of the lines surrounded by double-quotes) has
    797. 

  797. to be broken by <strong>mom</strong> in order to fit the current
    798. 

  798. line-length (say, a narrow column measure), the head underline
    799. 

  799. (underscore) will not behave.  You'll recognize the problem as soon
    800. 

  800. as you preview your document.  If you encounter a head that
    801. 

  801. misbehaves with respect to underlining, the solution is to
    802. 

  802. supply each line <em>as you want it</em> as a separate argument
    803. 

  803. (surrounded by double-quotes) to the <strong>HEAD</strong> macro.
    804. 

  804. <p>
    805. 

  805. For example, if <strong>mom</strong> breaks
    806. 

  806. <pre>
    807. 

  807. 	.HEAD "This is a very, very, very long head"
    808. 

  808. </pre>
    809. 

  809. into
    810. 

  810. <pre>
    811. 

  811. 	This is a very, very, very
    812. 

  812. 	        long head        
    813. 

  813. </pre>
    814. 

  814. 

  815. you'll see the misbehaving underscore and should change the
    816. 

  816. argument to <strong>HEAD</strong> to
    817. 

  817. <pre>
    818. 

  818. 	.HEAD "This is a very, very very" "long head"
    819. 

  819. </pre>
    820. 

  820. 

  821. <a name="HEAD_CONTROL"><h3><u>Head control macros</u></h3></a>
    822. 

  822. <p>
    823. 

  823. There are, in addition to the usual family/font/size/quad control
    824. 

  824. macros, a number of macros to manage head numbering, spacing,
    825. 

  825. underlining, and so on.  Check them out if you're unhappy with
    826. 

  826. <strong>mom</strong>'s defaults.
    827. 

  827. <p>
    828. 

  828. <ol>
    829. 

  829. 	<li><a href="#HEAD_GENERAL">Family/font/size/colour/quad</a>
    830. 

  830. 	<li><a href="#HEAD_CAPS">Caps</a>
    831. 

  831. 	<li><a href="#HEAD_SPACE">Pre-head space</a>
    832. 

  832. 	<li><a href="#HEAD_UNDERLINE">Underlining</a>
    833. 

  833. 	<li><a href="#NUMBER_HEADS">Numbering</a>
    834. 

  834. 	<li><a href="#RESET_HEAD_NUMBER">Reset head numbering</a>
    835. 

  835. 	<li><a href="#HEAD_INLINES">Vertical inline escapes inside heads</a>
    836. 

  836. </ol>
    837. 

  837. <p>
    838. 

  838. <a name="HEAD_GENERAL"><h3><u>1. Family/font/size/colour/quad</u></h3></a>
    839. 

  839. <p>
    840. 

  840. See
    841. 

  841. <a href="#CONTROL_MACRO_ARGS">Arguments to the control macros</a>.
    842. 

  842. <p>
    843. 

  843. <pre>
    844. 

  844. .HEAD_FAMILY default = prevailing document family; default is Times Roman
    845. 

  845. .HEAD_FONT   default = bold
    846. 

  846. .HEAD_SIZE   default = +1 (point)
    847. 

  847. .HEAD_COLOR  default = black
    848. 

  848. .HEAD_QUAD   default = CENTER
    849. 

  849. </pre>
    850. 

  850. 

  851. <a name="HEAD_CAPS"><h3><u>2. Capitalizing heads -- HEAD_CAPS</u></h3></a>
    852. 

  852. <p>
    853. 

  853. By default, <strong>mom</strong> sets heads in caps, regardless
    854. 

  854. of the
    855. 

  855. <a href="definitions.html#TERMS_STRINGARGUMENT">string(s)</a>
    856. 

  856. you give to
    857. 

  857. <a href="#HEAD">HEAD</a>.
    858. 

  858. To change this behaviour, do
    859. 

  859. <p>
    860. 

  860. <pre>
    861. 

  861. 	.HEAD_CAPS OFF
    862. 

  862. </pre>
    863. 

  863. 

  864. <strong>HEAD_CAPS</strong> is a toggle macro, therefore you can use
    865. 

  865. any argument you like instead of <strong>OFF</strong> (<strong>END,
    866. 

  866. QUIT, Q, X</strong>...).  To turn <strong>HEAD_CAPS</strong> back on,
    867. 

  867. simply invoke it without an argument.
    868. 

  868. <p>
    869. 

  869. 

  870. <a name="HEAD_SPACE"><h3><u>3. Space before heads -- HEAD_SPACE</u></h3></a>
    871. 

  871. <p>
    872. 

  872. By default, <strong>mom</strong> deposits 2 blank lines prior to every
    873. 

  873. head.  If you'd prefer just a single blank line, do
    874. 

  874. <p>
    875. 

  875. <pre>
    876. 

  876. 	.HEAD_SPACE OFF
    877. 

  877. </pre>
    878. 

  878. 

  879. <strong>HEAD_SPACE</strong> is a toggle macro, therefore you can use
    880. 

  880. any argument you like instead of <strong>OFF</strong> (<strong>END,
    881. 

  881. QUIT, Q, X</strong>...).  To restore the space before heads to 2
    882. 

  882. blank lines, invoke <strong>HEAD_SPACE</strong> without an argument.
    883. 

  883. <p>
    884. 

  884. 

  885. <a name="HEAD_UNDERLINE"><h3><u>4. Underlining heads -- HEAD_UNDERLINE</u></h3></a>
    886. 

  886. <p>
    887. 

  887. By default, <strong>mom</strong> underlines heads.  To change this
    888. 

  888. behaviour, do
    889. 

  889. <p>
    890. 

  890. <pre>
    891. 

  891. 	.HEAD_UNDERLINE OFF
    892. 

  892. </pre>
    893. 

  893. 

  894. <strong>HEAD_UNDERLINE</strong> is a toggle macro, therefore you can
    895. 

  895. use any argument you like instead of <strong>OFF</strong> (<strong>END,
    896. 

  896. QUIT, Q, X</strong>...).  To restore underlining of heads, invoke
    897. 

  897. <strong>HEAD_UNDERLINE</strong> without an argument.
    898. 

  898. <p>
    899. 

  899. 

  900. <a name="NUMBER_HEADS"><h3><u>5. Number heads -- NUMBER_HEADS</u></h3></a>
    901. 

  901. <p>
    902. 

  902. If you'd like your heads numbered, simply invoke
    903. 

  903. <strong>NUMBER_HEADS</strong> with no argument.  <strong>Mom</strong>
    904. 

  904. will number all subsequent heads automatically (in ascending order,
    905. 

  905. naturally).
    906. 

  906. <p>
    907. 

  907. If, in addition to numbering heads, you also request that
    908. 

  908. <a href="#SUBHEAD_INTRO">subheads</a>
    909. 

  909. and/or
    910. 

  910. <a href="#PARAHEAD_INTRO">paraheads</a>
    911. 

  911. be numbered, the head number will be included in their numbers
    912. 

  912. (each number separated by a period [dot]).
    913. 

  913. <p>
    914. 

  914. Should you wish to stop head numbering, invoke
    915. 

  915. <strong>NUMBER_HEADS</strong> with any argument (<strong>OFF, QUIT,
    916. 

  916. END, X</strong>...).  Head numbering will cease, and the head number
    917. 

  917. will not be included in the numbering of subheads and/or paraheads.
    918. 

  918. <p>
    919. 

  919. 

  920. <a name="RESET_HEAD_NUMBER"><h3><u>6. Reset head numbering -- RESET_HEAD_NUMBER</u></h3></a>
    921. 

  921. <p>
    922. 

  922. Should you wish to reset the head number to &quot;1&quot;, invoke
    923. 

  923. <strong>RESET_HEAD_NUMBER</strong> with no argument.  If, for some
    924. 

  924. reason, you want <strong>mom</strong> to use a head number that is not
    925. 

  925. the next in ascending order (i.e. the last head number + 1), invoke
    926. 

  926. <strong>RESET_HEAD_NUMBER</strong> with the number you want, e.g.
    927. 

  927. <p>
    928. 

  928. <pre>
    929. 

  929. 	.RESET_HEAD_NUMBER 6
    930. 

  930. </pre>
    931. 

  931. 

  932. Your next head will be numbered &quot;6&quot; and subsequent heads will
    933. 

  933. be numbered in ascending order from &quot;6&quot;.
    934. 

  934. <p>
    935. 

  935. 

  936. <a name="HEAD_INLINES"><h3><u>7. Vertical inline escapes inside heads</u></h3></a>
    937. 

  937. <p>
    938. 

  938. If you need to adjust the
    939. 

  939. <a href="definitions.html#TERMS_BASELINE">baseline</a>
    940. 

  940. position of a head (e.g. the head falls at the top of a column and
    941. 

  941. you want its
    942. 

  942. <a href="definitions.html#TERMS_ASCENDER">ascenders</a>
    943. 

  943. to line up with the ascenders of
    944. 

  944. <a href="definitions.html#TERMS_RUNNING">running text</a>
    945. 

  945. in other columns), you can embed a vertical motion
    946. 

  946. <a href="definitions.html#TERMS_INLINES">inline escape</a>
    947. 

  947. (either
    948. 

  948. <a href="inlines.html#INLINE_VERTICAL_MOM">mom</a>'s
    949. 

  949. or
    950. 

  950. <a href="inlines.html#INLINE_VERTICAL_GROFF">groff</a>'s
    951. 

  951. in the string(s) you pass to <strong>HEAD</strong>
    952. 

  952. <p>
    953. 

  953. For example,
    954. 

  954. <p>
    955. 

  955. <pre>
    956. 

  956. 	.HEAD "\[ALD3]Text of head"
    957. 

  957. 	    or
    958. 

  958. 	.HEAD "\[DOWN 3p]Text of head"
    959. 

  959. </pre>
    960. 

  960. 

  961. will lower the baseline of the head by three points.  Note that
    962. 

  962. there's no need to reverse the sense of the inline escape.
    963. 

  963. <p>
    964. 

  964. In the case of heads that run to more than one line, you must embed
    965. 

  965. the escape in the string for each line, like this:
    966. 

  966. <p>
    967. 

  967. <pre>
    968. 

  968. 	.HEAD "\[ALD3]First line" "\[ALD3]Next line" 
    969. 

  969. 	    or
    970. 

  970. 	.HEAD "\[DOWN 3p]First line" "\[DOWN 3p]Next line" 
    971. 

  971. </pre>
    972. 

  972. <hr>
    973. 

  973. 

  974. <!====================================================================>
    975. 

  975. 

  976. <a name="SUBHEAD_INTRO"><h2><u>Subheads</u></h2></a>
    977. 

  977. <ul>
    978. 

  978. 	<li><a href="#SUBHEAD">Tag: SUBHEAD</a>
    979. 

  979. 	<li><a href="#SUBHEAD_CONTROL">Subhead control macros</a>
    980. 

  980. </ul>
    981. 

  981. <p>
    982. 

  982. Subheads should be used any place you want titles to introduce
    983. 

  983. sections of a document below heads.  If you wish, <strong>mom</strong>
    984. 

  984. can number subheads for you.  Subhead numbers can also be included
    985. 

  985. hierarchically in numbered
    986. 

  986. <a href="#PARAHEAD_INTRO">paraheads</a>.
    987. 

  987. <p>
    988. 

  988. By default, subheads are flush left.  In
    989. 

  989. <a href="docprocessing.html#PRINTSTYLE">PRINTSTYLE TYPESET</a>,
    990. 

  990. they are set bold, slightly larger than paragraph text.  In
    991. 

  991. <a href="docprocessing.html#PRINTSTYLE">PRINTSTYLE TYPEWRITE</a>,
    992. 

  992. they are underlined.  A single linespace precedes them in both
    993. 

  993. printstyles, and a tiny space adjustment raises them slightly
    994. 

  994. above text that comes afterwards for greater clarity in
    995. 

  995. document structuring.
    996. 

  996. <p>
    997. 

  997. If these defaults don't suit you, you can change them with the
    998. 

  998. subhead control macros.
    999. 

  999. <p>
    1000. 

  1000. 

  1001. <!---SUBHEAD--->
    1002. 

  1002. 

  1003. <hr width="66%" align="left">
    1004. 

  1004. <p>
    1005. 

  1005. <a name="SUBHEAD">
    1006. 

  1006. 	<nobr>Macro: <strong>SUBHEAD</strong> &quot;&lt;text of subhead&gt;&quot; [ &quot;&lt;2nd line&gt;&quot; [ &quot;&lt;3rd line&gt;&quot; ... ] ]</nobr>
    1007. 

  1007. </a>
    1008. 

  1008. <p>
    1009. 

  1009. The argument to <strong>SUBHEAD</strong> is the text of the subhead,
    1010. 

  1010. surrounded by double-quotes.  If you need additional lines for a
    1011. 

  1011. subhead, simply surround each line with double-quotes.
    1012. 

  1012. <p>
    1013. 

  1013. <strong>NOTE:</strong> If a subhead falls near the bottom of an output
    1014. 

  1014. page and <strong>mom</strong> is unable to fit the head <em>plus at
    1015. 

  1015. least one line of text underneath it</em>, she will set the subhead
    1016. 

  1016. at the top of the next page.
    1017. 

  1017. 

  1018. <a name="SUBHEAD_CONTROL"><h3><u>Subhead control macros</u></h3></a>
    1019. 

  1019. <p>
    1020. 

  1020. In addition to the usual family/font/size/quad control
    1021. 

  1021. macros, there are macros to manage subhead numbering.
    1022. 

  1022. <p>
    1023. 

  1023. <ol>
    1024. 

  1024. 	<li><a href="#SUBHEAD_GENERAL">Family/font/size/colour/quad</a>
    1025. 

  1025. 	<li><a href="#NUMBER_SUBHEADS">Numbering</a>
    1026. 

  1026. 	<li><a href="#RESET_SUBHEAD_NUMBER">Reset subhead numbering</a>
    1027. 

  1027. 	<li><a href="#SUBHEAD_INLINES">Vertical inline escapes inside subheads</a>
    1028. 

  1028. </ol>
    1029. 

  1029. <p>
    1030. 

  1030. <a name="SUBHEAD_GENERAL"><h3><u>1. Family/font/size/quad</u></h3></a>
    1031. 

  1031. <p>
    1032. 

  1032. See
    1033. 

  1033. <a href="#CONTROL_MACRO_ARGS">Arguments to the control macros</a>.
    1034. 

  1034. <p>
    1035. 

  1035. <pre>
    1036. 

  1036. .SUBHEAD_FAMILY default = prevailing document family; default is Times Roman
    1037. 

  1037. .SUBHEAD_FONT   default = bold
    1038. 

  1038. .SUBHEAD_SIZE   default = +.5 (point)
    1039. 

  1039. .SUBHEAD_COLOR  default = black
    1040. 

  1040. .SUBHEAD_QUAD   default = LEFT
    1041. 

  1041. </pre>
    1042. 

  1042. 

  1043. <a name="NUMBER_SUBHEADS"><h3><u>2. Number subheads -- NUMBER_SUBHEADS</u></h3></a>
    1044. 

  1044. <p>
    1045. 

  1045. If you'd like your subheads numbered, simply invoke
    1046. 

  1046. <strong>.NUMBER_SUBHEADS</strong> with no argument.
    1047. 

  1047. <strong>Mom</strong> will number all subsequent subheads automatically
    1048. 

  1048. (in ascending order, naturally).
    1049. 

  1049. <p>
    1050. 

  1050. If, in addition to numbering subheads, you also request that
    1051. 

  1051. <a href="#HEAD_INTRO">heads</a>
    1052. 

  1052. be numbered, the head number will be included in the subhead number
    1053. 

  1053. (separated by a period [dot]).
    1054. 

  1054. <p>
    1055. 

  1055. Should you wish to stop subhead numbering, invoke
    1056. 

  1056. <strong>NUMBER_SUBHEADS</strong> with any argument (<strong>OFF, QUIT,
    1057. 

  1057. END, X</strong>...).  Subhead numbering will cease, and the subhead
    1058. 

  1058. number will not be included in the numbering of paraheads.
    1059. 

  1059. <p>
    1060. 

  1060. 

  1061. <a name="RESET_SUBHEAD_NUMBER"><h3><u>3. Reset head numbering -- RESET_SUBHEAD_NUMBER</u></h3></a>
    1062. 

  1062. <p>
    1063. 

  1063. Should you wish to reset the subhead number to &quot;1&quot;, invoke
    1064. 

  1064. <strong>RESET_SUBHEAD_NUMBER</strong> with no argument.  If, for some
    1065. 

  1065. reason, you want <strong>mom</strong> to use a subhead number that is not
    1066. 

  1066. the next in ascending order (i.e. the last subhead number + 1), invoke
    1067. 

  1067. <strong>RESET_SUBHEAD_NUMBER</strong> with the number you want, e.g.
    1068. 

  1068. <p>
    1069. 

  1069. <pre>
    1070. 

  1070. 	.RESET_SUBHEAD_NUMBER 4
    1071. 

  1071. </pre>
    1072. 

  1072. 

  1073. Your next subhead will be numbered &quot;4&quot; and subsequent
    1074. 

  1074. subheads will be numbered in ascending order from &quot;4&quot;.
    1075. 

  1075. 

  1076. <a name="SUBHEAD_INLINES"><h3><u>Vertical inline escapes inside subheads</u></h3></a>
    1077. 

  1077. See
    1078. 

  1078. <a href="#HEAD_INLINES">Vertical inline escapes inside heads</a>.
    1079. 

  1079. The information there applies equally to subheads.
    1080. 

  1080. <p>
    1081. 

  1081. <hr>
    1082. 

  1082. 

  1083. <!====================================================================>
    1084. 

  1084. 

  1085. <a name="PARAHEAD_INTRO"><h2><u>Paragraph heads</u></h2></a>
    1086. 

  1086. <ul>
    1087. 

  1087. 	<li><a href="#PARAHEAD">Tag: PARAHEAD</a>
    1088. 

  1088. 	<li><a href="#PARAHEAD_CONTROL">Parahead control macros</a>
    1089. 

  1089. </ul>
    1090. 

  1090. <p>
    1091. 

  1091. Paragraph heads (paraheads) should be used any place you want titles
    1092. 

  1092. to introduce paragraphs below heads or subheads.  If you wish,
    1093. 

  1093. <strong>mom</strong> can number paraheads for you.
    1094. 

  1094. <p>
    1095. 

  1095. By default, paraheads are joined to the body of a paragraph,
    1096. 

  1096. slightly indented (provided the paragraph is not a
    1097. 

  1097. &quot;first&quot; paragraph as defined in
    1098. 

  1098. <a href="#PARA_INDENT_FIRST">Indenting initial paragraphs</a>).
    1099. 

  1099. In
    1100. 

  1100. <a href="docprocessing.html#PRINTSTYLE">PRINTSTYLE TYPESET</a>,
    1101. 

  1101. they are set bold italic, slightly larger than paragraph text.  In
    1102. 

  1102. <a href="docprocessing.html#PRINTSTYLE">PRINTSTYLE TYPEWRITE</a>,
    1103. 

  1103. they are underlined.
    1104. 

  1104. <p>
    1105. 

  1105. If these defaults don't suit you, you can change them with the
    1106. 

  1106. parahead control macros.
    1107. 

  1107. <p>
    1108. 

  1108. 

  1109. <!---PARAHEAD--->
    1110. 

  1110. 

  1111. <hr width="66%" align="left">
    1112. 

  1112. <p>
    1113. 

  1113. <a name="PARAHEAD">
    1114. 

  1114. 	<nobr>Macro: <strong>PARAHEAD</strong> &quot;&lt;text of parahead&gt;&quot;</nobr>
    1115. 

  1115. </a>
    1116. 

  1116. <p>
    1117. 

  1117. <strong>PARAHEAD</strong> must come AFTER
    1118. 

  1118. <a href="#PP">PP</a>
    1119. 

  1119. or it will not work!
    1120. 

  1120. <p>
    1121. 

  1121. The argument is the text of the parahead, surrounded by double-quotes.
    1122. 

  1122. Because paraheads are joined to the body of a paragraph, they accept
    1123. 

  1123. only one argument (see
    1124. 

  1124. <a href="#HEAD">HEAD</a>
    1125. 

  1125. and
    1126. 

  1126. <a href="#SUBHEAD">SUBHEAD</a>).
    1127. 

  1127. <p>
    1128. 

  1128. 

  1129. <a name="PARAHEAD_CONTROL"><h3><u>Parahead control macros</u></h3></a>
    1130. 

  1130. <p>
    1131. 

  1131. In addition to the family/font/size/colour/indent control macros,
    1132. 

  1132. there are macros to manage parahead numbering.
    1133. 

  1133. <p>
    1134. 

  1134. <ol>
    1135. 

  1135. 	<li><a href="#PARAHEAD_GENERAL">Family/font/size/color</a>
    1136. 

  1136. 	<li><a href="#PARAHEAD_INDENT">Indent</a>
    1137. 

  1137. 	<li><a href="#NUMBER_PARAHEADS">Numbering</a>
    1138. 

  1138. 	<li><a href="#RESET_PARAHEAD_NUMBER">Reset parahead numbering</a>
    1139. 

  1139. </ol>
    1140. 

  1140. <p>
    1141. 

  1141. <a name="PARAHEAD_GENERAL"><h3><u>1. Family/font/size/colour</u></h3></a>
    1142. 

  1142. <p>
    1143. 

  1143. See
    1144. 

  1144. <a href="#CONTROL_MACRO_ARGS">Arguments to the control macros</a>.
    1145. 

  1145. <p>
    1146. 

  1146. <pre>
    1147. 

  1147. .PARAHEAD_FAMILY default = prevailing document family; default is Times Roman
    1148. 

  1148. .PARAHEAD_FONT   default = bold italic
    1149. 

  1149. .PARAHEAD_SIZE   default = +.5 (point)
    1150. 

  1150. <a name="PARAHEAD_COLOR">.PARAHEAD_COLOR  default = black*</a>
    1151. 

  1151. 

  1152. *If you colourize paragraph text, paraheads will appear in the same
    1153. 

  1153. colour as the text unless you explicitly tell mom to colour them
    1154. 

  1154. otherwise by invoking .PARAHEAD_COLOR.  If you do want paraheads
    1155. 

  1155. that are coloured the same as paragraph text, it's generally a good
    1156. 

  1156. idea to invoke .PARAHEAD_COLOR anyway (with the same colour used
    1157. 

  1157. for paragraph text), just to let mom know.
    1158. 

  1158. </pre>
    1159. 

  1159. 

  1160. <a name="PARAHEAD_INDENT"><h3><u>2. Indent</u></h3></a>
    1161. 

  1161. <p>
    1162. 

  1162. Unlike other control macros that end in
    1163. 

  1163. <a href="#CONTROL_INDENTS"><strong>_INDENT</strong></a>,
    1164. 

  1164. the argument to the macro that controls indenting of paragraph heads
    1165. 

  1165. (<strong>PARAHEAD_INDENT</strong>) is NOT relative to the first-line
    1166. 

  1166. indent of normal paragraphs.  In other words, it takes an absolute
    1167. 

  1167. value, and requires a
    1168. 

  1168. <a href="definitions.html#TERMS_UNITOFMEASURE">unit of measure</a>.
    1169. 

  1169. For example, to set the paragraph head indent to 2-1/2 picas, you
    1170. 

  1170. do:
    1171. 

  1171. <p>
    1172. 

  1172. <pre>
    1173. 

  1173. 	.PARAHEAD_INDENT 2.5P
    1174. 

  1174. </pre>
    1175. 

  1175. <strong>Mom</strong>'s default indent for paragraph heads is 1/2
    1176. 

  1176. the first-line indent of normal paragraphs (both printstyles).
    1177. 

  1177. However, as stated above, if you choose to change the indent, you
    1178. 

  1178. must give an absolute value (unless you're a groff expert and want
    1179. 

  1179. to manipulate the number register <code>\n[#PP_INDENT]u</code>
    1180. 

  1180. arithmetically as the argument to <strong>PARAHEAD_INDENT</strong>
    1181. 

  1181. for an indent that's relative to <strong>PP_INDENT</strong>.)
    1182. 

  1182. <p>
    1183. 

  1183. <strong>NOTE:</strong> Paragraph heads in &quot;first
    1184. 

  1184. paragraphs&quot;, as defined in
    1185. 

  1185. <a href="#PARA_INDENT_FIRST">Indenting initial paragraphs</a>,
    1186. 

  1186. are not indented unless you turn
    1187. 

  1187. <a href="#INDENT_FIRST_PARAS">INDENT_FIRST_PARAS</a>
    1188. 

  1188. on.
    1189. 

  1189. <p>
    1190. 

  1190. 

  1191. <a name="NUMBER_PARAHEADS"><h3><u>3. Number paraheads -- NUMBER_PARAHEADS</u></h3></a>
    1192. 

  1192. <p>
    1193. 

  1193. If you'd like your paraheads numbered, simply invoke
    1194. 

  1194. <strong>.NUMBER_PARAHEADS</strong> with no argument.
    1195. 

  1195. <strong>Mom</strong> will number all subsequent paraheads automatically
    1196. 

  1196. (in ascending order, naturally).
    1197. 

  1197. <p>
    1198. 

  1198. If, in addition to numbering paraheads, you also request that
    1199. 

  1199. <a href="#HEAD_INTRO">heads</a>
    1200. 

  1200. and
    1201. 

  1201. <a href="#SUBHEAD_INTRO">subheads</a>
    1202. 

  1202. be numbered, the head and/or subhead number will be included in the
    1203. 

  1203. parahead number (separated by a period [dot]).
    1204. 

  1204. <p>
    1205. 

  1205. Should you wish to stop parahead numbering, invoke
    1206. 

  1206. <strong>NUMBER_PARAHEADS</strong> with any argument (<strong>OFF,
    1207. 

  1207. QUIT, END, X</strong>...).  Parahead numbering will cease.
    1208. 

  1208. <p>
    1209. 

  1209. 

  1210. <a name="RESET_PARAHEAD_NUMBER"><h3><u>4. Reset head numbering -- RESET_PARAHEAD_NUMBER</u></h3></a>
    1211. 

  1211. <p>
    1212. 

  1212. Should you wish to reset the parahead number to &quot;1&quot;, invoke
    1213. 

  1213. <strong>RESET_PARAHEAD_NUMBER</strong> with no argument.  If, for some
    1214. 

  1214. reason, you want <strong>mom</strong> to use a parahead number that is not
    1215. 

  1215. the next in ascending order (i.e. the last parahead number + 1), invoke
    1216. 

  1216. <strong>RESET_PARAHEAD_NUMBER</strong> with the number you want, e.g.
    1217. 

  1217. <p>
    1218. 

  1218. <pre>
    1219. 

  1219. 	.RESET_PARAHEAD_NUMBER 7
    1220. 

  1220. </pre>
    1221. 

  1221. 

  1222. Your next parahead will be numbered &quot;7&quot; and subsequent
    1223. 

  1223. paraheads will be numbered in ascending order from &quot;7&quot;.
    1224. 

  1224. <p>
    1225. 

  1225. <hr>
    1226. 

  1226. 

  1227. <!====================================================================>
    1228. 

  1228. 

  1229. <a name="LINEBREAK_INTRO"><h2><u>Author linebreaks</u></h2></a>
    1230. 

  1230. <ul>
    1231. 

  1231. 	<li><a href="#LINEBREAK">Tag: LINEBREAK</a>
    1232. 

  1232. 	<li><a href="#LINEBREAK_CHAR">Linebreak character control macro</a>
    1233. 

  1233. </ul>
    1234. 

  1234. <p>
    1235. 

  1235. By default, <strong>mom</strong> marks
    1236. 

  1236. <a href="definitions.html#TERMS_LINEBREAK">author linebreaks</a>
    1237. 

  1237. with three centred asterisks.  You can change this behaviour
    1238. 

  1238. with the linebreak character
    1239. 

  1239. <a href="definitions.html#TERMS_CONTROLMACRO">control macro</a>.
    1240. 

  1240. <p>
    1241. 

  1241. 

  1242. <!---LINEBREAK--->
    1243. 

  1243. 

  1244. <hr width="66%" align="left">
    1245. 

  1245. <p>
    1246. 

  1246. <a name="LINEBREAK">
    1247. 

  1247. 	Macro: <strong>LINEBREAK</strong>
    1248. 

  1248. </a>
    1249. 

  1249. <br>
    1250. 

  1250. Alias: <strong>SECTION</strong>
    1251. 

  1251. 

  1252. <p>
    1253. 

  1253. <strong>LINEBREAK</strong> takes no arguments.  Simply invoke it
    1254. 

  1254. (on a line by itself, of course) whenever you want to insert an
    1255. 

  1255. author linebreak.  The appearance of the linebreak is controlled
    1256. 

  1256. by the
    1257. 

  1257. <a href="#LINEBREAK_CHAR">LINEBREAK_CHAR</a>
    1258. 

  1258. macro.
    1259. 

  1259. 

  1260. <h3><u>Linebreak character control macro</u></h3>
    1261. 

  1261. <p>
    1262. 

  1262. <a name="LINEBREAK_CHAR">
    1263. 

  1263. 	<nobr>Macro: <strong>LINEBREAK_CHAR</strong> [ &lt;character&gt; ] [ &lt;iterations&gt; [ &lt;vertical adjustment&gt; ] ]</nobr>
    1264. 

  1264. </a>
    1265. 

  1265. <br>
    1266. 

  1266. Alias: <strong>SECTION_CHAR</strong>
    1267. 

  1267. <br>
    1268. 

  1268. <em>*The third optional argument requires a
    1269. 

  1269. <a href="definitions.html#TERMS_UNITOFMEASURE">unit of measure</a></em>.
    1270. 

  1270. <p>
    1271. 

  1271. <strong>LINEBREAK_CHAR</strong> determines what <strong>mom</strong>
    1272. 

  1272. prints when <strong>LINEBREAK</strong> is invoked.  It takes 3
    1273. 

  1273. optional arguments: the character you want deposited at the line
    1274. 

  1274. break, the number of times you want the character repeated, and a
    1275. 

  1275. vertical adjustment factor.
    1276. 

  1276. <p>
    1277. 

  1277. The first argument is any legal groff character (e.g. <kbd>*</kbd>
    1278. 

  1278. [an asterisk], <kbd>\(dg</kbd> [a dagger], <kbd>\f(ZD\N'141\fP</kbd>
    1279. 

  1279. [an arbitrary character from Zapf Dingbats], <kbd>\l'4P'</kbd>
    1280. 

  1280. [a 4-pica long rule]).  <strong>Mom</strong> sets the character
    1281. 

  1281. centred on the current line length.  (See &quot;man groff_char&quot;
    1282. 

  1282. for a list of all legal groff characters.)
    1283. 

  1283. <p>
    1284. 

  1284. The second argument is the number of times to repeat the character.
    1285. 

  1285. <p>
    1286. 

  1286. The third argument is a +|- value by which to raise (+) or lower (-)
    1287. 

  1287. the character in order to make it appear visually centred between
    1288. 

  1288. sections of text.  This lets you make vertical adjustments
    1289. 

  1289. to characters that don't sit on the
    1290. 

  1290. <a href="definitions.html#TERMS_BASELINE">baseline</a>
    1291. 

  1291. (such as asterisks).  The argument must be preceded by a plus or
    1292. 

  1292. minus sign, and must include a unit of measure.
    1293. 

  1293. <p>
    1294. 

  1294. If you enter <strong>LINEBREAK_CHAR</strong> with no arguments,
    1295. 

  1295. sections of text will be separated by two blank lines when you invoke
    1296. 

  1296. <strong>LINEBREAK</strong>.
    1297. 

  1297. <p>
    1298. 

  1298. <strong>Mom</strong>'s default for <strong>LINEBREAK_CHAR</strong> is
    1299. 

  1299. <p>
    1300. 

  1300. <pre>
    1301. 

  1301. 	.LINEBREAK_CHAR * 3 -3p
    1302. 

  1302. </pre>
    1303. 

  1303. 

  1304. i.e. three asterisks, lowered 3 points from their normal vertical
    1305. 

  1305. position (for
    1306. 

  1306. <a href="docprocessing.html#PRINTSTYLE">PRINTSTYLE TYPESET</a>;
    1307. 

  1307. the vertical adjustment is -2 points for
    1308. 

  1308. <a href="docprocessing.html#PRINTSTYLE">PRINTSTYLE TYPEWRITE</a>).
    1309. 

  1309. 

  1310. <h3><u>Linebreak colour control macro</u></h3>
    1311. 

  1311. <p>
    1312. 

  1312. <a name="LINEBREAK_COLOR">
    1313. 

  1313. 	<nobr>Macro: <strong>LINEBREAK_COLOR</strong> &lt;color name&gt;</nobr>
    1314. 

  1314. </a>
    1315. 

  1315. <p>
    1316. 

  1316. To change the colour of the linebreak character(s), simply invoke
    1317. 

  1317. <strong>LINBREAK_COLOR</strong> with the name of a pre-defined (or
    1318. 

  1318. &quot;initialized&quot;) colour.
    1319. 

  1319. <br>
    1320. 

  1320. <hr>
    1321. 

  1321. 

  1322. <!====================================================================>
    1323. 

  1323. 

  1324. <a name="QUOTE_INTRO"><h2><u>Quotes (line for line)</u></h2></a>
    1325. 

  1325. <ul>
    1326. 

  1326. 	<li><a href="#QUOTE">Tag: QUOTE</a>
    1327. 

  1327. 	<li><a href="#QUOTE_CONTROL">Quote control macros</a>
    1328. 

  1328. </ul>
    1329. 

  1329. <p>
    1330. 

  1330. <a href="definitions.html#TERMS_QUOTE">Quotes</a>
    1331. 

  1331. are always set in
    1332. 

  1332. <a href="definitions.html#TERMS_NOFILL">nofill mode</a>,
    1333. 

  1333. flush left.  This permits entering quotes on a line for line basis in
    1334. 

  1334. your text editor and have them come out the same way on output copy.
    1335. 

  1335. (See
    1336. 

  1336. <a href="#BLOCKQUOTE_INTRO">Blockquotes</a>
    1337. 

  1337. for how quotes, in the present sense, differ from longer
    1338. 

  1338. passages of cited text.)
    1339. 

  1339. <p>
    1340. 

  1340. Since <strong>mom</strong> originally came into being to serve
    1341. 

  1341. the needs of creative writers (i.e. novelists, short story
    1342. 

  1342. writers, etc. -- not to cast aspersions on the creativity of
    1343. 

  1343. mathematicians and programmers), she sets quotes in italics
    1344. 

  1344. <a href="docprocessing.html#PRINTSTYLE">(PRINTSTYLE TYPESET)</a>
    1345. 

  1345. or underlined
    1346. 

  1346. <a href="docprocessing.html#PRINTSTYLE">(PRINTSTYLE TYPEWRITE)</a>,
    1347. 

  1347. indented from the left margin.  Obviously, she's thinking
    1348. 

  1348. &quot;quotes from poetry or song lyrics&quot;, but with the
    1349. 

  1349. <a href="#QUOTE_CONTROL">quote control macros</a>
    1350. 

  1350. you can change her defaults so <strong>QUOTE</strong> serves other
    1351. 

  1351. needs, e.g. entering verbatim snippets of programming code, command
    1352. 

  1352. line instructions, and so on.  (See the
    1353. 

  1353. <a href="#QUOTE_TIP">tip</a>
    1354. 

  1354. below for suggestions about including programming code snippets in
    1355. 

  1355. documents.)
    1356. 

  1356. <p>
    1357. 

  1357. <a name="QUOTE_SPACING"></a>
    1358. 

  1358. Besides indenting quotes, <strong>mom</strong> further sets them
    1359. 

  1359. off from
    1360. 

  1360. <a href="definitions.html#TERMS_RUNNING">running text</a>
    1361. 

  1361. with a small amount of vertical whitespace top and bottom.  In
    1362. 

  1362. <a href="docprocessing.html#PRINTSTYLE">PRINTSTYLE TYPEWRITE</a>,
    1363. 

  1363. this is always one full linespace.  In
    1364. 

  1364. <a href="docprocessing.html#PRINTSTYLE">PRINTSTYLE TYPESET</a>,
    1365. 

  1365. it's 1/2 of the prevailing
    1366. 

  1366. <a href="definitions.html#TERMS_LEADING">leading</a>
    1367. 

  1367. if the quote fits fully on the page (i.e. with running text above
    1368. 

  1368. and below it), otherwise it's a full linespace either above or below
    1369. 

  1369. as is necessary to balance the page to the bottom margin.  This
    1370. 

  1370. behaviour…
    1371.