GROHTML(1)GROHTML(1)NAMEgrohtml - html driver for groff
SYNOPSISgrohtml [ -atvdgm? ] [ -Fdir ] [ -Iimagetype ] [ -rreso-
lution ] [ files... ]
DESCRIPTIONgrohtml translates the output of GNU troff to html. Nor-
mally grohtml should be invoked by using the groff command
with a -Thtml option. If no files are given, grohtml will
read the standard input. A filename of - will also cause
grohtml to read the standard input. Html output is writ-
ten to the standard output. When grohtml is run by groff
options can be passed to grohtml using the groff -P
option.
OPTIONS-a force grohtml to generate html line breaks in the
same position as troff dictates. Without this
option grohtml generates text in paragraphs which
is formatted by the html browser.
-d turn on internal debugging.
-g tell grohtml not to try and guess titles and head-
ings. By using this flag together with the -m and
-a flag grohtml will treat the html browser as a
printer, not as a formatter.
-m leave margins alone. grohtml will not remove left
margins.
-t forbids grohtml from generating html tables when
implementing indentation and tabular text. grohtml
can implement .IP by tables or html indents. How-
ever if .2C is used it can only be sensibly con-
verted to html using a table structure. As a few
known bugs still exist with the html table code
this option is present to supress execution of this
development code. The default in grohtml is that
html tables are generated when appropriate.
-Fdir Search the directory dir/devname for font and
device description files; name is the name of the
device, usually html.
-Iimagetype
select the type of image generated when grohtml
encounters an equation, table, or picture. By
default this is png256. Legal image types are: gif
and any of the png formats which are supported by
ghostscript gs(1).
Groff Version 1.15 8 March 2000 1
GROHTML(1)GROHTML(1)-rresolution
select the resolution for all images. By default
this is 80 pixels per inch. Example: -r100 indi-
cates 100 pixels per inch.
-v Print the version number.
-? Display usage.
USAGE
There are styles called R, I, B, and BI mounted at font
positions 1 to 4. It is advisable to invoke groff with
the -mhtml macro set, which turns off headers, footers,
and hyphenation; additionally, it will right justify text.
DEPENDENCIESgrohtml is dependent upon grops and gs. If grohtml has
been configured to generate gif files then it is further
dependent upon, ppmtogif, and ppmquant. However if it has
been configured to generate png files (the default) then
it is dependent upon gs having a png output device.
Images are generated whenever a table, picture, equation
or line is encountered.
BUGS
This is still very alpha. At least three major bugs
remain: Firstly, grohtml sometimes miscalculates the end
of an html table resulting in text which appears twice.
Secondly equation numbers are not handled correctly.
Thirdly equation macros and pic macros can confuse gro-
html.
SEE ALSOafmtodit(1), groff(1), troff(1), psbb(1), groff_out(5),
groff_font(5), groff_char(7)Groff Version 1.15 8 March 2000 2
