|  | 
 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 Plan 9’s httpd(8)), which converts man(1) pages
    into HTML and depends on a specially annotated set of man(7) macros,
    invoked by troff −manhtml. 
    
    
    Troff output lines beginning 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
 
 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 Plan 9’s 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(7) 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.|  |  |  | x X html manref start cp 1 x X html manref end cp 1
 
 | 
 
 | 
 SEE ALSO    
 |  |  |  | troff(1), Plan 9’s ms2html(1), man2html in Plan 9’s 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. 
 | 
 |  |