Troff2html reads the
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 Plan 9s httpd(8)),
pages into HTML
and depends on a specially annotated set of
macros, invoked by
Troff output lines beginning
which are used to create HTML hyperlinks around text of the form
x X html ...
which are introduced by placing
\Xhtml ... in the
input, cause the rest of the line to be interpolated into the HTML produced.
Several such lines are recognized specially by
troff2html. The most important are the pair
x X html manref start cp 1
x X html manref end cp 1
Troff2html is new and experimental; in time, it may improve and subsume
On the one hand, because it uses the input,
ms2html can handle
troff2html does not handle at all; on the other hand,
ms2html understands only
documents and is easily confused by complex
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.