1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
318
319
320
321
322
323
324
325
326
327
328
329
330
331
332
333
334
335
336
337
338
339
340
341
342
343
344
345
346
347
348
349
350
351
352
353
354
355
356
357
358
359
360
361
362
363
364
365
366
367
368
369
370
371
372
373
374
375
376
377
378
379
380
381
382
383
384
385
386
387
388
389
390
391
392
393
394
395
396
397
398
399
400
401
402
403
404
405
406
407
408
409
410
411
412
413
414
415
416
417
418
419
420
421
422
423
424
425
426
427
428
429
430
431
432
433
434
435
436
437
438
439
440
441
442
443
444
445
446
447
448
449
450
451
452
453
454
455
456
457
458
459
460
461
462
463
464
465
466
467
468
469
470
471
472
473
474
475
476
477
478
479
480
481
482
483
484
485
486
487
488
489
490
491
492
493
494
495
496
497
498
499
500
501
502
503
504
505
506
507
508
509
510
511
512
513
514
515
516
517
518
519
520
521
522
523
524
525
526
527
528
529
530
531
532
533
534
535
536
537
538
539
540
541
542
543
544
545
546
547
548
549
550
551
552
553
554
555
556
557
558
559
560
561
562
563
564
565
566
567
568
569
570
571
572
573
574
575
576
577
578
579
580
581
582
583
584
585
586
587
588
589
590
591
592
593
594
595
596
597
598
599
600
601
602
603
604
605
606
607
608
609
610
611
612
613
614
615
616
617
618
619
620
621
622
623
624
625
626
627
628
629
630
631
632
633
634
635
636
637
638
639
640
641
642
643
644
645
646
647
648
649
650
651
652
653
654
655
656
657
658
659
660
661
|
<?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 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.1 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, creating a cover page</title>
</head>
<body bgcolor="#dfdfdf">
<!-- ==================================================================== -->
<a name="TOP"></a>
<p>
<a href="refer.html#TOP">Next</a>
<a href="rectoverso.html#TOP">Prev</a>
<a href="toc.html">Back to Table of Contents</a>
</p>
<a name="COVER_TOP"><h1 align="center"><u>Creating a cover page</u></h1></a>
<ul>
<li><a href="#COVER_INTRO">Introduction to cover pages</a></li>
<ul>
<li><a href="#PLEASE">Important note — please read</a></li>
<li><a href="#DESC">Description of what mom does on cover pages</a></li>
<li><a href="#PAGINATION">A note on headers/footers and pagination</a></li>
<li><a href="#DESIGN">What to do if you want to design your own cover pages</a></li>
</ul>
<li><a href="#COVER">The cover and document cover macros</a></li>
<ul>
<li><a href="#COVER">COVER/DOC_COVER</a></li>
<ul>
<li><a href="#REQUIRED">The required argument</a></li>
<li><a href="#CHAPTER">How the CHAPTER argument and friends work</a></li>
<li><a href="#OPTIONAL">The optional arguments</a></li>
<li><a href="#DOCTYPE">What the DOCTYPE argument means</a></li>
<li><a href="#BLANKPAGE">What the BLANKPAGE argument means</a></li>
</ul>
</ul>
<li><a href="#ON_OFF">Enabling/disabling automatic generation of cover pages</a></li>
<li><a href="#COVER_CONTROL">Control macros — changing the defaults for covers and document covers</a></li>
</ul>
<a name="COVER_INTRO"><h2><u>Introduction to cover pages</u></h2></a>
<p>
As of version 1.19 of <strong>mom</strong>, you can now have cover
pages generated automatically.
</p>
<p>
Though identical in treatment, <strong>mom</strong> provides two
kinds of cover pages: section cover pages (which I shall refer to
simply as "cover pages") and document cover pages
("doc covers").
</p>
<p>
A document cover page
(<a href="#DOC_COVER">doc cover</a>)
is what you'd most likely use at the start of a
<a href="rectoverso.html#COLLATE_INTRO">collated</a>
document, where you might want the name of the complete document,
the author(s) and the copyright line to appear. Another place you
might use a doc cover is for a novel, where you want the title of
the novel, not the chapter title or chapter number, as the first
cover page.
</p>
<p>
A section
<a href="#COVER">cover</a>
page is what you'd use for cover pages that separate sections of a
collated document, i.e. title pages. A section cover page (but not
a doc cover page) in a collated document could, for example, simply
read "PART I".
</p>
<p>
In non-collated documents (say, an essay) you can use either a
section cover (title page) or a doc cover to generate a cover sheet.
</p>
<p>
In addition, nothing prevents you from generating both a doc cover
page and a section cover page for every document in a collated
document. Or you can selectively disable the automatic generation
of either doc covers or section covers in a collated document
on-the-fly.
</p>
<p>
<a name="PLEASE"><strong>Important note:</strong></a>
automatic generation of cover or doc cover pages after the first
one(s) only takes place if you are working with collated documents.
<strong>Mom</strong> provides no mechanism for saying "print
a section cover here even though I'm still working on the same
(non-collated) document."
</p>
<a name="DESC"><h3><u>Description of what mom does on cover pages</u></h3></a>
<p>
By default, <strong>mom</strong> typesets cover (and doc cover)
pages identically to
<a href="definitions.html#TERMS_DOCHEADER">docheaders</a>
(see
<a href="docprocessing.html#DOCHEADER_CONTROL">How to change the look of docheaders</a>
for a description of what a docheader looks like). The only
differences are
<ul>
<li>the position on the page where the information is output</li>
<li>the (optional) addition of copyright and miscellaneous information</li>
<li>there's no running text underneath</li>
</ul>
</p>
<p>
You tell <strong>mom</strong> what you want to appear on cover pages
through the arguments you pass to
<a href="#COVER">COVER</a>
and/or
<a href="#COVER">DOC_COVER</a>.
Provided you have already given <strong>mom</strong> the
appropriate reference macros (e.g.
<a href="docprocessing.html#TITLE">TITLE</a>
or
<a href="docprocessing.html#AUTHOR">AUTHOR</a>),
she will output cover (and doc cover) pages identically to how she
would output docheaders containing the same information.
</p>
<p>
By default, <strong>mom</strong> starts cover (and doc cover) pages
one-third of the way down the page. This can be changed through
the use of the control macros
<a href="#COVER_CONTROL_INDEX">COVER_ADVANCE/DOC_COVER_ADVANCE</a>.
</p>
<p>
If you request copyright information (and have already given
<strong>mom</strong> the reference macro,
<a href="docprocessing.html#COPYRIGHT">COPYRIGHT</a>),
she sets it, by default, in a smaller
<a href="definitions.html#TERMS_PS">point size</a>
in the bottom right hand corner of the cover (or doc cover) page.
The default point size and the position can be controlled with
<a href="#COVER_CONTROL_INDEX">COVER_COPYRIGHT_SIZE/DOC_COVER_COPYRIGHT_SIZE</a>
and
<a href="#COVER_CONTROL_INDEX">COVER_COPYRIGHT_QUAD/DOC_COVER_COPYRIGHT_QUAD</a>.
</p>
<p>
Similarly, if you request miscellaneous information (and have
already given <strong>mom</strong> the reference macro,
<a href="docprocessing.html#MISC">MISC</a>),
she sets it, by default, in a smaller point size in the bottom left
hand corner of the cover (or doc cover) page. The default point
size is dependent on
<strong>COVER_COPYRIGHT_SIZE/DOC_COVER_COPYRIGHT_SIZE</strong>,
but the position can be controlled with
<a href="#COVER_CONTROL_INDEX">COVER_MISC_QUAD/DOC_COVER_MISC_QUAD</a>.
</p>
<a name="PAGINATION"></a>
<p>
<strong>NOTE: mom</strong> does not set any
<a href="definitions.html#TERMS_HEADER">headers</a>
or
<a href="definitions.html#TERMS_FOOTER">footers</a>
on cover pages. Neither does she set any page numbers. From
the point of view of pagination, cover (and doc cover) pages are
by default considered "null" pages. If you wish them to
be included in the pagination scheme (even though no page numbers
appear), you must tell <strong>mom</strong> that's what you want
with the macros <strong>DOC_COVERS_COUNT_PAGES</strong> and/or
<strong>COVERS_COUNT_PAGES</strong>.
</p>
<a name="DESIGN"></a>
<p>
Finally, if you want to design your own cover page(s), you can
always typeset them (using the
<a href="typesetting.html#MACROS_TYPESETTING">typesetting macros</a>),
invoke
<a href="typesetting.html#NEWPAGE"><kbd>.NEWPAGE</kbd></a>,
set up your document <em>in full</em> (see
<a href="docprocessing.html#DOCPROCESSING_TUT">Tutorial — Setting up a mom document</a>),
and lastly invoke
<a href="docprocessing.html#START"><kbd>.START</kbd></a>.
The cover page (and any typesetting commands on it) will have no
effect on <strong>mom</strong>'s processing of the document itself,
the first page of which, moreover, will be numbered "1"
unless you instruct her otherwise with
<a href="headfootpage.html#PAGENUMBER">PAGENUMBER</a>.
</p>
<!-- -COVER- -->
<hr width="66%" align="left"/>
<a name="COVER"></a>
<p>
Macro: <strong>COVER</strong>
<br/>
<a name="DOC_COVER"></a>
Macro: <strong>DOC_COVER</strong>
<br/>
<nobr>Required argument: <kbd>TITLE | DOCTITLE | COVERTITLE | CHAPTER | CHAPTER_TITLE | CHAPTER+TITLE</kbd></nobr>
<br/>
<nobr>Optional arguments: <kbd>[ SUBTITLE AUTHOR DOCTYPE COPYRIGHT MISC BLANKPAGE ]</kbd></nobr>
<br/>
<em>*Note: these macros should be placed in the
"style-sheet" section of your document setup (see the</em>
<a href="docprocessing.html#DOCPROCESSING_TUT">Tutorial — Setting up a mom document</a>),
<em>i.e. after PRINTSTYLE (and/or DOCTYPE and/or COPYSTYLE), but
before START.</em>
</p>
<p>
<strong>COVER</strong> and <strong>DOC_COVER</strong> behave
identically. The reason <strong>mom</strong> provides two macros
for automatic cover page generation is so that you can have two
different kinds of covers with different information on each.
</p>
<p>
Imagine, for a moment, you've written a document comprised of three
sections. When you
<a href="rectoverso.html#COLLATE">COLLATE</a>
the document for output, you could use <kbd>.DOC_COVER</kbd>
to generate a cover page that contained the name of the entire
document, your (the author's) name, and perhaps the copyright date.
Subsequently, you could use <kbd>.COVER</kbd>, after each
<kbd>.COLLATE</kbd> but before each
<a href="docprocessing.html#START">START</a>,
to generate a cover page (or cover "sheet", if you prefer)
containing just the name of the section.
</p>
<a name="REQUIRED"><h4><u>The required argument</u></h4></a>
<p>
Both <strong>COVER</strong> and <strong>DOC_COVER</strong>,
whenever invoked, require a first argument, as listed above.
This first argument will become the first bit of information
<strong>mom</strong> prints on the cover (or doc cover) page (i.e.
it will be the "title").
</p>
<p>
In order for the information to appear, you must, of course, first
have given <strong>mom</strong> the appropriate
<a href="docprocessing.html#REFERENCE_MACROS">reference macro</a>.
A list of the arguments with their equivalent reference macros follows.
</p>
<dl>
<dt><kbd>TITLE</kbd></dt>
<dd>
— means the argument you gave to <a href="docprocessing.html#TITLE">TITLE</a>
</dd>
<dt><kbd>DOCTITLE</kbd></dt>
<dd>
— means the argument you gave to <a href="docprocessing.html#DOCTITLE">DOCTITLE</a>
</dd>
<dt><kbd>COVERTITLE</kbd></dt>
<dd>
— means the argument you gave to <a href="docprocessing.html#COVERTITLE">COVERTITLE</a>
or
<a href="docprocessing.html#DOC_COVERTITLE">DOC_COVERTITLE</a>
</dd>
<dt><kbd>CHAPTER, CHAPTER_TITLE, CHAPTER+TITLE</kbd></dt>
<dd>
— see below (How the CHAPTER argument and friends work)
</dd>
</dl>
<a name="CHAPTER"><h5><u>How the CHAPTER argument and friends work</u></h5></a>
<p>
<kbd>CHAPTER</kbd>, by itself, will print the
<a href="docprocessing.html#CHAPTER_STRING">CHAPTER_STRING</a>
as well as the chapter number that you gave to
<a href="docprocessing.html#CHAPTER">CHAPTER</a>.
For example, assuming a vanilla setup for your chapter
<pre>
\# Reference macros
.CHAPTER 1
.CHAPTER_TITLE "The Bonny Blue Yonder"
<other stuff>
.COVER CHAPTER \" (or .DOC_COVER CHAPTER)
.START
</pre>
will simply print
<pre>
Chapter 1
</pre>
</p>
<p>
<kbd>CHAPTER_TITLE</kbd> will print the chapter title you
gave to
<a href="docprocessing.html#CHAPTER_TITLE">CHAPTER_TITLE</a>.
For example, assuming a vanilla setup for your chapter
<pre>
\# Reference macros
.CHAPTER 1
.CHAPTER_TITLE "The Bonny Blue Yonder"
<other stuff>
.COVER CHAPTER_TITLE \" (or .DOC_COVER CHAPTER_TITLE)
.START
</pre>
will simply print
<pre>
The Bonny Blue Yonder
</pre>
</p>
<p>
<kbd>CHAPTER+TITLE</kbd> will print <strong>both</strong> the
chapter string + number AND the chapter title. For example,
assuming a vanilla setup for your chapter
<pre>
\# Reference macros
.CHAPTER 1
.CHAPTER_TITLE "The Bonny Blue Yonder"
<other stuff>
.COVER CHAPTER+TITLE \" (or .DOC_COVER CHAPTER+TITLE)
.START
</pre>
will print
<pre>
Chapter 1
The Bonny Blue Yonder
</pre>
</p>
<a name="OPTIONAL"><h4><u>The optional arguments</u></h4></a>
<p>
The remainder of the arguments to <strong>COVER</strong> and
<strong>DOC_COVER</strong> are optional. They refer specifically to
the information you gave the
<a href="docprocessing.html#REFERENCE_MACROS">reference macros</a>
bearing the same name as the arguments.
</p>
<p>
You may enter as many or as few as you would like to see on your
cover (or doc cover) page. The only hitch is — PAY ATTENTION,
CLASS! — they must be entered in the order given above. For
example, if you want <kbd>TITLE</kbd>, <kbd>AUTHOR</kbd>,
<kbd>COPYRIGHT</kbd> and <kbd>MISC</kbd>
<pre>
.COVER TITLE AUTHOR COPYRIGHT MISC
</pre>
is correct, while
<pre>
.COVER TITLE AUTHOR MISC COPYRIGHT
</pre>
is not.
</p>
<a name="DOCTYPE"><h5><u>What the DOCTYPE argument means</u></h5></a>
<p>
When you pass <strong>COVER</strong> or <strong>DOC_COVER</strong>
the argument, <kbd>DOCTYPE</kbd>, it refers to the argument you gave
to
<a href="docprocessing.html#DOCTYPE">DOCTYPE</a> <kbd>NAMED</kbd>.
For example, if, in your
<a href="docprocessing.html#DOCSTYLE_MACROS">docstyle macros</a>
you gave a
<pre>
.DOCTYPE NAMED "Abstract"
</pre>
the argument, <kbd>DOCTYPE</kbd>, in the <strong>COVER</strong> or
<strong>DOC_COVER</strong> macros, would mean that you wanted the
word, Abstract, to appear on the cover (or doc cover), just as it
would in the
<a href="docprocessing.html#DOCHEADER">docheader</a>.
</p>
<a name="BLANKPAGE"><h5><u>What the BLANKPAGE argument means</u></h5></a>
<p>
If the final argument to <strong>DOC_COVER</strong> or
<strong>COVER</strong> is <kbd>BLANKPAGE</kbd>, <strong>mom</strong>
will insert a blank page after the doc cover or cover. This is
particularly useful if you intend to print your document two-sided,
since, in two-sided printing, no text should appear on the reverse
side of cover or title pages. If <strong>DOC_COVERS_COUNT_PAGES</strong>
and/or <strong>COVERS_COUNT_PAGES</strong> is enabled, the blank
page will be considered in the pagination scheme.
</p>
<!-- -ENABLING/DISABLING- -->
<hr width="33%" align="left"/>
<a name="ON_OFF"></a>
<p>
<nobr>Macro: <strong>COVERS</strong> <kbd><toggle></kbd></nobr>
<br/>
<nobr>Macro: <strong>DOC_COVERS</strong> <toggle></nobr>
</p>
<p>
By default, if you give <strong>mom</strong> a
<a href="#COVER">COVER</a>
or
<a href="#DOC_COVER">DOC_COVER</a>
macro, she will print it. In a document that contains sections,
articles or chapters formerly treated as "one-off's" but
now being
<a href="rectoverso.html#COLLATE_INTRO">collated</a>,
such behaviour may not be desirable.
</p>
<p>
<strong>Mom</strong> lets you selectively enable or disable the
generation of covers and/or doc covers with the toggle macros
<strong>COVERS</strong> and <strong>DOC_COVERS</strong>. Because
they're toggle macros, simply invoking them by themselves enables
automatic cover (or doc cover) generation, while invoking them with
any argument at all (<strong>OFF, QUIT, X</strong>, etc) disables
cover (or doc cover) generation.
</p>
<p>
<strong>NOTE:</strong> You must place these macros prior to any
instance of
<a href="docprocessing.html#START">START</a>.
Since they're "on" by default, there's no need to use
them if you want covers. However, if you don't, especially in the
kind of scenario described above, the best place to put them (most
likely with an <strong>OFF, NO, X</strong>, etc. argument), is
immediately after the first invocation of <strong>START</strong>.
By doing so, you ensure they precede all subsequent instances of
<strong>START</strong>.
</p>
<hr align="left" width="66%"/>
<a name="COVER_CONTROL"><h3><u>Control macros — changing the defaults for covers and document covers</u></h3></a>
<p>
The default typographic appearance of the items on a cover (or doc
cover) page is identical to that of the items in a
<a href="definitions.html#TERMS_DOCHEADER">docheader</a>.
(See
<a href="docprocessing.html#DOCHEADER_CONTROL">How to change the look of docheaders</a>
for a description of the defaults.)
</p>
<p>
<a href="docprocessing.html#COPYRIGHT">COPYRIGHT</a>
and
<a href="docprocessing.html#MISC">MISC</a>,
which do not appear in docheaders, have the following default
characteristics:
<ol>
<li>The copyright line is set in the bottom right hand corner
of the page, 2
<a href="definitions.html#TERMS_PS">point sizes</a>
smaller than the size of
<a href="definitions.html#TERMS_RUNNING">running text</a>
</li>
<li>The "misc" line is set in the bottom left hand
corner of the page, in the same family, font and point size
as the copyright line.
</li>
</ol>
</p>
<p>
With the exception of the copyright and "misc" lines, the
defaults for the entirety of cover (and doc cover) pages, and all
the elements thereon, can be changed with control macros whose
behaviour and arguments are identical to
<a href="docprocessing.html#DOCHEADER_CONTROL_INDEX">the control macros used for docheaders</a>.
The only difference is the name by which you invoke the control
macro(s).
</p>
<p>
The complete list of cover (and doc cover) page control macros
follows; please refer to the
<a href="docprocessing.html#DOCHEADER_CONTROL_INDEX">docheader control macros index</a>
in order to understand how to use them.
</p>
<a name="COVER_CONTROL_INDEX"><h4><u>Index of cover and doc cover control macros</u></h4></a>
<pre>
<a name="COVER_ADVANCE">.COVER_ADVANCE .DOC_COVER_ADVANCE</a> -+
<a name="COVER_FAMILY">.COVER_FAMILY .DOC_COVER_FAMILY</a> | like DOCHEADER_
<a name="COVER_LEAD">.COVER_LEAD .DOC_COVER_LEAD</a> -+
.COVER_TITLE_FAMILY .DOC_COVER_TITLE_FAMILY -+
.COVER_TITLE_FONT .DOC_COVER_TITLE_FONT | like
.COVER_TITLE_COLOR .DOC_COVER_TITLE_COLOR | TITLE_
.COVER_TITLE_SIZE .DOC_COVER_TITLE_SIZE -+
.COVER_CHAPTER_TITLE_FAMILY .DOC_COVER_CHAPTER_TITLE_FAMILY -+
.COVER_CHAPTER_TITLE_FONT .DOC_COVER_CHAPTER_TITLE_FONT | like
.COVER_CHAPTER_TITLE_COLOR .DOC_COVER_CHAPTER_TITLE_COLOR | CHAPTER_TITLE_
.COVER_CHAPTER_TITLE_SIZE .DOC_COVER_CHAPTER_TITLE_SIZE -+
.COVER_SUBTITLE_FAMILY .DOC_COVER_SUBTITLE_FAMILY -+
.COVER_SUBTITLE_FONT .DOC_COVER_SUBTITLE_FONT | like
.COVER_SUBTITLE_COLOR .DOC_COVER_SUBTITLE_COLOR | SUBTITLE_
.COVER_SUBTITLE_SIZE .DOC_COVER_AUTHOR_SIZE -+
.COVER_ATTRIBUTE_COLOR .DOC_COVER_ATTRIBUTE_COLOR - like ATTRIBUTE_COLOR
- the macro, .ATTRIBUTE_STRING, controls the attribution string
for both docheaders and cover pages; cover pages have no
separate ATTRIBUTE_STRING macro
.COVER_AUTHOR_FAMILY .DOC_COVER_AUTHOR_FAMILY -+
.COVER_AUTHOR_FONT .DOC_COVER_AUTHOR_FONT | like
.COVER_AUTHOR_COLOR .DOC_COVER_AUTHOR_COLOR | AUTHOR_
.COVER_AUTHOR_SIZE .DOC_COVER_AUTHOR_SIZE -+
.COVER_DOCTYPE_FAMILY .DOC_COVER_DOCTYPE_FAMILY -+
.COVER_DOCTYPE_FONT .DOC_COVER_DOCTYPE_FONT | like
.COVER_DOCTYPE_COLOR .DOC_COVER_DOCTYPE_COLOR | DOCTYPE_
.COVER_DOCTYPE_SIZE .DOC_COVER_DOCTYPE_SIZE -+
.COVER_COPYRIGHT_FAMILY .DOC_COVER_COPYRIGHT_FAMILY -+
.COVER_COPYRIGHT_FONT .DOC_COVER_COPYRIGHT_FONT | like any
.COVER_COPYRIGHT_COLOR .DOC_COVER_COPYRIGHT_COLOR | of the above
.COVER_COPYRIGHT_SIZE .DOC_COVER_COPYRIGHT_SIZE -+
.COVER_COPYRIGHT_QUAD .DOC_COVER_COPYRIGHT_QUAD
- the copyright quad can be either L (left) or R (right); default is left
.COVER_MISC_COLOR .DOC_COVER_MISC_COLOR - like any of the above _COLOR macros
.COVER_MISC_QUAD .DOC_COVER_MISC_QUAD
- the misc quad can be either L (left) or R (right); default is left
- see <a href="#MISC">Notes</a>
.COVER_UNDERLINE .DOC_COVER_UNDERLINE - like DOCTYPE_UNDERLINE
- see <a href="#UNDERLINE">Notes</a>
.COVERS_COUNT_PAGES .DOC_COVERS_COUNT_PAGES
- whether to consider cover pages in the pagination scheme; the
default is to ignore them
- see <a href="#COUNT">Notes</a>
</pre>
<h5><u>Notes</u></h5>
<a name="MISC"></a>
<p>
<strong>COVER_MISC</strong> and <strong>DOC_COVER_MISC</strong>
have only two control macros, <strong>_COLOR</strong> and
<strong>_QUAD</strong>. The family, font and size of
the <kbd>MISC</kbd> argument to <strong>COVER</strong>
or <strong>DOC_COVER</strong> are always the same as for
<kbd>COPYRIGHT</kbd>. Should you wish the family, font or size
to be different from <kbd>COPYRIGHT</kbd>, I suggest setting the
type specs for <kbd>COPYRIGHT</kbd> to the ones you want for
<kbd>MISC</kbd>, then altering them for <kbd>COPYRIGHT</kbd> using
<a href="inlines.html#INDEX_INLINES">inline escapes</a>
in the
<a href="definitions.html#TERMS_STRINGARGUMENT">string argument</a>
you pass to the macro,
<a href="docprocessing.html#COPYRIGHT">COPYRIGHT</a>.
(Of course, you could always do the reverse, but if you pass several
arguments to
<a href="docprocessing.html#MISC">MISC</a>,
it's more likely you want to get <strong>MISC</strong> right first.)
</p>
<a name="UNDERLINE"></a>
<p>
<strong>COVER_UNDERLINE</strong> and <strong>DOC_COVER_UNDERLINE</strong>
apply only to the doctype-name that appears on covers or doc
covers, and then only if <kbd>DOCTYPE</kbd> is given as one of the
arguments to
<a href="#COVER">COVER</a>
or
<a href="#DOC_COVER">DOC_COVER</a>. It is invoked in exactly the
same way as
<a href="docprocessing.html#DOCTYPE_UNDERLINE">DOCTYPE_UNDERLINE</a>.
</p>
<a name="COUNT"></a>
<p>
<strong>COVERS_COUNT_PAGES</strong> and
<strong>DOC_COVERS_COUNT_PAGES</strong> are toggle macros, hence
invoking them by themselves means that <strong>mom</strong> will
consider cover and doc cover pages in the pagination scheme;
invoking them with any argument (<strong>OFF, NO, X</strong>,
etc.) means they are ignored. The default is to ignore them.
</p>
<hr/>
<p>
<a href="refer.html#TOP">Next</a>
<a href="rectoverso.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:
-->
|
