Skip to content

Commit 46e6c13

Browse files
authored
clarify restrictions vs bad practice
1 parent 45af77b commit 46e6c13

File tree

1 file changed

+7
-3
lines changed

1 file changed

+7
-3
lines changed

doc/Language/tables.pod6

Lines changed: 7 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -32,7 +32,9 @@ illegal.
3232
3. The only valid row separator characters are V<'_'>, V<'-'>, V<'+'>, V<' '>,
3333
V<'|'>, and V<'='>.
3434
35-
4. Consecutive row separator lines are illegal (but only generate a warning).
35+
4. Consecutive interior row-separator lines are illegal.
36+
37+
5. Leading and trailing row-separator lines generate a warning.
3638
3739
=head1 Best Practices
3840
@@ -43,7 +45,9 @@ the problem.
4345
2. Align table columns and rows carefully. See the examples in later
4446
best practices.
4547
46-
3. For tables with a heading and single- or multi-line content, use
48+
3. Don't use visual borders on the table.
49+
50+
4. For tables with a heading and single- or multi-line content, use
4751
one or more contiguous equal signs (V<'='>) as the row separator after
4852
the heading, and use one or more contiguous hyphens (V<'-'>) as the row
4953
separator in the content portion of the table. For example,
@@ -226,7 +230,7 @@ r1c0 r0c1 r0c3
226230
=end table
227231
=end code
228232
229-
=item Two consecutive row separators are not allowed:
233+
=item Two consecutive interior row separators are not allowed:
230234
231235
=begin code :skip-test
232236
=begin table

0 commit comments

Comments
 (0)