NAME
troff2html – convert troff output into HTML |
SYNOPSIS
troff2html [ –t title ] [ file ... ] |
DESCRIPTION
Troff2html reads the troff(1) output in the named files, default
standard input, and converts them into HTML. Troff2html does a tolerable job with straight troff output, but it is helped by annotations, described below. Its main use is for man2html (see httpd(8)), which converts man(1) pages into HTML and depends on a specially annotated set of man(6) macros, invoked by troff –manhtml.
Troff output lines beginning
Troff2html is new and experimental; in time, it may improve and
subsume ms2html(1). On the one hand, because it uses the input,
ms2html can handle pic(1), eqn(1), etc., which troff2html does
not handle at all; on the other hand, ms2html understands only
ms(6) documents and is easily confused by complex
troff constructions. Troff2html has the reverse properties: it
does not handle the preprocessors but its output is reliable and
(modulo helper annotations) is independent of macro package. |
SOURCE
/sys/src/cmd/troff2html |
SEE ALSO
troff(1), ms2html(1), man2html in httpd(8). |
BUGS
Troff and HTML have different models, and they don't mesh well
in all cases. Troff's indented paragraphs are not well served
in HTML, and the output of troff2html shows this. |