Linux and UNIX Man Pages

Linux & Unix Commands - Search Man Pages

tbl(1) [osf1 man page]

tbl(1)							      General Commands Manual							    tbl(1)

NAME
tbl - formats tables for nroff SYNOPSIS
tbl [file...] OPTIONS
Produces output without fractional line motions. You use this option when the destination output device or printer or post-filter cannot handle fractional line motions. Reads in ms macros prior to table formatting. Reads in the mm macros prior to table formatting, if your system has the *roff mm macros installed. DESCRIPTION
The tbl preprocessor is used for formatting tables for nroff. When you run tbl, the input files are copied to standard output, except for lines between the .TS (table start) and .TE (table end) command lines. All lines between the .TS and .TE command lines are assumed to describe a table and are reformatted. If no arguments are given, tbl reads from standard input, so it can be used as a filter. When tbl is used with neqn or other equation for- matting *roff tools, the tbl command should be invoked first to minimize the volume of data passed through the pipes. EXAMPLES
The following examples show tables that have been coded using tbl macros and the results after you run tbl to format the table. .TS tab(@); c s s c c s c c c l n n. Household Population Town@Households @Number@Size Bedminster@789@3.26 Bernards Twp.@3087@3.74 Bernardsville@2018@3.30 Bound Brook@3425@3.04 Branchburg@1644@3.49 Bridgewater@7897@3.81 Far Hills@240@3.19 .TE When formatted by tbl and then nroff, the output is as follows: Household Population Town Households Number Size Bedminster 789 3.26 Bernards Twp. 3087 3.74 Bernardsville 2018 3.30 Bound Brook 3425 3.04 Branchburg 1644 3.49 Bridgewater 7897 3.81 Far Hills 240 3.19 The following example shows how to specify column widths using the w column option. The width of a column must be large enough to contain it's anticipated data. Multiple line column entries are controlled by T{ and T}. .TS tab(@); cw(.5i) lw(1.2i) lw(3.0i). Return@Error@Description _ 0@@Successful completion. 1@ENOM@T{ Insufficient memory exists to create this object. Multiple lines can be written in text surrounded by T braces. T} 2@EINVAL@The value specified is invalid. .TE When formatted by tbl and then nroff, the output is as follows: Return Error Description _________________________________________________________________ 0 Successful completion. 1 ENOM Insufficient memory exists to create this object. Multiple lines can be written in text surrounded by T braces. 2 EINVAL The value specified is invalid. SEE ALSO
neqn(1), nroff(1), ms(5) tbl(1)

Check Out this Related Man Page

COLCRT(1)						    BSD General Commands Manual 						 COLCRT(1)

NAME
colcrt -- filter nroff output for CRT previewing SYNOPSIS
colcrt [-] [-2] [file ...] DESCRIPTION
The colcrt utility provides virtual half-line and reverse line feed sequences for terminals without such capability, and on which overstrik- ing is destructive. Half-line characters and underlining (changed to dashing `-') are placed on new lines in between the normal output lines. The following options are available: - Suppress all underlining. This option is especially useful for previewing allboxed tables from tbl(1). -2 Cause all half-lines to be printed, effectively double spacing the output. Normally, a minimal space output format is used which will suppress empty lines. The program never suppresses two consecutive empty lines, however. The -2 option is useful for sending output to the line printer when the output contains superscripts and subscripts which would otherwise be invisible. ENVIRONMENT
The LANG, LC_ALL and LC_CTYPE environment variables affect the execution of colcrt as described in environ(7). EXAMPLES
A typical use of colcrt would be tbl exum2.n | nroff -ms | colcrt - | more DIAGNOSTICS
The colcrt utility exits 0 on success, and >0 if an error occurs. SEE ALSO
col(1), more(1), nroff(1), troff(1), ul(1) BUGS
Should fold underlines onto blanks even with the '-' option so that a true underline character would show. Can't back up more than 102 lines. General overstriking is lost; as a special case '|' overstruck with '-' or underline becomes '+'. Lines are trimmed to 132 characters. Some provision should be made for processing superscripts and subscripts in documents which are already double-spaced. Characters that take up more than one column position may not be underlined correctly. HISTORY
The colcrt command appeared in 3.0BSD. BSD
July 31, 2004 BSD
Man Page