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