===================================================================
RCS file: /cvs/mandoc/tbl.7,v
retrieving revision 1.8
retrieving revision 1.10
diff -u -p -r1.8 -r1.10
--- mandoc/tbl.7	2011/01/10 14:40:30	1.8
+++ mandoc/tbl.7	2011/01/11 14:15:56	1.10
@@ -1,4 +1,4 @@
-.\"	$Id: tbl.7,v 1.8 2011/01/10 14:40:30 kristaps Exp $
+.\"	$Id: tbl.7,v 1.10 2011/01/11 14:15:56 kristaps Exp $
 .\"
 .\" Copyright (c) 2010 Kristaps Dzonsons <kristaps@bsd.lv>
 .\"
@@ -14,7 +14,7 @@
 .\" ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF
 .\" OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
 .\"
-.Dd $Mdocdate: January 10 2011 $
+.Dd $Mdocdate: January 11 2011 $
 .Dt TBL 7
 .Os
 .Sh NAME
@@ -209,17 +209,25 @@ Justify a number around its last decimal point.
 If the decimal point is not found on the number, it's assumed to trail
 the number.
 .It Cm s
-Span columns from the last non-span data cell.
+Horizontally span columns from the last non-
+.Ns Cm s
+data cell.
 It is an error if spanning columns follow a
 .Cm \-
 or
 .Cm \(ba
 cell, or come first.
+This option is not supported by
+.Xr mandoc 1 .
 .It Cm a
 Left-justify a literal string and pad with one space.
 .It Cm ^
-This option is not supported by
-.Xr mandoc 1 .
+Vertically span rows from the last non-
+.Ns Cm ^
+data cell.
+It is an error to invoke a vertical span on the first layout row.
+Unlike a horizontal spanner, you must specify an empty cell (if it not
+empty, the data is discarded) in the corresponding data cell.
 .It Cm \-
 Replace the data cell (its contents will be lost) with a single
 horizontal line.