glenda.party
term% ls -F
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)