GSP
Quick Navigator

Search Site

Unix VPS
A - Starter
B - Basic
C - Preferred
D - Commercial
MPS - Dedicated
Previous VPSs
* Sign Up! *

Support
Contact Us
Online Help
Handbooks
Domain Status
Man Pages

FAQ
Virtual Servers
Pricing
Billing
Technical

Network
Facilities
Connectivity
Topology Map

Miscellaneous
Server Agreement
Year 2038
Credits
 

USA Flag

 

 

Man Pages


Manual Reference Pages  -  TROFF2HTML (1)

NAME

troff2html - convert troff output into HTML

CONTENTS

Synopsis
Description
See Also
Bugs

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
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 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.

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.
Search for    or go to Top of page |  Section 1 |  Main Index


TROFF2HTML (1) -->

Powered by GSP Visit the GSP FreeBSD Man Page Interface.
Output converted with manServer 1.07.