Add a --list-fonts option, since getting PostScript names out of TrueType

[sgt/halibut] / doc / manpage.but

diff --git a/doc/manpage.but b/doc/manpage.but
index 371b15d..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}
 
 \cfg{man-identity}{halibut}{1}{2004-04-08}{Halibut}{Simon Tatham}
 \cfg{man-mindepth}{1}
 


@@ -5,7 +7,7 @@
 
 \H{manpage-name} NAME
 
 
 \H{manpage-name} NAME
 

-\cw{halibut} - multi-format documentation formatting tool
+\cw{halibut} \u2013{\u2212{-}} multi-format documentation formatting tool

 
 \H{manpage-synopsis} SYNOPSIS
 
 
 \H{manpage-synopsis} SYNOPSIS
 


@@ -83,14 +85,6 @@ you specify; the subsidiary files will have suffixes \c{-1}, \c{-2}
 etc.
 }
 
 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
 \dt \cw{--pdf}[\cw{=}\e{filename}]
 
 \dd Makes Halibut generate an output file in PDF format. If


@@ -99,13 +93,13 @@ 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.
 
 the output PDF file will be as specified in the input files,
 or \c{output.pdf} if none is specified at all.
 

-\dt \cw{--man}[\cw{=}\e{filename}]
+\dt \cw{--ps}[\cw{=}\e{filename}]

 
 

-\dd Makes Halibut generate an output file in Unix \cw{man} page
-format. If the optional \e{filename} parameter is supplied, the
-output \cw{man} page will be given that name. Otherwise, the name of
-the output \cw{man} page will be as specified in the input files, or
-\c{output.1} if none is specified at all.
+\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}...]
 
 
 \dt \cw{-C}\e{word}\cw{:}\e{word}[\cw{:}\e{word}...]
 


@@ -114,6 +108,20 @@ Halibut. Using this directive is exactly equivalent to appending an
 extra input file to the command line which contains the directive
 \cw{\\cfg\{}\e{word}\cw{\}\{}\e{word}\cw{\}\{}\e{word}...\cw{\}}.
 
 extra input file to the command line which contains the directive
 \cw{\\cfg\{}\e{word}\cw{\}\{}\e{word}\cw{\}\{}\e{word}...\cw{\}}.
 

+\dt \cw{--input-charset}\cw{=}\e{charset}
+
+\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
 \dt \cw{--precise}
 
 \dd Makes Halibut report the column number as well as the line


@@ -132,7 +140,7 @@ options.
 
 \dd Makes Halibut display its licence (MIT).
 
 
 \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
 
 For more information on Halibut, including full details of the input
 file format, look in the full manual. If this is not installed


@@ -140,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/}
 
 
 \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.
 
 This man page isn't terribly complete.

-
-The HTML output isn't very good.
-
-Unicode handling is atrocious.