Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages


home | help
TBL(1)			    General Commands Manual			TBL(1)

       tbl - format tables for troff

       tbl [ -Cv ] [ files...  ]

       This manual page	describes the GNU version of tbl, which	is part	of the
       groff document formatting system.  tbl compiles descriptions of	tables
       embedded	 within	troff input files into commands	that are understood by
       troff.  Normally, it should be invoked using the	-t  option  of	groff.
       It is highly compatible with Unix tbl.  The output generated by GNU tbl
       cannot be processed with	Unix troff; it	must  be  processed  with  GNU
       troff.	If  no files are given on the command line, the	standard input
       will be read.  A	filename of - will cause  the  standard	 input	to  be

       -C     Recognize	 .TS  and  .TE even when followed by a character other
	      than space or newline.

       -v     Print the	version	number.

       Only the	differences between GNU	tbl and	Unix tbl are described here.

       Normally	tbl attempts to	prevent	undesirable breaks in the table	by us-
       ing diversions.	This can sometimes interact badly with macro packages'
       own use of diversions, when footnotes, for example, are used.  The  no-
       keep option tells tbl not to try	and prevent breaks in this way.

       The decimalpoint	option specifies the character to be recognized	as the
       decimal point character in place	of the default period.	 It  takes  an
       argument	 in  parentheses, which	must be	a single character, as for the
       tab option.

       The f format modifier can be followed by	an arbitrary length font  name
       in parentheses.

       There is	a d format modifier which means	that a vertically spanning en-
       try should be aligned at	the bottom of its range.

       There is	no limit on the	number of columns in a table, nor any limit on
       the  number of text blocks.  All	the lines of a table are considered in
       deciding	column widths, not just	the  first  200.   Table  continuation
       (.T&) lines are not restricted to the first 200 lines.

       Numeric and alphabetic items may	appear in the same column.

       Numeric and alphabetic items may	span horizontally.

       tbl  uses register, string, macro and diversion names beginning with 3.
       When using tbl you should avoid using any names beginning with a	3.

       You should use .TS H/.TH	in conjunction with a supporting macro package
       for  all	 multi-page boxed tables.  If there is no header that you wish
       to appear at the	top of each page of the	table, place the .TH line  im-
       mediately  after	the format section.  Do	not enclose a multi-page table
       within keep/release macros, or divert it	in any other way.

       A text block within a table must	be able	to fit on one page.

       The bp request cannot be	used to	force a	page-break in a	multi-page ta-
       ble.  Instead, define BP	as follows

	      .de BP
	      .ie '\\n(.z'' .bp	\\$1
	      .el \!.BP	\\$1

       and use BP instead of bp.

       Using  \a  directly  in	a table	to get leaders will not	work.  This is
       correct behaviour: \a is	a uninterpreted	leader.	 To get	leaders	use  a
       real leader, either by using a control A	or like	this:

	      .ds a \a
	      lw(1i) l.

       groff(1), troff(1)

Groff Version 1.17.2		 6 August 2001				TBL(1)


Want to link to this manual page? Use this URL:

home | help