unixdev.net


Switch to SpeakEasy.net DSL

The Modular Manual Browser

Home Page
Manual: (OSF1-V5.1-alpha)
Page:
Section:
Apropos / Subsearch:
optional field



tbl(1)								       tbl(1)



NAME

  tbl -	formats	tables for nroff

SYNOPSIS

  tbl [file...]

OPTIONS

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

  -ms Reads in ms macros prior to table	formatting.

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

   1.
	    .TS
	    tab(@);
	    c s	s
	    c c	s
	    c c	c
	    l n	n.
	    Household Population
	    Town@Households
	    @Number@Size
	    Bedminster@789AT3.26
	    Bernards Twp.@3087AT3.74
	    Bernardsville@2018AT3.30
	    Bound Brook@3425AT3.04
	    Branchburg@1644AT3.49
	    Bridgewater@7897AT3.81
	    Far	Hills@240AT3.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

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