Revamp of the Halibut error handling mechanism.

[sgt/halibut] / doc / manpage.but

diff --git a/doc/manpage.but b/doc/manpage.but
index 5889e59..5ce02eb 100644 (file)
--- a/doc/manpage.but
+++ b/doc/manpage.but
@@ -1,3 +1,5 @@
+\versionid $Id$
+
 \cfg{man-identity}{halibut}{1}{2004-04-08}{Halibut}{Simon Tatham}
 \cfg{man-mindepth}{1}
 
@@ -5,7 +7,7 @@
 
 \H{manpage-name} NAME
 
-\cw{halibut} - multi-format documentation formatting tool
+\cw{halibut} \u2013{\u2212{-}} multi-format documentation formatting tool
 
 \H{manpage-synopsis} SYNOPSIS
 
@@ -83,14 +85,6 @@ you specify; the subsidiary files will have suffixes \c{-1}, \c{-2}
 etc.
 }
 
-\dt \cw{--ps}[\cw{=}\e{filename}]
-
-\dd Makes Halibut generate an output file in PostScript format. If
-the optional \e{filename} parameter is supplied, the PostScript
-output file will be given that name. Otherwise, the name of
-the output PostScript file will be as specified in the input files,
-or \c{output.ps} if none is specified at all.
-
 \dt \cw{--pdf}[\cw{=}\e{filename}]
 
 \dd Makes Halibut generate an output file in PDF format. If
@@ -99,6 +93,14 @@ output file will be given that name. Otherwise, the name of
 the output PDF file will be as specified in the input files,
 or \c{output.pdf} if none is specified at all.
 
+\dt \cw{--ps}[\cw{=}\e{filename}]
+
+\dd Makes Halibut generate an output file in PostScript format. If
+the optional \e{filename} parameter is supplied, the PostScript
+output file will be given that name. Otherwise, the name of
+the output PostScript file will be as specified in the input files,
+or \c{output.ps} if none is specified at all.
+
 \dt \cw{-C}\e{word}\cw{:}\e{word}[\cw{:}\e{word}...]
 
 \dd Adds a configuration directive to the input processed by
@@ -111,6 +113,15 @@ extra input file to the command line which contains the directive
 \dd Changes the assumed character set for input files from the
 default of ASCII.
 
+\dt \cw{--list-charsets}
+
+\dd Makes Halibut list character sets known to it.
+
+\dt \cw{--list-fonts}
+
+\dd Makes Halibut list fonts known to it, either intrinsically or
+by being passed as input files.
+
 \dt \cw{--precise}
 
 \dd Makes Halibut report the column number as well as the line
@@ -129,7 +140,7 @@ options.
 
 \dd Makes Halibut display its licence (MIT).
 
-\H{putty-manpage-more-information} MORE INFORMATION
+\H{manpage-more-information} MORE INFORMATION
 
 For more information on Halibut, including full details of the input
 file format, look in the full manual. If this is not installed
@@ -137,10 +148,6 @@ locally on your system, you can also find it at the Halibut web site:
 
 \W{http://www.chiark.greenend.org.uk/~sgtatham/halibut/}\cw{http://www.chiark.greenend.org.uk/~sgtatham/halibut/}
 
-\H{putty-manpage-bugs} BUGS
+\H{manpage-bugs} BUGS
 
 This man page isn't terribly complete.
-
-The HTML output isn't very good.
-
-Unicode handling is atrocious.