MANUAL: clarify pipe table width calculation (#4630)

closes #4520
This commit is contained in:
Mauro Bieg 2018-05-10 06:05:23 +02:00 committed by John MacFarlane
parent d30fbc2879
commit b502056104

View file

@ -2936,10 +2936,12 @@ legal (though ugly) pipe table:
The cells of pipe tables cannot contain block elements like paragraphs
and lists, and cannot span multiple lines. If a pipe table contains a
row whose printable content is wider than the column width (see
`--columns`), then the cell contents will wrap, with the
relative cell widths determined by the widths of the separator
lines. (In this case, the table will take up the full text
width.) If no lines are wider than column width, then
`--columns`), then the table will take up the full text width and
the cell contents will wrap, with the relative cell widths determined
by the number of dashes in the line separating the table header from
the table body. (For example `---|-` would make the first column 3/4
and the second column 1/4 of the full text width.)
On the other hand, if no lines are wider than column width, then
cell contents will not be wrapped, and the cells will be sized
to their contents.