From ed74d52dc56cae1a6425d700c7ad68801b72050d Mon Sep 17 00:00:00 2001
From: Marc Espie <espie@cvs.openbsd.org>
Date: Sat, 1 Mar 2003 14:40:50 +0000
Subject: flesh out a bit more.

---
 gnu/usr.bin/groff/tbl/tbl.1 | 51 +++++++++++++++++++++++++++++++++++++++++----
 1 file changed, 47 insertions(+), 4 deletions(-)

diff --git a/gnu/usr.bin/groff/tbl/tbl.1 b/gnu/usr.bin/groff/tbl/tbl.1
index 75b51325358..bbf79bc75f3 100644
--- a/gnu/usr.bin/groff/tbl/tbl.1
+++ b/gnu/usr.bin/groff/tbl/tbl.1
@@ -1,4 +1,4 @@
-.\" $OpenBSD: tbl.1,v 1.2 2003/03/01 11:39:28 espie Exp $
+.\" $OpenBSD: tbl.1,v 1.3 2003/03/01 14:40:49 espie Exp $
 .\"
 .\" Copyright (c) 2003 Marc Espie
 .\"
@@ -172,9 +172,49 @@ alphabetic subcolumn.
 Corresponding entries are left-aligned, and set so that the widest is centered
 within the column.
 .It s or S
-spanned heading.
+spanned heading. 
+The entry for the previous column continues on this column.
 .It ^
-vertically spanned heading.
+vertically spanned heading. 
+The entry for the previous row continues on this row.
+.It _ or =
+horizontal rule, replacing the column entry.
+.Sq =
+creates a double rule.
+If an adjacent column also contains an horizontal rule or if there are
+vertical rules adjoing the column, the line is extended to meet the nearby
+lines.
+Any data entry for this column will be ignored and a warning message be
+printed.
+.It | or ||
+single or double vertical rule.
+.El
+.Pp
+Some extra features are available as modifiers
+.Bl -tag -width l
+.It "Inter-column spacing"
+A number may follow a column format.
+This number indicates the separation between the column and the next 
+column.
+The default number is 3.
+The unit used is ens 
+.Po
+one en is roughly the width of the letter
+.Sq n
+.Pc .
+.It "Non-centered vertical spanning"
+Vertically spanned  items are normally centered over the rows they span.
+If the column format is followed by t or T, the item will begin at the
+top line of the span.
+.It "Font changes"
+A string containing a font name or number preceded by f or F may be used
+to indicate that the corresponding column should be formatted in that font.
+In
+.Ux
+.Nm ,
+all font names are at most two letters long.
+The letters b, b, I, and i are synonyms for fB and fI.
+Individual data items within the table may override these specifications.
 .El
 .Ss TABLE DATA
 Each table line is normally entered as one line of data.
@@ -184,7 +224,7 @@ specified in the
 .Ar tabs
 option).
 There a few exceptions:
-.Bl -tag -width "Troff"
+.Bl -tag -width l
 .It "Embedded troff commands"
 An input line beginning with a
 .Sq .
@@ -257,6 +297,9 @@ should be aligned at the bottom.
 .Pp
 There are no arrbitrary limits on the number of columns or the number of
 text blocks in a table.
+.Sh BUGS
+This documentation is currently incomplete and only describes a subset of
+.Nm tbl .
 .Sh SEE ALSO
 .Xr eqn 1 ,
 .Xr nroff 1
-- 
cgit v1.2.3