groff: grohtml

 
 7.8 'grohtml'
 =============
 
 The 'grohtml' front end (which consists of a preprocessor,
 'pre-grohtml', and a device driver, 'post-grohtml') translates the
 output of GNU 'troff' to HTML.  Users should always invoke 'grohtml' via
 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 'groff''s '-P' option.
 
    'grohtml' invokes 'groff' twice.  In the first pass, pictures,
 equations, and tables are rendered using the 'ps' device, and in the
 second pass HTML output is generated by the 'html' device.
 
    'grohtml' always writes output in 'UTF-8' encoding and has built-in
 entities for all non-composite unicode characters.  In spite of this,
 'groff' may issue warnings about unknown special characters if they
 can't be found during the first pass.  Such warnings can be safely
 ignored unless the special characters appear inside a table or equation,
 in which case glyphs for these characters must be defined for the 'ps'
 device as well.
 
    This output device is fully documented on its manual page,
 'grohtml(1)'.
 

Menu