Added Cyg-Win
This commit is contained in:
parent
82cbc206eb
commit
413c315806
10586 changed files with 3806249 additions and 0 deletions
|
|
@ -0,0 +1,350 @@
|
|||
<?xml version="1.0" encoding="utf-8"?>
|
||||
<!--
|
||||
This file is part of groff, the GNU roff type-setting system.
|
||||
|
||||
Copyright (C) 2004-2020 Free Software Foundation, Inc.
|
||||
Written by Peter Schaffter (peter@schaffter.ca).
|
||||
|
||||
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 no
|
||||
Invariant Sections, 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=utf-8"/>
|
||||
<title>Mom -- Recto/verso printing, collating</title>
|
||||
<link rel="stylesheet" type="text/css" href="stylesheet.css" />
|
||||
</head>
|
||||
|
||||
<body style="background-color: #f5faff;">
|
||||
|
||||
<!-- ==================================================================== -->
|
||||
|
||||
<div id="top" class="page">
|
||||
|
||||
<!-- Navigation links -->
|
||||
<table style="width: 100%;">
|
||||
<tr>
|
||||
<td><a href="toc.html">Back to Table of Contents</a></td>
|
||||
<td style="text-align: right;"><a href="cover.html#top">Next: Cover pages</a></td>
|
||||
</tr>
|
||||
</table>
|
||||
|
||||
<h1 class="docs">Recto/verso printing, collating</h1>
|
||||
|
||||
<div style="width: 50%; margin: auto;">
|
||||
<ul class="no-enumerator" style="margin-left: -1em;">
|
||||
<li><a href="#rectoverso-intro">Introduction to recto/verso printing</a>
|
||||
<ul style="margin-left: -.5em; list-style-type: disc;">
|
||||
<li><a href="#rectoverso-list">Macro list</a></li>
|
||||
</ul></li>
|
||||
<li><a href="#collate-intro">Introduction to collating</a>
|
||||
<ul style="margin-left: -.5em; list-style-type: disc;">
|
||||
<li><a href="#collate">The COLLATE macro</a></li>
|
||||
</ul></li>
|
||||
</ul>
|
||||
</div>
|
||||
|
||||
<div class="rule-medium"><hr/></div>
|
||||
|
||||
<h2 id="rectoverso-intro" class="docs">Introduction to recto/verso printing</h2>
|
||||
|
||||
<p>
|
||||
Recto/verso printing allows you to set up a mom 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, mom automatically takes control of the following
|
||||
aspects of alternating page layout:
|
||||
</p>
|
||||
<ul style="margin-top: -.5em; margin-left: -.5em; margin-bottom: -.5em;">
|
||||
<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#header">headers</a>
|
||||
or
|
||||
<a href="definitions.html#footer">footers</a>
|
||||
(see the
|
||||
<a href="headfootpage.html#description-general">General description of headers</a>)
|
||||
</li>
|
||||
<li>switching
|
||||
<a href="headfootpage.html#hdrftr-recto">HEADER_RECTO</a>
|
||||
and
|
||||
<a href="headfootpage.html#hdrftr-recto">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>
|
||||
<br/>
|
||||
|
||||
<div class="macro-list-container">
|
||||
<h3 id="rectoverso-list" class="macro-list">Recto/verso macros</h3>
|
||||
<ul class="macro-list">
|
||||
<li><a href="#recto-verso">RECTO_VERSO</a></li>
|
||||
<li><a href="#force-recto">FORCE_RECTO</a></li>
|
||||
<li><a href="#switch-hdrftr">SWITCH_HEADERS (also FOOTERS)</a>
|
||||
– switch starting position of the header parts (left and right)
|
||||
</li>
|
||||
</ul>
|
||||
</div>
|
||||
|
||||
<!-- -RECTO_VERSO- -->
|
||||
|
||||
<div id="recto-verso" class="box-macro-args">
|
||||
Macro: <b>RECTO_VERSO</b>
|
||||
</div>
|
||||
|
||||
<p>
|
||||
If you want mom to set up alternating pages for recto/verso
|
||||
printing, simply invoke RECTO_VERSO, with no argument, anywhere in
|
||||
your document (most likely before
|
||||
<a href="docprocessing.html#start">START</a>).
|
||||
</p>
|
||||
|
||||
<div class="box-tip">
|
||||
<p class="tip-top">
|
||||
<span class="note">Note:</span>
|
||||
Recto/verso always switches the left and right parts of
|
||||
<a href="definitions.html#header">headers</a>
|
||||
or
|
||||
<a href="definitions.html#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 START).
|
||||
</p>
|
||||
|
||||
<p class="tip-bottom">
|
||||
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 START).
|
||||
</p>
|
||||
</div>
|
||||
|
||||
<!-- -FORCE_RECTO- -->
|
||||
|
||||
<div id="force-recto" class="box-macro-args" style="margin-top: 1em;">
|
||||
Macro: <b>FORCE_RECTO</b>
|
||||
</div>
|
||||
|
||||
<p>
|
||||
It is a common convention with two-sided printing to ensure that
|
||||
cover pages, title pages, and chapters or major sections of a document
|
||||
always begin on the recto side of a page. This sometimes
|
||||
necessitates inserting a blank page before the start of a new
|
||||
chapter or major section.
|
||||
</p>
|
||||
|
||||
<p>
|
||||
If you would like mom to take care of this for you automatically,
|
||||
simply invoke <kbd>FORCE_RECTO</kbd> before the first
|
||||
<a href="docprocessing.html#start">START</a>
|
||||
of the document.
|
||||
</p>
|
||||
|
||||
<!-- -SWITCH_HDRFTR- -->
|
||||
|
||||
<div id="switch-hdrftr" class="box-macro-args" style="margin-top: 1em;">
|
||||
Macro: <b>SWITCH_HEADERS</b>
|
||||
</div>
|
||||
|
||||
<p>
|
||||
SWITCH_HEADERS 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 mom’s default
|
||||
placement of author and title, use SWITCH_HEADERS to reverse it.
|
||||
</p>
|
||||
|
||||
<p>
|
||||
SWITCH_HEADERS can also be useful in conjunction with
|
||||
<a href="#recto-verso">RECTO_VERSO</a>.
|
||||
The assumption of RECTO_VERSO is that the first page of a document
|
||||
(i.e. recto/odd) represents the norm for header-left and header-right,
|
||||
meaning that the second (and all subsequent verso/even) pages of the
|
||||
document will reverse the order of header-left and header-right.
|
||||
</p>
|
||||
|
||||
<p>
|
||||
If mom’s behaviour in this matter is not what you want, simply
|
||||
invoke SWITCH_HEADERS 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>
|
||||
|
||||
<div class="rule-medium"><hr/></div>
|
||||
|
||||
<!-- ===================================================================== -->
|
||||
|
||||
<h2 id="collate-intro" class="docs">Introduction to collating</h2>
|
||||
|
||||
<p>
|
||||
Many people wisely keep chapters of a long work in separate
|
||||
files, previewing or printing them as needed during the draft
|
||||
phase. However, when it comes to the final version, mom requires
|
||||
a single, collated file in order to keep track of page numbering
|
||||
and recto/verso administration, generating tables of contents and
|
||||
endnotes, ensuring that
|
||||
<a href="definitions.html#docheader">docheaders</a>
|
||||
get printed correctly, and a host of other details.
|
||||
</p>
|
||||
|
||||
<p>
|
||||
The COLLATE macro, which can be used with any
|
||||
<a href="docprocessing.html#doctype">DOCTYPE</a>
|
||||
except <kbd>LETTER</kbd>, lets you glue mom-formatted input files
|
||||
together. You need only concatenate chapters into a single file
|
||||
(most likely with <kbd>cat(1)</kbd>), and put
|
||||
<kbd>.COLLATE</kbd> at the end of each concatenated chapter.
|
||||
Assuming all the files begin with the required
|
||||
<a href="docprocessing.html#reference-macros">reference macros</a>
|
||||
(metadata), style parameters, and
|
||||
<a href="docprocessing.html#start">START</a>,
|
||||
each chapter will begin on a fresh page and behave as expected.
|
||||
</p>
|
||||
|
||||
<p>
|
||||
Even if you work with monolithic, multi-chapter files, every
|
||||
chapter and its associated metadata plus <kbd>.START</kbd>
|
||||
still needs to be preceded by <kbd>.COLLATE</kbd>.
|
||||
</p>
|
||||
|
||||
<div class="box-tip">
|
||||
<p class="tip">
|
||||
<span class="note">Note:</span>
|
||||
COLLATE assumes you are collating documents/files with similar
|
||||
type-style parameters hence there’s no need for PRINTSTYLE
|
||||
to appear after COLLATE, although if you’re collating
|
||||
documents that were created as separate files, chances are the
|
||||
PRINTSTYLE’s already there.
|
||||
</p>
|
||||
</div>
|
||||
|
||||
<div class="box-tip">
|
||||
<p id="caution" class="tip">
|
||||
<b>Two words of caution:</b>
|
||||
</p>
|
||||
<ol style="margin-top: -1.25em; padding-bottom: .5em;">
|
||||
<li>Do not collate documents of differing
|
||||
PRINTSTYLES (i.e., don’t try to
|
||||
collate a <kbd>TYPESET</kbd> document and <kbd>TYPEWRITE</kbd>
|
||||
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>
|
||||
</div>
|
||||
|
||||
<!-- -COLLATE- -->
|
||||
|
||||
<div class="macro-id-overline">
|
||||
<h3 id="collate" class="macro-id">collate</h3>
|
||||
</div>
|
||||
|
||||
<div class="box-macro-args">
|
||||
Macro: <b>COLLATE</b>
|
||||
</div>
|
||||
|
||||
<p>
|
||||
The most basic (and most likely) collating situation looks like
|
||||
this:
|
||||
<br/>
|
||||
<span class="pre-in-pp">
|
||||
.COLLATE
|
||||
.CHAPTER 17
|
||||
.START
|
||||
</span>
|
||||
A slightly more complex version of the same thing, for chapters
|
||||
that require their own titles, looks like this:
|
||||
<br/>
|
||||
<span class="pre-in-pp">
|
||||
.COLLATE
|
||||
.CHAPTER_TITLE "Geek Fatigue: Symptoms and Causes"
|
||||
.START
|
||||
</span>
|
||||
</p>
|
||||
|
||||
<div class="box-tip" style="margin-top: -1em">
|
||||
<p class="tip">
|
||||
<span class="tip">Tip:</span>
|
||||
If the last line of text before <kbd>.COLLATE</kbd>
|
||||
falls too close to the bottom margin, or if the line is followed
|
||||
by a macro likely to cause a linebreak (e.g. <kbd>.LIST OFF</kbd> or
|
||||
<kbd>.IQ</kbd>), mom may output a superfluous blank page before
|
||||
the start of the following document.
|
||||
</p>
|
||||
|
||||
<p class="tip-bottom" style="margin-top: -1em">
|
||||
In order to avoid this, insert
|
||||
<a href="docprocessing.html#EL"><kbd>.EL</kbd></a>
|
||||
after the last line of text, before <kbd>.COLLATE</kbd> and/or any
|
||||
concluding macros. For example,
|
||||
<br/>
|
||||
<span class="pre-in-pp">
|
||||
some concluding text.\c
|
||||
.EL
|
||||
.COLLATE
|
||||
</span>
|
||||
or
|
||||
<br/>
|
||||
<span class="pre-in-pp">
|
||||
some concluding text.\c
|
||||
.EL
|
||||
.LIST OFF
|
||||
.COLLATE
|
||||
</span>
|
||||
</p>
|
||||
</div>
|
||||
|
||||
<div class="box-tip">
|
||||
<p class="tip">
|
||||
<span class="note">Note:</span>
|
||||
See the
|
||||
<a href="#caution">two words of caution</a>,
|
||||
above.
|
||||
</p>
|
||||
</div>
|
||||
|
||||
<div class="rule-long"><hr/></div>
|
||||
|
||||
<!-- Navigation links -->
|
||||
<table style="width: 100%; margin-top: 12px;">
|
||||
<tr>
|
||||
<td style="width: 33%;"><a href="toc.html">Back to Table of Contents</a></td>
|
||||
<td style="width: 33%; text-align: center;"><a href="#top">Top</a></td>
|
||||
<td style="width: 33%; text-align: right;"><a href="cover.html">Next: Cover pages</a></td>
|
||||
</tr>
|
||||
</table>
|
||||
|
||||
</div>
|
||||
|
||||
<div class="bottom-spacer"><br/></div>
|
||||
|
||||
</body>
|
||||
</html>
|
||||
Loading…
Add table
Add a link
Reference in a new issue