PageRenderTime 15ms CodeModel.GetById 2ms app.highlight 8ms RepoModel.GetById 1ms app.codeStats 1ms

/contrib/groff/contrib/mom/momdoc/rectoverso.html

https://bitbucket.org/freebsd/freebsd-head/
HTML | 253 lines | 226 code | 24 blank | 3 comment | 0 complexity | abca72f6650ecd2c0eac5c6816f8aa87 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, Recto/verso printing</title>
  6</head>
  7<body bgcolor="#dfdfdf">
  8
  9<!====================================================================>
 10
 11<a href="cover.html#TOP">Next</a>&nbsp;&nbsp;
 12<a href="headfootpage.html#TOP">Prev</a>&nbsp;&nbsp;
 13<a href="toc.html">Back to Table of Contents</a>
 14<p>
 15
 16<a name="TOP"></a>
 17<a name="INDEX_RECTOVERSO"></a>
 18<a name="RECTOVERSO">
 19	<h1 align="center"><u>RECTO/VERSO PRINTING and COLLATING</u></h1>
 20</a>
 21
 22<ul>
 23	<li><a href="#RECTOVERSO_INTRO">Introduction to recto/verso</a>
 24	<ul>
 25		<li><a href="#RECTOVERSO_LIST">Macro list</a>
 26	</ul>
 27	<li><a href="#COLLATE_INTRO">Introduction to collating</a>
 28	<ul>
 29		<li><a href="#COLLATE">The COLLATE macro</a>
 30	</ul>
 31</ul>
 32
 33<a name="RECTOVERSO_INTRO">
 34	<h2><u>Introduction to recto/verso</u></h2>
 35</a>
 36
 37Recto/verso printing allows you to set up a <strong>mom</strong>
 38document in such a way that it can be printed on both sides of a
 39printer sheet and subsequently bound.
 40<p>
 41With recto/verso, <strong>mom</strong> automatically takes control
 42of the following aspects of alternating page layout:
 43<br>
 44<ul>
 45	<li>switching left and right margins (if they're not equal)
 46	<li>switching the left and right parts of the default 3-part
 47		<a href="definitions.html#TERMS_HEADER">headers</a>
 48		or
 49		<a href="definitions.html#TERMS_FOOTER">footers</a>
 50		(see the
 51		<a href="headfootpage.html#DESCRIPTION_GENERAL">General description of headers</a>)
 52	<li>switching
 53		<a href="headfootpage.html#HDRFTR_RECTOVERSO">HEADER_RECTO</a>
 54		and
 55		<a href="headfootpage.html#HDRFTR_RECTOVERSO">HEADER_VERSO</a>
 56		if user-defined, single string recto/verso headers
 57		or footers are used in place of the default 3-part
 58		headers or footers
 59	<li>switching the page number position (if page numbers are not centred)
 60</ul>
 61<p>
 62It is beyond the scope of this documentation to cover the different
 63ways in which you can make your printer print on both sides of a sheet.
 64A simple but effective method for those of us with &quot;dumb&quot;
 65printers is to open the document (after it's been processed into
 66PostScript by groff -- see
 67<a href="using.html#USING_INVOKING">How to invoke groff with mom</a>)
 68in <strong>gv</strong> (ghostview),
 69click the &quot;odd pages&quot; icon, then click &quot;Print
 70Marked&quot;.  After printing is complete, rearrange the sheets
 71appropriately, put them back in your printer, and have
 72<strong>gv</strong> print the &quot;even pages&quot;.  If you prefer to
 73work from the command line, check out the man pages for
 74<strong>pstops</strong> and <strong>psbook</strong>.  There are other
 75programs out there as well to help with two-sided printing.
 76<p>
 77
 78<a name="RECTOVERSO_LIST">
 79	<h3><u>Recto/verso macros list</u></h3>
 80</a>
 81
 82<ul>
 83	<li><a href="#RECTO_VERSO">RECTO_VERSO</a>
 84	<li><a href="#SWITCH_HDRFTR">SWITCH_HEADERS (also FOOTERS)</a>
 85</ul>
 86<p>
 87
 88<hr>
 89<!---RECTO_VERSO--->
 90
 91<a name="RECTO_VERSO">
 92	<h3><u>Recto/verso printing</u></h3>
 93</a>
 94Macro: <strong>RECTO_VERSO</strong>
 95
 96<p>
 97If you want <strong>mom</strong> to set up alternating pages for
 98recto/verso printing, simply invoke <strong>RECTO_VERSO</strong>
 99with no argument.
100<p>
101<strong>NOTE:</strong>
102<br>
103Recto/verso always switches the left and right parts of
104<a href="definitions.html#TERMS_HEADER">headers</a>
105or
106<a href="definitions.html#TERMS_FOOTER">footers</a>
107on odd/even pages.  However, it only switches the left and right
108margins if the margins aren't equal.  Consequently, it is your
109responsibility to set the appropriate differing left and right
110margins with
111<a href="typesetting.html#L_MARGIN">L_MARGIN</a>
112and
113<a href="typesetting.html#R_MARGIN">R_MARGIN</a>
114(prior to
115<a href="docprocessing.html#START">START</a>)
116or with
117<a href="docprocessing.html#DOC_LEFT_MARGIN">DOC_LEFT_MARGIN</a>
118and
119<a href="docprocessing.html#DOC_RIGHT_MARGIN">DOC_RIGHT_MARGIN</a>
120(before or after <strong>START</strong>).
121<p>
122Equally, recto/verso only switches the page number position if page
123numbers aren't centred, which means you have to set the page
124number position with
125<a href="headfootpage.html#PAGENUM_POS">PAGENUM_POS</a>
126(before or after <strong>START</strong>).
127<p>
128
129<!---SWITCH_HDRFTR--->
130
131<hr width="66%" align="left">
132<a name="SWITCH_HDRFTR">
133	<h3><u>Switch header left part/right part</u></h3>
134</a>
135Macro: <strong>SWITCH_HEADERS</strong>
136
137<p>
138<strong>SWITCH_HEADERS</strong> switches the location of the
139header left string (by default, the author) and the header right
140string (by default, the document title).  If you don't like
141<strong>mom</strong>'s default placement of author and title, use
142<strong>SWITCH_HEADERS</strong> to reverse it.
143<p>
144<strong>SWITCH_HEADERS</strong> can also be useful in conjunction
145with
146<a href="#RECTO_VERSO">RECTO_VERSO</a>.
147The assumption of <strong>RECTO_VERSO</strong> is that the first
148page of a document (recto/odd) represents the norm for header-left
149and header-right, meaning that the second (and all subsequent even)
150page(s) of the document exchange header-left and header-right.
151<p>
152If <strong>mom</strong>'s behaviour in this matter is not what
153you want, simply invoke <strong>SWITCH_HEADERS</strong> on the
154first page of your recto/verso document to reverse her default
155treatment of header parts.  The remainder of your document (with
156respect to headers) will come out as you want.
157<p>
158<strong>NOTE:</strong> Replace <strong>_HEADERS</strong>, above,
159with <strong>_FOOTERS</strong> if your document uses footers.
160<p>
161<hr>
162
163<!=====================================================================>
164
165<a name="COLLATE_INTRO">
166	<h2><u>Introduction to collating</u></h2>
167</a>
168
169The macro <strong>COLLATE</strong> lets you join documents together.
170Primarily, it's a convenience for printing long documents that
171comprise several chapters, although it could be used for any
172document type (except <strong>LETTER</strong>).
173<p>
174Personally, I prefer to keep chapters in separate files and print
175them out as needed.  However, that means keeping track of the correct
176starting page number for each chapter, a problem circumvented by the
177use of <strong>COLLATE</strong>.
178<p>
179When collating chapters, you need only put <code>.COLLATE</code>
180at the end of a chapter, follow it with any
181<a href="docprocessing.html#REFERENCE_MACROS">reference macros</a>
182needed for the new chapter, e.g.
183<a href="docprocessing.html#CHAPTER">CHAPTER</a>
184or
185<a href="docprocessing.html#CHAPTER_STRING">CHAPTER_STRING</a>
186(have a look at the
187<a href="#CHAPTER_NOTE">Special Note on CHAPTER</a>)
188make any pertinent style changes to the document (unlikely, but
189possible), and re-invoke the
190<a href="docprocessing.html#START">START</a>
191macro.  Your new chapter will begin on a fresh page and behave
192as expected.
193<p>
194<strong>COLLATE</strong> assumes you are collating documents/files
195with similar type-style parameters hence there's no need for
196<strong>PRINTSTYLE</strong> to appear after <strong>COLLATE</strong>,
197although if you're collating documents that were created as separate
198files, chances are the <strong>PRINTSTYLE</strong>'s already there.
199<p>
200<a name="CAUTION"></a>
201<strong><u>Two words of caution:</u></strong>
202<ol>
203	<li>Do not collate documents of differing
204		<strong>PRINTSTYLES</strong> (i.e. don't try to
205		collate a TYPESET document and TYPEWRITE document).
206	<li>Use <strong>DOC_FAMILY</strong> instead of
207		<strong>FAMILY</strong> if, for some reason, you want
208		to change the family of all the document elements after
209		<strong>COLLATE</strong>.  <strong>FAMILY</strong>, by
210		itself, will change the family of paragraph text only.
211</ol>
212<p>
213
214<!---COLLATE--->
215
216<hr width="66%" align="left">
217<a name="COLLATE">
218	<h3><u>Collate document files</u></h3>
219</a>
220
221Macro: <strong>COLLATE</strong>
222
223<p>
224The most basic (and most likely) collating situation looks like
225this:
226<p>
227<pre>
228	.COLLATE
229	.CHAPTER 17
230	.START
231</pre>
232
233A slightly more complex version of the same thing, for chapters
234that require their own titles, looks like this:
235<p>
236<pre>
237	.COLLATE
238	.CHAPTER_TITLE "Geek Fatigue: Symptoms and Causes"
239	.START
240</pre>
241
242<strong>NOTE:</strong> See the
243<a href="#CAUTION">two words of caution</a>,
244above.
245<p>
246
247<hr>
248<a href="cover.html#TOP">Next</a>&nbsp;&nbsp;
249<a href="headfootpage.html#TOP">Prev</a>&nbsp;&nbsp;
250<a href="#TOP">Top</a>&nbsp;&nbsp;
251<a href="toc.html">Back to Table of Contents</a>
252</body>
253</html>