diff options
Diffstat (limited to 'man/man1/tbl.html')
-rw-r--r-- | man/man1/tbl.html | 187 |
1 files changed, 187 insertions, 0 deletions
diff --git a/man/man1/tbl.html b/man/man1/tbl.html new file mode 100644 index 00000000..a50e8939 --- /dev/null +++ b/man/man1/tbl.html @@ -0,0 +1,187 @@ +<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> |