Linux and UNIX Man Pages

Linux & Unix Commands - Search Man Pages

tblcvt(1) [linux man page]

TBLCVT(1)						      General Commands Manual							 TBLCVT(1)

NAME
tblcvt - troffcvt preprocessor to convert tbl-format tables SYNTAX
tblcvt [ file ] ... DESCRIPTION
tblcvt examines troff input for tables that would normally be processed by the tbl program, i.e., for lines bracketed by the .TS table start and .TE table end requests. tblcvt parses table specifications and data and converts it to a form that troffcvt can more easily han- dle. This is useful for document processing commands that use troffcvt, since troffcvt has knowledge only of the troff input language, and knows nothing of the tbl input language. tblcvt is a direct replacement for tbl. Suppose you would normally process a document using tbl and troff (or groff, etc.) like this: % tbl file ... | troff ... To format the document using tblcvt and troffcvt, use a command like this: % tblcvt file ... | troffcvt ... Actually, it's more likely that you'll be using one of the troffcvt front ends such as troff2html than that you'll be using troffcvt directly. troffcvt in the preceding command may be replaced by the name of the front end: % tblcvt file ... | troff2html ... If it seems that troffcvt or a front end are not reading the output from tblcvt , specify - after the option list to explicitly tell them to read the standard input after processing their other options: % tblcvt file ... | troffcvt ... - % tblcvt file ... | troff2html ... - DIAGNOSTICS
Diagnostic messages are written in this format: tblcvt:line l (table t, section s): message... This indicates that a problem was detected at line number l, and that tblcvt considers the line to be part of table number t and section s within the table. Section numbers start at one and are incremented for each .T& request that occurs within a table specification. SEE ALSO
troffcvt(1) tblcvt - A troffcvt Preprocessor WHO-TO-BLAME Paul DuBois, dubois@primate.wisc.edu. BUGS
For the most part, tblcvt assumes your tables make sense, i.e., are legal according to the tbl input language. tblcvt may complain about malformed table constructs (if it detects them), but it may also get confused by them and generate garbage output. tblcvt generates troff output that uses long request names, so you can't use compatibility mode -C ( option) with troffcvt or a troffcvt front end. tblcvt doesn't support vertically-spanned lines. It prints a warning when it detects one, but the table output won't be correct. TBLCVT(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)
Man Page