TROFF2HTML(1)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 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
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 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
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.