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 con-
          fused 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

     Page 1                       Plan 9             (printed 3/29/24)

     TROFF2HTML(1)                                       TROFF2HTML(1)

          served in HTML, and the output of troff2html shows this.

     Page 2                       Plan 9             (printed 3/29/24)