c38da2b7 |
1 | \cfg{man-identity}{halibut}{1}{2004-04-08}{Halibut}{Simon Tatham} |
2 | \cfg{man-mindepth}{1} |
3 | |
4 | \A{manpage} Halibut \cw{man} page |
5 | |
6 | \H{manpage-name} NAME |
7 | |
8 | \cw{halibut} - multi-format documentation formatting tool |
9 | |
10 | \H{manpage-synopsis} SYNOPSIS |
11 | |
12 | \c halibut [options] file1.but [file2.but ...] |
13 | \e bbbbbbb iiiiiii iiiiiiiii iiiiiiiii |
14 | |
5ff1157f |
15 | \H{manpage-description} DESCRIPTION |
c38da2b7 |
16 | |
17 | \c{halibut} reads the given set of input files, assembles them into |
18 | a document, and outputs that document in one or more formats. |
19 | |
20 | The available command-line options can configure what formats |
21 | Halibut should output in, and can also configure other things about |
22 | the way Halibut works. |
23 | |
5ff1157f |
24 | \H{manpage-options} OPTIONS |
c38da2b7 |
25 | |
26 | The command-line options supported by \c{halibut} are: |
27 | |
28 | \dt \cw{--text}[\cw{=}\e{filename}] |
29 | |
30 | \dd Makes Halibut generate an output file in plain text format. If |
31 | the optional \e{filename} parameter is supplied, the output text |
32 | file will be given that name. Otherwise, the name of the output text |
33 | file will be as specified in the input files, or \c{output.txt} if |
34 | none is specified at all. |
35 | |
36 | \dt \cw{--html}[\cw{=}\e{filename}] |
37 | |
38 | \dd Makes Halibut generate one or more output files in HTML format. |
39 | If the optional \e{filename} parameter is supplied, there will be |
40 | precisely one HTML output file with that name, containing the whole |
41 | document. Otherwise, there may be one or more than one HTML file |
42 | produced as output; this, and the file names, will be as specified |
43 | in the input files, or given a set of default names starting with |
44 | \c{Contents.html} if none is specified at all. |
45 | |
46 | \dt \cw{--winhelp}[\cw{=}\e{filename}] |
47 | |
48 | \dd Makes Halibut generate an output file in Windows Help format. If |
49 | the optional \e{filename} parameter is supplied, the output help |
50 | file will be given that name. Otherwise, the name of the output help |
51 | file will be as specified in the input files, or \c{output.hlp} if |
52 | none is specified at all. |
53 | |
54 | \lcont{ |
55 | The output help file must have a name ending in \c{.hlp}; if it does |
56 | not, \c{.hlp} will be added. A secondary contents file will be created |
57 | alongside the main help file, with the same name except that it will |
58 | end in \c{.cnt} (for example \c{output.cnt}, if the main file is |
59 | \c{output.hlp}). |
60 | } |
61 | |
62 | \dt \cw{--man}[\cw{=}\e{filename}] |
63 | |
64 | \dd Makes Halibut generate an output file in Unix \cw{man} page |
65 | format. If the optional \e{filename} parameter is supplied, the |
66 | output \cw{man} page will be given that name. Otherwise, the name of |
67 | the output \cw{man} page will be as specified in the input files, or |
68 | \c{output.1} if none is specified at all. |
69 | |
70 | \dt \cw{-C}\e{word}\cw{:}\e{word}[\cw{:}\e{word}...] |
71 | |
72 | \dd Adds a configuration directive to the input processed by |
73 | Halibut. Using this directive is exactly equivalent to appending an |
74 | extra input file to the command line which contains the directive |
75 | \cw{\\cfg\{}\e{word}\cw{\}\{}\e{word}\cw{\}\{}\e{word}...\cw{\}}. |
76 | |
77 | \dt \cw{--precise} |
78 | |
79 | \dd Makes Halibut report the column number as well as the line |
80 | number when it encounters an error in an input file. |
81 | |
82 | \dt \cw{--help} |
83 | |
84 | \dd Makes Halibut display a brief summary of its command-line |
85 | options. |
86 | |
87 | \dt \cw{--version} |
88 | |
89 | \dd Makes Halibut report its version number. |
90 | |
91 | \dt \cw{--licence} |
92 | |
93 | \dd Makes Halibut display its licence (MIT). |
94 | |
5ff1157f |
95 | \H{putty-manpage-more-information} MORE INFORMATION |
c38da2b7 |
96 | |
97 | For more information on Halibut, including full details of the input |
98 | file format, look in the full manual. If this is not installed |
99 | locally on your system, you can also find it at the Halibut web site: |
100 | |
101 | \W{http://www.chiark.greenend.org.uk/~sgtatham/halibut/}\cw{http://www.chiark.greenend.org.uk/~sgtatham/halibut/} |
102 | |
5ff1157f |
103 | \H{putty-manpage-bugs} BUGS |
c38da2b7 |
104 | |
105 | This man page isn't terribly complete. |
106 | |
107 | The HTML output isn't very good. |
108 | |
109 | Unicode handling is atrocious. |
110 | |
111 | Several more output formats (PostScript, PDF, \cw{info}) are missing. |