@@ -2936,10 +2936,12 @@ legal (though ugly) pipe table:
2936The cells of pipe tables cannot contain block elements like paragraphs
2936The cells of pipe tables cannot contain block elements like paragraphs
2937and lists, and cannot span multiple lines. If a pipe table contains a
2937and lists, and cannot span multiple lines. If a pipe table contains a
2938row whose printable content is wider than the column width (see
2938row whose printable content is wider than the column width (see
2939+`--columns`), then the table will take up the full text width and
2939−`--columns`), then the cell contents will wrap, with the
2940+the cell contents will wrap, with the relative cell widths determined
2940−relative cell widths determined by the widths of the separator
2941+by the number of dashes in the line separating the table header from
2941−lines. (In this case, the table will take up the full text
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.)
2942−width.) If no lines are wider than column width, then
2944+On the other hand, if no lines are wider than column width, then
2943cell contents will not be wrapped, and the cells will be sized
2945cell contents will not be wrapped, and the cells will be sized
2944to their contents.
2946to their contents.