Content-type: text/html Man page of tbl

tbl

Section: User Commands (1)
Index Return to Main Contents
 

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 formatting *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 [email protected] @[email protected] Bedminster@[email protected] Bernards Twp.@3087@3.74 [email protected]@3.30 Bound [email protected]@3.04 [email protected]@3.49 [email protected]@3.81 Far Hills@[email protected] .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). [email protected]@Description _ 0@@Successful completion. [email protected]@T{ Insufficient memory exists to create this object. Multiple lines can be written in text surrounded by T braces. T} [email protected]@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)


 

Index

NAME
SYNOPSIS
OPTIONS
DESCRIPTION
EXAMPLES
SEE ALSO

This document was created by man2html, using the manual pages.
Time: 02:42:52 GMT, October 02, 2010