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

   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
  37 Recto/verso printing allows you to set up a <strong>mom</strong>
  38 document in such a way that it can be printed on both sides of a
  39 printer sheet and subsequently bound.
  40 <p>
  41 With recto/verso, <strong>mom</strong> automatically takes control
  42 of 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>
  62 It is beyond the scope of this documentation to cover the different
  63 ways in which you can make your printer print on both sides of a sheet.
  64 A simple but effective method for those of us with &quot;dumb&quot;
  65 printers is to open the document (after it's been processed into
  66 PostScript by groff -- see
  67 <a href="using.html#USING_INVOKING">How to invoke groff with mom</a>)
  68 in <strong>gv</strong> (ghostview),
  69 click the &quot;odd pages&quot; icon, then click &quot;Print
  70 Marked&quot;.  After printing is complete, rearrange the sheets
  71 appropriately, put them back in your printer, and have
  72 <strong>gv</strong> print the &quot;even pages&quot;.  If you prefer to
  73 work from the command line, check out the man pages for
  74 <strong>pstops</strong> and <strong>psbook</strong>.  There are other
  75 programs 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>
  94 Macro: <strong>RECTO_VERSO</strong>
  95
  96 <p>
  97 If you want <strong>mom</strong> to set up alternating pages for
  98 recto/verso printing, simply invoke <strong>RECTO_VERSO</strong>
  99 with no argument.
 100 <p>
 101 <strong>NOTE:</strong>
 102 <br>
 103 Recto/verso always switches the left and right parts of
 104 <a href="definitions.html#TERMS_HEADER">headers</a>
 105 or
 106 <a href="definitions.html#TERMS_FOOTER">footers</a>
 107 on odd/even pages.  However, it only switches the left and right
 108 margins if the margins aren't equal.  Consequently, it is your
 109 responsibility to set the appropriate differing left and right
 110 margins with
 111 <a href="typesetting.html#L_MARGIN">L_MARGIN</a>
 112 and
 113 <a href="typesetting.html#R_MARGIN">R_MARGIN</a>
 114 (prior to
 115 <a href="docprocessing.html#START">START</a>)
 116 or with
 117 <a href="docprocessing.html#DOC_LEFT_MARGIN">DOC_LEFT_MARGIN</a>
 118 and
 119 <a href="docprocessing.html#DOC_RIGHT_MARGIN">DOC_RIGHT_MARGIN</a>
 120 (before or after <strong>START</strong>).
 121 <p>
 122 Equally, recto/verso only switches the page number position if page
 123 numbers aren't centred, which means you have to set the page
 124 number 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>
 135 Macro: <strong>SWITCH_HEADERS</strong>
 136
 137 <p>
 138 <strong>SWITCH_HEADERS</strong> switches the location of the
 139 header left string (by default, the author) and the header right
 140 string (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
 145 with
 146 <a href="#RECTO_VERSO">RECTO_VERSO</a>.
 147 The assumption of <strong>RECTO_VERSO</strong> is that the first
 148 page of a document (recto/odd) represents the norm for header-left
 149 and header-right, meaning that the second (and all subsequent even)
 150 page(s) of the document exchange header-left and header-right.
 151 <p>
 152 If <strong>mom</strong>'s behaviour in this matter is not what
 153 you want, simply invoke <strong>SWITCH_HEADERS</strong> on the
 154 first page of your recto/verso document to reverse her default
 155 treatment of header parts.  The remainder of your document (with
 156 respect to headers) will come out as you want.
 157 <p>
 158 <strong>NOTE:</strong> Replace <strong>_HEADERS</strong>, above,
 159 with <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
 169 The macro <strong>COLLATE</strong> lets you join documents together.
 170 Primarily, it's a convenience for printing long documents that
 171 comprise several chapters, although it could be used for any
 172 document type (except <strong>LETTER</strong>).
 173 <p>
 174 Personally, I prefer to keep chapters in separate files and print
 175 them out as needed.  However, that means keeping track of the correct
 176 starting page number for each chapter, a problem circumvented by the
 177 use of <strong>COLLATE</strong>.
 178 <p>
 179 When collating chapters, you need only put <code>.COLLATE</code>
 180 at the end of a chapter, follow it with any
 181 <a href="docprocessing.html#REFERENCE_MACROS">reference macros</a>
 182 needed for the new chapter, e.g.
 183 <a href="docprocessing.html#CHAPTER">CHAPTER</a>
 184 or
 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>)
 188 make any pertinent style changes to the document (unlikely, but
 189 possible), and re-invoke the
 190 <a href="docprocessing.html#START">START</a>
 191 macro.  Your new chapter will begin on a fresh page and behave
 192 as expected.
 193 <p>
 194 <strong>COLLATE</strong> assumes you are collating documents/files
 195 with similar type-style parameters hence there's no need for
 196 <strong>PRINTSTYLE</strong> to appear after <strong>COLLATE</strong>,
 197 although if you're collating documents that were created as separate
 198 files, 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
 221 Macro: <strong>COLLATE</strong>
 222
 223 <p>
 224 The most basic (and most likely) collating situation looks like
 225 this:
 226 <p>
 227 <pre>
 228         .COLLATE
 229         .CHAPTER 17
 230         .START
 231 </pre>
 232
 233 A slightly more complex version of the same thing, for chapters
 234 that 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>,
 244 above.
 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>