*nix Documentation Project
·  Home
 +   man pages
·  Linux HOWTOs
·  FreeBSD Tips
·  *niX Forums

  man pages->NetBSD man pages -> tbl (1)              



NAME    [Toc]    [Back]

       tbl - format tables for troff

SYNOPSIS    [Toc]    [Back]

       tbl [ -Cv ] [ files...  ]

DESCRIPTION    [Toc]    [Back]

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

OPTIONS    [Toc]    [Back]

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

       -v     Print the version number.

USAGE    [Toc]    [Back]

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

       Normally tbl attempts to prevent undesirable breaks in the
       table  by  using  diversions.  This can sometimes interact
       badly with macro packages' own  use  of  diversions,  when
       footnotes, for example, are used.  The nokeep 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  entry  should  be  aligned  at the bottom of its

       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.

BUGS    [Toc]    [Back]

       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  immediately  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

       The bp request cannot be used to force a page-break  in  a
       multi-page table.  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.

SEE ALSO    [Toc]    [Back]

       groff(1), troff(1)

Groff Version 1.16.1      April 8, 2001                    TBL(1)
[ Back ]
 Similar pages
Name OS Title
eqn FreeBSD format equations for troff
neqn OpenBSD format equations for troff
eqn OpenBSD format equations for troff
eqn Linux format equations for troff
eqn NetBSD format equations for troff
tbl HP-UX format tables for nroff
dmpxlt HP-UX dump iconv translation tables to a readable format
groff_diff FreeBSD differences between GNU troff and classical troff
pic NetBSD compile pictures for troff or TeX
pic OpenBSD compile pictures for troff or TeX
Copyright © 2004-2005 DeniX Solutions SRL
newsletter delivery service