/[groff]/groff/contrib/mom/momdoc/typemacdoc.html
ViewVC logotype

Diff of /groff/contrib/mom/momdoc/typemacdoc.html

Parent Directory Parent Directory | Revision Log Revision Log | View Patch Patch

revision 1.7 by wlemb, Fri Jun 4 06:43:08 2004 UTC revision 1.8 by wl, Mon Jan 24 08:23:21 2005 UTC
# Line 52  margins, line length, Line 52  margins, line length,
52  <a href="definitions.html#TERMS_LEADING">leading</a>,  <a href="definitions.html#TERMS_LEADING">leading</a>,
53  and  and
54  <a href="definitions.html#TERMS_QUAD">quad</a>.  <a href="definitions.html#TERMS_QUAD">quad</a>.
 <p>  
 <strong>NOTE:</strong> See the section on  
 <a href="#TB_MARGINS">Top and bottom margins in document processing</a>  
 for information on how <strong>mom</strong> interprets  
 <a href="typesetting.html#T_MARGIN">T_MARGIN</a>  
 and  
 <a href="typesetting.html#B_MARGIN">B_MARGIN</a>  
 in document processing.  
55    
56  <p>  <p>
57  <strong>Mom</strong> assumes that any changes to these parameters  <strong>Mom</strong> assumes that any changes to these parameters
# Line 71  middle of a document. Line 63  middle of a document.
63  <p>  <p>
64  The following lists those typesetting macros whose behaviour during  The following lists those typesetting macros whose behaviour during
65  document processing requires some explanation.  document processing requires some explanation.
66    (Please refer to
67    <a href="#TB_MARGINS">Top and bottom margins in document processing</a>
68    for information on how <strong>mom</strong> interprets
69    <a href="typesetting.html#T_MARGIN">T_MARGIN</a>
70    and
71    <a href="typesetting.html#B_MARGIN">B_MARGIN</a>
72    in document processing.  Additionally, see
73    <a href="#ADD_SPACE">ADD_SPACE</a>
74    if you encounter the problem of trying to get <strong>mom</strong>
75    to put space at the tops of pages after the first.)
76    
77    
78  <p>  <p>
79  <pre>  <pre>
80  MACRO           EFFECT DURING DOCUMENT PROCESSING  MACRO           EFFECT DURING DOCUMENT PROCESSING
# Line 177  running text, but have no effect on the Line 181  running text, but have no effect on the
181  <a href="definitions.html#TERMS_FOOTER">footers</a>,  <a href="definitions.html#TERMS_FOOTER">footers</a>,
182  or page numbers.  or page numbers.
183    
184    <a name="ADD_SPACE">
185            <h2><u>ADD_SPACE</u></h2>
186    </a>
187    
188    <p>
189    Occasionally, you may want to insert space before the start of
190    <a href="definitions.html#TERMS_RUNNING">running text</a>
191    on pages after the first.
192    <p>
193    You might have tried using
194    <a href="typesetting.html#ALD">ALD</a>
195    or
196    <a href="typesetting.html#SPACE">SPACE</a>
197    and found it did nothing.  This is because <strong>mom</strong>
198    normally inhibits any extra space before the start of running text
199    on pages after the first.
200    <p>
201    If you need the space, you must use the macro,
202    <strong>ADD_SPACE</strong>, in conjuction with
203    <a href="typesetting.html#NEWPAGE">NEWPAGE</a>.
204    <strong>ADD_SPACE</strong> takes as its single argument the
205    distance you want <strong>mom</strong> to advance from the normal
206    baseline position at the top of the page.  A
207    <a href="definitions.html#TERMS_UNITOFMEASURE">unit of measure</a>
208    is required.
209    
210    <p>
211    For example, say you wanted to insert 2 inches of space before the
212    start of running text on a page other than the first.  You'd
213    accomplish it with
214    
215    <p>
216    <pre>
217            .NEWPAGE
218            .ADD_SPACE 2i
219    </pre>
220    
221    which would terminate your current page, break to a new page,
222    print the header (assuming headers are on) and insert 2 inches of
223    space before the start of running text.
224    <p>
225    Since adding space in this way is almost sure to disrupt
226    <strong>mom</strong>'s ability to guarantee perfectly flush bottom
227    margins, I highly recommend using the
228    <a href="docprocessing.html#SHIM">SHIM</a>
229    macro immediately after <strong>ADD_SPACE</strong>.
230  <p>  <p>
231  <hr>  <hr>
232  <a href="macrolist.html#TOP">Next</a>&nbsp;&nbsp;  <a href="macrolist.html#TOP">Next</a>&nbsp;&nbsp;

Legend:
Removed from v.1.7  
changed lines
  Added in v.1.8

savannah-hackers-public@gnu.org
ViewVC Help
Powered by ViewVC 1.1.26