term% cat index.txt TROFF2HTML(1) General Commands Manual TROFF2HTML(1)
NAME
troff2html - convert troff output into HTML
SYNOPSIS
troff2html [ -t title ] [ file ... ]
DESCRIPTION
Troff2html reads the troff(1) output in the named files, default stan‐
dard 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
x X html ...
which are introduced by placing \X'html ...' 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
which are used to create HTML hyperlinks around text of the form cp(1)
pointing to /magic/man2html/1/cp.
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 eas‐
ily confused by complex troff constructions. Troff2html has the re‐
verse 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.
TROFF2HTML(1)