3 troff2html \- convert troff output into HTML
19 default standard input,
20 and converts them into HTML.
23 does a tolerable job with straight
25 output, but it is helped by annotations, described below.
33 and depends on a specially annotated set of
40 output lines beginning
46 which are introduced by placing
47 .B \eX'html\ \f1...\fP'
50 cause the rest of the line to be interpolated into the HTML produced.
51 Several such lines are recognized specially by
53 The most important are the pair
56 x X html manref start cp 1
57 x X html manref end cp 1
60 which are used to create HTML hyperlinks around text of the form
63 .BR /magic/man2html/1/cp .
66 is new and experimental; in time, it may improve and subsume
68 On the one hand, because it uses the input,
75 does not handle at all; on the other hand,
79 documents and is easily confused by complex
83 has the reverse properties: it does not handle the preprocessors but its output
84 is reliable and (modulo helper annotations) is independent of macro package.
86 .B /sys/src/cmd/troff2html
95 and HTML have different models, and they don't mesh well in all cases.
97 indented paragraphs are not well served in HTML, and the output of