~mdw
/
sgt
/
halibut
/ blobdiff
commit
grep
author
committer
pickaxe
?
search:
re
summary
|
shortlog
|
log
|
commit
|
commitdiff
|
tree
raw
|
inline
| side by side
Make the title a bit scarier to test the PostScript backend some more,
[sgt/halibut]
/
doc
/
running.but
diff --git
a/doc/running.but
b/doc/running.but
index
56790ec
..
884c33f
100644
(file)
--- a/
doc/running.but
+++ b/
doc/running.but
@@
-1,3
+1,5
@@
+\versionid $Id$
+
\C{running} Running Halibut
\I{running Halibut}In the simplest case, running Halibut is very
\C{running} Running Halibut
\I{running Halibut}In the simplest case, running Halibut is very
@@
-39,10
+41,10
@@
have configured Halibut to generate a single file, it will be called
\c{output.info-2} etc., will be files suitable for use with GNU
\c{info}.
\c{output.info-2} etc., will be files suitable for use with GNU
\c{info}.
-\b \c{output.ps} will be a printable PostScript manual.
-
\b \c{output.pdf} will be a printable PDF manual.
\b \c{output.pdf} will be a printable PDF manual.
+\b \c{output.ps} will be a printable PostScript manual.
+
\H{running-options} \ii{Command-line options}
Halibut supports command-line options in case you don't want to use
\H{running-options} \ii{Command-line options}
Halibut supports command-line options in case you don't want to use
@@
-121,18
+123,18
@@
additional files \c{output.info-1}, \c{output.info-2} and so on.
}
}
-\dt \i\cw{--ps}[\cw{=}\e{filename}]
-
-\dd Specifies that you want to generate PostScript output. You
-can optionally specify a file name (e.g. \c{--ps=myfile.ps}), in
-which case Halibut will change the name of the output file as well.
-
\dt \i\cw{--pdf}[\cw{=}\e{filename}]
\dd Specifies that you want to generate PDF output. You
can optionally specify a file name (e.g. \c{--pdf=myfile.pdf}), in
which case Halibut will change the name of the output file as well.
\dt \i\cw{--pdf}[\cw{=}\e{filename}]
\dd Specifies that you want to generate PDF output. You
can optionally specify a file name (e.g. \c{--pdf=myfile.pdf}), in
which case Halibut will change the name of the output file as well.
+\dt \i\cw{--ps}[\cw{=}\e{filename}]
+
+\dd Specifies that you want to generate PostScript output. You
+can optionally specify a file name (e.g. \c{--ps=myfile.ps}), in
+which case Halibut will change the name of the output file as well.
+
If you do not specify any of the above options, Halibut will simply
produce \e{all} of its output formats.
If you do not specify any of the above options, Halibut will simply
produce \e{all} of its output formats.
@@
-176,7
+178,7
@@
identically to \c{--text -Ctext-filename:myfile.txt}. The Windows
Help and man page formats work similarly. HTML is slightly
different, since it also arranges for single-file output if you pass
a filename to \c{--html}; so \c{--html=myfile.html} is equivalent to
Help and man page formats work similarly. HTML is slightly
different, since it also arranges for single-file output if you pass
a filename to \c{--html}; so \c{--html=myfile.html} is equivalent to
-\c{--html -C
xhtml-single-filename:myfile.html -Cx
html-leaf-level:0}.
+\c{--html -C
html-single-filename:myfile.html -C
html-leaf-level:0}.
(See \k{output} for explanations of all these configuration
directives.)
(See \k{output} for explanations of all these configuration
directives.)
@@
-184,7
+186,7
@@
In addition to these, there are also a few other options:
\dt \i\cw{--input-charset}\cw{=}\e{charset}
\dt \i\cw{--input-charset}\cw{=}\e{charset}
-\dd Changes the default assumed
character set
for all input files from
+\dd Changes the default assumed
\i{character set}
for all input files from
ASCII to something else. (\cw{-Cinput-charset} cannot be used for
this, as \cw{-C} directives are processed after all other input, so
wouldn't affect any files.)
ASCII to something else. (\cw{-Cinput-charset} cannot be used for
this, as \cw{-C} directives are processed after all other input, so
wouldn't affect any files.)
@@
-198,6
+200,10
@@
See \k{input-config} for more information about the input character set.
}
}
+\dt \I{character sets, enumerating}\i\cw{--list-charsets}
+
+\dd List character sets known to Halibut.
+
\dt \i\cw{--help}
\dd Print a brief help message and exit immediately. (Don't confuse
\dt \i\cw{--help}
\dd Print a brief help message and exit immediately. (Don't confuse