3 \C{output} Halibut output formats
5 This chapter describes each of Halibut's current \i{output formats}.
6 It gives some general information about the format, and also
7 describes all the \i{configuration directives} which are specific to
10 \H{output-text} Plain text
12 This output format generates the document as a single \i{plain text}
13 file. No table of contents or index is generated.
15 The precise formatting of the text file can be controlled by a
16 variety of configuration directives. They are listed in the
17 following subsections.
19 \S{output-text-file} Output file name
21 \dt \I{\cw{\\cfg\{text-filename\}}}\cw{\\cfg\{text-filename\}\{}\e{filename}\cw{\}}
23 \dd Sets the \i{output file name} in which to store the text file.
24 This directive is implicitly generated if you provide a file name
25 parameter after the command-line option \i\c{--text} (see
28 \S{output-text-dimensions} Indentation and line width
30 This section describes the configuration directives which control
31 the \i{horizontal dimensions} of the output text file: how much
32 paragraphs are indented by and how long the lines are.
34 \dt \I{\cw{\\cfg\{text-width\}}}\cw{\\cfg\{text-width\}\{}\e{width}\cw{\}}
36 \dd Sets the \I{text width}width of the main part of the document,
37 in characters. This width will be used for wrapping paragraphs and
38 for centring titles (if you have asked for titles to be centred -
39 see \k{output-text-headings}). This width does \e{not} include the
40 left indentation set by \cw{\\cfg\{text-indent\}}; if you specify an
41 indent of 8 and a width of 64, your maximum output line length will
44 \dt \I{\cw{\\cfg\{text-indent\}}}\cw{\\cfg\{text-indent\}\{}\e{indent}\cw{\}}
46 \dd Sets the left \i{indentation} for the document. If you set this
47 to zero, your document will look like an ordinary text file as
48 someone with a text editor might have written it; if you set it
49 above zero, the text file will have a \i{margin} down the left in
50 the style of some printed manuals, and you can then configure the
51 section numbers to appear in this margin (see
52 \k{output-text-headings}).
54 \dt \I{\cw{\\cfg\{text-indent-code\}}}\cw{\\cfg\{text-indent-code\}\{}\e{indent}\cw{\}}
56 \dd Specifies how many extra characters of indentation (on top of
57 the normal left indent) should be given to \I{code paragraphs,
58 indentation} code paragraphs.
60 \dt \I{\cw{\\cfg\{text-list-indent\}}}\cw{\\cfg\{text-list-indent\}\{}\e{indent}\cw{\}}
62 \dd Specifies how many extra spaces should be used to indent the
63 bullet or number in a \I{bulletted list, indentation}bulletted or
64 \I{numbered list, indentation}numbered \I{list, indentation}list.
65 The actual body of the list item will be indented by this much
66 \e{plus} the value configured by \cw{\\cfg\{text-listitem-indent\}}.
68 \dt \I{\cw{\\cfg\{text-listitem-indent\}}}\cw{\\cfg\{text-listitem-indent\}\{}\e{indent}\cw{\}}
70 \dd Specifies how many extra spaces should be used to indent the
71 body of a list item, over and above the number configured in
72 \cw{\\cfg\{text-list-indent\}}.
74 \dt \I{\cw{\\cfg\{text-indent-preamble\}}}\cw{\\cfg\{text-indent-preamble\}\{}\e{boolean}\cw{\}}
76 \dd When this is set to \c{true}, the document \i{preamble} (i.e. any
77 paragraphs appearing before the first chapter heading) will be
78 indented to the level specified by \cw{\\cfg\{text-indent\}}. If
79 this setting is \c{false}, the document preamble will not be
80 indented at all from the left margin.
82 \S{output-text-headings} \ii{Configuring heading display}
84 The directives in this section allow you to configure the appearance
85 of the title, chapter and section headings in your text file.
87 Several of the directives listed below specify the \i{alignment} of
88 a heading. These alignment options have three possible values:
92 \dd Align the heading to the very left of the text file (column zero).
96 \dd Align the section title to the left of the main display region
97 (in other words, indented to the level specified by
98 \cw{\\cfg\{text-indent\}}). The section \e{number} is placed to the
99 left of that (so that it goes in the margin if there is room).
103 \dd Centre the heading.
105 Also, several of the directives below specify how a title should be
106 \I{underlining}underlined. The parameter to one of these directives
107 should be either blank (\cw{\{\}}) or a piece of text which will be
108 repeated to produce the underline. So you might want to specify, for
109 example, \cw{\\text-title-underline\{=\}} but
110 \cw{\\text-chapter-underline\{\-\}}.
112 You can also specify more than one underline setting, and Halibut
113 will choose the first one that the output character set supports.
114 So, for example, you could write
115 \cw{\\text-chapter-underline\{\\u203e\}\{\-\}}, and Halibut would use
116 the Unicode \q{OVERLINE} character where possible and fall back to
117 the ASCII minus sign otherwise.
119 \dt \I{\cw{\\cfg\{text-title-align\}}}\cw{\\cfg\{text-title-align\}\{}\e{alignment}\cw{\}}
121 \dd Specifies the alignment of the overall document title: \c{left},
122 \c{leftplus} or \c{centre}.
124 \dt \I{\cw{\\cfg\{text-title-underline\}}}\cw{\\cfg\{text-title-underline\}\{}\e{underline-text}\cw{\}}
126 \dd Specifies how the overall document title should be underlined.
128 \dt \I{\cw{\\cfg\{text-chapter-align\}}}\cw{\\cfg\{text-chapter-align\}\{}\e{alignment}\cw{\}}
130 \dd Specifies the alignment of chapter and appendix headings.
132 \dt \I{\cw{\\cfg\{text-chapter-underline\}}}\cw{\\cfg\{text-chapter-underline\}\{}\e{underline-text}\cw{\}}
134 \dd Specifies how chapter and appendix headings should be underlined.
136 \dt \I{\cw{\\cfg\{text-chapter-numeric\}}}\cw{\\cfg\{text-chapter-numeric\}\{}\e{boolean}\cw{\}}
138 \dd If this is set to \c{true}, then chapter headings will not
139 contain the word \q{Chapter} (or whatever other word you have
140 defined in its place - see \k{input-sections} and \k{input-config});
141 they will just contain the chapter \e{number}, followed by the
142 chapter title. If you set this to \c{false}, chapter headings will
143 be prefixed by \q{Chapter} or equivalent.
145 \dt \I{\cw{\\cfg\{text-chapter-suffix\}}}\cw{\\cfg\{text-chapter-suffix\}\{}\e{text}\cw{\}}
147 \dd This specifies the suffix text to be appended to the chapter
148 number, before displaying the chapter title. For example, if you set
149 this to \cq{:\_}, then the chapter title might look something
150 like \q{Chapter 2: Doing Things}.
152 \dt \I{\cw{\\cfg\{text-section-align\}}}\cw{\\cfg\{text-section-align\}\{}\e{level}\cw{\}\{}\e{alignment}\cw{\}}
154 \dd Specifies the alignment of section headings at a particular
155 level. The \e{level} parameter specifies which level of section
156 headings you want to affect: 0 means first-level headings (\c{\\H}),
157 1 means second-level headings (\c{\\S}), 2 means the level below
158 that (\c{\\S2}), and so on. The \e{alignment} parameter is treated
159 just like the other alignment directives listed above.
161 \dt \I{\cw{\\cfg\{text-section-underline\}}}\cw{\\cfg\{text-section-underline\}\{}\e{level}\cw{\}\{}\e{underline-text}\cw{\}}
163 \dd Specifies how to underline section headings at a particular level.
165 \dt \I{\cw{\\cfg\{text-section-numeric\}}}\cw{\\cfg\{text-section-numeric\}\{}\e{level}\cw{\}\{}\e{boolean}\cw{\}}
167 \dd Specifies whether section headings at a particular level should
168 contain the word \q{Section} or equivalent (if \c{false}), or should
169 be numeric only (if \c{true}).
171 \dt \I{\cw{\\cfg\{text-section-suffix\}}}\cw{\\cfg\{text-section-suffix\}\{}\e{level}\cw{\}\{}\e{text}\cw{\}}
173 \dd Specifies the \I{suffix text, in section titles}suffix text to
174 be appended to section numbers at a particular level, before
175 displaying the section title.
177 \S{output-text-characters} Configuring the characters used
179 \dt \I\cw{\\cfg\{text-charset\}}\cw{\\cfg\{text-charset\}\{}\e{character set name}\cw{\}}
181 \dd This tells Halibut what \i{character set} the output should be
182 in. Any Unicode characters representable in this set will be output
183 verbatim; any other characters will not be output and their
184 \i{fallback text} (if any) will be used instead.
188 The character set names are the same as for
189 \cw{\\cfg\{input-charset\}} (see \k{input-config}). However, unlike
190 \cw{\\cfg\{input-charset\}}, this directive affects the \e{entire}
191 output; it's not possible to switch encodings halfway through.
195 \dt \I{\cw{\\cfg\{text-bullet\}}}\cw{\\cfg\{text-bullet\}\{}\e{text}\cw{\}}[\cw{\{}\e{text}...\cw{\}}]
197 \dd This specifies the text which should be used as the \i{bullet}
198 in bulletted lists. It can be one character
199 (\cw{\\cfg\{text-bullet\}\{-\}}), or more than one
200 (\cw{\\cfg\{text-bullet\}\{(*)\}}).
204 Like \cw{\\cfg\{quotes\}} (see \k{input-config}), you can specify multiple
205 possible options after this command, and Halibut will choose the first one
206 which the output character set supports. For example, you might write
207 \cw{\\cfg\{text-bullet\}\{\\u2022\}\{\\u00b7\}\{*\}}, in which case
208 Halibut would use the Unicode \q{BULLET} character where possible,
209 fall back to the ISO-8859-1 \q{MIDDLE DOT} if that wasn't available,
210 and resort to the ASCII asterisk if all else failed.
214 \dt \I{\cw{\\cfg\{text-rule\}}}\cw{\\cfg\{text-rule\}\{}\e{text}\cw{\}}[\cw{\{}\e{text}...\cw{\}}]
216 \dd This specifies the text which should be used for drawing
217 \i{horizontal rules} (generated by \i\c{\\rule}; see
218 \k{input-rule}). It can be one character, or more than one. The
219 string you specify will be repeated to reach the required width, so
220 you can specify something like \cq{-=} to get a rule that looks
225 Like \cw{\\cfg\{text-bullet\}}, you can specify multiple fallback
226 options in this command.
230 \dt \I{\cw{\\cfg\{text-quotes\}}}\cw{\\cfg\{text-quotes\}\{}\e{open-quote}\cw{\}\{}\e{close-quote}\cw{\}}[\cw{\{}\e{open-quote}\cw{\}\{}\e{close-quote}...\cw{\}}]
232 \dd This specifies a set of quote characters for the text backend,
233 overriding any defined by \cw{\\cfg\{quotes\}}. It has the same syntax
234 (see \k{input-config}).
238 In this backend, these quotes will also be used to mark text enclosed
239 in the \c{\\c} command (see \k{input-code}).
243 \dt \I{\cw{\\cfg\{text-emphasis\}}}\cw{\\cfg\{text-emphasis\}\{}\e{start-emph}\cw{\}\{}\e{end-emph}\cw{\}}[\cw{\{}\e{start-emph}\cw{\}\{}\e{end-emph}...\cw{\}}]
245 \dd This specifies the characters which should be used to surround
246 emphasised text (written using the \c{\\e} command; see
251 You should separately specify the start-emphasis and end-emphasis
252 text, each of which can be more than one character if you want.
253 Also, like \cw{\\cfg\{text-quotes\}}, you can specify multiple pairs
254 of fallback options in this command, and Halibut will always use a
259 \S{output-text-misc} Miscellaneous configuration options
261 \dt \I{\cw{\\cfg\{text-list-suffix\}}}\cw{\\cfg\{text-list-suffix\}\{}\e{text}\cw{\}}
263 \dd This text is appended to the number on a \i{numbered list} item
264 (see \k{input-list-number}). So if you want to label your lists as
265 \q{1)}, \q{2)} and so on, then you would write
266 \cw{\\cfg\{text-list-suffix\}\{)\}}.
268 \dt \I{\cw{\\cfg\{text-versionid\}}}\cw{\\cfg\{text-versionid\}\{}\e{boolean}\cw{\}}
270 \dd If this is set to \c{true}, \i{version ID paragraphs} (defined
271 using the \i\c{\\versionid} command - see \k{input-blurb}) will be
272 included at the bottom of the text file. If it is set to \c{false},
273 they will be omitted completely.
275 \# FIXME: code indentation is configurable, therefore \quote
276 \# indentation probably ought to be as well.
278 \# FIXME: text-indent-* should be consistently named.
280 \S{output-text-defaults} Default settings
282 The \i{default settings} for Halibut's plain text output format are:
284 \c \cfg{text-filename}{output.txt}
286 \c \cfg{text-width}{68}
287 \c \cfg{text-indent}{7}
288 \c \cfg{text-indent-code}{2}
289 \c \cfg{text-list-indent}{1}
290 \c \cfg{text-listitem-indent}{3}
291 \c \cfg{text-indent-preamble}{false}
293 \c \cfg{text-title-align}{centre}
294 \c \cfg{text-title-underline}{\u2550}{=}
296 \c \cfg{text-chapter-align}{left}
297 \c \cfg{text-chapter-underline}{\u203e}{-}
298 \c \cfg{text-chapter-numeric}{false}
299 \c \cfg{text-chapter-suffix}{: }
301 \c \cfg{text-section-align}{0}{leftplus}
302 \c \cfg{text-section-underline}{0}{}
303 \c \cfg{text-section-numeric}{0}{true}
304 \c \cfg{text-section-suffix}{0}{ }
306 \c \cfg{text-section-align}{1}{leftplus}
307 \c \cfg{text-section-underline}{1}{}
308 \c \cfg{text-section-numeric}{1}{true}
309 \c \cfg{text-section-suffix}{1}{ }
311 \c ... and so on for all section levels below this ...
312 \e iiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiii
314 \c \cfg{text-charset}{ASCII}
315 \c \cfg{text-bullet}{\u2022}{-}
316 \c \cfg{text-rule}{\u2500}{-}
317 \c \cfg{text-quotes}{\u2018}{\u2019}{`}{'}
318 \c \cfg{text-emphasis}{_}{_}
320 \c \cfg{text-list-suffix}{.}
321 \c \cfg{text-versionid}{true}
325 This output format generates an \i{HTML} version of the document. By
326 default, this will be in multiple files, starting with
327 \c{Contents.html} and splitting the document into files by chapter
328 and/or subsection. You can configure precisely how the text is split
329 between HTML files using the configuration commands described in
330 this section. In particular, you can configure Halibut to output one
331 single HTML file instead of multiple ones.
333 \I{\cw{\\cfg\{xhtml-anything\}}}Configuration directives with an
334 \c{xhtml-} prefix are synonyms for those with an \c{html-} prefix.
336 \S{output-html-file} Controlling the output file names
338 \dt \I{\cw{\\cfg\{html-contents-filename\}}}\cw{\\cfg\{html-contents-filename\}\{}\e{filename}\cw{\}}
340 \dd Sets the \i{output file name} in which to store the top-level
341 contents page. Since this is the first page a user ought to see when
342 beginning to read the document, a good choice in many cases might be
343 \c{index.html} (although this is not the default, for historical
346 \dt \I{\cw{\\cfg\{html-index-filename\}}}\cw{\\cfg\{html-index-filename\}\{}\e{filename}\cw{\}}
348 \dd Sets the file name in which to store the document's index.
350 \dt \I{\cw{\\cfg\{html-template-filename\}}}\cw{\\cfg\{html-template-filename\}\{}\e{template}\cw{\}}
352 \dd Provides a \i{template} to be used when constructing the file
353 names of each chapter or section of the document. This template
354 should contain at least one \i\e{formatting command}, in the form of
355 a per cent sign followed by a letter. (If you need a literal per
356 cent sign, you can write \c{%%}.)
360 The formatting commands used in this template are:
362 \dt \I{%N-upper}\c{%N}
364 \dd Expands to the visible title of the section, with white space
365 removed. So in a chapter declared as \cq{\\C\{fish\} Catching
366 Fish}, this formatting command would expand to
371 \dd Expands to the type and number of the section, without white
372 space. So in chapter 1 this would expand to \cq{Chapter1}; in
373 section A.4.3 it would expand to \cq{SectionA.4.3}, and so on.
374 If the section has no number (an unnumbered chapter created using
375 \c{\\U}), this directive falls back to doing the same thing as
380 \dd Expands to the number of the section, in a format suitable for an
381 HTML fragment name. The first character of the section type is
382 prepended to the section number. So in chapter 1 this would expand to
383 \cq{C1}; in section A.4.3 it would expand to \cq{SA.4.3}, and so on.
384 If the section has no number (an unnumbered chapter created using
385 \c{\\U}), this directive falls back to doing the same thing as \c{%N}.
389 \dd Expands to the internal keyword specified in the section title.
390 So in a chapter declared as \cq{\\C\{fish\} Catching Fish}, this
391 formatting command would expand to \cq{fish}. If the section has
392 no keyword (an unnumbered chapter created using \c{\\U}), this
393 directive falls back to doing the same thing as \c{%N}.
395 These formatting directives can also be used in the
396 \cw{\\cfg\{html-template-fragment\}} configuration directive (see
397 \k{output-html-misc}).
401 \dt \I{\cw{\\cfg\{html-single-filename\}}}\cw{\\cfg\{html-single-filename\}\{}\e{filename}\cw{\}}
403 \dd Sets the file name in which to store the entire document, if
404 Halibut is configured (using \c{\\cfg\{html-leaf-level\}\{0\}} to
405 produce a single self-contained file. Both this directive \e{and}
406 \c{\\cfg\{html-leaf-level\}\{0\}} are implicitly generated if you
407 provide a file name parameter after the command-line option
408 \i\c{--html} (see \k{running-options}).
410 \S{output-html-split} Controlling the splitting into HTML files
412 By default, the HTML output from Halibut is split into multiple
413 files. Each file typically contains a single chapter or section and
414 everything below it, unless subsections of that chapter are
415 themselves split off into further files.
417 Most files also contain a contents section, giving hyperlinks to the
418 sections in the file and/or the sections below it.
420 The configuration directives listed below allow you to configure the
421 splitting into files, and the details of the contents sections.
423 \dt \I{\cw{\\cfg\{html-leaf-level\}}}\cw{\\cfg\{html-leaf-level\}\{}\e{depth}\cw{\}}
425 \dd This setting indicates the depth of section which should be
426 given a \I{leaf file}\q{leaf} file (a file with no sub-files). So if
427 you set it to 1, for example, then every chapter will be given its
428 own HTML file, plus a top-level \i{contents file}. If you set this
429 to 2, then each chapter \e{and} each \c{\\H} section will have a
430 file, and the chapter files will mostly just contain links to their
435 If you set this option to zero, then the whole document will appear
436 in a single file. If you do this, Halibut will call that file
437 \i\c{Manual.html} instead of \i\c{Contents.html} by default.
439 This option is automatically set to zero if you provide a file name
440 parameter after the command-line option \i\c{--html} (see
441 \k{running-options}), because you have specified a single file name
442 and so Halibut assumes you want the whole document to be placed in
447 \dt \I{\cw{\\cfg\{html-contents-depth\}}}\cw{\\cfg\{html-contents-depth\}\{}\e{level}\cw{\}\{}\e{depth}\cw{\}}
449 \dd This directive allows you to specify how \I{depth of
450 contents}deep any contents section in a particular level of file
455 The \e{level} parameter indicates which level of contents section
456 you are dealing with. 0 denotes the main contents section in the
457 topmost file \c{Contents.html}; 1 denotes a contents section in a
458 chapter file; 2 is a contents section in a file containing a \c{\\H}
461 The \e{depth} parameter indicates the maximum depth of heading which
462 will be shown in this contents section. Again, 1 denotes a chapter,
463 2 is a \c{\\H} heading, 3 is a \c{\\S} heading, and so on.
465 So, for example: \cw{\\cfg\{html-contents-depth\}\{1\}\{3\}} instructs
466 Halibut to put contents links in chapter files for all sections down
467 to \c{\\S} level, but not to go into any more detail than that.
469 For backwards compatibility, the alternative syntax
470 \cw{\\cfg\{html-contents-depth-}\e{level}\cw{\}\{}\e{depth}\cw{\}}
475 \dt \I{\cw{\\cfg\{html-leaf-contains-contents\}}}\cw{\\cfg\{html-leaf-contains-contents\}\{}\e{boolean}\cw{\}}
477 \dd If you set this to \c{true}, then each leaf file will contain
478 its own contents section which summarises the text within it.
480 \dt \I{\cw{\\cfg\{html-leaf-smallest-contents\}}}\cw{\\cfg\{html-leaf-smallest-contents\}\{}\e{number}\cw{\}}
482 \dd Contents sections in leaf files are not output at all if they
483 contain very few entries (on the assumption that it just isn't worth
484 bothering). This directive configures the minimum number of entries
485 required in a leaf contents section to make Halibut bother
486 generating it at all.
488 \S{output-html-html} Including pieces of your own HTML
490 The directives in this section allow you to supply pieces of
491 \I{HTML}\i{verbatim HTML} code, which will be included in various
492 parts of the output files.
494 Note that none of Halibut's usual character set translation is applied
495 to this code; it is assumed to already be in a suitable encoding for
496 the target HTML files.
498 \dt \I{\cw{\\cfg\{html-head-end\}}}\cw{\\cfg\{html-head-end\}\{}\e{HTML text}\cw{\}}
500 \dd The text you provide in this directive is placed at the end of
501 the \i\cw{<HEAD>} section of each output HTML file. So this is a
502 good place to put, for example, a link to a \i{CSS} \i{stylesheet}.
504 \dt \I{\cw{\\cfg\{html-local-head\}}}\cw{\\cfg\{html-local-head\}\{}\e{HTML text}\cw{\}}
506 \dd This configuration directive is local: you specify it within a
507 document section, and it acts on that section only.
511 The text you provide in this directive is placed at the end of the
512 \i\cw{<HEAD>} section of whichever output HTML file contains the
513 section in which the directive was placed. You can specify this
514 directive multiple times in multiple sections if you like.
516 This directive is particularly useful for constructing \i{MacOS
517 on-line help}, which is mostly normal HTML but which requires a
518 special \i\cw{<META NAME="AppleTitle">} tag in the topmost source
519 file. You can arrange this by placing this configuration directive
520 in the preamble or the introduction section, something like this:
522 \c \cfg{html-local-head}{<meta name="AppleTitle"
523 \c content="MyApp Help">}
527 \dt \I{\cw{\\cfg\{html-body-tag\}}}\cw{\\cfg\{html-body-tag\}\{}\e{HTML text}\cw{\}}
529 \dd The text you provide in this directive is used in place of the
530 \i\cw{<BODY>} tag in each output file. So if you wanted to define a
531 \i{background colour}, for example, you could write
532 \cw{\\cfg\{html-body-tag\}\{<body bg="#123456">\}}.
534 \dt \I{\cw{\\cfg\{html-body-start\}}}\cw{\\cfg\{html-body-start\}\{}\e{HTML text}\cw{\}}
536 \dd The text you provide in this directive is placed at the
537 beginning of the \i\cw{<BODY>} section of each output HTML file. So
538 if you intend your HTML files to be part of a web site with a
539 standard \i{house style}, and the style needs a \i{header} at the
540 top of every page, this is where you can add that header.
542 \dt \I{\cw{\\cfg\{html-body-end\}}}\cw{\\cfg\{html-body-end\}\{}\e{HTML text}\cw{\}}
544 \dd The text you provide in this directive is placed at the end of
545 the \i\cw{<BODY>} section of each output HTML file, before any address
546 section. So if you intend your HTML files to be part of a web site
547 with a standard \i{house style}, and the style needs a \i{footer} at
548 the bottom of every page, this is where you can add that footer.
550 \dt \I{\cw{\\cfg\{html-address-start\}}}\cw{\\cfg\{html-address-start\}\{}\e{HTML text}\cw{\}}
552 \dd The text you provide in this directive is placed at the
553 beginning of the \i\cw{<ADDRESS>} section at the bottom of each
554 output HTML file. This might be a good place to put authors'
555 \i{contact details}, for example.
557 \dt \I{\cw{\\cfg\{html-address-end\}}}\cw{\\cfg\{html-address-end\}\{}\e{HTML text}\cw{\}}
559 \dd The text you provide in this directive is placed at the end of
560 the \i\cw{<ADDRESS>} section at the bottom of each output HTML file,
561 after the version IDs (if present).
563 \dt \I{\cw{\\cfg\{html-navigation-attributes\}}}\cw{\\cfg\{html-navigation-attributes\}\{}\e{HTML attributes}\cw{\}}
565 \dd The text you provide in this directive is included inside the
566 \cw{<P>} tag containing the \i{navigation links} at the top of each
567 page (\i{\q{Previous}} / \i{\q{Contents}} / \i{\q{Next}}). So if you
568 wanted the navigation links to have a particular CSS style, you
570 \cw{\\cfg\{html-navigation-attributes\}\{class="foo"\}}, and the
571 navigation-links paragraph would then begin with the tag \cw{<p
574 \S{output-html-headings} \ii{Configuring heading display}
576 \dt \I{\cw{\\cfg\{html-chapter-numeric\}}}\cw{\\cfg\{html-chapter-numeric\}\{}\e{boolean}\cw{\}}
578 \dd If this is set to \c{true}, then chapter headings will not
579 contain the word \q{Chapter} (or whatever other word you have
580 defined in its place - see \k{input-sections} and \k{input-config});
581 they will just contain the chapter \e{number}, followed by the
582 chapter title. If you set this to \c{false}, chapter headings will
583 be prefixed by \q{Chapter} or equivalent.
585 \dt \I{\cw{\\cfg\{html-chapter-suffix\}}}\cw{\\cfg\{html-chapter-suffix\}\{}\e{text}\cw{\}}
587 \dd This specifies the suffix text to be appended to the chapter
588 number, before displaying the chapter title. For example, if you set
589 this to \cq{:\_}, then the chapter title might look something
590 like \q{Chapter 2: Doing Things}.
592 \dt \I{\cw{\\cfg\{html-section-numeric\}}}\cw{\\cfg\{html-section-numeric\}\{}\e{level}\cw{\}\{}\e{boolean}\cw{\}}
594 \# {level} can be omitted (defaults to 0). Is this intentional?
596 \dd Specifies whether section headings at a particular level should
597 contain the word \q{Section} or equivalent (if \c{false}), or should
598 be numeric only (if \c{true}). The \e{level} parameter specifies
599 which level of section headings you want to affect: 0 means
600 first-level headings (\c{\\H}), 1 means second-level headings
601 (\c{\\S}), 2 means the level below that (\c{\\S2}), and so on.
603 \dt \I{\cw{\\cfg\{html-section-suffix\}}}\cw{\\cfg\{html-section-suffix\}\{}\e{level}\cw{\}\{}\e{text}\cw{\}}
605 \# {level} can be omitted (defaults to 0). Is this intentional?
607 \dd Specifies the suffix text to be appended to section numbers at a
608 particular level, before displaying the section title.
610 \S{output-html-names} Configuring standard text
612 These directives let you fine-tune the names Halibut uses in places
613 such as the navigation bar to refer to various parts of the document,
614 and other standard pieces of text, for instance to change them to a
617 \dt \I{\cw{\\cfg\{html-preamble-text\}}}\cw{\\cfg\{html-preamble-text\}\{}\e{text}\cw{\}}
619 \dt \I{\cw{\\cfg\{html-contents-text\}}}\cw{\\cfg\{html-contents-text\}\{}\e{text}\cw{\}}
621 \dt \I{\cw{\\cfg\{html-index-text\}}}\cw{\\cfg\{html-index-text\}\{}\e{text}\cw{\}}
623 \dd Text used to refer to the preamble (i.e., any paragraphs before
624 the first chapter heading), contents, and index respectively, in the
625 navigation bar, contents, and index.
629 (\c{html-contents-text} and \c{html-index-text} override the
630 cross-format configuration keywords \c{contents} and \c{index} (see
631 \k{input-config}, if both appear. They are legacy keywords preserved
632 for backwards compatibility; you should generally use \c{contents}
637 \dt \I{\cw{\\cfg\{html-title-separator\}}}\cw{\\cfg\{html-title-separator\}\{}\e{text}\cw{\}}
639 \dd If multiple headings are used in a file's \cw{<TITLE>} tag, this
640 text is used to separate them.
642 \# Under what circumstances can this occur?
644 \dt \I{\cw{\\cfg\{html-index-main-separator\}}}\cw{\\cfg\{html-index-main-separator\}\{}\e{text}\cw{\}}
646 \dd Separator between index term and references in the index.
648 \dt \I{\cw{\\cfg\{html-index-multiple-separator\}}}\cw{\\cfg\{html-index-multiple-separator\}\{}\e{text}\cw{\}}
650 \dd Separator between multiple references for a single index term in
653 \dt \I{\cw{\\cfg\{html-pre-versionid\}}}\cw{\\cfg\{html-pre-versionid\}\{}\e{text}\cw{\}}
655 \dt \I{\cw{\\cfg\{html-post-versionid\}}}\cw{\\cfg\{html-post-versionid\}\{}\e{text}\cw{\}}
657 \dd Text surrounding each output \i{version ID paragraph}.
659 \dt \I{\cw{\\cfg\{html-nav-prev-text\}}}\cw{\\cfg\{html-nav-prev-text\}\{}\e{text}\cw{\}}
661 \dt \I{\cw{\\cfg\{html-nav-next-text\}}}\cw{\\cfg\{html-nav-next-text\}\{}\e{text}\cw{\}}
663 \dd The text used for the \q{previous page} and \q{next page} links on
666 \dt \I{\cw{\\cfg\{html-nav-separator\}}}\cw{\\cfg\{html-nav-separator\}\{}\e{text}\cw{\}}
668 \dd Separator between links in the navigation bar.
670 \S{output-html-characters} Configuring the characters used
672 Unlike the other backends, HTML does not have a single
673 \i\cw{\\cfg\{html-charset\}} directive, as there are several levels of
674 character encoding to consider.
676 The character set names are the same as for
677 \cw{\\cfg\{input-charset\}} (see \k{input-config}). However, unlike
678 \cw{\\cfg\{input-charset\}}, these directives affect the \e{entire}
679 output; it's not possible to switch encodings halfway through.
681 \dt \I\cw{\\cfg\{html-output-charset\}}\cw{\\cfg\{html-output-charset\}\{}\e{character set name}\cw{\}}
683 \dd The character encoding of the HTML file to be output. Unicode
684 characters in this encoding's repertoire are included literally rather
685 than as \i{HTML entities}.
687 \dt \I\cw{\\cfg\{html-restrict-charset\}}\cw{\\cfg\{html-restrict-charset\}\{}\e{character set name}\cw{\}}
689 \dd Only Unicode characters representable in this character set will be
690 output; any others will be omitted and use their fallback text, if
691 any. Characters not in \q{html-output-charset} will be represented as
692 HTML numeric entities.
694 \dt \I{\cw{\\cfg\{html-quotes\}}}\cw{\\cfg\{html-quotes\}\{}\e{open-quote}\cw{\}\{}\e{close-quote}\cw{\}}[\cw{\{}\e{open-quote}\cw{\}\{}\e{close-quote}...\cw{\}}]
696 \dd Specifies the quotation marks to use, overriding any
697 \cw{\\cfg\{quotes\}} directive. You can specify multiple
698 fallback options. Works exactly like the \cw{\\cfg\{text-quotes\}}
699 directive (see \k{output-text-characters}).
701 \S{output-html-misc} Miscellaneous options
703 \dt \I\cw{\\cfg\{html-version\}}\cw{\\cfg\{html-version\}\{}\e{version}\cw{\}}
705 \dd Identifies the precise version of HTML that is output. This
706 affects the declaration within the HTML, and also has minor effects on
707 the body of the HTML so that it is valid for the declared version. The
708 available variants are:
718 \dd W3C HTML 4.01 Strict
722 \dd ISO/IEC 15445:2000
724 \dt \cw{xhtml1.0transitional}
726 \dd W3C XHTML 1.0 Transitional
728 \dt \cw{xhtml1.0strict}
730 \dd W3C XHTML 1.0 Strict
734 \dt \I{\cw{\\cfg\{html-template-fragment\}}}\cw{\\cfg\{html-template-fragment\}\{}\e{template}\cw{\}}[\cw{\{}\e{template}\cw{\}\{}...\cw{\}}]
736 \dd This directive lets you specify a \i{template}, with exactly the
737 same syntax used in \cw{\\cfg\{html-template-filename\}} (see
738 \k{output-html-file}), to be used for the anchor names (\i\cw{<a
739 name="...">}) used to allow URLs to refer to specific sections
740 within a particular HTML file. So if you set this to \cq{%k},
741 for example, then each individual section in your document will be
742 addressable by means of a URL ending in a \c{#} followed by your
743 internal section keyword.
747 If more than one template is specified, anchors are generated in all
748 the specified formats; Halibut's own cross-references are generated
749 with the first template.
751 Characters that are not permitted in anchor names are stripped. If
752 there are no valid characters left, or a fragment is non-unique,
753 Halibut starts inventing fragment names and suffixes as appropriate.
755 Note that there are potentially fragment names that are not controlled
756 by this mechanism, such as index references.
760 \dt \I{\cw{\\cfg\{html-versionid\}}}\cw{\\cfg\{html-versionid\}\{}\e{boolean}\cw{\}}
762 \dd If this is set to \c{true}, \i{version ID paragraphs} (defined using
763 the \i\c{\\versionid} command - see \k{input-blurb}) will be included
764 visibly in the \i\cw{<ADDRESS>} section at the bottom of each HTML
765 file. If it is set to \c{false}, they will only be included as HTML
768 \dt \I{\cw{\\cfg\{html-suppress-address\}}}\cw{\\cfg\{html-suppress-address\}\{}\e{boolean}\cw{\}}
770 \dd If this is set to \c{true}, the \i\cw{<ADDRESS>} section at the
771 bottom of each HTML file will be omitted completely. (This will
772 therefore also cause \i{version IDs} not to be included visibly.)
774 \dt \I{\cw{\\cfg\{html-author\}}}\cw{\\cfg\{html-author\}\{}\e{text}\cw{\}}
776 \dd The text supplied here goes in a \I{\cw{<META>} tags}\cw{<META
777 name="author">} tag in the output HTML files, so that browsers which
778 support this can automatically identify the \i{author} of the document.
780 \dt \I{\cw{\\cfg\{html-description\}}}\cw{\\cfg\{html-description\}\{}\e{text}\cw{\}}
782 \dd The text supplied here goes in a \I{\cw{<META>} tags}\cw{<META
783 name="description">} tag in the output HTML files, so that browsers
784 which support this can easily pick out a brief \I{description, of
785 document}description of the document.
787 \S{output-html-defaults} Default settings
789 The \i{default settings} for Halibut's HTML output format are:
791 \c \cfg{html-contents-filename}{Contents.html}
792 \c \cfg{html-index-filename}{IndexPage.html}
793 \c \cfg{html-template-filename}{%n.html}
794 \c \cfg{html-single-filename}{Manual.html}
796 \c \cfg{html-leaf-level}{2}
797 \c \cfg{html-leaf-contains-contents}{false}
798 \c \cfg{html-leaf-smallest-contents}{4}
799 \c \cfg{html-contents-depth}{0}{2}
800 \c \cfg{html-contents-depth}{1}{3}
801 \c ... and so on for all section levels below this ...
802 \e iiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiii
804 \c \cfg{html-head-end}{}
805 \c \cfg{html-body-tag}{<body>}
806 \c \cfg{html-body-start}{}
807 \c \cfg{html-body-end}{}
808 \c \cfg{html-address-start}{}
809 \c \cfg{html-address-end}{}
810 \c \cfg{html-navigation-attributes}{}
812 \c \cfg{html-chapter-numeric}{false}
813 \c \cfg{html-chapter-suffix}{: }
815 \c \cfg{html-section-numeric}{0}{true}
816 \c \cfg{html-section-suffix}{0}{ }
818 \c \cfg{html-section-numeric}{1}{true}
819 \c \cfg{html-section-suffix}{1}{ }
821 \c ... and so on for all section levels below this ...
822 \e iiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiii
824 \c \cfg{html-preamble-text}{Preamble}
825 \c \cfg{html-contents-text}{Contents}
826 \c \cfg{html-index-text}{Index}
827 \c \cfg{html-title-separator}{ - }
828 \c \cfg{html-index-main-separator}{: }
829 \c \cfg{html-index-multiple-separator}{, }
830 \c \cfg{html-pre-versionid}{[}
831 \c \cfg{html-post-versionid}{]}
832 \c \cfg{html-nav-prev-text}{Previous}
833 \c \cfg{html-nav-next-text}{Next}
834 \c \cfg{html-nav-separator}{ | }
836 \c \cfg{html-output-charset}{ASCII}
837 \c \cfg{html-restrict-charset}{UTF-8}
838 \c \cfg{html-quotes}{\u2018}{\u2019}{"}{"}
840 \c \cfg{html-version}{html4}
841 \c \cfg{html-template-fragment}{%b}
842 \c \cfg{html-versionid}{true}
843 \c \cfg{html-suppress-address}{false}
844 \c \cfg{html-author}{}
845 \c \cfg{html-description}{}
847 \H{output-whlp} Windows Help
849 This output format generates data that can be used by the \i{Windows
850 Help} program \cw{WINHELP.EXE}. There are two actual files
851 generated, one ending in \c{.hlp} and the other ending in \c{.cnt}.
853 Currently, the output is hardcoded to be in the \q{\i{Win1252}}
854 character set. (If anyone knows how character sets are encoded in
855 Windows Help, we'd appreciate help.)
857 The Windows Help output format supports the following configuration
860 \S{output-whlp-file} Output file name
862 \dt \I{\cw{\\cfg\{winhelp-filename\}}}\cw{\\cfg\{winhelp-filename\}\{}\e{filename}\cw{\}}
864 \dd Sets the \i{output file name} in which to store the man page.
865 This directive is implicitly generated if you provide a file name
866 parameter after the command-line option \i\c{--winhelp} (see
867 \k{running-options}).
871 Your output file name should end with \c{.hlp}; if it doesn't,
872 Halibut will append it. Halibut will also generate a contents file
873 (ending in \c{.cnt}) alongside the file name you specify.
877 \S{output-whlp-characters} Configuring the characters used
879 \dt \I{\cw{\\cfg\{winhelp-bullet\}}}\cw{\\cfg\{winhelp-bullet\}\{}\e{text}\cw{\}}[\cw{\{}\e{text}\cw{\}}...]
881 \dd Specifies the text to use as the \i{bullet} in bulletted lists.
882 You can specify multiple fallback options. Works exactly like the
883 \cw{\\cfg\{text-bullet\}} directive (see
884 \k{output-text-characters}).
886 \dt \I{\cw{\\cfg\{winhelp-quotes\}}}\cw{\\cfg\{winhelp-quotes\}\{}\e{open-quote}\cw{\}\{}\e{close-quote}\cw{\}}[\cw{\{}\e{open-quote}\cw{\}\{}\e{close-quote}...\cw{\}}]
888 \dd Specifies the quotation marks to use, overriding any
889 \cw{\\cfg\{quotes\}} directive. You can specify multiple
890 fallback options. Works exactly like the \cw{\\cfg\{text-quotes\}}
891 directive (see \k{output-text-characters}).
893 \S{output-whlp-misc} Miscellaneous configuration options
895 \dt \I{\cw{\\cfg\{winhelp-contents-titlepage\}}}\cw{\\cfg\{winhelp-contents-titlepage\}\{}\e{title}\cw{\}}
897 \dd Sets the text used to describe the help page containing the blurb
898 (see \k{input-blurb}) and table of contents.
901 \I{\cw{\\cfg\{winhelp-section-suffix\}}}\cw{\\cfg\{winhelp-section-suffix\}\{}\e{text}\cw{\}}
903 \dd Specifies the \I{suffix text, in section titles}suffix text to
904 be appended to section numbers, before displaying the section title.
905 (Applies to all levels.)
907 \dt \I{\cw{\\cfg\{winhelp-list-suffix\}}}\cw{\\cfg\{winhelp-list-suffix\}\{}\e{text}\cw{\}}
909 \dd This text is appended to the number on a \i{numbered list} item,
910 in exactly the same way as \cw{\\cfg\{text-list-suffix\}} (see
911 \k{output-text-characters}).
913 \dt \I{\cw{\\cfg\{winhelp-topic\}}}\cw{\\cfg\{winhelp-topic\}\{}\e{topic-name}\cw{\}}
915 \dd This directive defines a Windows \i{Help topic} name in the current
916 section. Topic names can be used by the program invoking
917 \cw{WINHELP.EXE} to jump straight to a particular section. So you
918 can use this for \i{context-sensitive help}.
922 For example, if you used this directive in a particular section:
924 \c \cfg{winhelp-topic}{savingfiles}
926 then a Windows application could invoke Windows Help to jump to that
927 particular section in the help file like this:
929 \c WinHelp(hwnd, "mydoc.hlp", HELP_COMMAND,
930 \c (DWORD)"JI(`',`savingfiles')");
932 You can use this configuration directive many times, in many
933 different subsections of your document, in order to define a lot of
934 different help contexts which you can use in this way.
938 \S{output-whlp-defaults} Default settings
940 The \i{default settings} for the Windows Help output format are:
942 \c \cfg{winhelp-filename}{output.hlp}
944 \c \cfg{winhelp-bullet}{\u2022}{-}
945 \c \cfg{winhelp-quotes}{\u2018}{\u2019}{"}{"}
947 \c \cfg{winhelp-contents-titlepage}{Title page}
948 \c \cfg{winhelp-section-suffix}{: }
949 \c \cfg{winhelp-list-suffix}{.}
951 and no \c{\\cfg\{winhelp-topic\}} directives anywhere.
953 \H{output-man} Unix \cw{man} pages
955 This output format generates a Unix \i{\cw{man} page}. That is to say,
956 it generates \i\c{nroff} input designed to work with the \c{-mandoc}
959 The available configuration options for this format are as follows:
961 \S{output-man-file} Output file name
963 \dt \I{\cw{\\cfg\{man-filename\}}}\cw{\\cfg\{man-filename\}\{}\e{filename}\cw{\}}
965 \dd Sets the \i{output file name} in which to store the man page.
966 This directive is implicitly generated if you provide a file name
967 parameter after the command-line option \i\c{--man} (see
968 \k{running-options}).
970 \S{output-man-identity} Configuring headers and footers
972 \dt \I{\cw{\\cfg\{man-identity\}}}\cw{\\cfg\{man-identity\}\{}\e{text}\cw{\}\{}\e{text...}\cw{\}}
974 \dd This directive is used to generate the initial \i{\c{.TH}
975 directive} that appears at the top of a \cw{man} page. It expects to
976 be followed by some number of brace pairs containing text, which will
977 be used in the \i{headers} and \i{footers} of the formatted output.
981 A traditional order for the arguments appears to be:
983 \n The name of the program.
985 \n The (numeric) manual section.
987 \n The date that the \cw{man} page was written.
989 \n The name of any containing suite of which the program is a part.
991 \n The name of the \i{author} of the \cw{man} page.
993 For example, a typical \cw{man} page might contain
995 \c \cfg{man-identity}{make-foo}{1}{June 2003}{foo-utils}{Fred
1000 \S{output-man-headings} Configuring heading display
1002 \dt \I{\cw{\\cfg\{man-headnumbers\}}}\cw{\\cfg\{man-headnumbers\}\{}\e{boolean}\cw{\}}
1004 \dd If this is set to \c{true}, then \i{section headings} in the
1005 \cw{man} page will have their \i{section numbers} displayed as usual. If
1006 set to \c{false}, the section numbers will be omitted. (\cw{man}
1007 pages traditionally have section names such as \q{SYNOPSIS},
1008 \q{OPTIONS} and \q{BUGS}, and do not typically number them, so
1009 \c{false} is the setting which conforms most closely to normal
1012 \dt \I{\cw{\\cfg\{man-mindepth\}}}\cw{\\cfg\{man-mindepth\}\{}\e{depth}\cw{\}}
1014 \dd If this is set to a number greater than 0, then section headings
1015 \e{higher} than the given depth will not be displayed. If it is set
1016 to zero, all section headings will be displayed as normal.
1020 The point of this is so that you can use the same Halibut input file
1021 to generate a quick-reference \cw{man} page for a program, \e{and} to
1022 include that \cw{man} page as an appendix in your program's full manual.
1023 If you are to include the \cw{man} page as an appendix, then the internal
1024 headings within the page will probably need to be at \c{\\H} or
1025 \c{\\S} level; therefore, when you format that input file on its own
1026 to create the \cw{man} page itself, you will need to have defined a
1027 \c{\\C} and possibly a \c{\\H} heading beforehand, which you don't
1028 want to see displayed.
1030 Here's an example. You might have a file \c{appendix.but}, which
1033 \c \A{manpages} \cw{man} pages for the Foo tool suite
1035 \c \cfg{man-mindepth}{2}
1037 Then you have a file \c{make-foo.but}, and probably others like it
1038 as well, each of which looks something like this:
1040 \c \cfg{man-identity}{make-foo}{1}{June 2003}{foo-utils}{Fred
1043 \c \H{man-foo} \cw{man} page for \c{make-foo}
1045 \c \S{man-foo-name} NAME
1047 \c \c{make-foo} - create Foo files for the Foo tool suite
1049 \c \S{man-foo-synopsis} SYNOPSIS
1051 \c ... and so on ...
1052 \e iiiiiiiiiiiiiiiii
1054 So when you're generating your main manual, you can include
1055 \c{appendix.but} followed by \c{make-foo.but} and any other \cw{man}
1056 pages you have, and your \cw{man} pages will be formatted neatly as
1057 part of an appendix. Then, in a separate run of Halibut, you can
1060 \c halibut appendix.but make-foo.but
1062 and this will generate a \cw{man} page \c{output.1}, in which the
1063 headings \q{\cw{man} pages for the Foo tool suite} and \q{\cw{man}
1064 page for \c{make-foo}} will not be displayed because of the
1065 \c{man-mindepth} directive. So the first visible heading in the
1066 output \cw{man} page will be \q{NAME}, exactly as a user would
1071 \S{output-man-characters} Configuring the characters used
1073 \dt \I{\cw{\\cfg\{man-charset\}}}\cw{\\cfg\{man-charset\}\{}\e{character set}\cw{\}}
1075 \dd Specifies what character set the output should be in, similarly to
1076 \cw{\\cfg\{text-charset\}} (see \k{output-text-characters}).
1078 \# FIXME: you're probably on your own in making sure that it's
1079 sensible to output man pages in that charset.
1081 \dt \I{\cw{\\cfg\{man-bullet\}}}\cw{\\cfg\{man-bullet\}\{}\e{text}\cw{\}}[\cw{\{}\e{text}\cw{\}}...]
1083 \dd Specifies the text to use as the \i{bullet} in bulletted lists.
1084 You can specify multiple fallback options. Works exactly like the
1085 \cw{\\cfg\{text-bullet\}} directive (see \k{output-text-characters}).
1087 \dt \I{\cw{\\cfg\{man-rule\}}}\cw{\\cfg\{man-rule\}\{}\e{text}\cw{\}}[\cw{\{}\e{text}...\cw{\}}]
1089 \dd This specifies the text which should be used for drawing
1090 \i{horizontal rules} (generated by \i\c{\\rule}; see
1091 \k{input-rule}) when the manual page is rendered into text.
1092 It should only be one character long, but otherwise
1093 it works like the \cw{\\cfg\{text-rule\}} directive
1094 (see \k{output-text-characters}).
1096 \dt \I{\cw{\\cfg\{man-quotes\}}}\cw{\\cfg\{man-quotes\}\{}\e{open-quote}\cw{\}\{}\e{close-quote}\cw{\}}[\cw{\{}\e{open-quote}\cw{\}\{}\e{close-quote}...\cw{\}}]
1098 \dd Specifies the quotation marks to use, overriding any
1099 \cw{\\cfg\{quotes\}} directive. You can specify multiple
1100 fallback options. Works exactly like the \cw{\\cfg\{text-quotes\}}
1101 directive (see \k{output-text-characters}).
1103 \S{output-man-defaults} Default settings
1105 The \i{default settings} for the \cw{man} page output format are:
1107 \c \cfg{man-filename}{output.1}
1109 \c \cfg{man-identity}{}
1111 \c \cfg{man-headnumbers}{false}
1112 \c \cfg{man-mindepth}{0}
1114 \c \cfg{man-charset}{ASCII}
1115 \c \cfg{man-bullet}{\u2022}{o}
1116 \c \cfg{man-rule}{\u2500}{-}
1117 \c \cfg{man-quotes}{\u2018}{\u2019}{"}{"}
1119 \H{output-info} GNU \c{info}
1121 This output format generates files which can be used with the \i{GNU
1124 There are typically multiple output files: a primary file whose name
1125 usually ends in \c{.info}, and one or more subsidiary files whose
1126 names have numbers on the end, so that they end in \c{.info-1},
1127 \c{.info-2} and so on. Alternatively, this output format can be
1128 configured to output a single large file containing the whole
1131 The \c{info} output format supports the following configuration
1134 \S{output-info-file} Controlling the output filenames
1136 \dt \I{\cw{\\cfg\{info-filename\}}}\cw{\\cfg\{info-filename\}\{}\e{filename}\cw{\}}
1138 \dd Sets the output file name in which to store the \c{info} file.
1139 This directive is implicitly generated if you provide a file name
1140 parameter after the command-line option \i\c{--info} (see
1141 \k{running-options}).
1145 The suffixes \c{-1}, \c{-2}, \c{-3} and so on will be appended to
1146 your output file name to produce any subsidiary files required.
1148 Note that \c{info} files refer to their own names internally, so
1149 these files cannot be \I{renaming \c{info} files}renamed after
1150 creation and remain useful.
1154 \dt \I{\cw{\\cfg\{info-max-file-size\}}}\cw{\\cfg\{info-max-file-size\}\{}\e{bytes}\cw{\}}
1156 \dd Sets the preferred \i{maximum file size} for each subsidiary
1157 file. As a special case, if you set this to zero, there will be no
1158 subsidiary files and the whole document will be placed in a single
1159 self-contained output file. (However, note that this file can still
1160 not be renamed usefully.)
1164 The preferred maximum file size is only a guideline. Halibut may be
1165 forced to exceed it if a single section of the document is larger
1166 than the maximum size (since individual \c{info} nodes may not be
1167 split between files).
1171 \S{output-info-dimensions} Indentation and line width
1173 \dt \I{\cw{\\cfg\{info-width\}}}\cw{\\cfg\{info-width\}\{}\e{width}\cw{\}}
1175 \dd Sets the \I{text width}width of the main part of the document,
1176 in characters. Works exactly like the \cw{\\cfg\{text-width\}}
1177 directive (see \k{output-text-dimensions}).
1179 \dt \I{\cw{\\cfg\{info-indent-code\}}}\cw{\\cfg\{info-indent-code\}\{}\e{indent}\cw{\}}
1181 \dd Specifies the extra indentation for \I{code paragraphs,
1182 indentation} code paragraphs. Works exactly like the
1183 \cw{\\cfg\{text-indent-code\}} directive (see
1184 \k{output-text-dimensions}).
1186 \dt \I{\cw{\\cfg\{info-index-width\}}}\cw{\\cfg\{info-index-width\}\{}\e{width}\cw{\}}
1188 \dd Specifies how much horizontal space to leave in the index node
1189 for the text of \i{index terms}, before displaying the sections the
1192 \dt \I{\cw{\\cfg\{info-list-indent\}}}\cw{\\cfg\{info-list-indent\}\{}\e{indent}\cw{\}}
1194 \dd Specifies the extra indentation before the bullet or number in a
1195 \I{bulletted list, indentation}\I{numbered list, indentation}list
1196 item. Works exactly like the \cw{\\cfg\{text-list-indent\}}
1197 directive (see \k{output-text-dimensions}).
1199 \dt \I{\cw{\\cfg\{info-listitem-indent\}}}\cw{\\cfg\{info-listitem-indent\}\{}\e{indent}\cw{\}}
1201 \dd Specifies the additional indentation before the body of a list
1202 item. Works exactly like the \cw{\\cfg\{text-listitem-indent\}}
1203 directive (see \k{output-text-dimensions}).
1205 \S{output-info-headings} Configuring heading display
1207 \dt \I{\cw{\\cfg\{info-section-suffix\}}}\cw{\\cfg\{info-section-suffix\}\{}\e{text}\cw{\}}
1209 \dd Specifies the suffix text to be appended to each section number
1210 before displaying the section title. For example, if you set this to
1211 \cq{:\_}, then a typical section title might look something like
1212 \q{Section 3.1: Something Like This}.
1214 \dt \I{\cw{\\cfg\{info-underline\}}}\cw{\\cfg\{info-underline\}\{}\e{text}\cw{\}}[\cw{\{}\e{text}\cw{\}}...]
1216 \dd Specifies the text to be used to underline section titles. Works
1217 very much like the \cw{\\cfg\{text-chapter-underline\}} directive
1218 (see \k{output-text-headings}). You can specify more than one
1219 option, and Halibut will choose the first one supported by the
1222 \S{output-info-characters} Controlling the characters used
1224 \dt \I{\cw{\\cfg\{info-charset\}}}\cw{\\cfg\{info-charset\}\{}\e{character set}\cw{\}}
1226 \dd Specifies what character set the output should be in, similarly to
1227 \cw{\\cfg\{text-charset\}} (see \k{output-text-characters}).
1229 \# FIXME: if you try sufficiently hard, you can probably find an
1230 output encoding that will break the info format by trampling on its
1231 special characters. So either don't do that, or tell us what we should
1234 \dt \I{\cw{\\cfg\{info-bullet\}}}\cw{\\cfg\{info-bullet\}\{}\e{text}\cw{\}}[\cw{\{}\e{text}\cw{\}}...]
1236 \dd Specifies the text to use as the \i{bullet} in bulletted lists.
1237 You can specify multiple fallback options. Works exactly like the
1238 \cw{\\cfg\{text-bullet\}} directive (see
1239 \k{output-text-characters}).
1241 \dt \I{\cw{\\cfg\{info-rule\}}}\cw{\\cfg\{info-rule\}\{}\e{text}\cw{\}}[\cw{\{}\e{text}\cw{\}}...]
1243 \dd Specifies the text used to draw \i{horizontal rules}. You can
1244 specify multiple fallback options. Works exactly like the
1245 \cw{\\cfg\{text-rule\}} directive (see \k{output-text-characters}).
1247 \dt \I{\cw{\\cfg\{info-quotes\}}}\cw{\\cfg\{info-quotes\}\{}\e{open-quote}\cw{\}\{}\e{close-quote}\cw{\}}[\cw{\{}\e{open-quote}\cw{\}\{}\e{close-quote}...\cw{\}}]
1249 \dd Specifies the quotation marks to use, overriding any
1250 \cw{\\cfg\{quotes\}} directive. You can specify multiple
1251 fallback options. Works exactly like the \cw{\\cfg\{text-quotes\}}
1252 directive (see \k{output-text-characters}).
1254 \dt \I{\cw{\\cfg\{info-emphasis\}}}\cw{\\cfg\{info-emphasis\}\{}\e{start-emph}\cw{\}\{}\e{end-emph}\cw{\}}[\cw{\{}\e{start-emph}\cw{\}\{}\e{end-emph}...\cw{\}}]
1256 \dd Specifies how to display emphasised text. You can specify
1257 multiple fallback options. Works exactly like the
1258 \cw{\\cfg\{text-emphasis\}} directive (see
1259 \k{output-text-characters}).
1261 \S{output-info-misc} Miscellaneous configuration options
1263 \dt \I{\cw{\\cfg\{info-list-suffix\}}}\cw{\\cfg\{info-list-suffix\}\{}\e{text}\cw{\}}
1265 \dd Specifies the text to append to the item numbers in a
1266 \i{numbered list}. Works exactly like the
1267 \cw{\\cfg\{text-list-suffix\}} directive (see
1268 \k{output-text-misc}).
1270 \dt \I{\cw{\\cfg\{info-dir-entry\}}}\cw{\\cfg\{info-dir-entry\}\{}\e{section}\cw{\}\{}\e{short
1271 name}\cw{\}\{}\e{long name}\cw{\}}[\cw{\{}\e{keyword}\cw{\}}]
1273 \dd Constructs an \i\cw{INFO-DIR-ENTRY} section and places it in the
1274 header of the Info file. This mechanism is used to automatically
1275 generate the \i{\c{dir} file} at the root of a Unix system's
1276 \c{info} collection.
1280 The parameters to this directive are:
1284 \dd Specifies the section of the \c{dir} file in which you want your
1285 document referenced. For example, \q{Development}, or \q{Games}, or
1290 \dd Specifies a short name for the directory entry, which will
1291 appear at the start of the menu line.
1295 \dd Specifies a long name for the directory entry, which will appear
1296 at the end of the menu line.
1300 \dd This parameter is optional. If it is present, then the directory
1301 entry will cause a jump to a particular subsection of your document,
1302 rather than starting at the top. The subsection will be the one
1303 referred to by the given keyword (see \k{input-sections} for details
1304 about assigning keywords to document sections).
1306 For example, in a document describing many game programs, the
1307 configuration directive
1309 \c \cfg{info-dir-entry}{Games}{Chess}{Electronic chess
1312 might produce text in the \c{dir} file looking something like this:
1315 \c * Chess: (mygames)Chapter 3. Electronic chess game
1317 if the output file were called \c{mygames.info} and the keyword
1318 \c{chess} had been used to define Chapter 3 of the document.
1322 \S{output-info-defaults} Default settings
1324 The \i{default settings} for the \c{info} output format are:
1326 \c \cfg{info-filename}{output.info}
1327 \c \cfg{info-max-file-size}{65536}
1329 \c \cfg{info-width}{70}
1330 \c \cfg{info-indent-code}{2}
1331 \c \cfg{info-index-width}{40}
1332 \c \cfg{info-list-indent}{1}
1333 \c \cfg{info-listitem-indent}{3}
1335 \c \cfg{info-section-suffix}{: }
1336 \c \cfg{info-underline}{\u203e}{-}
1338 \c \cfg{info-charset}{ASCII}
1339 \c \cfg{info-bullet}{\u2022}{-}
1340 \c \cfg{info-rule}{\u2500}{-}
1341 \c \cfg{info-quotes}{\u2018}{\u2019}{`}{'}
1342 \c \cfg{info-emphasis}{_}{_}
1344 \c \cfg{info-list-suffix}{.}
1346 and no \cw{\\cfg\{info-dir-entry\}} directives.
1348 \H{output-paper} Paper formats
1350 These output formats (currently PostScript and PDF) generate printable
1351 manuals. As such, they share a number of configuration directives.
1353 \S{output-ps} \i{PostScript}
1355 This output format generates a printable manual in PostScript format.
1357 There is one configuration option specific to PostScript:
1359 \dt \I{\cw{\\cfg\{ps-filename\}}}\cw{\\cfg\{ps-filename\}\{}\e{filename}\cw{\}}
1361 \dd Sets the \i{output file name} in which to store the PostScript
1362 file. This directive is implicitly generated if you provide a file
1363 name parameter after the command-line option \i\c{--ps} (see
1364 \k{running-options}).
1366 The \i{default settings} for the PostScript output format are:
1368 \c \cfg{ps-filename}{output.ps}
1370 \S{output-pdf} \i{PDF}
1372 This output format generates a printable manual in PDF format. This
1373 should look exactly identical to the PostScript output (see
1374 \k{output-ps}), but also uses some PDF interactive features to
1375 provide an outline of all the document's sections and clickable
1376 cross-references between sections.
1378 There is one configuration option specific to PDF:
1380 \dt \I{\cw{\\cfg\{pdf-filename\}}}\cw{\\cfg\{pdf-filename\}\{}\e{filename}\cw{\}}
1382 \dd Sets the \i{output file name} in which to store the PDF file.
1383 This directive is implicitly generated if you provide a file name
1384 parameter after the command-line option \i\c{--pdf} (see
1385 \k{running-options}).
1387 The \i{default settings} for the PDF output format are:
1389 \c \cfg{pdf-filename}{output.pdf}
1391 \S{output-paper-dimensions} Configuring layout and \i{measurements}
1393 All measurements are in PostScript \i{points} (72 points to the inch).
1395 \S2{output-paper-pagesize} Page properties
1397 \dt \I{\cw{\\cfg\{paper-page-width\}}}\cw{\\cfg\{paper-page-width\}\{}\e{points}\cw{\}}
1399 \dt \I{\cw{\\cfg\{paper-page-height\}}}\cw{\\cfg\{paper-page-height\}\{}\e{points}\cw{\}}
1401 \dd Specify the absolute limits of the paper.
1403 \dt \I{\cw{\\cfg\{paper-left-margin\}}}\cw{\\cfg\{paper-left-margin\}\{}\e{points}\cw{\}}
1405 \dt \I{\cw{\\cfg\{paper-top-margin\}}}\cw{\\cfg\{paper-top-margin\}\{}\e{points}\cw{\}}
1407 \dt \I{\cw{\\cfg\{paper-right-margin\}}}\cw{\\cfg\{paper-right-margin\}\{}\e{points}\cw{\}}
1409 \dt \I{\cw{\\cfg\{paper-bottom-margin\}}}\cw{\\cfg\{paper-bottom-margin\}\{}\e{points}\cw{\}}
1411 \dd Specify the margins. Most text appears within these margins,
1416 \b Section numbers, which appear in the left margin.
1418 \b The footer (containing page numbers), which appears in the bottom
1423 \S2{output-paper-line} Vertical spacing
1425 \dt \I{\cw{\\cfg\{paper-base-leading\}}}\cw{\\cfg\{paper-base-leading\}\{}\e{points}\cw{\}}
1427 \dd Specifies the amount of space between lines of text within a
1428 paragraph. (So, if the font size is 12pt and there is 2pt of leading,
1429 there will be 14pt between successive baselines.)
1431 \dt \I{\cw{\\cfg\{paper-base-para-spacing\}}}\cw{\\cfg\{paper-base-para-spacing\}\{}\e{points}\cw{\}}
1433 \dd Specifies the amount of vertical space between paragraphs. (The
1434 vertical space between paragraphs does \e{not} include
1435 \c{paper-base-leading}.)
1437 \S2{output-paper-indentation} Indentation
1439 \dt \I{\cw{\\cfg\{paper-list-indent\}}}\cw{\\cfg\{paper-list-indent\}\{}\e{points}\cw{\}}
1441 \dd Specifies the indentation of the bullet or number in a
1442 \I{bulletted list, indentation}bulletted or \I{numbered list,
1443 indentation}numbered \I{list, indentation}list, similarly to
1444 \cw{\\cfg\{text-list-indent\}} (see \k{output-text-dimensions}).
1446 \dt \I{\cw{\\cfg\{paper-listitem-indent\}}}\cw{\\cfg\{paper-listitem-indent\}\{}\e{points}\cw{\}}
1448 \dd Specifies the \e{extra} indentation for the body of a list item,
1449 over and above the amount configured in \cw{\\cfg\{paper-list-indent\}}.
1451 \# FIXME: doesn't actually work, AFAICT.
1453 \dt \I{\cw{\\cfg\{paper-quote-indent\}}}\cw{\\cfg\{paper-quote-indent\}\{}\e{points}\cw{\}}
1455 \dd Specifies the amount of indentation for a level of quoting. Used
1456 for \cw{\\quote} (see \k{input-quote}) and code quotes with \cw{\\c}
1457 (see \k{input-code}).
1459 \S2{output-paper-headings} Headings
1461 \dt \I{\cw{\\cfg\{paper-chapter-top-space\}}}\cw{\\cfg\{paper-chapter-top-space\}\{}\e{points}\cw{\}}
1463 \dd Specifies the space between the top margin and the top of the
1464 chapter heading. (Each chapter begins on a new page.)
1466 \dt \I{\cw{\\cfg\{paper-chapter-underline-thickness\}}}\cw{\\cfg\{paper-chapter-underline-thickness\}\{}\e{points}\cw{\}}
1468 \dd Specifies the vertical thickness of the black rule under chapter
1471 \dt \I{\cw{\\cfg\{paper-chapter-underline-depth\}}}\cw{\\cfg\{paper-chapter-underline-depth\}\{}\e{points}\cw{\}}
1473 \dd Specifies the distance between the base of the chapter heading and
1474 the \e{base} of the underlying rule.
1476 \dt \I{\cw{\\cfg\{paper-sect-num-left-space\}}}\cw{\\cfg\{paper-sect-num-left-space\}\{}\e{points}\cw{\}}
1478 \dd Specifies the distance between the left margin and the \e{right}
1479 of section numbers (which are in the left margin).
1481 \S2{output-paper-index} Contents and index
1483 \dt \I{\cw{\\cfg\{paper-contents-index-step\}}}\cw{\\cfg\{paper-contents-index-step\}\{}\e{points}\cw{\}}
1485 \dt \I{\cw{\\cfg\{paper-contents-margin\}}}\cw{\\cfg\{paper-contents-margin\}\{}\e{points}\cw{\}}
1487 \# FIXME: I do not know what dees one does. (I couldn't get either of
1488 them to do anything obvious, although the source indicates they should
1491 \dt \I{\cw{\\cfg\{paper-leader-separation\}}}\cw{\\cfg\{paper-leader-separation\}\{}\e{points}\cw{\}}
1493 \dd Specifies the horizontal spacing between dots in \i\e{leaders}
1494 (the dotted lines that appear between section headings and page
1495 numbers in the table of contents).
1497 \dt \I{\cw{\\cfg\{paper-footer-distance\}}}\cw{\\cfg\{paper-footer-distance\}\{}\e{points}\cw{\}}
1499 \dd Specifies the distance between the bottom margin and the \e{base}
1500 of the footer (which contains page numbers).
1502 \dt \I{\cw{\\cfg\{paper-index-columns\}}}\cw{\\cfg\{paper-index-columns\}\{}\e{columns}\cw{\}}
1504 \dd Specifies the number of columns the index should be divided into.
1506 \# FIXME: with this set to 1, the right-alignment of some index entry
1507 page numbers in the Halibut manual is decidedly wonky.
1509 \dt \I{\cw{\\cfg\{paper-index-gutter\}}}\cw{\\cfg\{paper-index-gutter\}\{}\e{points}\cw{\}}
1511 \dd Specifies the amount of \I{gutter} horizontal space between index
1514 \dt \I{\cw{\\cfg\{paper-index-minsep\}}}\cw{\\cfg\{paper-index-minsep\}\{}\e{points}\cw{\}}
1516 \dd Specifies the minimum allowable horizontal space between an index
1517 entry and its page number. If the gap is smaller, the page number is
1518 moved to the next line.
1520 \S2{output-paper-fonts} \ii{Fonts}
1522 The directives in this section control which fonts Halibut uses for
1523 various kinds of text. Directives for setting the font normally take
1524 three font names, the first of which is used for normal text, the
1525 second for emphasised text, and the third for code. Any fonts which
1526 aren't specified are left unchanged. Fonts are named using their
1527 PostScript names and must be ones whose metrics are compiled into
1532 \b \cw{Times-Italic}
1536 \b \cw{Times-BoldItalic}
1540 \b \cw{Helvetica-Oblique}
1542 \b \cw{Helvetica-Bold}
1544 \b \cw{Helvetica-BoldOblique}
1548 \b \cw{Courier-Oblique}
1550 \b \cw{Courier-Bold}
1552 \b \cw{Courier-BoldOblique}
1554 \ii{Font sizes} are specified in PostScript \i{points} (72 to the inch).
1556 \dt \I{\cw{\\cfg\{paper-title-fonts\}}}\cw{\\cfg\{paper-title-fonts\}\{}\e{normal-font}\cw{\}}[\cw{\{}\e{emph-font}\cw{\}}[\cw{\{}\e{code-font}\cw{\}}]]
1558 \dd Specifies the fonts to use for text in the document title.
1560 \dt \I{\cw{\\cfg\{paper-title-font-size\}}}\cw{\\cfg\{paper-title-font-size\}\{}\e{points}\cw{\}}
1562 \dd Specifies the \i{font size} of the document title.
1564 \dt \I{\cw{\\cfg\{paper-chapter-fonts\}}}\cw{\\cfg\{paper-chapter-fonts\}\{}\e{normal-font}\cw{\}}[\cw{\{}\e{emph-font}\cw{\}}[\cw{\{}\e{code-font}\cw{\}}]]
1566 \dd Specifies the fonts to use for text in chapter titles.
1568 \dt \I{\cw{\\cfg\{paper-chapter-font-size\}}}\cw{\\cfg\{paper-chapter-font-size\}\{}\e{points}\cw{\}}
1570 \dd Specifies the \i{font size} of chapter titles.
1572 \dt \I{\cw{\\cfg\{paper-section-fonts\}}}\cw{\\cfg\{paper-section-fonts\}\{}\e{level}\cw{\}\{}\e{normal-font}\cw{\}}[\cw{\{}\e{emph-font}\cw{\}}[\cw{\{}\e{code-font}\cw{\}}]]
1574 \dd Specifies the fonts to use for text in section headings at the \e{level}
1577 \dt \I{\cw{\\cfg\{paper-section-font-size\}}}\cw{\\cfg\{paper-section-font-size\}\{}\e{level}\cw{\}\{}\e{points}\cw{\}}
1579 \dd Specifies the \i{font size} of section headings at the \e{level}
1582 \dt \I{\cw{\\cfg\{paper-base-fonts\}}}\cw{\\cfg\{paper-base-fonts\}\{}\e{normal-font}\cw{\}}[\cw{\{}\e{emph-font}\cw{\}}[\cw{\{}\e{code-font}\cw{\}}]]
1584 \dd Specifies the fonts to use for text in the body text.
1586 \dt \I{\cw{\\cfg\{paper-base-font-size\}}}\cw{\\cfg\{paper-base-font-size\}\{}\e{points}\cw{\}}
1588 \dd Specifies the \i{font size} of body text.
1590 \dt \I{\cw{\\cfg\{paper-code-fonts\}}}\cw{\\cfg\{paper-code-fonts\}\{}\e{bold-font}\cw{\}}[\cw{\{}\e{italic-font}\cw{\}}[\cw{\{}\e{normal-font}\cw{\}}]]
1592 \dd Specifies the fonts to use for text in code paragraps. The
1593 \e{bold-font} is used for bold text, the \e{italic-font} for
1594 emphasised text, and the \e{normal-font} for normal code.
1596 \dt \I{\cw{\\cfg\{paper-code-font-size\}}}\cw{\\cfg\{paper-code-font-size\}\{}\e{points}\cw{\}}
1598 \dd Specifies the \i{font size} of text in code paragraphs.
1600 \dt \I{\cw{\\cfg\{paper-pagenum-font-size\}}}\cw{\\cfg\{paper-pagenum-font-size\}\{}\e{points}\cw{\}}
1602 \dd Specifies the font size to use for \i{page numbers}.
1604 \S2{output-paper-misc} Miscellaneous
1606 \dt \I{\cw{\\cfg\{paper-rule-thickness\}}}\cw{\\cfg\{paper-rule-thickness\}\{}\e{points}\cw{\}}
1608 \dd Specifies the vertical thickness of the rule produced by the
1609 \cw{\\rule} command (see \k{input-rule}). (Note that no extra space is
1610 reserved for thicker rules.)
1612 \S{output-paper-characters} Configuring the characters used
1614 \dt \I{\cw{\\cfg\{paper-bullet\}}}\cw{\\cfg\{paper-bullet\}\{}\e{text}\cw{\}}[\cw{\{}\e{text}\cw{\}}...]
1616 \dd Specifies the text to use as the \i{bullet} in bulletted lists.
1617 You can specify multiple fallback options. Works exactly like the
1618 \cw{\\cfg\{text-bullet\}} directive (see
1619 \k{output-text-characters}).
1621 \dt \I{\cw{\\cfg\{paper-quotes\}}}\cw{\\cfg\{paper-quotes\}\{}\e{open-quote}\cw{\}\{}\e{close-quote}\cw{\}}[\cw{\{}\e{open-quote}\cw{\}\{}\e{close-quote}...\cw{\}}]
1623 \dd Specifies the quotation marks to use, overriding any
1624 \cw{\\cfg\{quotes\}} directive. You can specify multiple
1625 fallback options. Works exactly like the \cw{\\cfg\{text-quotes\}}
1626 directive (see \k{output-text-characters}).
1628 \S{output-paper-defaults} Default settings for paper formats
1630 The default page size corresponds to 210\_\u00D7{x}\_297\_mm, i.e.,
1633 \c \cfg{paper-page-width}{595}
1634 \c \cfg{paper-page-height}{842}
1636 \c \cfg{paper-left-margin}{72}
1637 \c \cfg{paper-top-margin}{72}
1638 \c \cfg{paper-right-margin}{72}
1639 \c \cfg{paper-bottom-margin}{108}
1641 \c \cfg{paper-base-leading}{1}
1642 \c \cfg{paper-base-para-spacing}{10}
1644 \c \cfg{paper-list-indent}{6}
1645 \c \cfg{paper-listitem-indent}{18}
1646 \c \cfg{paper-quote-indent}{18}
1648 \c \cfg{paper-chapter-top-space}{72}
1649 \c \cfg{paper-chapter-underline-thickness}{3}
1650 \c \cfg{paper-chapter-underline-depth}{14}
1651 \c \cfg{paper-sect-num-left-space}{12}
1653 \c \cfg{paper-contents-index-step}{24}
1654 \c \cfg{paper-contents-margin}{84}
1655 \c \cfg{paper-leader-separation}{12}
1656 \c \cfg{paper-footer-distance}{32}
1657 \c \cfg{paper-index-columns}{2}
1658 \c \cfg{paper-index-gutter}{36}
1659 \c \cfg{paper-index-minsep}{18}
1661 \c \cfg{paper-base-fonts}{Times-Roman}{Times-Italic}{Courier}
1662 \c \cfg{paper-base-font-size}{12}
1663 \c \cfg{paper-code-fonts}{Courier-Bold}{Courier-Oblique}{Courier}
1664 \c \cfg{paper-code-font-size}{12}
1665 \c \cfg{paper-title-fonts}{Helvetica-Bold}{Helvetica-BoldOblique}{Courier-Bold}
1666 \c \cfg{paper-title-font-size}{24}
1667 \c \cfg{paper-chapter-fonts}{Helvetica-Bold}{Helvetica-BoldOblique}{Courier-Bold}
1668 \c \cfg{paper-chapter-font-size}{20}
1669 \c \cfg{paper-section-fonts}{0}{Helvetica-Bold}{Helvetica-BoldOblique}{Courier-Bold}
1670 \c \cfg{paper-section-font-size}{0}{16}
1671 \c \cfg{paper-section-fonts}{1}{Helvetica-Bold}{Helvetica-BoldOblique}{Courier-Bold}
1672 \c \cfg{paper-section-font-size}{1}{14}
1673 \c \cfg{paper-section-fonts}{2}{Helvetica-Bold}{Helvetica-BoldOblique}{Courier-Bold}
1674 \c \cfg{paper-section-font-size}{2}{13}
1675 \c ... and so on for all section levels below this ...
1676 \e iiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiii
1678 \c \cfg{paper-pagenum-font-size}{12}
1680 \c \cfg{paper-rule-thickness}{1}
1682 \c \cfg{paper-bullet}{\u2022}{-}
1683 \c \cfg{paper-quotes}{\u2018}{\u2019}{'}{'}