contrib/groff/contrib/mom/momdoc/definitions.html

   1 <html>
   2 <head>
   3 <meta http-equiv="content-type" content="text/html;charset=iso-8859-1">
   4 <title>Mom -- Definitions and Terms</title>
   5 </head>
   6 <body bgcolor="#dfdfdf">
   7
   8 <!====================================================================>
   9
  10 <a href="using.html#TOP">Next</a>&nbsp;&nbsp;
  11 <a href="intro.html#TOP">Prev</a>&nbsp;&nbsp;
  12 <a href="toc.html">Back to Table of Contents</a>
  13
  14 <a name="TOP"></a>
  15 <a name="TERMS">
  16         <h1 align="center"><u>DEFINITIONS OF TERMS USED IN THIS MANUAL</u></h1>
  17 </a>
  18
  19 <a href="#TERMS_TYPESETTING">Typesetting Terms</a>
  20 <br>
  21 <a href="#TERMS_GROFF">Groff Terms</a>
  22 <br>
  23 <a href="#TERMS_MOM">Mom Document Processing Terms</a>
  24 <p>
  25 I use a number of typesetting-specific and groff-specific terms
  26 throughout this documentation, as well as a few terms that apply
  27 to <strong>mom</strong> herself.  To make life easier, I'll explain
  28 them here.  Refer back to this section should you encounter a word
  29 or concept you're not familiar with.  Words in these definitions that
  30 are defined elsewhere in this section are marked with asterisks.
  31 <br>
  32 <hr>
  33
  34 <a name="TERMS_TYPESETTING">
  35         <h2><u>Typesetting terms</u></h2>
  36 </a>
  37
  38 <ul>
  39         <li><a href="#TERMS_ASCENDER">Ascender</a>
  40         <li><a href="#TERMS_BASELINE">Baseline</a>
  41         <li><a href="#TERMS_BALLOTBOX">Ballot box</a>
  42         <li><a href="#TERMS_BULLET">Bullet</a>
  43         <li><a href="#TERMS_CAPHEIGHT">Cap-height</a>
  44         <li><a href="#TERMS_DESCENDER">Descender</a>
  45         <li><a href="#TERMS_DISCRETIONARYHYPHEN">Discretionary hyphen</a>
  46         <li><a href="#TERMS_DROPCAP">Drop cap</a>
  47         <li><a href="#TERMS_EM">Em/en</a>
  48         <li><a href="#TERMS_FAMILY">Family</a>
  49         <li><a href="#TERMS_FIGURESPACE">Figure space/Digit space</a>
  50         <li><a href="#TERMS_FIXEDWIDTHSPACE">Fixed width space</a>
  51         <li><a href="#TERMS_FONT">Font</a>
  52         <li><a href="#TERMS_FORCE">Force justify</a>
  53         <li><a href="#TERMS_JUST">Justify/justification</a>
  54         <li><a href="#TERMS_GUTTER">Gutter</a>
  55         <li><a href="#TERMS_KERN">Kerning</a>
  56         <li><a href="#TERMS_KERNUNIT">Kern Units</a>
  57         <li><a href="#TERMS_LEADING">Lead/leading</a>
  58         <li><a href="#TERMS_LEADER">Leaders</a>
  59         <li><a href="#TERMS_LIGATURES">Ligature</a>
  60         <li><a href="#TERMS_PICASPOINTS">Picas/Points</a>
  61         <li><a href="#TERMS_PS">Point Size</a>
  62         <li><a href="#TERMS_QUAD">Quad</a>
  63         <li><a href="#TERMS_RAG">Rag</a>
  64         <li><a href="#TERMS_SOLID">Solid/set solid</a>
  65         <li><a href="#TERMS_TRACKKERNING">Track kerning/Line kerning</a>
  66         <li><a href="#TERMS_UNBREAKABLESPACE">Unbreakable space</a>
  67         <li><a href="#TERMS_WORDSPACE">Word space</a>
  68         <li><a href="#TERMS_XHEIGHT">x-height</a>
  69 </ul>
  70 <dl>
  71
  72 <dt><a name="TERMS_ASCENDER"><em>Ascender</em></a>
  73 <dd>The portion of a letter that extends above the bowl.  For example,
  74 the letters a, c, and e have no ascenders.  The letters b, d, and h
  75 do.
  76
  77 <dt><a name="TERMS_BASELINE"><em>Baseline</em></a>
  78 <dd>The imaginary line on which the bottoms of capital letters and the
  79 bowls of lower case letters rest.
  80
  81 <dt><a name="TERMS_BALLOTBOX"><em>Ballot box</em></a>
  82 <dd>An unfilled square, usually <strong>*cap-height</strong> in size,
  83 typically placed beside items in a checklist.
  84
  85 <dt><a name="TERMS_BULLET"><em>Bullet</em></a>
  86 <dd>A small, filled circle typically found beside items or points in
  87 a list.
  88
  89 <dt><a name="TERMS_CAPHEIGHT"><em>Cap-height</em></a>
  90 <dd>The height of the tallest capital letter in a given
  91 <strong>*font</strong> at the current <strong>*point
  92 size</strong>.
  93
  94 <dt><a name="TERMS_DESCENDER"><em>Descender</em></a>
  95 <dd>The portion of a letter that extends beneath the
  96 <strong>*baseline</strong> (j, q, y are letters with descenders).
  97
  98 <dt><a name="TERMS_DISCRETIONARYHYPHEN"><em>Discretionary hyphen</em></a>
  99 <dd>A symbol inserted between two syllables of a word that indicates to a
 100 typesetting program the legal hyphenation points in the word.  Normally,
 101 if hyphenation is turned on, groff knows where to hyphenate words.
 102 However, hyphenation being what it is (in English, at any rate),
 103 groff doesn't always get it right.  Discretionary hyphens make sure
 104 it does.  In the event that the word doesn't need to be hyphenated
 105 at all, groff leaves them alone.  In groff, the discretionary hyphen is
 106 entered with
 107 <p>
 108 <pre>
 109         \%
 110 </pre>
 111
 112 (backslash followed by a percent).
 113
 114 <dt><a name="TERMS_DROPCAP"><em>Drop cap</em></a>
 115 <dd>A large, usually upper-case letter that introduces the first
 116 paragraph of a document or section thereof.  The top of the drop
 117 cap usually lines up with the top of the first line of the
 118 paragraph, and typically &quot;drops&quot; several lines lower.
 119 Text adjacent to the drop cap is indented to the right of the
 120 letter until the bottom of the drop cap is reached, at which
 121 point text reverts to the left margin.
 122
 123 <dt><a name="TERMS_EM"><em>Em/en</em></a>
 124 <dd>A relative measurement equal to the width of the letter M at a
 125 given <strong>*point size</strong> in a given <strong>*font</strong>.
 126 Since most Ms are designed square, an em is usually (but sometimes
 127 erroneously) considered to be the same size as the current point size
 128 (i.e. if the point size of the type is 12, one em equals 12 points).
 129 An en is equal to the width of a letter N (historically 2/3 of an em,
 130 although groff treats an en as 1/2 of an em).  Typically, ems and
 131 ens are used to measure indents, or to define the length of dashes
 132 (long hyphens).
 133
 134 <dt><a name="TERMS_FAMILY"><em>Family</em></a>
 135 <dd>The collective name by which a collection of
 136 <strong>*fonts</strong> are known, e.g.  Helvetica, Times Roman,
 137 Garamond.
 138
 139 <dt><a name="TERMS_FIGURESPACE"><em>Figure space/Digit space</em></a>
 140 <dd>A <strong>*fixed width space</strong> that has the width of one digit.  Used for
 141 aligning numerals in, say, columns or numbered lists.  In groff,
 142 the figure space is entered with
 143 <p>
 144 <pre>
 145         \0
 146 </pre>
 147
 148 (backslash followed by a zero).
 149
 150 <dt><a name="TERMS_FIXEDWIDTHSPACE"><em>Fixed width space</em></a>
 151 <dd>Equal to <strong>*word space</strong>, but does not expand or
 152 contract when text is <strong>*justified</strong>.  In groff, fixed
 153 width space is entered with
 154 <p>
 155 <pre>
 156         \&lt;space&gt;
 157 </pre>
 158
 159 where &lt;space&gt; means "hit the spacebar on your keyboard."
 160
 161 <dt><a name="TERMS_FONT"><em>Font</em></a>
 162 <dd>The specific style of type within a <strong>*family</strong>,
 163 e.g. roman, italic.  Groff understands four fonts within any given
 164 family: roman, italic, bold, and bold italic.
 165
 166 <dt><a name="TERMS_FORCE"><em>Force justify
 167 </em></a>
 168 <dd>Sometimes, in <strong>*justified</strong> text, a line needs to be
 169 broken short of the right margin.  Force justifying means telling a
 170 typesetting program (like groff) that you want the line broken early
 171 AND that you want the line's word spacing stretched to force the line
 172 flush with the right margin.
 173
 174 <dt><a name="TERMS_GUTTER"><em>Gutter</em></a>
 175 <dd>The vertical whitespace separating columns of type.
 176
 177 <dt><a name="TERMS_JUST"><em>Justify/justification</em></a>
 178 <dd>Lines of type are justified when they're flush at both the left and
 179 right margins.  Justification is the act of making both margins flush.
 180 Some people use the terms "left justified" and "right justified"
 181 to mean type where only the left (or right) margins align.  I don't.
 182 See <strong>*quad</strong>.
 183
 184 <dt><a name="TERMS_KERN"><em>Kerning</em></a>
 185 <dd>Moving pairs of letters closer together to remove excess
 186 whitespace between them.  In the days before phototypesetting,
 187 type was set from small, rectangular blocks of wood or metal, each
 188 block having exactly one letter.  Because the edge of each block
 189 determined the edge of each letter, certain letter combinations (TA,
 190 for example) didn't fit together well and had to be morticed by hand
 191 to bring them visually closer.  Modern typesetting systems usually
 192 take care of kerning automatically, but they're far from perfect.
 193 Professional typesetters still devote a lot of time to fitting letters
 194 and punctuation together properly.
 195
 196 <dt><a name="TERMS_KERNUNIT"><em>Kern Units</em></a>
 197 <dd>A relative distance equal to 1/36 of the current
 198 <strong>*point size</strong>.  Used between individual letters
 199 for <strong>*kerning</strong>.  Different typesetting systems use
 200 different values (1/54 is popular), and sometimes call kern units by
 201 a different name.
 202 <p>
 203 <strong>Experts:
 204 <br></strong>A kern unit has nothing to do with groff
 205 machine units.
 206
 207 <dt><a name="TERMS_LEADING"><em>Lead/leading</em></a>
 208 <dd>The distance from the <strong>*baseline</strong> of one line of
 209 type to the line of type immediately beneath it.  Pronounced "ledding."
 210 Also called line spacing.  Usually measured in <strong>*points</strong>.
 211 <p>
 212 <em>In case you're interested...</em> In previous centuries,
 213 lines of type were separated by thin strips of -- you guessed it
 214 -- lead.  Lines of type that had no lead between them were said to
 215 be &quot;set solid.&quot; Once you began separating them with strips
 216 of lead, they were said to be &quot;leaded&quot;, and the spacing was
 217 expressed in terms of the number of <strong>*points</strong> of lead.
 218 For this reason, &quot;leading&quot; and &quot;line spacing&quot;
 219 aren't, historically speaking, synonymous.  If type was set 10 on 12,
 220 for example, the leading was 2 points, not 12.  Nowadays, however,
 221 the two terms are used interchangeably to mean the distance from
 222 baseline to baseline.
 223
 224 <dt><a name="TERMS_LEADER"><em>Leaders</em></a>
 225 <dd>Single characters used to fill lines, usually to their end.
 226 So called because they &quot;lead&quot; the eye from one element
 227 of the page to another.  For example, in the following (brief)
 228 Table of Contents, the periods (dots) are leaders.
 229 <p>
 230 <pre>
 231         Foreword............... 2
 232         Chapter 1.............. 5
 233         Chapter 2.............. 38
 234         Chapter 3.............. 60
 235 </pre>
 236
 237 <dt><a name="TERMS_LIGATURES"><em>Ligature</em></a>
 238 <dd>Ligatures are letters joined together to form a single character.
 239 The commonest are fi, fl, ff, ffi and ffl.  Others are ae and oe.
 240 Occasionally, one sees an st ligature, but this is archaic and
 241 quite rare.
 242
 243 <dt><a name="TERMS_PICASPOINTS"><em>Picas/Points</em></a>
 244 <dd>There are twelve points in a pica, and six picas in an inch
 245 (hence 72 points to the inch).  In the same way that gem-dealers
 246 have always used their own system of measurement for weight (carats),
 247 typographers have always used their own system of measurement for type.
 248
 249 <dt><a name="TERMS_PS"><em>Point Size</em></a>
 250 <dd>The nominal size of type, measured in <strong>*points</strong>,
 251 from the bottom of the longest <strong>*descender</strong> to the top
 252 of the highest <strong>*ascender</strong>.  In reality, type is always
 253 fractionally smaller than its point size.
 254
 255 <dt><a name="TERMS_QUAD"><em>Quad</em></a>
 256 <dd>When only one margin of type is flush, lines of type are quadded in
 257 the direction of the flush margin.  Therefore, quad left means the
 258 left margin is flush, the right isn't.  Quad right means the right
 259 margin is flush, the left isn't.  Quad center means neither the left
 260 nor the right margin is flush; rather, lines of type are quadded on
 261 both sides so that type appears centered on the page.
 262
 263 <dt><a name="TERMS_RAG"><em>Rag</em></a>
 264 <dd>Describes a margin that isn't flush.  Rag right means the right
 265 margin isn't flush.  Rag left means the left margin isn't flush.
 266 The expression "flush left/rag right" is sometimes used to describe
 267 type that is <strong>*quadded</strong> left.
 268
 269 <dt><a name="TERMS_SOLID"><em>Solid/set solid</em></a>
 270 <dd>When no <strong>*lead</strong> is added between lines of type
 271 (i.e. the <strong>*point size</strong> and linespacing are the
 272 same), the lines are said to be &quot;set solid.&quot;
 273
 274 <dt><a name="TERMS_TRACKKERNING"><em>Track kerning/Line kerning</em></a>
 275 <dd>Sometimes, it's advantageous to increase or decrease the amount of
 276 space between every letter in a line by an equal (usually small)
 277 amount, in order to fit more (or fewer) characters on the line.
 278 The correct term is letter spacing, but track kerning and line kerning
 279 (and sometimes, just "kerning") have come to mean the same thing.
 280
 281 <dt><a name="TERMS_UNBREAKABLESPACE"><em>Unbreakable space</em></a>
 282 <dd>Equal to <strong>*word space</strong>, however words separated by
 283 an unbreakable space will always be kept together on the same line.
 284 Expands and contracts like word space.  Useful for proper names, which
 285 should never be broken.  In groff, unbreakable space is entered with
 286 <p>
 287 <pre>
 288         \~
 289 </pre>
 290
 291 (backslash followed by a tilde).
 292
 293 <dt><a name="TERMS_WORDSPACE"><em>Word space</em></a>
 294 <dd>The amount of whitespace between words.  When text is
 295 <strong>*justified</strong>, word space expands or contracts to make
 296 the margins flush.
 297
 298 <dt><a name="TERMS_XHEIGHT"><em>x-height</em></a>
 299 <dd>The height of a lower case letter x in a given font at a given
 300 point size.  Generally used to mean the average height of the bowl
 301 of lower case letters.
 302 </dl>
 303 <hr>
 304
 305 <a name="TERMS_GROFF">
 306         <h2><u>Groff terms</u></h2>
 307 </a>
 308
 309 <ul>
 310         <li><a href="#TERMS_ALIAS">Alias</a>
 311         <li><a href="#TERMS_ARGUMENTS">Arguments</a>
 312         <li><a href="#TERMS_COMMENTLINES">Comment lines</a>
 313         <li><a href="#TERMS_CONTROLLINES">Control Lines</a>
 314         <li><a href="#TERMS_FILLED">Filled lines</a>
 315         <li><a href="#TERMS_INLINES">Inline escapes</a>
 316         <li><a href="#TERMS_INPUTLINE">Input line</a>
 317         <li><a href="#TERMS_MACROS">Macros</a>
 318         <li><a href="#TERMS_UNITS">Machine units</a>
 319         <li><a href="#TERMS_NUMERICARGUMENT">Numeric argument</a>
 320         <li><a href="#TERMS_OUTPUTLINE">Output line</a>
 321         <li><a href="#TERMS_PRIMITIVES">Primitives</a>
 322         <li><a href="#TERMS_STRINGARGUMENT">String Argument</a>
 323         <li><a href="#TERMS_UNITOFMEASURE">Unit of measure</a>
 324         <li><a href="#TERMS_ZEROWIDTHCHARACTER">Zero-width character</a>
 325 </ul>
 326 <dl>
 327
 328 <dt><a name="TERMS_ALIAS"><em>Alias</em></a>
 329 <dd>A <strong>*macro</strong> invoked by a name different from its
 330 &quot;official&quot; name.  For example, the official name of the
 331 macro to change <strong>*family</strong> is <strong>FAMILY</strong>.
 332 Its alias is <strong>FAM</strong>.  Aliases may be created for any
 333 macro (via the
 334 <a href="goodies.html#ALIAS">ALIAS</a>
 335 macro) provided the alias uses a name not already taken
 336 by the <strong>mom</strong> macros or one of the groff
 337 <strong>*primitives</strong>.  For a complete list of alias names
 338 you must not use, see the
 339 <a href="reserved.html#RESERVED">list of reserved words</a>.
 340
 341 <dt><a name="TERMS_ARGUMENTS"><em>Arguments</em></a>
 342 <dd>Parameters or information needed by a <strong>*macro</strong>
 343 to do its job.  For example, in the macro
 344 <p>
 345 <pre>
 346         .PT_SIZE 12
 347 </pre>
 348
 349 &quot;12&quot; is the argument.  In the macro
 350 <p>
 351 <pre>
 352         .QUAD LEFT
 353 </pre>
 354
 355 LEFT is the argument.  Arguments are separated from macros by spaces.
 356 Some macros require several arguments; each is separated by a space.
 357
 358 <dt><a name="TERMS_COMMENTLINES"><em>Comment Lines</em></a>
 359 <dd><strong>*Input lines</strong> introduced with the comment character
 360 <p>
 361 <pre>
 362         \#
 363 </pre>
 364
 365 When processing output, groff silently ignores everything on the
 366 line after the comment character.
 367
 368 <dt><a name="TERMS_CONTROLLINES"><em>Control Lines</em></a>
 369 <dd>Instructions to groff that appear on a line by themselves,
 370 which means that &quot;control lines&quot; are either
 371 <strong>*macros</strong> or <strong>*groff primitives</strong>.
 372 Control lines begin with a period or, occasionally, an apostrophe.
 373
 374 <dt><a name="TERMS_FILLED"><em>Filled lines/fill mode</em></a>
 375 <dd>Automatic <strong>*justification</strong> or
 376 <strong>*quadding</strong>.  In fill mode, the ends of lines as they
 377 appear in your text editor are ignored.  Instead, words from adjoining
 378 <strong>*input lines</strong> are added one at a time to the output
 379 line until no more words fit.  Then, depending whether text is to
 380 be <strong>*justified</strong> or <strong>*quadded</strong> (left,
 381 right, or center), and depending on whether automatic hyphenation
 382 is turned on, groff attempts to hyphenate the last word, or, barring
 383 that, spreads and breaks the line (when justification is turned on) or
 384 breaks and quads the line (when quadding is turned on).
 385 <p>
 386 <a name="TERMS_NOFILL"></a>
 387 Nofill mode (non-filled text) means that groff respects the ends
 388 of lines as they appear in your text editor.
 389
 390 <dt><a name="TERMS_INLINES"><em>Inline escapes</em></a>
 391 <dd>Instructions issued to groff that appear as part of an
 392 <strong>*input line</strong> (as opposed to <strong>*macros</strong>,
 393 which must appear on a line by themselves).  Inline escapes are always
 394 introduced by the backslash character.  For example,
 395 <p>
 396 <pre>
 397         A line of text with the word T\*[BU 2]oronto in it
 398 </pre>
 399
 400 contains the inline escape \*[BU 2] (which means &quot;move the letter
 401 'o' 2 <strong>*kern units</strong> closer to the letter 'T'&quot;).
 402 <p>
 403 <strong>Mom</strong>'s inline escapes always take the form
 404 <strong>\*[</strong><i>ESCAPE</i><strong>]</strong>, where <i>ESCAPE</i>
 405 is composed of capital letters, sometimes followed immediately
 406 by a digit, sometimes followed by a space and a <strong>*numeric
 407 argument</strong>. <strong>Groff</strong>'s escapes begin with the
 408 backslash character but typically have no star and are in lower case.
 409 For example, the <strong>mom</strong> escapes to move forward 6 points
 410 on a line are either
 411 <p>
 412 <pre>
 413         \*[FP6]&nbsp;&nbsp;or&nbsp;&nbsp;\*[FWD 6p]
 414 </pre>
 415
 416 while the <strong>groff</strong> escape for the same thing is
 417 <p>
 418 <pre>
 419         \h'6p'
 420 </pre>
 421
 422 <dt><a name="TERMS_INPUTLINE"><em>Input line</em></a>
 423 <dd>A line of text as it appears in your text editor.
 424
 425 <dt><a name="TERMS_MACROS"><em>Macros</em></a>
 426 <dd>Instructions embedded in a document that determine how groff processes
 427 the text for output.  <strong>mom</strong>'s macros always begin with a
 428 period, on a line by themselves, and must be typed in capital letters.
 429 Typically, macros contain complex commands issued to groff -- behind
 430 the scenes -- via groff <strong>*primitives</strong>.
 431
 432 <dt><a name="TERMS_UNITS"><em>Machine units</em></a>
 433 <dd>A machine unit is 1/1000 of a <strong>*point</strong> when the
 434 groff device is ps.  (&quot;ps&quot; means &quot;PostScript&quot;  --
 435 the default device for which groff prepares output, and the device for
 436 which <strong>mom</strong> was specifically designed.)
 437
 438 <dt><a name="TERMS_NUMERICARGUMENT"><em>Numeric argument</em></a>
 439 <dd>An <strong>*argument</strong> that has the form of a digit.
 440 Numeric arguments can be built out of arithmetic expressions using
 441 +, -, *, and / for plus, minus, times, and divided-by respectively.
 442 If a numeric argument requires a <strong>*unit of measure</strong>,
 443 a unit of measure must be appended to <em>every</em> digit in the
 444 argument.  For example:
 445 <p>
 446 <pre>
 447         .ALD 1i-1v
 448 </pre>
 449
 450 <strong>NOTE:</strong> groff does not respect the order of operations,
 451 but rather evaluates arithmetic expressions from left to right.
 452 Parentheses must be used to circumvent this peculiarity.  Not to
 453 worry, though.  The likelihood of more than just the occasional plus
 454 or minus sign when using <strong>mom</strong>'s macros is slim.
 455
 456 <dt><a name="TERMS_OUTPUTLINE"><em>Output line</em></a>
 457 <dd>A line of text as it appears in output copy.
 458
 459 <dt><a name="TERMS_PRIMITIVES"><em>Primitives</em></a>
 460 <dd>The two-letter, lower case instructions groff uses as its
 461 native command language, and out of which macros are built.
 462
 463 <dt><a name="TERMS_STRINGARGUMENT"><em>String Argument</em></a>
 464 <dd>Technically, any <strong>*argument</strong> that is not numeric.
 465 In this documentation, string argument means an argument that requires
 466 the user to input text.  For example, in the <strong>*macro</strong>
 467 <p>
 468 <pre>
 469         .TITLE "My Pulitzer Novel"
 470 </pre>
 471
 472 &quot;My Pulitzer Novel&quot; is a string argument.
 473 <p>
 474 Because string arguments must be enclosed by double-quotes, you can't
 475 use double-quotes as part of the string argument.  If you need
 476 double-quotes to be part of a string argument, use the <strong>*inline
 477 escapes</strong> <strong> \(lq</strong> and <strong>\(rq</strong>
 478 (leftquote and rightquote respectively) in place of the double-quote
 479 character (").
 480
 481 <dt><a name="TERMS_UNITOFMEASURE"><em>Unit of measure</em></a>
 482 <dd>The single letter after a <strong>*numeric argument</strong>
 483 that tells <strong>mom</strong> what measurement scale the argument
 484 should use.  Commonly valid units are:
 485 <p>
 486 <table valign="baseline" summary="unitsofmeasure">
 487 <tr><td><strong>i</strong><td> = <td>inches
 488 <tr><td><strong>p</strong><td> = <td>points
 489 <tr><td><strong>P</strong><td> = <td>picas
 490 <tr><td><strong>c</strong><td> = <td>centimeters
 491 <tr><td><strong>m</strong><td> = <td>ems
 492 <tr><td><strong>n</strong><td> = <td>ens
 493 <tr><td><strong>v</strong><td> = <td>the current leading (line space)</td></tr>
 494 </table>
 495 <br>
 496 <dd>Units of measure must come immediately after the numeric argument (i.e.
 497 with no space between the argument and the unit of measure), like this:
 498 <p>
 499 <pre>
 500         .ALD 2v
 501         .LL  39P
 502         .IL  1i
 503 </pre>
 504
 505 The above example advances 2 line spaces and sets the line length to
 506 39 picas with a left indent of 1 inch.
 507 <p>
 508 <strong>IMPORTANT:</strong> Most <strong>mom</strong> macros
 509 that set the size or measure of something MUST be given a unit of
 510 measure.  <strong>mom</strong>'s macros do not have default units
 511 of measure.  There are a couple of exceptions, the most notable of
 512 which are <strong>PT_SIZE</strong> and <strong>LS</strong>.  Both use
 513 <strong>*points</strong> as the default unit of measure, which means
 514 you don't have to append &quot;p&quot; to their argument.
 515 <p>
 516 You can enter decimal values for any unit of measure.  Different units
 517 may be combined by adding them together (e.g. 1.5i+2m, which gives a
 518 measure of 1-1/2 inches plus 2 ems).
 519 <p>
 520 <strong>NOTE:</strong> a pica is composed of 12 points,
 521 therefore 12.5 picas is 12 picas and 6 points, not 12 picas
 522 and 5 points.  If you want 12 picas and 5 points, you have to
 523 enter the measure as 12P+5p.
 524
 525 <dt><a name="TERMS_ZEROWIDTHCHARACTER"><em>Zero-width character</em></a>
 526 <dd>The <strong>*inline escape</strong> that allows you to print a
 527 literal period, apostrophe and, if <strong>*output lines</strong>
 528 are <strong>*filled</strong>, a space that falls at the beginning of
 529 an <strong>*input line</strong>.  It looks like this:
 530 <p>
 531 <pre>
 532         \&amp;
 533 </pre>
 534
 535 (backslash followed by an ampersand).
 536 <p>
 537 Normally, groff interprets a period (or an apostrophe) at the beginning
 538 of an input line as meaning that what follows is a <strong>*control
 539 line</strong>.  In fill modes, groff treats a space at the beginning
 540 of an input line as meaning &quot;start a new line and put a space
 541 at the beginning of it.&quot; If you want groff to interpret periods
 542 and apostrophes at the beginning of input lines literally (ie. print
 543 them), or spaces at the beginning of input lines as just garden
 544 variety word spaces, you must start the line with the zero-width
 545 character.
 546 </dl>
 547 <hr>
 548
 549 <a name="TERMS_MOM">
 550         <h2><u>Mom's Document Processing Terms</u></h2>
 551 </a>
 552
 553 <ul>
 554         <li><a href="#TERMS_BLOCKQUOTE">Blockquote</a>
 555         <li><a href="#TERMS_CONTROLMACRO">Control macro</a>
 556         <li><a href="#TERMS_DOCHEADER">Docheader</a>
 557         <li><a href="#TERMS_EPIGRAPH">Epigraph</a>
 558         <li><a href="#TERMS_FOOTER">Footer</a>
 559         <li><a href="#TERMS_HEAD">Head</a>
 560         <li><a href="#TERMS_HEADER">Header</a>
 561         <li><a href="#TERMS_LINEBREAK">Linebreak</a>
 562         <li><a href="#TERMS_PARAHEAD">Paragraph head</a>
 563         <li><a href="#TERMS_QUOTE">Quote</a>
 564         <li><a href="#TERMS_RUNNING">Running text</a>
 565         <li><a href="#TERMS_SUBHEAD">Subhead</a>
 566         <li><a href="#TERMS_TOGGLE">Toggle</a>
 567 </ul>
 568 <dl>
 569 <dt><a name="TERMS_BLOCKQUOTE"><em>Blockquote</em></a>
 570 <dd>Cited material other than <strong>*quotes</strong>.
 571 Typically set at a smaller point size than paragraph text, indented
 572 from the left and right margins.  Blockquotes are
 573 <strong>*filled</strong>.
 574
 575 <dt><a name="TERMS_CONTROLMACRO"><em>Control macro</em></a>
 576 <dd>Macros used in
 577 <a href="docprocessing.html#DOCPROCESSING">document processing</a>
 578 to control/alter the appearance of document elements (e.g. heads,
 579 quotes, footnotes, <strong>*headers</strong>, etc.).
 580
 581 <dt><a name="TERMS_DOCHEADER"><em>Document header/docheader</em></a>
 582 <dd>Document information (title, subtitle, author, etc) output
 583 at the top of page one.
 584
 585 <dt><a name="TERMS_EPIGRAPH"><em>Epigraph</em></a>
 586 <dd>A short, usually cited passage that appears at the
 587 beginning of a chapter, story, or other document.
 588
 589 <dt><a name="TERMS_FOOTER"><em>Footer/page footer</em></a>
 590 <dd>Document information (frequently author and title) output in
 591 the bottom margin of pages <em>after</em> page one.  Not to be
 592 confused with footnotes, which are considered part of
 593 <strong>*running text</strong>.
 594
 595 <dt><a name="TERMS_HEAD"><em>Head</em></a>
 596 <dd>A title that introduces a major section of a document.
 597
 598 <dt><a name="TERMS_HEADER"><em>Header/page header</em></a>
 599 <dd>Document information (frequently author and title) output in
 600 the top margin of pages <em>after</em> page one.
 601 <p>
 602 <strong>NOTE:</strong> In terms of content and style, headers and
 603 <strong>*footers</strong> are the same; they differ only in their
 604 placement on the page.  In most places in this documentation,
 605 references to the content or style of headers applies equally to
 606 footers.
 607
 608 <dt><a name="TERMS_LINEBREAK"><em>Linebreak/author linebreak</em></a>
 609 <dd>A horizontal gap in <strong>*running text</strong>, frequently
 610 set off by typographic symbols such as asterisks or daggers.  Used to
 611 indicate a shift in the content of a document (e.g. a scene change in a
 612 short story).
 613
 614 <dt><a name="TERMS_PARAHEAD"><em>Paragraph head</em></a>
 615 <dd>A title joined to the body of a paragraph; hierarchically one
 616 level beneath <strong>*subheads</strong>.
 617
 618 <dt><a name="TERMS_QUOTE"><em>Quote</em></a>
 619 <dd>A quote, to <strong>mom</strong>, is a line-for-line setting
 620 of quoted material (e.g. poetry, song lyrics, or a snippet of
 621 programming code).  You don't have to use
 622 <a href="typesetting.html#BR">BR</a>
 623 with quotes.
 624
 625 <dt><a name="TERMS_RUNNING"><em>Running text</em></a>
 626 <dd>In a document formatted with <strong>mom</strong>, running
 627 text means text that forms the body of the document, including
 628 elements such as heads and subheads.  <strong>*Docheaders,
 629 *headers, *footers</strong> and page numbers are NOT part of
 630 running text.
 631
 632 <dt><a name="TERMS_SUBHEAD"><em>Subhead</em></a>
 633 <dd>A title used to introduce secondary sections of a document;
 634 hierarchically one level beneath sections introduced by
 635 <strong>*heads</strong>.
 636
 637 <dt><a name="TERMS_TOGGLE"><em>Toggle</em></a>
 638 <dd>A macro or tag that, when invoked without an argument,
 639 begins something or turns a feature on, and, when invoked with
 640 ANY argument, ends something or turns a feature off.  See
 641 <a href="intro.html#TOGGLE_EXAMPLE">Example 3</a>
 642 of the section
 643 <a href="intro.html#MACRO_ARGS">How to read macro arguments</a>.
 644 </dl>
 645
 646 <p>
 647 <hr>
 648 <a href="using.html#TOP">Next</a>&nbsp;&nbsp;
 649 <a href="intro.html#TOP">Prev</a>&nbsp;&nbsp;
 650 <a href="#TOP">Top</a>&nbsp;&nbsp;
 651 <a href="toc.html">Back to Table of Contents</a>
 652 </body>
 653 </html>