NAME    [Toc]    [Back]

       grohtml - html driver for groff

SYNOPSIS    [Toc]    [Back]

       grohtml  [ -atvdgm?  ] [ -Fdir ] [ -Iimagetype ] [ -rreso-
       lution ] [ files...  ]

DESCRIPTION    [Toc]    [Back]

       grohtml translates the output of GNU troff to html.   Normally
 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  written
  to the standard output.  When grohtml is run by groff
       options can be  passed  to  grohtml  using  the  groff  -P
       option.

OPTIONS    [Toc]    [Back]

       -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  headings.
   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.   However
  if  .2C  is used it can only be sensibly converted
 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).
       -rresolution
              select the resolution for all images.   By  default
              this  is  80 pixels per inch.  Example: -r100 indicates
 100 pixels per inch.

       -v     Print the version number.

       -?     Display usage.

USAGE    [Toc]    [Back]

       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.

DEPENDENCIES    [Toc]    [Back]

       grohtml 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    [Toc]    [Back]

       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 ALSO    [Toc]    [Back]

       afmtodit(1),  groff(1),  troff(1),  psbb(1), groff_out(5),
       groff_font(5), groff_char(7)


Groff Version 1.15         9 April 2000                         2