Re: [Groff] Table cell vertical align

[Ralph Corderoy]

Hi Werner,

> > I think I learnt this from the list when I asked a few months ago.
> > See lines marked `->' and tbl(1).  [...]
> >
> >  -> l rd.
> >     ...
> >  -> \^;\^
>
> Very nice :-)  This tbl trick apparently escaped my radar, and I can't
> remember having seen it on the list.

http://lists.gnu.org/archive/html/groff/2012-04/msg00001.html was the
start of the brief thread, credit, as so often, to Tadziu for the
answer.  :-)

> Could you prepare a small patch to tbl.man which documents that?  It's
> far from obvious.

My last email in that thread summed up my understanding, here's a patch
based on that.  I think the main issue was the ambiguous parse of the
original;  I took it to mean that `d' alone was sufficient.  Feel free
to axe the example or otherwise edit as you prefer.

Cheers, Ralph.


--- tbl.1.orig  2012-09-11 10:39:50.000000000 +0100
+++ tbl.1       2012-09-11 10:55:15.000000000 +0100
@@ -393,8 +393,59 @@
 .
 .TP
 .BR d , D
-Start an item vertically spanning rows at the bottom of its range rather
+Start an item that vertically spans rows,
+using the `^' column specifier or `\[rs]^' data item,
+at the bottom of its range rather
 than vertically centering it (GNU tbl only).
+Example:
+.RS
+.IP
+.EX
+\&.TS
+\&tab(;) allbox;
+\&l ld
+\&r ^
+\&l rd.
+\&T{
+\&1
+\&.br
+\&2
+\&T};foo
+\&r;
+\&T{
+\&3
+\&.br
+\&4
+\&T};bar
+\&\^;\^
+\&.TE
+.EE
+.RE
+.
+.IP
+Result:
+.
+.RS
+.IP
+.TS
+tab(;) allbox;
+l ld
+r ^
+l rd.
+T{
+1
+.br
+2
+T};foo
+r;
+T{
+3
+.br
+4
+T};bar
+\^;\^
+.TE
+.RE
 .
 .TP
 .BR e , E