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