TROFF2HTML(1) General Commands Manual TROFF2HTML(1)NAME
troff2html - convert troff documents to Hypertext Markup Language
SYNTAX
troff2html [ options ] file ... ]
DESCRIPTION
troff2html converts files written in the troff input language and converts them to Hypertext Markup Language (HTML). It works by running
the input files through troffcvt and then through tc2html and tc2html-toc.
troff2html understands the usual troffcvt options. It also understands the additional options listed below:
-D Enable debugging output.
-E Cause tc2html to echo token information to stderr as tokens are read from troffcvt.
-n No execution. Just show the commands that troff2html would execute to process the document.
-p Don't run the postprocessors (tc2html and tc2html-toc). The output from troff2html will be in the troffcvt output language.
-T title
Specify a title for the document. This can be used for documents that do not contain any recognizable title. If the document does
contain a title, it is overridden.
SEE ALSO troffcvt(1), tc2html(1)WHO-TO-BLAME
Paul DuBois, dubois@primate.wisc.edu.
BUGS
troff2html uses a set of special macros that tell troffcvt how to generate tc2html-specific output that tc2html uses to recognize HTML
structural elements. These macros do not work in compatibility mode.
TROFF2HTML(1)
Check Out this Related Man Page
TC2HTML-TOC(1) General Commands Manual TC2HTML-TOC(1)NAME
tc2html-toc - table of contents processor for tc2html
SYNTAX
tc2html-toc file ...
DESCRIPTION
tc2html is a postprocessor for troffcvt that produces Hypertext Markup Language (HTML). tc2html is capable of generating a table of con-
tents (TOC). However, since TOC entries cannot all be known until the entire input document has been read, tc2html writes the TOC near the
end of the HTML document.
To handle this problem, tc2html-toc examines tc2html output for a table of contents and moves it to the correct location. tc2html-toc is
invoked for your automatically if you use troff2html (which also invokes tc2html). If you run tc2html manually, you must also run tc2html-
toc manually.
tc2html and tc2html-toc cooperate by means of the following conventions. If tc2html writes a TOC, it surrounds them with the following two
HTML comments:
<!-- TOC BEGIN -->
<!-- TOC END -->
If the user wishes to explicitly specify a location for the TOC, this may be done by invoking the .H*toc*title request in the document.
This request writes a TOC title followed by this HTML comment:
<!-- INSERT TOC HERE -->
In addition, macro package redefinitions used with tc2html can make a guess about where the TOC should be located in the absence of an
explicit location marker. To do so, a redefinition can write the following advisory marker comment:
<!-- INSERT TOC HERE, MAYBE -->
For example, redefinitions for the -man macros can write an advisory location for the TOC after the .TH macro invocation has been seen.
Given these conventions, tc2html-toc reads the input and examines it for the TOC and TOC location. The input is written unchanged to the
output if no TOC is found. Otherwise, the locations listed below are used to reposition the TOC (with locations listed first taking prior-
ity):
o The position of the TOC location marker.
o The position of the advisory TOC location marker.
o The beginning of the <BODY> part of the document.
SEE ALSO troffcvt(1), tc2html(1), troff2html(1)WHO-TO-BLAME
Paul DuBois, dubois@primate.wisc.edu.
DIAGNOSTICS
tc2html-toc exits with an error if it discovers that the TOC location marker lies within the TOC itself.
TC2HTML-TOC(1)