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

  man pages->Tru64 Unix man pages -> tbl (1)              
Title
Content
Arch
Section
 

tbl(1)

Contents


NAME    [Toc]    [Back]

       tbl - formats tables for nroff

SYNOPSIS    [Toc]    [Back]

       tbl [file...]

OPTIONS    [Toc]    [Back]

       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    [Toc]    [Back]

       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    [Toc]    [Back]

       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    [Toc]    [Back]

      
      
       neqn(1), nroff(1), ms(5)



                                                           tbl(1)
[ Back ]
 Similar pages
Name OS Title
tbl HP-UX format tables for nroff
term Tru64 Terminal driver tables for nroff
checknr Tru64 Checks nroff files
deroff HP-UX remove nroff, tbl, and neqn constructs
checknr HP-UX check nroff/troff files
nroff FreeBSD emulate nroff command with groff
checknr FreeBSD check nroff/troff files
colcrt FreeBSD filter nroff output for CRT previewing
soelim NetBSD eliminate .so's from nroff input
checknr NetBSD check nroff/troff files
Copyright © 2004-2005 DeniX Solutions SRL
newsletter delivery service