/contrib/groff/contrib/mom/momdoc/letters.html

https://bitbucket.org/freebsd/freebsd-head/ · HTML · 463 lines · 412 code · 45 blank · 6 comment · 0 complexity · ececcffb0ec984696cad1b568b238fea MD5 · raw file

  1. <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 3.2 Final//EN">
  2. <html>
  3. <head>
  4. <meta http-equiv="content-type" content="text/html;charset=iso-8859-1">
  5. <title>Mom -- Document Processing, Writing Letters</title>
  6. </head>
  7. <body bgcolor="#dfdfdf">
  8. <!====================================================================>
  9. <a href="macrolist.html#TOP">Next</a>&nbsp;&nbsp;
  10. <a href="refer.html#TOP">Prev</a>&nbsp;&nbsp;
  11. <a href="toc.html">Back to Table of Contents</a>
  12. <p>
  13. <a name="TOP"></a>
  14. <a name="LETTERS">
  15. <h1 align="center"><u>WRITING LETTERS WITH MOM</u></h1>
  16. </a>
  17. <a name="LETTERS_INTRO">
  18. <h2><u>Introduction</u></h2>
  19. </a>
  20. <strong>Mom</strong>'s simple but effective letter-writing
  21. macros are a subset of the
  22. <a href="docprocessing.html#DOCPROCESSING">document processing macros</a>,
  23. designed to ease the creation of correspondence.
  24. <p>
  25. Because the letter macros are a subset of the document
  26. processing macros, you can use
  27. <a href="definitions.html#TERMS_CONTROLMACRO">control macros</a>
  28. to design correspondence to your own specifications. However,
  29. <strong>mom</strong> makes no pretence of providing complete design
  30. flexibility in the matter of letters, which are, after all, simple
  31. communicative documents whose only real style requirements are that
  32. they be neat and professional-looking.
  33. <p>
  34. <a name="TUTORIAL"><h2><u>Tutorial on writing letters</u></h2></a>
  35. <p>
  36. <strong>Mom</strong> letters begin, like all
  37. <strong>mom</strong>-processed documents, with a
  38. <a href="docprocessing.html#REFERENCE_MACROS">reference macro</a>
  39. (in this case,
  40. <a href="docprocessing.html#AUTHOR">AUTHOR</a>),
  41. a
  42. <a href="docprocessing.html#DOCTYPE">DOCTYPE</a>
  43. (<strong>LETTER</strong>, obviously), the essential
  44. <a href="docprocessing.html#PRINTSTYLE">PRINTSTYLE</a>
  45. macro, and
  46. <a href="docprocessing.html#START">START</a>,
  47. like this:
  48. <p>
  49. <pre>
  50. .AUTHOR "Yannick P. Guique"
  51. .DOCTYPE LETTER
  52. .PRINTSTYLE TYPESET
  53. .START
  54. </pre>
  55. <strong>PRINTSTYLE</strong>, above, could also be
  56. <strong>TYPEWRITE</strong>. <strong>Mom</strong> has no objection
  57. to creating letters that look like they were typed on an Underwood
  58. by a shapely secretary with 1940s gams.
  59. <p>
  60. After the <strong>START</strong> macro, you enter headers pertinent to
  61. your letter: the date, the addressee (in business correspondence,
  62. typically both name and address), the addresser (that's you; in
  63. business correspondence, typically both name and address), and a
  64. greeting (in full, e.g. &quot;Dear Mr. Smith,&quot; or &quot;Dear
  65. Mr. Smith:&quot;).
  66. <p>
  67. The macros for entering the headers are simple (they're not even
  68. <a href="definitions.html#TERMS_TOGGLE">toggles</a>):
  69. <p>
  70. <pre>
  71. .DATE
  72. .TO
  73. .FROM
  74. .GREETING
  75. </pre>
  76. You may enter them in any order you like, except for
  77. <strong>GREETING</strong>, which must come last.
  78. <strong>Mom</strong> ignores any headers you omit and spaces the
  79. letter's opening according to what you do include. See
  80. <a href="#LETTERS_DEFAULTS">Default for letters</a>
  81. to find out how <strong>mom</strong> formats the headers.
  82. <p>
  83. (In pre 1.1.7-a releases of <strong>mom</strong>, the order
  84. of entry was fixed at the above. This has been changed, although
  85. if you do follow the above order, <strong>mom</strong> will
  86. continue to behave exactly as she did in pre 1.1.7-a.)
  87. <p>
  88. Once you've filled in what you need to get a letter started, simply
  89. type the letter, introducing each and every paragraph, including
  90. the first, with the
  91. <a href="docelement.html#PP">PP</a>
  92. macro.
  93. <p>
  94. At the end of the letter, should you wish an indented closing
  95. (&quot;Yours truly,&quot; &quot;Sincerely,&quot; &quot;Hugs and
  96. kisses&quot;), invoke the macro <strong>CLOSING</strong> on a
  97. line by itself and follow it with the text of the closing.
  98. <strong>N.B.</strong> Don't put your name here; <strong>mom</strong>
  99. supplies it automatically from <strong>AUTHOR</strong> with
  100. enough space to leave room for your signature.
  101. <p>
  102. Assuming our tutorial letter is for business correspondence,
  103. here's what the complete letter looks like.
  104. <p>
  105. <pre>
  106. .AUTHOR "Yannick P. Guique"
  107. .DOCTYPE LETTER
  108. .PRINTSTYLE TYPESET
  109. .START
  110. .DATE
  111. August 25, 2004
  112. .TO
  113. GUILLAUME BARRIČRES
  114. Minidoux Corporation
  115. 5000 Pannes Drive
  116. Redmond, Virginia
  117. .FROM
  118. Y.P. GUIQUE
  119. 022 Umask Road
  120. St-Sauveur-en-dehors-de-la-mappe, Québec
  121. .GREETING
  122. Dear Mr. Barričres,
  123. .PP
  124. It has come to my attention that you have been lobbying the
  125. US government to prohibit the use of open source software by
  126. endeavouring to outlaw so-called &quot;warranty free&quot;
  127. applications.
  128. .PP
  129. I feel it is my duty to inform you that the success of your
  130. operating system with its embedded web browser relies heavily
  131. on open source programs and protocols, most notably TCP/IP.
  132. .PP
  133. Therefore, in the interests of your corporation's fiscal health,
  134. I strongly advise that you withdraw support for any US
  135. legislation that would cripple or render illegal open source
  136. development.
  137. .CLOSING
  138. Sincerely,
  139. </pre>
  140. This produces a letter with headers that follow the North American
  141. standard for business correspondence. If you'd prefer another
  142. style of correspondence, for example, British, you'd set up the
  143. same letter like this:
  144. <p>
  145. <pre>
  146. .AUTHOR "Yannick P. Guique"
  147. .DOCTYPE LETTER
  148. .PRINTSTYLE TYPESET
  149. .START
  150. .FROM
  151. .RIGHT
  152. Y.P. GUIQUE
  153. 022 Umask Road
  154. St-Sauveur-en-dehors-de-la-mappe, Québec
  155. .TO
  156. GUILLAUME BARRIČRES
  157. Minidoux Corporation
  158. 5000 Pannes Drive
  159. Redmond, Virginia
  160. .DATE
  161. .RIGHT
  162. August 25, 2004
  163. .GREETING
  164. Dear Mr. Barričres,
  165. </pre>
  166. Notice the use of <strong>.RIGHT</strong> after
  167. <strong>.FROM</strong> and <strong>.DATE</strong> in this example,
  168. used to change the default quad for these macros.
  169. <p>
  170. <hr>
  171. <a name="LETTERS_DEFAULTS">
  172. <h2><u>Defaults for letters</u></h2>
  173. </a>
  174. In letters, if the order of header macros is
  175. <p>
  176. <pre>
  177. .DATE
  178. .TO
  179. .FROM
  180. .GREETING
  181. </pre>
  182. <strong>mom</strong> sets
  183. <br>
  184. <ol>
  185. <li>the date flush right, page right, at the top of page one,
  186. with a gap of two linespaces underneath
  187. <li>the addressee in a block flush left, page left, with a gap of
  188. one linespace underneath
  189. <li>the addresser in a block flush left, page left, with a gap of
  190. one linespace underneath
  191. <li>the greeting flush left, with a gap of one linespace
  192. underneath
  193. </ol>
  194. <p>
  195. which is the standard for North American business correspondence.
  196. <p>
  197. If you switch the order of <strong>.DATE</strong>,
  198. <strong>.TO</strong> and/or <strong>.FROM</strong>,
  199. <strong>mom</strong> sets all the headers flush left, with a gap of
  200. one linespace underneath each. (The default left quad of any header
  201. can be changed by invoking the <strong>.RIGHT</strong> macro, on
  202. a line by itself, immediately before inputting the text of the
  203. header.)
  204. <p>
  205. Following the headers, <strong>mom</strong> sets
  206. <p>
  207. <ul>
  208. <li>the body of the letter justified
  209. <li>in multi-page letters:
  210. <ul>
  211. <li>a footer indicating there's a next page (of the form <code>.../#</code>)
  212. <li>the page number at the top of every page after page one
  213. </ul>
  214. <li>the closing/signature line flush left, indented halfway across the page
  215. </ul>
  216. <p>
  217. Other important style defaults are listed below, and may be changed
  218. via the
  219. <a href="typesetting.html#MACROS_TYPESETTING">typesetting macros</a>
  220. or the document processing
  221. <a href="definitions.html#TERMS_CONTROLMACRO">control macros</a>
  222. prior to
  223. <a href="docprocessing.html#START">START</a>. Assume that any
  224. style parameter not listed below is the same as for
  225. <a href="docprocessing.html#TYPESET_DEFAULTS">PRINTSTYLE TYPESET</a>
  226. or
  227. <a href="docprocessing.html#TYPEWRITE_DEFAULTS">PRINTSTYLE TYPEWRITE</a>.
  228. <p>
  229. <pre>
  230. PARAMETER PRINTSTYLE TYPESET PRINTSTYLE TYPEWRITE
  231. --------- ------------------ --------------------
  232. Paper size 8.5 x 11 inches 8.5 x 11 inches
  233. Left/right margins 1.25 inches 1.25 inches
  234. Header margin 3.5 picas 3.5 picas
  235. (for page numbers)
  236. Header gap 3 picas 3 picas
  237. (for page numbers)
  238. Family Times Roman Courier
  239. Font roman roman
  240. Point size 12 12
  241. Line space 13.5 12 (i.e. singlespaced)
  242. Paragraph indent 3 ems 3 picas
  243. Spaced paragraphs yes no
  244. Footers* yes yes
  245. Footer margin 3 picas 3 picas
  246. Footer gap 3 picas 3 picas
  247. Page numbers top, centred top, centred
  248. *Footers contain a &quot;next page&quot; number of the form .../#
  249. </pre>
  250. <hr>
  251. <a name="LETTERS_MACROS">
  252. <h2><u>The letter macros</u></h2>
  253. </a>
  254. All letter macros must come after
  255. <a href="docprocessing.html#START">START</a>,
  256. except <strong>NO_SUITE</strong>.
  257. <p>
  258. <ul>
  259. <li><a href="#DATE">DATE</a>
  260. <li><a href="#TO">TO</a>
  261. <li><a href="#FROM">FROM</a>
  262. <li><a href="#GREETING">GREETING</a>
  263. <li><a href="#CLOSING">CLOSING</a>
  264. <li><a href="#NO_SUITE">NO_SUITE</a> -- &quot;next page&quot; number off
  265. </ul>
  266. <br>
  267. <!---DATE--->
  268. <hr width="66%" align="left">
  269. <p>
  270. <a name="DATE"></a>
  271. Macro: <strong>DATE</strong>
  272. <p>
  273. Invoke <strong>DATE</strong> on a line by itself, with the date
  274. underneath, like this:
  275. <p>
  276. <pre>
  277. .DATE
  278. October 31, 2002
  279. </pre>
  280. If you wish to change the default quad direction for the date,
  281. enter <kbd>.LEFT</kbd> or <kbd>.RIGHT</kbd>, on a line by itself,
  282. immediately after <kbd>.DATE</kbd>.
  283. <p>
  284. If you wish to insert additional space between the date and any
  285. letter header that comes after it, do so after inputting the date,
  286. not at the top of the next header macro, like this:
  287. <p>
  288. <pre>
  289. .DATE
  290. October 31, 2002
  291. .SPACE \" Or, more simply, .SP
  292. </pre>
  293. If you wish to remove the default space,
  294. <p>
  295. <pre>
  296. .SPACE -1v \" Or, more simply, .SP -1v
  297. </pre>
  298. will do the trick.
  299. <p>
  300. <!---TO--->
  301. <hr width="66%" align="left">
  302. <p>
  303. <a name="TO"></a>
  304. Macro: <strong>TO</strong>
  305. <p>
  306. Invoke <strong>TO</strong> on a line by itself, with the name
  307. and address of the addressee underneath, like this:
  308. <p>
  309. <pre>
  310. .TO
  311. JOHN SMITH
  312. 10 Roberts Crescent
  313. Bramladesh, Ont.
  314. </pre>
  315. If you wish to change the default quad direction for the address,
  316. enter <kbd>.LEFT</kbd> or <kbd>.RIGHT</kbd>, on a line by itself,
  317. immediately after <kbd>.TO</kbd>.
  318. <p>
  319. If you wish to insert additional space between the address and
  320. any letter header that comes after it, do so after inputting the
  321. address, not at the top of the next header macro, like this:
  322. <p>
  323. <pre>
  324. .TO
  325. JOHN SMITH
  326. 10 Roberts Crescent
  327. Bramladesh, Ont.
  328. .SPACE \" Or, more simply, .SP
  329. </pre>
  330. If you wish to remove the default space,
  331. <p>
  332. <pre>
  333. .SPACE -1v \" Or, more simply, .SP -1v
  334. </pre>
  335. will do the trick.
  336. <p>
  337. <!---FROM--->
  338. <hr width="66%" align="left">
  339. <p>
  340. <a name="FROM"></a>
  341. Macro: <strong>FROM</strong>
  342. <p>
  343. Invoke <strong>FROM</strong> on a line by itself, with the name
  344. and address of the addresser underneath, like this:
  345. <p>
  346. <pre>
  347. .FROM
  348. JOE BLOW
  349. 15 Brunette Road
  350. Ste-Vieille-Andouille, Québec
  351. </pre>
  352. If you wish to change the default quad direction for the address,
  353. enter <kbd>.LEFT</kbd> or <kbd>.RIGHT</kbd>, on a line by itself,
  354. immediately after <kbd>.FROM</kbd>.
  355. <p>
  356. If you wish to insert additional space between the address and
  357. any letter header that comes after it, do so after inputting the
  358. address, not at the top of the next header macro, like this:
  359. <p>
  360. <pre>
  361. .FROM
  362. JOE BLOW
  363. 15 Brunette Road
  364. Ste-Vieille-Andouille, Québec
  365. .SPACE \" Or, more simply, .SP
  366. </pre>
  367. If you wish to remove the default space,
  368. <p>
  369. <pre>
  370. .SPACE -1v \" Or, more simply, .SP -1v
  371. </pre>
  372. will do the trick.
  373. <p>
  374. <!---GREETING--->
  375. <hr width="66%" align="left">
  376. <p>
  377. <a name="GREETING"></a>
  378. Macro: <strong>GREETING</strong>
  379. <p>
  380. Invoke <strong>GREETING</strong> on a line by itself, with the
  381. full salutation you want for the letter, like this:
  382. <p>
  383. <pre>
  384. .GREETING
  385. Dear Mr. Smith,
  386. </pre>
  387. <!---CLOSING--->
  388. <hr width="66%" align="left">
  389. <p>
  390. <a name="CLOSING"></a>
  391. Macro: <strong>CLOSING</strong>
  392. <p>
  393. Invoke <strong>CLOSING</strong> on a line by itself after the
  394. body of the letter, with the closing you'd like (e.g. &quot;Yours
  395. truly,&quot;), like this:
  396. <p>
  397. <pre>
  398. .CLOSING
  399. Yours truly,
  400. </pre>
  401. <!---NO_SUITE--->
  402. <hr width="66%" align="left">
  403. <p>
  404. <a name="NO_SUITE"></a>
  405. Macro: <strong>NO_SUITE</strong>
  406. <p>
  407. If you don't want <strong>mom</strong> to print a &quot;next
  408. page&quot; number at the bottom of multi-page letters, invoke
  409. <code>.NO_SUITE</code>, on a line by itself, prior to
  410. <a href="docprocessing.html#START">START</a>.
  411. <p>
  412. <hr>
  413. <a href="macrolist.html#TOP">Next</a>&nbsp;&nbsp;
  414. <a href="refer.html#TOP">Prev</a>&nbsp;&nbsp;
  415. <a href="#TOP">Top</a>&nbsp;&nbsp;
  416. <a href="toc.html">Back to Table of Contents</a>
  417. </body>
  418. </html>