Item5864: TablePlugin documentation needs better coverage of spans from header row

Priority:	CurrentState:	AppliesTo:	Component:	WaitingFor:
Low	Closed	Extension	TablePlugin

TablePlugin page describes rowspans as:

Table cells with a single caret indicate follow-up rows of multi-row spans. For example,

| One One | One Two | One Three |
| ^ | Two Two | Two Three |
| Three One | ^ | Three Three |

The docs don't say (or show) that header cells can also be spanned into the rows below.

The absence of this example bit us recently where I am employed. We upgraded TablePlugin and spans from the header row are failing. We could have caught this earlier if the example on the TablePlugin page had been more complete.

I recommend updating the example as

---++ Row Spans

Table cells with a single caret indicate follow-up rows of multi-row spans. For example,
<table width="100%"><tr><td>
<verbatim>
| *A* | *B* | *C* | *D* |
| ^ | One One | One Two | One Three |
| ^ | Two One | ^ | Two Three |
| ^ | Three One | Three Two | ^ |
</verbatim>
</td><td align="right">
| *A* | *B* | *C* | *D* |
| ^ | One One | One Two | One Three |
| ^ | Two One | ^ | Two Three |
| ^ | Three One | Three Two | ^ |
</td></tr></table>

NOTE - this example works on twiki.org. It current fails in develop.twiki.org. See Bugs/Item5865.

This bug report only concentrates on the documentation.

A	B	C	D
	One One	One Two	One Three
	Two One		Two Three
	Three One	Three Two

-- TWiki:Main/VickiBrown - 01 Aug 2008