| <head> |
| <title>tbl(1) - Plan 9 from User Space</title> |
| <meta content="text/html; charset=utf-8" http-equiv=Content-Type> |
| </head> |
| <body bgcolor=#ffffff> |
| <table border=0 cellpadding=0 cellspacing=0 width=100%> |
| <tr height=10><td> |
| <tr><td width=20><td> |
| <tr><td width=20><td><b>TBL(1)</b><td align=right><b>TBL(1)</b> |
| <tr><td width=20><td colspan=2> |
| <br> |
| <p><font size=+1><b>NAME </b></font><br> |
| |
| <table border=0 cellpadding=0 cellspacing=0><tr height=2><td><tr><td width=20><td> |
| |
| tbl – format tables for nroff or troff<br> |
| |
| </table> |
| <p><font size=+1><b>SYNOPSIS </b></font><br> |
| |
| <table border=0 cellpadding=0 cellspacing=0><tr height=2><td><tr><td width=20><td> |
| |
| <tt><font size=+1>tbl</font></tt> [ <i>file ...</i> ]<br> |
| |
| </table> |
| <p><font size=+1><b>DESCRIPTION </b></font><br> |
| |
| <table border=0 cellpadding=0 cellspacing=0><tr height=2><td><tr><td width=20><td> |
| |
| <i>Tbl</i> is a preprocessor for formatting tables for <i>nroff</i> or <a href="../man1/troff.html"><i>troff</i>(1)</a>. |
| The input <i>files</i> are copied to the standard output, except for |
| segments of the form<br> |
| |
| <table border=0 cellpadding=0 cellspacing=0><tr height=2><td><tr><td width=20><td> |
| |
| <tt><font size=+1>.TS <br> |
| </font></tt><i>options</i> <tt><font size=+1>;<br> |
| </font></tt><i>format</i> <tt><font size=+1>.<br> |
| </font></tt><i>data <br> |
| </i><tt><font size=+1>.T& <br> |
| </font></tt><i>format</i> <tt><font size=+1>.<br> |
| </font></tt><i>data <br> |
| </i>. . .<br> |
| <tt><font size=+1>.TE <br> |
| |
| <table border=0 cellpadding=0 cellspacing=0><tr height=5><td></table> |
| </font></tt> |
| |
| </table> |
| which describe tables and are replaced by <i>troff</i> requests to lay |
| out the tables. If no arguments are given, <i>tbl</i> reads the standard |
| input. |
| <table border=0 cellpadding=0 cellspacing=0><tr height=5><td></table> |
| |
| The (optional) <i>options</i> line is terminated by a semicolon and contains |
| one or more of<br> |
| |
| <table border=0 cellpadding=0 cellspacing=0><tr height=2><td><tr><td width=20><td> |
| |
| <tt><font size=+1>center</font></tt> center the table; default is left-adjust<br> |
| <tt><font size=+1>expand</font></tt> make table as wide as current line length<br> |
| <tt><font size=+1>box<br> |
| doublebox</font></tt> enclose the table in a box or double box<br> |
| <tt><font size=+1>allbox</font></tt> enclose every item in a box<br> |
| <tt><font size=+1>tab(</font></tt><i>x</i><tt><font size=+1>)</font></tt> use <i>x</i> to separate input items; default is tab<br> |
| <tt><font size=+1>linesize(</font></tt><i>n</i><tt><font size=+1>)</font></tt> set rules in <i>n</i>-point type<br> |
| <tt><font size=+1>delim(</font></tt><i>xy</i><tt><font size=+1>)</font></tt> recognize <i>x</i> and <i>y</i> as <a href="../man1/eqn.html"><i>eqn</i>(1)</a> delimiters<br> |
| |
| <table border=0 cellpadding=0 cellspacing=0><tr height=5><td></table> |
| |
| |
| </table> |
| Each line, except the last, of the obligatory <i>format</i> describes |
| one row of the table. The last line describes all rows until the |
| next <tt><font size=+1>.T&</font></tt>, where the format changes, or the end of the table at |
| <tt><font size=+1>.TE</font></tt>. A format is specified by key letters, one per column, either |
| upper or lower case:<br> |
| |
| <table border=0 cellpadding=0 cellspacing=0><tr height=2><td><tr><td width=20><td> |
| |
| <tt><font size=+1>L</font></tt> Left justify: the default for columns without format keys.<br> |
| <tt><font size=+1>R</font></tt> Right justify.<br> |
| <tt><font size=+1>C</font></tt> Center.<br> |
| <tt><font size=+1>N</font></tt> Numeric: align at decimal point (inferred for integers) or at |
| <tt><font size=+1>\&</font></tt>.<br> |
| <tt><font size=+1>S</font></tt> Span: extend previous column across this one.<br> |
| <tt><font size=+1>A</font></tt> Alphabetic: left-aligned within column, widest item centered, |
| indented relative to <tt><font size=+1>L</font></tt> rows.<br> |
| <tt><font size=+1>^</font></tt> Vertical span: continue item from previous row into this row.<br> |
| <tt><font size=+1>−</font></tt> Draw a horizontal rule in this column.<br> |
| <tt><font size=+1>=</font></tt> Draw a double horizontal rule in this column.<br> |
| |
| <table border=0 cellpadding=0 cellspacing=0><tr height=5><td></table> |
| |
| |
| </table> |
| Key letters may be followed by modifiers, also either case:<br> |
| |
| <table border=0 cellpadding=0 cellspacing=0><tr height=2><td><tr><td width=20><td> |
| |
| <tt><font size=+1>|</font></tt> Draw vertical rule between columns.<br> |
| <tt><font size=+1>||</font></tt> Draw a double vertical rule between columns.<br> |
| <i>n</i> Gap between column is <i>n</i> ens wide. Default is 3.<br> |
| <tt><font size=+1>F</font></tt><i>font</i> Use specified <i>font</i>. <tt><font size=+1>B</font></tt> and <tt><font size=+1>I</font></tt> mean <tt><font size=+1>FB</font></tt> and <tt><font size=+1>FI</font></tt>.<br> |
| <tt><font size=+1>T</font></tt> Begin vertically-spanned item at top row of range; default is |
| vertical centering (with <tt><font size=+1>^</font></tt>).<br> |
| <tt><font size=+1>P</font></tt><i>n</i> Use point size <i>n</i>.<br> |
| <tt><font size=+1>V</font></tt><i>n</i> Use <i>n</i>-point vertical spacing in text block; signed <i>n</i> means relative |
| change.<br> |
| <tt><font size=+1>W(</font></tt><i>n</i><tt><font size=+1>)</font></tt> Column width as a <i>troff</i> width specification. Parens are optional |
| if <i>n</i> is a simple integer.<br> |
| <tt><font size=+1>E</font></tt> Equalize the widths of all columns marked <tt><font size=+1>E</font></tt>.<br> |
| |
| <table border=0 cellpadding=0 cellspacing=0><tr height=5><td></table> |
| |
| |
| </table> |
| Each line of <i>data</i> becomes one row of the table; tabs separate |
| items. Lines beginning with <tt><font size=+1>.</font></tt> are <i>troff</i> requests. Certain special |
| data items are recognized:<br> |
| |
| <table border=0 cellpadding=0 cellspacing=0><tr height=2><td><tr><td width=20><td> |
| |
| <tt><font size=+1>_</font></tt> Draw a horizontal rule in this column.<br> |
| <tt><font size=+1>=</font></tt> Draw a double horizontal rule in this column. A data line consisting |
| of a single <tt><font size=+1>_</font></tt> or <tt><font size=+1>=</font></tt> draws the rule across the whole table.<br> |
| <tt><font size=+1>\_</font></tt> Draw a rule only as wide as the contents of the column.<br> |
| <tt><font size=+1>\R</font></tt><i>x</i> Repeat character <i>x</i> across the column.<br> |
| <tt><font size=+1>\^</font></tt> Span the previous item in this column down into this row.<br> |
| <tt><font size=+1>T{</font></tt> The item is a text block to be separately formatted by <i>troff</i> |
| and placed in the table. The block continues to the next line |
| beginning with <tt><font size=+1>T}</font></tt>. The remainder of the data line follows at that |
| point.<br> |
| |
| <table border=0 cellpadding=0 cellspacing=0><tr height=5><td></table> |
| |
| |
| </table> |
| When it is used in a pipeline with <i>eqn</i>, the <i>tbl</i> command should |
| be first, to minimize the volume of data passed through pipes.<br> |
| |
| </table> |
| <p><font size=+1><b>EXAMPLES </b></font><br> |
| |
| <table border=0 cellpadding=0 cellspacing=0><tr height=2><td><tr><td width=20><td> |
| |
| Let <tab> represent a tab (which should be typed as a genuine tab).<br> |
| <tt><font size=+1>.TS<br> |
| c s s<br> |
| c c s<br> |
| c c c<br> |
| l n n.<br> |
| Household Population<br> |
| Town</font></tt><tab><tt><font size=+1>Households<br> |
| </font></tt><tab><tt><font size=+1>Number</font></tt><tab><tt><font size=+1>Size<br> |
| </font></tt> |
| </table> |
| Bedminster<tab>789<tab>3.26<br> |
| Bernards Twp.<tab>3087<tab>3.74<br> |
| Bernardsville<tab>2018<tab>3.30<br> |
| .TE<br> |
| <br> |
| <br> |
| <br> |
| c s s<br> |
| c c s<br> |
| c c c<br> |
| l n n.<br> |
| Household Population<br> |
| Town Households<br> |
| Number Size<br> |
| Bedminster 789 3.26<br> |
| Bernards Twp. 3087 3.74<br> |
| Bernardsville 2018 3.30<br> |
| <td width=20> |
| <tr height=20><td> |
| </table> |
| <!-- TRAILER --> |
| <table border=0 cellpadding=0 cellspacing=0 width=100%> |
| <tr height=15><td width=10><td><td width=10> |
| <tr><td><td> |
| <center> |
| <a href="../../"><img src="../../dist/spaceglenda100.png" alt="Space Glenda" border=1></a> |
| </center> |
| </table> |
| <!-- TRAILER --> |
| </body></html> |
