2 Copyright (C) 1999-2000, 2001, 2002, 2003, 2004 Free Software Foundation, Inc.
4 Permission is granted to make and distribute verbatim copies of this
5 manual provided the copyright notice and this permission notice are
6 preserved on all copies.
8 Permission is granted to copy and distribute modified versions of this
9 manual under the conditions for verbatim copying, provided that the
10 entire resulting derived work is distributed under the terms of a
11 permission notice identical to this one.
13 Permission is granted to copy and distribute translations of this
14 manual into another language, under the above conditions for modified
15 versions, except that this permission notice may be included in
16 translations approved by the Free Software Foundation instead of in
21 .\" Like TP, but if specified indent is more than half
22 .\" the current line-length - indent, use the default indent.
24 . ie \\n(.$=0:((0\\$1)*2u>(\\n(.lu-\\n(.iu)) .TP
29 .TH GROHTML @MAN1EXT@ "@MDATE@" "Groff Version @VERSION@"
33 grohtml \- html driver for groff
45 . ie \\n(.$-1 .RI "[\ \fB\\$1\fP" "\\$2" "\ ]"
46 . el .RB "[\ " "\\$1" "\ ]"
54 .OP \-o \%image-vertical-offset
56 .OP \-a \%aa-text-bits
57 .OP \-g \%aa-graphic-bits
59 .RI "[\ " files\|.\|.\|. "\ ]"
67 front end (which consists of a preprocessor,
71 translates the output of GNU
74 Users should always invoke
76 via the groff command with a
79 If no files are given,
81 will read the standard input.
86 to read the standard input.
87 Html output is written to the standard output.
92 options can be passed to
103 Number of bits of antialiasing information to be used by
105 when generating png images.
106 The default is\~4 but valid values are 0, 1, 2, and\~4.
110 .B \%\-dTextAlphaBits
112 .B \%\-dGraphicAlphaBits
113 options in order to exploit antialiasing.
116 from issuing antialiasing commands to
120 .BI \-g aa-graphic-bits
121 Number of bits of antialiasing information to be used by
123 when generating png images.
124 The default is\~4 but valid values are 0, 1, 2, and\~4.
128 .B \%\-dTextAlphaBits
130 .B \%\-dGraphicAlphaBits
131 options in order to exploit antialiasing.
134 from issuing antialiasing commands to
139 Initialize the background color to white.
143 Generate section and number headings by using
145 and increasing the font size, rather than using the
153 Turn off the production of automatic section links at the top of the
158 Turn off the automatic header and footer line (html rule).
162 Set the base point size of the source file.
163 Thereafter when this point size is used in the source it will correspond
164 to the html base size.
165 Every increase of two points in the source will yield a
167 tag, and conversely when a decrease of two points is seen a
173 Generate simple heading anchors whenever a section/number heading is found.
174 Without the option the anchor value is the textual heading.
175 This can cause problems when a heading contains a `?' on older versions of
176 some browsers (Netscape).
177 This flag is automatically turned on if a heading contains an image.
181 Display page rendering progress to stderr.
183 only displays a page number when an image is required.
189 to the search path for font and device description files;
191 is the name of the device, usually
196 Select the resolution for all images.
197 By default this is 100 pixels per inch.
200 indicates 200 pixels per inch.
204 Determine the image stem name.
205 If omitted grohtml uses
211 .BI \-o vertical-offset
212 Specify the vertical offset of images in points.
218 to place all image files into directory
225 to split the html output into multiple files.
228 is the stem and all level one section headings start a new
230 .IR filename-n.html .
234 Print the version number.
238 There are styles called
244 mounted at font positions 1 to 4.
249 is dependent upon the png utilities
256 (version 2.37.6 or greater)
259 from the netpbm package (version 9.16 or greater) will work also.
260 It is also dependent upon
265 Images are generated whenever a table, picture, equation or line is
271 has been completely redesigned and rewritten.
272 It is still beta code.
276 .BR afmtodit (@MAN1EXT@),
277 .BR groff (@MAN1EXT@),
278 .BR @g@troff (@MAN1EXT@),
279 .BR psbb (@MAN1EXT@),
280 .BR groff_out (@MAN5EXT@),
281 .BR groff_font (@MAN5EXT@),
282 .BR groff_char (@MAN7EXT@)