Title

tlisthead -- Set up super-headers for tlist

Syntax

tlisthead row [, across(delimiter) up(delimiter) begin display]

where row is:

heading [delimiter heading] [...]

and where delimiter can be:

\ or | or one of the delimiters specified in across() or up()

[+] Note that spaces around delimters are considered part of the relevant headings.

Description

tlisthead iteratively sets up super-headings (and/or headings) for tlist:

o- The first time tlisthead is invoked, it sets up a single row of headers.

o- On each subsequent ivocation, it adds another row below the others.
(But see below for starting over)

o- The final placement of data columns below the headers is determined by tlist.

There are two possible delimiters to use, across and up. By default, across is \ and up is |, but they can be set in the options.

o- Both across and up separate one heading from the next within a row.

o- up also aligns with a delimiter in the previous (higher) row.

Any rows beyond the first must include exactly one up for each delmiter in the previous row.

tlisthead will 'start over' with the single specified row:

1) When using the begin option

2) When there are NO up delimiters, and that doesn't match the previous row.

Options

across(delimiter) specifies an across delimiter to use instead of the default \

up(delimiter) specifies an up delimiter to use instead of the default |

begin replaces any existing headings with the specified single row.

display shows the entire table of headings, as it would be used in a subsequent tlist.

Example

tlisthead a\ b \c
tlisthead a1\a2 | b1 | c1\c2\c3
tlist v1 v2 | v3 | v4 v5 | v6 | v7 | v8

Result:

a | b | c |
| | |
a1 | a2 | b1 | c1 | c2 | c3 |
| | | | | |
v1 | v2 | v3 | v4 | v5 | v6 | v7 | v8 |
-----+-----+-----+-----+-----+-----+-----+-----+
v11 | v21 | v31 | v41 | v51 | v61 | v71 | v81 |
v12 | v22 | v32 | v42 | v52 | v62 | v72 | v82 |