diff options
Diffstat (limited to 'contrib/mom/momdoc/definitions.html')
-rw-r--r-- | contrib/mom/momdoc/definitions.html | 652 |
1 files changed, 652 insertions, 0 deletions
diff --git a/contrib/mom/momdoc/definitions.html b/contrib/mom/momdoc/definitions.html new file mode 100644 index 00000000..1272f6cd --- /dev/null +++ b/contrib/mom/momdoc/definitions.html @@ -0,0 +1,652 @@ +<html> +<head> +<meta http-equiv="content-type" content="text/html;charset=iso-8859-1"> +<title>Mom -- Definitions and Terms</title> +</head> +<body bgcolor="#dfdfdf"> + +<!====================================================================> + +<a href="using.html#TOP">Next</a> +<a href="intro.html#TOP">Prev</a> +<a href="toc.html">Back to Table of Contents</a> + +<a name="TOP"></a> +<a name="TERMS"> + <h1 align="center"><u>DEFINITIONS OF TERMS USED IN THIS MANUAL</u></h1> +</a> + +<a href="#TERMS_TYPESETTING">Typesetting Terms</a> +<br> +<a href="#TERMS_GROFF">Groff Terms</a> +<br> +<a href="#TERMS_MOM">Mom Document Processing Terms</a> +<p> +I use a number of typesetting-specific and groff-specific terms +throughout this documentation, as well as a few terms that apply +to <strong>mom</strong> herself. To make life easier, I'll explain +them here. Refer back to this section should you encounter a word +or concept you're not familiar with. Words in these definitions that +are defined elsewhere in this section are marked with asterisks. +<br> +<hr> + +<a name="TERMS_TYPESETTING"> + <h2><u>Typesetting terms</u></h2> +</a> + +<ul> + <li><a href="#TERMS_ASCENDER">Ascender</a> + <li><a href="#TERMS_BASELINE">Baseline</a> + <li><a href="#TERMS_BALLOTBOX">Ballot box</a> + <li><a href="#TERMS_BULLET">Bullet</a> + <li><a href="#TERMS_CAPHEIGHT">Cap-height</a> + <li><a href="#TERMS_DESCENDER">Descender</a> + <li><a href="#TERMS_DISCRETIONARYHYPHEN">Discretionary hyphen</a> + <li><a href="#TERMS_DROPCAP">Drop cap</a> + <li><a href="#TERMS_EM">Em/en</a> + <li><a href="#TERMS_FAMILY">Family</a> + <li><a href="#TERMS_FIGURESPACE">Figure space/Digit space</a> + <li><a href="#TERMS_FIXEDWIDTHSPACE">Fixed width space</a> + <li><a href="#TERMS_FONT">Font</a> + <li><a href="#TERMS_FORCE">Force justify</a> + <li><a href="#TERMS_JUST">Justify/justification</a> + <li><a href="#TERMS_GUTTER">Gutter</a> + <li><a href="#TERMS_KERN">Kerning</a> + <li><a href="#TERMS_KERNUNIT">Kern Units</a> + <li><a href="#TERMS_LEADING">Lead/leading</a> + <li><a href="#TERMS_LEADER">Leaders</a> + <li><a href="#TERMS_LIGATURES">Ligature</a> + <li><a href="#TERMS_PICASPOINTS">Picas/Points</a> + <li><a href="#TERMS_PS">Point Size</a> + <li><a href="#TERMS_QUAD">Quad</a> + <li><a href="#TERMS_RAG">Rag</a> + <li><a href="#TERMS_SOLID">Solid/set solid</a> + <li><a href="#TERMS_TRACKKERNING">Track kerning/Line kerning</a> + <li><a href="#TERMS_UNBREAKABLESPACE">Unbreakable space</a> + <li><a href="#TERMS_WORDSPACE">Word space</a> + <li><a href="#TERMS_XHEIGHT">x-height</a> +</ul> +<dl> + +<dt><a name="TERMS_ASCENDER"><em>Ascender</em></a> +<dd>The portion of a letter that extends above the bowl. For example, +the letters a, c, and e have no ascenders. The letters b, d, and h +do. + +<dt><a name="TERMS_BASELINE"><em>Baseline</em></a> +<dd>The imaginary line on which the bottoms of capital letters and the +bowls of lower case letters rest. + +<dt><a name="TERMS_BALLOTBOX"><em>Ballot box</em></a> +<dd>An unfilled square, usually <strong>*cap-height</strong> in size, +typically placed beside items in a checklist. + +<dt><a name="TERMS_BULLET"><em>Bullet</em></a> +<dd>A small, filled circle typically found beside items or points in +a list. + +<dt><a name="TERMS_CAPHEIGHT"><em>Cap-height</em></a> +<dd>The height of the tallest capital letter in a given +<strong>*font</strong> at the current <strong>*point +size</strong>. + +<dt><a name="TERMS_DESCENDER"><em>Descender</em></a> +<dd>The portion of a letter that extends beneath the +<strong>*baseline</strong> (j, q, y are letters with descenders). + +<dt><a name="TERMS_DISCRETIONARYHYPHEN"><em>Discretionary hyphen</em></a> +<dd>A symbol inserted between two syllables of a word that indicates to a +typesetting program the legal hyphenation points in the word. Normally, +if hyphenation is turned on, groff knows where to hyphenate words. +However, hyphenation being what it is (in English, at any rate), +groff doesn't always get it right. Discretionary hyphens make sure +it does. In the event that the word doesn't need to be hyphenated +at all, groff leaves them alone. In groff, the discretionary hyphen is +entered with +<p> +<pre> + \% +</pre> + +(backslash followed by a percent). + +<dt><a name="TERMS_DROPCAP"><em>Drop cap</em></a> +<dd>A large, usually upper-case letter that introduces the first +paragraph of a document or section thereof. The top of the drop +cap usually lines up with the top of the first line of the +paragraph, and typically "drops" several lines lower. +Text adjacent to the drop cap is indented to the right of the +letter until the bottom of the drop cap is reached, at which +point text reverts to the left margin. + +<dt><a name="TERMS_EM"><em>Em/en</em></a> +<dd>A relative measurement equal to the width of the letter M at a +given <strong>*point size</strong> in a given <strong>*font</strong>. +Since most Ms are designed square, an em is usually (but sometimes +erroneously) considered to be the same size as the current point size +(i.e. if the point size of the type is 12, one em equals 12 points). +An en is equal to the width of a letter N (historically 2/3 of an em, +although groff treats an en as 1/2 of an em). Typically, ems and +ens are used to measure indents, or to define the length of dashes +(long hyphens). + +<dt><a name="TERMS_FAMILY"><em>Family</em></a> +<dd>The collective name by which a collection of +<strong>*fonts</strong> are known, e.g. Helvetica, Times Roman, +Garamond. + +<dt><a name="TERMS_FIGURESPACE"><em>Figure space/Digit space</em></a> +<dd>A <strong>*fixed width space</strong> that has the width of one digit. Used for +aligning numerals in, say, columns or numbered lists. In groff, +the figure space is entered with +<p> +<pre> + \0 +</pre> + +(backslash followed by a zero). + +<dt><a name="TERMS_FIXEDWIDTHSPACE"><em>Fixed width space</em></a> +<dd>Equal to <strong>*word space</strong>, but does not expand or +contract when text is <strong>*justified</strong>. In groff, fixed +width space is entered with +<p> +<pre> + \<space> +</pre> + +where <space> means "hit the spacebar on your keyboard." + +<dt><a name="TERMS_FONT"><em>Font</em></a> +<dd>The specific style of type within a <strong>*family</strong>, +e.g. roman, italic. Groff understands four fonts within any given +family: roman, italic, bold, and bold italic. + +<dt><a name="TERMS_FORCE"><em>Force justify +</em></a> +<dd>Sometimes, in <strong>*justified</strong> text, a line needs to be +broken short of the right margin. Force justifying means telling a +typesetting program (like groff) that you want the line broken early +AND that you want the line's word spacing stretched to force the line +flush with the right margin. + +<dt><a name="TERMS_GUTTER"><em>Gutter</em></a> +<dd>The vertical whitespace separating columns of type. + +<dt><a name="TERMS_JUST"><em>Justify/justification</em></a> +<dd>Lines of type are justified when they're flush at both the left and +right margins. Justification is the act of making both margins flush. +Some people use the terms "left justified" and "right justified" +to mean type where only the left (or right) margins align. I don't. +See <strong>*quad</strong>. + +<dt><a name="TERMS_KERN"><em>Kerning</em></a> +<dd>Moving pairs of letters closer together to remove excess +whitespace between them. In the days before phototypesetting, +type was set from small, rectangular blocks of wood or metal, each +block having exactly one letter. Because the edge of each block +determined the edge of each letter, certain letter combinations (TA, +for example) didn't fit together well and had to be morticed by hand +to bring them visually closer. Modern typesetting systems usually +take care of kerning automatically, but they're far from perfect. +Professional typesetters still devote a lot of time to fitting letters +and punctuation together properly. + +<dt><a name="TERMS_KERNUNIT"><em>Kern Units</em></a> +<dd>A relative distance equal to 1/36 of the current +<strong>*point size</strong>. Used between individual letters +for <strong>*kerning</strong>. Different typesetting systems use +different values (1/54 is popular), and sometimes call kern units by +a different name. +<p> +<strong>Experts: +<br></strong>A kern unit has nothing to do with groff +machine units. + +<dt><a name="TERMS_LEADING"><em>Lead/leading</em></a> +<dd>The distance from the <strong>*baseline</strong> of one line of +type to the line of type immediately beneath it. Pronounced "ledding." +Also called line spacing. Usually measured in <strong>*points</strong>. +<p> +<em>In case you're interested...</em> In previous centuries, +lines of type were separated by thin strips of -- you guessed it +-- lead. Lines of type that had no lead between them were said to +be "set solid." Once you began separating them with strips +of lead, they were said to be "leaded", and the spacing was +expressed in terms of the number of <strong>*points</strong> of lead. +For this reason, "leading" and "line spacing" +aren't, historically speaking, synonymous. If type was set 10 on 12, +for example, the leading was 2 points, not 12. Nowadays, however, +the two terms are used interchangeably to mean the distance from +baseline to baseline. + +<dt><a name="TERMS_LEADER"><em>Leaders</em></a> +<dd>Single characters used to fill lines, usually to their end. +So called because they "lead" the eye from one element +of the page to another. For example, in the following (brief) +Table of Contents, the periods (dots) are leaders. +<p> +<pre> + Foreword............... 2 + Chapter 1.............. 5 + Chapter 2.............. 38 + Chapter 3.............. 60 +</pre> + +<dt><a name="TERMS_LIGATURES"><em>Ligature</em></a> +<dd>Ligatures are letters joined together to form a single character. +The commonest are fi, fl, ff, ffi and ffl. Others are ae and oe. +Occasionally, one sees an st ligature, but this is archaic and +quite rare. + +<dt><a name="TERMS_PICASPOINTS"><em>Picas/Points</em></a> +<dd>There are twelve points in a pica, and six picas in an inch +(hence 72 points to the inch). In the same way that gem-dealers +have always used their own system of measurement for weight (carats), +typographers have always used their own system of measurement for type. + +<dt><a name="TERMS_PS"><em>Point Size</em></a> +<dd>The nominal size of type, measured in <strong>*points</strong>, +from the bottom of the longest <strong>*descender</strong> to the top +of the highest <strong>*ascender</strong>. In reality, type is always +fractionally smaller than its point size. + +<dt><a name="TERMS_QUAD"><em>Quad</em></a> +<dd>When only one margin of type is flush, lines of type are quadded in +the direction of the flush margin. Therefore, quad left means the +left margin is flush, the right isn't. Quad right means the right +margin is flush, the left isn't. Quad center means neither the left +nor the right margin is flush; rather, lines of type are quadded on +both sides so that type appears centered on the page. + +<dt><a name="TERMS_RAG"><em>Rag</em></a> +<dd>Describes a margin that isn't flush. Rag right means the right +margin isn't flush. Rag left means the left margin isn't flush. +The expression "flush left/rag right" is sometimes used to describe +type that is <strong>*quadded</strong> left. + +<dt><a name="TERMS_SOLID"><em>Solid/set solid</em></a> +<dd>When no <strong>*lead</strong> is added between lines of type +(i.e. the <strong>*point size</strong> and linespacing are the +same), the lines are said to be "set solid." + +<dt><a name="TERMS_TRACKKERNING"><em>Track kerning/Line kerning</em></a> +<dd>Sometimes, it's advantageous to increase or decrease the amount of +space between every letter in a line by an equal (usually small) +amount, in order to fit more (or fewer) characters on the line. +The correct term is letter spacing, but track kerning and line kerning +(and sometimes, just "kerning") have come to mean the same thing. + +<dt><a name="TERMS_UNBREAKABLESPACE"><em>Unbreakable space</em></a> +<dd>Equal to <strong>*word space</strong>, however words separated by +an unbreakable space will always be kept together on the same line. +Expands and contracts like word space. Useful for proper names, which +should never be broken. In groff, unbreakable space is entered with +<p> +<pre> + \~ +</pre> + +(backslash followed by a tilde). + +<dt><a name="TERMS_WORDSPACE"><em>Word space</em></a> +<dd>The amount of whitespace between words. When text is +<strong>*justified</strong>, word space expands or contracts to make +the margins flush. + +<dt><a name="TERMS_XHEIGHT"><em>x-height</em></a> +<dd>The height of a lower case letter x in a given font at a given +point size. Generally used to mean the average height of the bowl +of lower case letters. +</dl> +<hr> + +<a name="TERMS_GROFF"> + <h2><u>Groff terms</u></h2> +</a> + +<ul> + <li><a href="#TERMS_ALIAS">Alias</a> + <li><a href="#TERMS_ARGUMENTS">Arguments</a> + <li><a href="#TERMS_COMMENTLINES">Comment lines</a> + <li><a href="#TERMS_CONTROLLINES">Control Lines</a> + <li><a href="#TERMS_FILLED">Filled lines</a> + <li><a href="#TERMS_INLINES">Inline escapes</a> + <li><a href="#TERMS_INPUTLINE">Input line</a> + <li><a href="#TERMS_MACROS">Macros</a> + <li><a href="#TERMS_UNITS">Machine units</a> + <li><a href="#TERMS_NUMERICARGUMENT">Numeric argument</a> + <li><a href="#TERMS_OUTPUTLINE">Output line</a> + <li><a href="#TERMS_PRIMITIVES">Primitives</a> + <li><a href="#TERMS_STRINGARGUMENT">String Argument</a> + <li><a href="#TERMS_UNITOFMEASURE">Unit of measure</a> + <li><a href="#TERMS_ZEROWIDTHCHARACTER">Zero-width character</a> +</ul> +<dl> + +<dt><a name="TERMS_ALIAS"><em>Alias</em></a> +<dd>A <strong>*macro</strong> invoked by a name different from its +"official" name. For example, the official name of the +macro to change <strong>*family</strong> is <strong>FAMILY</strong>. +Its alias is <strong>FAM</strong>. Aliases may be created for any +macro (via the +<a href="goodies.html#ALIAS">ALIAS</a> +macro) provided the alias uses a name not already taken +by the <strong>mom</strong> macros or one of the groff +<strong>*primitives</strong>. For a complete list of alias names +you must not use, see the +<a href="reserved.html#RESERVED">list of reserved words</a>. + +<dt><a name="TERMS_ARGUMENTS"><em>Arguments</em></a> +<dd>Parameters or information needed by a <strong>*macro</strong> +to do its job. For example, in the macro +<p> +<pre> + .PS 12 +</pre> + +"12" is the argument. In the macro +<p> +<pre> + .QUAD LEFT +</pre> + +LEFT is the argument. Arguments are separated from macros by spaces. +Some macros require several arguments; each is separated by a space. + +<dt><a name="TERMS_COMMENTLINES"><em>Comment Lines</em></a> +<dd><strong>*Input lines</strong> introduced with the comment character +<p> +<pre> + \# +</pre> + +When processing output, groff silently ignores everything on the +line after the comment character. + +<dt><a name="TERMS_CONTROLLINES"><em>Control Lines</em></a> +<dd>Instructions to groff that appear on a line by themselves, +which means that "control lines" are either +<strong>*macros</strong> or <strong>*groff primitives</strong>. +Control lines always begin with a period. + +<dt><a name="TERMS_FILLED"><em>Filled lines/fill mode</em></a> +<dd>Automatic <strong>*justification</strong> or +<strong>*quadding</strong>. In fill mode, the ends of lines as they +appear in your text editor are ignored. Instead, words from adjoining +<strong>*input lines</strong> are added one at a time to the output +line until no more words fit. Then, depending whether text is to +be <strong>*justified</strong> or <strong>*quadded</strong> (left, +right, or center), and depending on whether automatic hyphenation +is turned on, groff attempts to hyphenate the last word, or, barring +that, spreads and breaks the line (when justification is turned on) or +breaks and quads the line (when quadding is turned on). +<p> +<a name="TERMS_NOFILL"></a> +Nofill mode (non-filled text) means that groff respects the ends +of lines as they appear in your text editor. + +<dt><a name="TERMS_INLINES"><em>Inline escapes</em></a> +<dd>Instructions issued to groff that appear as part of an +<strong>*input line</strong> (as opposed to <strong>*macros</strong>, +which must appear on a line by themselves). Inline escapes are always +introduced by the backslash character. For example, +<p> +<pre> + A line of text with the word T\*[BU2]oronto in it +</pre> + +contains the inline escape \*[BU2] (which means "move the letter o 2 +<strong>*kern units</strong> closer to the letter T"). +<p> +<strong>mom</strong>'s inline escapes always take the form +<strong>\*[</strong><i>ESCAPE</i><strong>]</strong>, where +<i>ESCAPE</i> is composed of capital letters, sometimes with digits. +<strong>groff</strong> escapes begin with the backslash +character but typically have no star and are in lower case. For +example, the <strong>mom</strong> escape to move forward 6 +points on a line is +<p> +<pre> + \*[FP6] +</pre> + +while the <strong>groff</strong> escape for the same thing is +<p> +<pre> + \h'6p' +</pre> + +<dt><a name="TERMS_INPUTLINE"><em>Input line</em></a> +<dd>A line of text as it appears in your text editor. + +<dt><a name="TERMS_MACROS"><em>Macros</em></a> +<dd>Instructions embedded in a document that determine how groff processes +the text for output. <strong>mom</strong>'s macros always begin with a +period, on a line by themselves, and must be typed in capital letters. +Typically, macros contain complex commands issued to groff -- behind +the scenes -- via groff <strong>*primitives</strong>. + +<dt><a name="TERMS_UNITS"><em>Machine units</em></a> +<dd>A machine unit is 1/1000 of a <strong>*point</strong> when the +groff device is ps. ("ps" means "PostScript" -- +the default device for which groff prepares output, and the device for +which <strong>mom</strong> was specifically designed.) + +<dt><a name="TERMS_NUMERICARGUMENT"><em>Numeric argument</em></a> +<dd>An <strong>*argument</strong> that has the form of a digit. +Numeric arguments can be built out of arithmetic expressions using ++, -, *, and / for plus, minus, times, and divided-by respectively. +If a numeric argument requires a <strong>*unit of measure</strong>, +a unit of measure must be appended to <em>every</em> digit in the +argument. For example: +<p> +<pre> + .ALD 1i-1v +</pre> + +<strong>NOTE:</strong> groff does not respect the order of operations, +but rather evaluates arithmetic expressions from left to right. +Parentheses must be used to circumvent this peculiarity. Not to +worry, though. The likelihood of more than just the occasional plus +or minus sign when using <strong>mom</strong>'s macros is slim. + +<dt><a name="TERMS_OUTPUTLINE"><em>Output line</em></a> +<dd>A line of text as it appears in output copy. + +<dt><a name="TERMS_PRIMITIVES"><em>Primitives</em></a> +<dd>The two-letter, lower case instructions groff uses as its +native command language, and out of which macros are built. + +<dt><a name="TERMS_STRINGARGUMENT"><em>String Argument</em></a> +<dd>Technically, any <strong>*argument</strong> that is not numeric. +In this documentation, string argument means an argument that requires +the user to input text. For example, in the <strong>*macro</strong> +<p> +<pre> + .TITLE "My Pulitzer Novel" +</pre> + +"My Pulitzer Novel" is a string argument. +<p> +Because string arguments must be enclosed by double-quotes, you can't +use double-quotes as part of the string argument. If you need +double-quotes to be part of a string argument, use the <strong>*inline +escapes</strong> <strong> \(lq</strong> and <strong>\(rq</strong> +(leftquote and rightquote respectively) in place of the double-quote +character ("). + +<dt><a name="TERMS_UNITOFMEASURE"><em>Unit of measure</em></a> +<dd>The single letter after a <strong>*numeric argument</strong> +that tells <strong>mom</strong> what measurement scale the argument +should use. Commonly valid units are: +<p> +<table valign="baseline" summary="unitsofmeasure"> +<tr><td><strong>i</strong><td> = <td>inches +<tr><td><strong>p</strong><td> = <td>points +<tr><td><strong>P</strong><td> = <td>picas +<tr><td><strong>c</strong><td> = <td>centimeters +<tr><td><strong>m</strong><td> = <td>ems +<tr><td><strong>n</strong><td> = <td>ens +<tr><td><strong>v</strong><td> = <td>the current leading (line space)</td></tr> +</table> +<br> +<dd>Units of measure must come immediately after the numeric argument (i.e. +with no space between the argument and the unit of measure), like this: +<p> +<pre> + .ALD 2v + .LL 39P + .IL 1i +</pre> + +The above example advances 2 line spaces and sets the line length to +39 picas with a left indent of 1 inch. +<p> +<strong>IMPORTANT:</strong> Most <strong>mom</strong> macros +that set the size or measure of something MUST be given a unit of +measure. <strong>mom</strong>'s macros do not have default units +of measure. There are a couple of exceptions, the most notable of +which are <strong>PS</strong> and <strong>LS</strong>. Both use +<strong>*points</strong> as the default unit of measure, which means +you don't have to append "p" to their argument. +<p> +You can enter decimal values for any unit of measure. Different units +may be combined by adding them together (e.g. 1.5i+2m, which gives a +measure of 1-1/2 inches plus 2 ems). +<p> +<strong>NOTE:</strong> a pica is composed of 12 points, +therefore 12.5 picas is 12 picas and 6 points, not 12 picas +and 5 points. If you want 12 picas and 5 points, you have to +enter the measure as 12P+5p. + +<dt><a name="TERMS_ZEROWIDTHCHARACTER"><em>Zero-width character</em></a> +<dd>The <strong>*inline escape</strong> that allows you to print a +literal period, apostrophe and, if <strong>*output lines</strong> +are <strong>*filled</strong>, a space that falls at the beginning of +an <strong>*input line</strong>. It looks like this: +<p> +<pre> + \& +</pre> + +(backslash followed by an ampersand). +<p> +Normally, groff interprets a period (or an apostrophe) at the beginning +of an input line as meaning that what follows is a <strong>*control +line</strong>. In fill modes, groff treats a space at the beginning +of an input line as meaning "start a new line and put a space +at the beginning of it." If you want groff to interpret periods +and apostrophes at the beginning of input lines literally (ie. print +them), or spaces at the beginning of input lines as just garden +variety word spaces, you must start the line with the zero-width +character. +</dl> +<hr> + +<a name="TERMS_MOM"> + <h2><u>Mom's Document Processing Terms</u></h2> +</a> + +<ul> + <li><a href="#TERMS_BLOCKQUOTE">Blockquote</a> + <li><a href="#TERMS_CONTROLMACRO">Control macro</a> + <li><a href="#TERMS_DOCHEADER">Docheader</a> + <li><a href="#TERMS_EPIGRAPH">Epigraph</a> + <li><a href="#TERMS_FOOTER">Footer</a> + <li><a href="#TERMS_HEAD">Head</a> + <li><a href="#TERMS_HEADER">Header</a> + <li><a href="#TERMS_LINEBREAK">Linebreak</a> + <li><a href="#TERMS_PARAHEAD">Paragraph head</a> + <li><a href="#TERMS_QUOTE">Quote</a> + <li><a href="#TERMS_RUNNING">Running text</a> + <li><a href="#TERMS_SUBHEAD">Subhead</a> + <li><a href="#TERMS_TOGGLE">Toggle</a> +</ul> +<dl> +<dt><a name="TERMS_BLOCKQUOTE"><em>Blockquote</em></a> +<dd>Cited material other than <strong>*quotes</strong>. +Typically set at a smaller point size than paragraph text, indented +from the left and right margins. Blockquotes are +<strong>*filled</strong>. + +<dt><a name="TERMS_CONTROLMACRO"><em>Control macro</em></a> +<dd>Macros used in +<a href="docprocessing.html#DOCPROCESSING">document processing</a> +to control/alter the appearance of document elements (e.g. heads, +quotes, footnotes, <strong>*headers</strong>, etc.). + +<dt><a name="TERMS_DOCHEADER"><em>Document header/docheader</em></a> +<dd>Document information (title, subtitle, author, etc) output +at the top of page one. + +<dt><a name="TERMS_EPIGRAPH"><em>Epigraph</em></a> +<dd>A short, usually cited passage that appears at the +beginning of a chapter, story, or other document. + +<dt><a name="TERMS_FOOTER"><em>Footer/page footer</em></a> +<dd>Document information (frequently author and title) output in +the bottom margin of pages <em>after</em> page one. Not to be +confused with footnotes, which are considered part of +<strong>*running text</strong>. + +<dt><a name="TERMS_HEAD"><em>Head</em></a> +<dd>A title that introduces a major section of a document. + +<dt><a name="TERMS_HEADER"><em>Header/page header</em></a> +<dd>Document information (frequently author and title) output in +the top margin of pages <em>after</em> page one. +<p> +<strong>NOTE:</strong> In terms of content and style, headers and +<strong>*footers</strong> are the same; they differ only in their +placement on the page. In most places in this documentation, +references to the content or style of headers applies equally to +footers. + +<dt><a name="TERMS_LINEBREAK"><em>Linebreak/author linebreak</em></a> +<dd>A horizontal gap in <strong>*running text</strong>, frequently +set off by typographic symbols such as asterisks or a daggers. +Used to indicate a shift in the content of a document (e.g. a scene +change in a short story). + +<dt><a name="TERMS_PARAHEAD"><em>Paragraph head</em></a> +<dd>A title joined to the body of a paragraph; hierarchically one +level beneath <strong>*subheads</strong>. + +<dt><a name="TERMS_QUOTE"><em>Quote</em></a> +<dd>A quote, to <strong>mom</strong>, is a line-for-line setting +of quoted material (e.g. poetry, song lyrics, or a snippet of +programming code). You don't have to use +<a href="typesetting.html#BR">BR</a> +with quotes. + +<dt><a name="TERMS_RUNNING"><em>Running text</em></a> +<dd>In a document formatted with <strong>mom</strong>, running +text means text that forms the body of the document, including +elements such as heads and subheads. <strong>*Docheaders, +*headers, *footers</strong> and page numbers are NOT part of +running text. + +<dt><a name="TERMS_SUBHEAD"><em>Subhead</em></a> +<dd>A title used to introduce secondary sections of a document; +hierarchically one level beneath sections introduced by +<strong>*heads</strong>. + +<dt><a name="TERMS_TOGGLE"><em>Toggle</em></a> +<dd>A macro or tag that, when invoked without an argument, +begins something or turns a feature on, and, when invoked with +ANY argument, ends something or turns a feature off. See +<a href="intro.html#TOGGLE_EXAMPLE">Example 3</a> +of the section +<a href="intro.html#MACRO_ARGS">How to read macro arguments</a>. +</dl> + +<p> +<hr> +<a href="using.html#TOP">Next</a> +<a href="intro.html#TOP">Prev</a> +<a href="#TOP">Top</a> +<a href="toc.html">Back to Table of Contents</a> +</body> +</html> |