diff options
author | PTPi <PTPi> | 2010-08-18 22:40:25 +0000 |
---|---|---|
committer | PTPi <PTPi> | 2010-08-18 22:40:25 +0000 |
commit | 3ba71bae1806d1b02f7d0d0e49d53523bb501c70 (patch) | |
tree | 94b0669b79b84ef6a6eb84198c84ccb17f74bd81 /contrib/mom/momdoc/rectoverso.html | |
parent | 819deb8e912543224eb32c7545ba0d1ff047fd3d (diff) | |
download | groff-3ba71bae1806d1b02f7d0d0e49d53523bb501c70.tar.gz |
Complete doc overhaul; removed old files
Diffstat (limited to 'contrib/mom/momdoc/rectoverso.html')
-rw-r--r-- | contrib/mom/momdoc/rectoverso.html | 321 |
1 files changed, 0 insertions, 321 deletions
diff --git a/contrib/mom/momdoc/rectoverso.html b/contrib/mom/momdoc/rectoverso.html deleted file mode 100644 index 5eb7f013..00000000 --- a/contrib/mom/momdoc/rectoverso.html +++ /dev/null @@ -1,321 +0,0 @@ -<?xml version="1.0" encoding="iso-8859-1"?> -<!-- -This file is part of groff, the GNU roff type-setting system. - -Copyright (C) 2004, 2005, 2006, 2009 Free Software Foundation, Inc. -Written by Peter Schaffter. - -Permission is granted to copy, distribute and/or modify this document -under the terms of the GNU Free Documentation License, Version 1.3 or -any later version published by the Free Software Foundation; with the -Invariant Sections being this comment section, with no Front-Cover -Texts, and with no Back-Cover Texts. - -A copy of the Free Documentation License is included as a file called -FDL in the main directory of the groff source package. ---> -<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd"> -<html xmlns="http://www.w3.org/1999/xhtml"> -<head> -<meta http-equiv="content-type" content="text/html;charset=iso-8859-1"/> -<title>Mom -- Document Processing, Recto/verso printing</title> -</head> -<body bgcolor="#dfdfdf"> - -<!-- ==================================================================== --> - -<a name="TOP"></a> - -<p> -<a href="cover.html#TOP">Next</a> -<a href="headfootpage.html#TOP">Prev</a> -<a href="toc.html">Back to Table of Contents</a> -</p> - -<a name="RECTOVERSO"><h1 align="center"><u>Recto/verso printing, collating</u></h1></a> - -<a name="INDEX_RECTOVERSO"></a> - -<ul> - <li><a href="#RECTOVERSO_INTRO">Introduction to recto/verso</a></li> - <ul> - <li><a href="#RECTOVERSO_LIST">Macro list</a></li> - </ul> - <li><a href="#COLLATE_INTRO">Introduction to collating</a></li> - <ul> - <li><a href="#COLLATE">The COLLATE macro</a></li> - </ul> -</ul> - -<a name="RECTOVERSO_INTRO"><h2><u>Introduction to recto/verso</u></h2></a> - -<p> -Recto/verso printing allows you to set up a <strong>mom</strong> -document in such a way that it can be printed on both sides of a -printer sheet and subsequently bound. -</p> - -<p> -With recto/verso, <strong>mom</strong> automatically takes control -of the following aspects of alternating page layout: -</p> - -<ul> - <li>switching left and right margins (if they're not equal)</li> - <li>switching the left and right parts of the default 3-part - <a href="definitions.html#TERMS_HEADER">headers</a> - or - <a href="definitions.html#TERMS_FOOTER">footers</a> - (see the - <a href="headfootpage.html#DESCRIPTION_GENERAL">General description of headers</a>) - </li> - <li>switching - <a href="headfootpage.html#HDRFTR_RECTOVERSO">HEADER_RECTO</a> - and - <a href="headfootpage.html#HDRFTR_RECTOVERSO">HEADER_VERSO</a> - if user-defined, single string recto/verso headers - or footers are used in place of the default 3-part - headers or footers - </li> - <li>switching the page number position (if page numbers are not centred)</li> -</ul> - -<p> -It is beyond the scope of this documentation to cover the different -ways in which you can make your printer print on both sides of a sheet. -A simple but effective method for those of us with "dumb" -printers is to open the document (after it's been processed into -PostScript by groff — see -<a href="using.html#USING_INVOKING">How to invoke groff with mom</a>) -in <strong>gv</strong> (ghostview), click the "odd pages" -icon, then click "Print Marked". After printing -is complete, rearrange the sheets appropriately, put them -back in your printer, and have <strong>gv</strong> print the -"even pages". If you prefer to work from the command -line, check out the man pages for <strong>pstops</strong> and -<strong>psbook</strong>. There are other programs out there as well -to help with two-sided printing. -</p> - -<a name="RECTOVERSO_LIST"><h3><u>Recto/verso macros list</u></h3></a> - -<ul> - <li><a href="#RECTO_VERSO">RECTO_VERSO</a></li> - <li><a href="#SWITCH_HDRFTR">SWITCH_HEADERS (also FOOTERS)</a> - — switch position of the header parts (left and right) - </li> -</ul> - -<!-- -RECTO_VERSO- --> - -<hr align="left" width="66%"/> - -<a name="RECTO_VERSO"></a> - -<p> -Macro: <strong>RECTO_VERSO</strong> -</p> - -<p> -If you want <strong>mom</strong> to set up alternating pages for -recto/verso printing, simply invoke <strong>RECTO_VERSO</strong> -with no argument. -</p> - -<p> -<strong>NOTE:</strong> Recto/verso always switches the left and -right parts of -<a href="definitions.html#TERMS_HEADER">headers</a> -or -<a href="definitions.html#TERMS_FOOTER">footers</a> -on odd/even pages. However, it only switches the left and right -margins if the margins aren't equal. Consequently, it is your -responsibility to set the appropriate differing left and right -margins with -<a href="typesetting.html#L_MARGIN">L_MARGIN</a> -and -<a href="typesetting.html#R_MARGIN">R_MARGIN</a> -(prior to -<a href="docprocessing.html#START">START</a>) -or with -<a href="docprocessing.html#DOC_LEFT_MARGIN">DOC_LEFT_MARGIN</a> -and -<a href="docprocessing.html#DOC_RIGHT_MARGIN">DOC_RIGHT_MARGIN</a> -(before or after <strong>START</strong>). -</p> - -<p> -Equally, recto/verso only switches the page number position if page -numbers aren't centred, which means you have to set the page number -position with -<a href="headfootpage.html#PAGENUM_POS">PAGENUM_POS</a> -(before or after <strong>START</strong>). -</p> - -<!-- -SWITCH_HDRFTR- --> - -<hr width="33%" align="left"/> - -<a name="SWITCH_HDRFTR"></a> - -<p> -Macro: <strong>SWITCH_HEADERS</strong> -</p> - -<p> -<strong>SWITCH_HEADERS</strong> switches the location of the -header left string (by default, the author) and the header right -string (by default, the document title). If you don't like -<strong>mom</strong>'s default placement of author and title, use -<strong>SWITCH_HEADERS</strong> to reverse it. -</p> - -<p> -<strong>SWITCH_HEADERS</strong> can also be useful in conjunction -with -<a href="#RECTO_VERSO">RECTO_VERSO</a>. -The assumption of <strong>RECTO_VERSO</strong> is that the first -page of a document (recto/odd) represents the norm for header-left -and header-right, meaning that the second (and all subsequent even) -page(s) of the document exchange header-left and header-right. -</p> - -<p> -If <strong>mom</strong>'s behaviour in this matter is not what you -want, simply invoke <strong>SWITCH_HEADERS</strong> on the first -page of your recto/verso document to reverse her default treatment -of header parts. The remainder of your document (with respect to -headers) will come out as you want. -</p> - -<hr/> - -<!-- ===================================================================== --> - -<a name="COLLATE_INTRO"><h2><u>Introduction to collating</u></h2></a> - -<p> -The macro <strong>COLLATE</strong> lets you join documents together. -Primarily, it's a convenience for printing long documents that -comprise several chapters, although it could be used for any -document type (except <strong>LETTER</strong>). -</p> - -<p> -Personally, I prefer to keep chapters in separate files and print -them out as needed. However, that means keeping track of the correct -starting page number for each chapter, a problem circumvented by the -use of <strong>COLLATE</strong>. -</p> - -<p> -When collating chapters, you need only put <kbd>.COLLATE</kbd> at -the end of a chapter, follow it with any -<a href="docprocessing.html#REFERENCE_MACROS">reference macros</a> -needed for the new chapter, e.g. -<a href="docprocessing.html#CHAPTER">CHAPTER</a> -or -<a href="docprocessing.html#CHAPTER_STRING">CHAPTER_STRING</a>, -make any pertinent style changes to the document (unlikely, but -possible), and re-invoke the -<a href="docprocessing.html#START">START</a> -macro. Your new chapter will begin on a fresh page and behave -as expected. -</p> - -<p> -<strong>COLLATE</strong> assumes you are collating documents/files -with similar type-style parameters hence there's no need for -<strong>PRINTSTYLE</strong> to appear after <strong>COLLATE</strong>, -although if you're collating documents that were created as separate -files, chances are the <strong>PRINTSTYLE</strong>'s already there. -</p> - -<a name="CAUTION"></a> - -<p> -<strong><u>Two words of caution:</u></strong> - -<ol> - <li>Do not collate documents of differing - <strong>PRINTSTYLES</strong> (i.e. don't try to - collate a TYPESET document and TYPEWRITE document). - </li> - <li>Use <kbd>.DOC_FAMILY</kbd> instead of - <kbd>.FAMILY</kbd> if, for some reason, you want to - change the family of all the document elements after - <kbd>.COLLATE</kbd>. <kbd>.FAMILY</kbd>, by itself, will - change the family of paragraph text only. - </li> -</ol> -</p> - -<!-- -COLLATE- --> - -<hr width="66%" align="left"/> - -<a name="COLLATE"></a> - -<p> -Macro: <strong>COLLATE</strong> -</p> - -<p> -The most basic (and most likely) collating situation looks like -this: - -<pre> - .COLLATE - .CHAPTER 17 - .START -</pre> -</p> - -<p> -A slightly more complex version of the same thing, for chapters -that require their own titles, looks like this: - -<pre> - .COLLATE - .CHAPTER_TITLE "Geek Fatigue: Symptoms and Causes" - .START -</pre> -</p> - -<p> -<strong>Tip:</strong> If the last -<a href="definitions.html#TERMS_OUTPUTLINE">output line</a> -of a document before <strong>COLLATE</strong> falls too close to -the bottom margin for running text, <strong>mom</strong> may output -a blank page with only a header or footer between collated -documents. In order to avoid this, I recommend always preceding -<strong>COLLATE</strong> with -<a href="typesetting.html#EL">.EL</a>, -like this - -<pre> - .EL - .COLLATE -</pre> -</p> - -<p> -<strong>NOTE:</strong> See the -<a href="#CAUTION">two words of caution</a>, -above. -</p> - -<hr/> - -<p> -<a href="cover.html#TOP">Next</a> -<a href="headfootpage.html#TOP">Prev</a> -<a href="#TOP">Top</a> -<a href="toc.html">Back to Table of Contents</a> -</p> - -</body> -</html> - -<!-- vim: fileencoding=latin1: nomodified: ---> |