diff options
Diffstat (limited to 'contrib/mom/momdoc/docelement.html')
-rw-r--r-- | contrib/mom/momdoc/docelement.html | 275 |
1 files changed, 27 insertions, 248 deletions
diff --git a/contrib/mom/momdoc/docelement.html b/contrib/mom/momdoc/docelement.html index 5da69632..c7bea507 100644 --- a/contrib/mom/momdoc/docelement.html +++ b/contrib/mom/momdoc/docelement.html @@ -2,7 +2,7 @@ <!-- This file is part of groff, the GNU roff type-setting system. -Copyright (C) 2004, 2005, 2006, 2009, 2010, 2011 Free Software Foundation, Inc. +Copyright (C) 2004, 2005, 2006, 2009, 2010 Free Software Foundation, Inc. Written by Peter Schaffter. Permission is granted to copy, distribute and/or modify this document @@ -82,11 +82,6 @@ FDL in the main directory of the groff source package. <li><a href="#subhead">SUBHEAD</a></li> <li><a href="#subhead-control">Subhead control</a></li> </ul> -<h3 class="toc toc-docproc-header"><a class="header-link" href="#subsubhead-intro">Subsubheads</a></h3> -<ul class="toc-docproc" style="margin-top: .5em;"> - <li><a href="#subsubhead">SUBSUBHEAD</a></li> - <li><a href="#subsubhead-control">Subsubhead control</a></li> -</ul> <h3 class="toc toc-docproc-header"><a class="header-link" href="#parahead-intro">Paragraph heads</a></h3> <ul class="toc-docproc" style="margin-top: .5em;"> <li><a href="#parahead">PARAHEAD</a></li> @@ -1125,9 +1120,9 @@ See <a href="#control-macro-args">Arguments to the control macros</a>. </p> <span class="pre defaults"> -.HEAD_FAMILY default = prevailing document family -.HEAD_FONT default = bold, underlined (TYPESET); roman,underlined (TYPEWRITE) -.HEAD_SIZE default = +1 (TYPESET); 0 (TYPEWRITE) +.HEAD_FAMILY default = prevailing document family; default is Times Roman +.HEAD_FONT default = bold +.HEAD_SIZE default = +1 (point) .HEAD_COLOR default = black .HEAD_QUAD default = CENTER </span> @@ -1146,9 +1141,8 @@ To change this behaviour, do .HEAD_CAPS OFF </span> HEAD_CAPS is a toggle macro, therefore you can use any argument you -like instead of <kbd>OFF</kbd> to disable it (e.g. <b>END, QUIT, Q, -X</b>...). To turn HEAD_CAPS back on, simply invoke it without an -argument. +like instead of <kbd>OFF</kbd> (<b>END, QUIT, Q, X</b>...). To turn +HEAD_CAPS back on, simply invoke it without an argument. </p> <h4 id="head-space" class="docs" style="margin-top: -.25em;">3. Pre-head space</h4> @@ -1355,7 +1349,7 @@ Subheads should be used any place you want titles to introduce sections of a document below heads. If you wish, mom can number subheads for you. Subhead numbers can also be included hierarchically in numbered -<a href="#subsubhead-intro">subsubheads</a>. +<a href="#parahead-intro">paraheads</a>. </p> <p> @@ -1393,10 +1387,9 @@ surround each line with double-quotes. <div class="box-tip"> <p class="tip"> <span class="note">Note:</span> -If a subhead falls near the bottom of an output page and mom -is unable to fit the subhead <i>plus at least one line of text -underneath it</i>, she will set the subhead at the top of the next -page. +If a subhead falls near the bottom of an output page and mom is +unable to fit the head <i>plus at least one line of text underneath +it</i>, she will set the subhead at the top of the next page. </p> </div> @@ -1405,14 +1398,13 @@ page. <p class="defaults"> In addition to the usual family/font/size/quad control macros, there -are macros to manage subhead numbering and vertical placement. +are macros to manage subhead numbering. </p> <ol style="margin-top: .5em; padding-bottom: .5em;"> <li><a href="#subhead-general">Family/font/size/colour/quad</a></li> <li><a href="#number-subheads">Numbering</a></li> <li><a href="#reset-subhead-number">Reset subhead numbering</a></li> - <li><a href="#subhead-baseline-adjust">Baseline adjustment</a></li> <li><a href="#subhead-inlines">Vertical inline escapes inside subheads</a></li> </ol> </div> @@ -1425,9 +1417,9 @@ See <a href="#control-macro-args">Arguments to the control macros</a>. </p> <span class="pre defaults" style="padding-bottom: -1em;"> -.SUBHEAD_FAMILY default = prevailing document family -.SUBHEAD_FONT default = bold (TYPESET); italic, ie underlined (TYPEWRITE) -.SUBHEAD_SIZE default = +.5 (TYPESET); 0 (TYPEWRITE) +.SUBHEAD_FAMILY default = prevailing document family; default is Times Roman +.SUBHEAD_FONT default = bold +.SUBHEAD_SIZE default = +.5 (point) .SUBHEAD_COLOR default = black .SUBHEAD_QUAD default = LEFT </span> @@ -1483,32 +1475,7 @@ Your next subhead will be numbered “4” and subsequent subheads will be numbered in ascending order from “4”. </p> -<h4 id="subhead-baseline-adjust" class="docs" style="margin-top: -.25em;">4. Baseline adjustment</h4> - -<p> -For aesthetic reasons and to clarify document structure, mom raises -subheads slightly above the -<a href="definitions.html#baseline">baseline</a> -on which they would otherwise fall. In -<a href="docprocessing.html#printstyle">PRINTSTYLE <kbd>TYPESET</kbd></a>, -the amount is 1/8 of the prevailing -<a href="definitions.html#leading">leading</a>. In -<a href="docprocessing.html#printstyle">PRINTSTYLE <kbd>TYPEWRITE</kbd></a>, -it’s 1/5 of the prevailing leading. -</p> - -<p> -If you would prefer mom not exhibit this behaviour, or if you would -like to change the amount by which she raises the subhead, use the -macro <kbd>.SUBHEAD_BASELINE_ADJUST</kbd>. With an argument of 0 (zero), -subhead baseline adjustment will be disabled. Any other numeric -argument, with a -<a href="definitions.html#unitofmeasure">unit of measure</a> -appended directly onto the argument, will cause mom to raise your -subheads by the amount you specify. -</p> - -<h4 id="subhead-inlines" class="docs" style="margin-top: -.25em;">5. Vertical inline escapes inside subheads</h4> +<h4 id="subhead-inlines" class="docs" style="margin-top: -.25em;">4. Vertical inline escapes inside subheads</h4> <p> See @@ -1520,183 +1487,6 @@ The information there applies equally to subheads. <!-- ==================================================================== --> -<h2 id="subsubhead-intro" class="macro-group">Subsubheads</h2> - -<ul style="margin-left: -.5em;"> - <li><a href="#subsubhead">Tag: SUBSUBHEAD</a></li> - <li><a href="#subsubhead-control">Subsubhead control macros</a></li> -</ul> - -<p> -Subsubheads should be used any place you want titles to introduce -sections of a document below subheads. If you wish, mom can -number subsubheads for you. Subsubhead numbers can also be included -hierarchically in numbered -<a href="#parahead-intro">paraheads</a>. -</p> - -<p> -By default, subsubheads are flush left. In -<a href="docprocessing.html#printstyle">PRINTSTYLE <kbd>TYPESET</kbd></a>, -they are set in italic, slightly larger than paragraph text. In -<a href="docprocessing.html#printstyle">PRINTSTYLE <kbd>TYPEWRITE</kbd></a>, -they are set roman at the same size as the prevailing type. A -single linespace precedes them in both printstyles, and a tiny space -adjustment raises them slightly above text that comes afterwards for -greater clarity in document structuring. -</p> - -<p> -If these defaults don’t suit you, you can change them with the -subsubhead control macros. -</p> - -<!-- -SUBSUBHEAD- --> - -<div class="macro-id-overline"> -<h3 id="subsubhead" class="macro-id">SUBSUBHEAD</h3> -</div> - -<div class="box-macro-args"> -Macro: <b>SUBSUBHEAD</b> <kbd class="macro-args">"<text of subsubhead>" [ "<2nd line>" [ "<3rd line>" ... ] ]</kbd> -</div> - -<p> -The argument to SUBSUBHEAD is the text of the subsubhead, surrounded by -double-quotes. If you need additional lines for a subsubhead, simply -surround each line with double-quotes. -</p> - -<div class="box-tip"> -<p class="tip"> -<span class="note">Note:</span> -If a subsubhead falls near the bottom of an output page and mom -is unable to fit the subsubhead <i>plus at least one line of text -underneath it</i>, she will set the subsubhead at the top of the next -page. -</p> -</div> - -<div class="defaults-container" style="background-color: #ded4bd; border: none;"> -<h3 id="subsubhead-control" class="docs defaults">SUBSUBHEAD control macros and defaults</h3> - -<p class="defaults"> -In addition to the usual family/font/size/quad control macros, there -are macros to manage subsubhead numbering. -</p> - -<ol style="margin-top: .5em; padding-bottom: .5em;"> - <li><a href="#subsubhead-general">Family/font/size/colour/quad</a></li> - <li><a href="#number-subsubheads">Numbering</a></li> - <li><a href="#reset-subsubhead-number">Reset subsubhead numbering</a></li> - <li><a href="#subsubhead-baseline-adjust">Baseline adjustment</a></li> - <li><a href="#subsubhead-inlines">Vertical inline escapes inside subsubheads</a></li> -</ol> -</div> - -<h4 id="subsubhead-general" class="docs" style="margin-top: -1.5em; margin-bottom: .5em;">1. Family/font/size/quad</h4> - -<div class="defaults-container" style="padding-bottom: 8px;"> -<p class="defaults" style="padding-top: 6px;"> -See -<a href="#control-macro-args">Arguments to the control macros</a>. -</p> -<span class="pre defaults" style="padding-bottom: -1em;"> -.SUBSUBHEAD_FAMILY default = prevailing document family -.SUBSUBHEAD_FONT default = italic (TYPESET); roman (TYPEWRITE) -.SUBSUBHEAD_SIZE default = +.5 (TYPESET); 0 (TYPEWRITE) -.SUBSUBHEAD_COLOR default = black -.SUBSUBHEAD_QUAD default = LEFT -</span> -</div> - -<h4 id="number-subsubheads" class="docs" style="margin-top: -1.25em;">2. Number subsubheads</h4> - -<p> -If you’d like your subsubheads numbered, simply invoke -<kbd>.NUMBER_SUBSUBHEADS</kbd> with no argument. Mom will number -all subsequent subsubheads automatically (in ascending order, -naturally). -</p> - -<p> -If, in addition to numbering subsubheads, you also request that -<a href="#head-intro">heads</a> -be numbered, the head number will be included in the subsubhead -number (separated by a period [dot]). -</p> - -<p> -Should you wish to stop subsubhead numbering, invoke -<kbd>.NUMBER_SUBSUBHEADS</kbd> with any argument (<kbd>OFF, QUIT, END, -X</kbd>...). Subsubhead numbering will cease, and the subsubhead number -will not be included in the numbering of paraheads. -</p> - -<p> -See also -<a href="#prefix-chapter-number">Prefixing chapter numbers</a> -if you’d like chapter numbers prepended to the subsubhead numbers. -</p> - -<h4 id="reset-subsubhead-number" class="docs" style="margin-top: -.25em;">3. Reset subsubhead numbering</h4> - -<p> -Should you wish to reset the subsubhead number to “1”, -invoke -<span class="pre-in-pp"> - .RESET_SUBSUBHEAD_NUMBER -</span> -with no argument. If, for some reason, you want mom to use a -subsubhead number that is not the next in ascending order (i.e. the -last subsubhead number + 1), invoke <kbd>.RESET_SUBSUBHEAD_NUMBER</kbd> -with the number you want, e.g. -<br/> -<span class="pre-in-pp"> - .RESET_SUBSUBHEAD_NUMBER 4 -</span> - -Your next subsubhead will be numbered “4” and subsequent -subsubheads will be numbered in ascending order from “4”. -</p> - -<h4 id="subsubhead-baseline-adjust" class="docs" style="margin-top: -.25em;">4. Baseline adjustment</h4> - -<p> -For aesthetic reasons and to clarify document structure, mom raises -subsubheads slightly above the -<a href="definitions.html#baseline">baseline</a> -on which they would otherwise fall. In -<a href="docprocessing.html#printstyle">PRINTSTYLE <kbd>TYPESET</kbd></a>, -the amount is 1/8 of the prevailing -<a href="definitions.html#leading">leading</a>. In -<a href="docprocessing.html#printstyle">PRINTSTYLE <kbd>TYPEWRITE</kbd></a>, -it’s 1/5 of the prevailing leading. -</p> - -<p> -If you would prefer mom not exhibit this behaviour, or if you would -like to change the amount by which she raises the subsubhead, use the -macro <kbd>.SUBSUBHEAD_BASELINE_ADJUST</kbd>. With an argument of 0 (zero), -subsubhead baseline adjustment will be disabled. Any other numeric -argument, with a -<a href="definitions.html#unitofmeasure">unit of measure</a> -appended directly onto the argument, will cause mom to raise your -subsubheads by the amount you specify. -</p> - -<h4 id="subsubhead-inlines" class="docs" style="margin-top: -.25em;">5. Vertical inline escapes inside sububheads</h4> - -<p> -See -<a href="#head-inlines">Vertical inline escapes inside heads</a>. -The information there applies equally to subsubheads. -</p> - -<div class="rule-short"><hr/></div> - -<!-- ==================================================================== --> - <h2 id="parahead-intro" class="macro-group">Paragraph heads</h2> <ul style="margin-left: -.5em;"> @@ -1731,8 +1521,8 @@ parahead control macros. <div class="box-tip"> <p class="tip"> <span class="tip">Tip:</span> -If you really need a heading level below subsubheads that -isn’t joined to the body of a paragraph, you can trick +If you really need a heading level below subhead (a sub-subhead) +that isn’t joined to the body of a paragraph, you can trick PARAHEAD into giving you one by creating a paragraph that contains only a parahead, like this: <br/> @@ -1795,9 +1585,9 @@ See <a href="#control-macro-args">Arguments to the control macros</a>. </p> <span class="pre defaults"> -.PARAHEAD_FAMILY default = prevailing document family -.PARAHEAD_FONT default = bold italic (TYPESET); italic, ie underlined (TYPEWRITE) -.PARAHEAD_SIZE default = -.25 (TYPESET); 0 (TYPEWRITE) +.PARAHEAD_FAMILY default = prevailing document family; default is Times Roman +.PARAHEAD_FONT default = bold italic +.PARAHEAD_SIZE default = +.5 (point) .PARAHEAD_COLOR default = black* *If you colourize paragraph text, paraheads will appear in the same @@ -1825,6 +1615,9 @@ do: <span class="pre-in-pp"> .PARAHEAD_INDENT 2.5P </span> +</p> + +<p> Mom’s default indent for paragraph heads is 1/2 the first-line indent of normal paragraphs (both printstyles). However, as stated above, if you choose to change the indent, you must give an absolute @@ -1836,18 +1629,6 @@ PP_INDENT.) <div class="box-tip"> <p class="tip"> -<span class="tip">Tip:</span> -If you want to make the parahead indent equal to the paragraph -indent, a convenient way to do it is -<br/> -<span class="pre-in-pp"> - .PARAHEAD INDENT \n[#PP_INDENT] -</span> -</p> -</div> - -<div class="box-tip"> -<p class="tip"> <span class="note">Note:</span> Paragraph heads in “first paragraphs”, as defined in <a href="#para-indent-first">Indenting initial paragraphs</a>, @@ -1953,11 +1734,10 @@ Macro: <b>PREFIX_CHAPTER_NUMBER</b> <kbd class="macro-args"><none> | <c </div> <p> -If you’ve requested numbering of heads, subheads, subsubheads -and/or paragraph heads (with +If you’ve requested numbering of heads, subheads and/or paragraph +heads (with <a href="#number-heads">NUMBER_HEADS</a>, -<a href="#number-subheads">NUMBER_SUBHEADS,</a> -<a href="#number-subheads">NUMBER_SUBSUBHEADS</a> +<a href="#number-subheads">NUMBER_SUBHEADS</a> and/or <a href="#number-paraheads">NUMBER_PARAHEADS</a>) and you’d like mom, in addition, to prefix @@ -5556,11 +5336,10 @@ See <a href="#control-macro-args">Arguments to the control macros</a>. </p> <span class="pre defaults"> -.ENDNOTE_STRING_FAMILY default = prevailing document family +.ENDNOTE_STRING_FAMILY default = prevailing document family; default is Times Roman .ENDNOTE_STRING_FONT default = bold .ENDNOTE_STRING_SIZE* default = +1 .ENDNOTE_STRING_QUAD default = centred -.ENDNOTE_STRING_COLOR default = black *Relative to the size of the endnotes text (set with ENDNOTE_PT_SIZE) </span> |