diff options
| author | Alejandro Colomar <alx@kernel.org> | 2025-08-22 21:53:15 +0200 |
|---|---|---|
| committer | Alejandro Colomar <alx@kernel.org> | 2025-08-22 22:19:15 +0200 |
| commit | d58fd9181a331c605bd50fbdee13b162ff386905 (patch) | |
| tree | cc58a604be6b17a2767acb649f0dc8f463638749 /man/man7/man-pages.7 | |
| parent | 089c5b3b57095d9533d5efbc1c9a836103b32de8 (diff) | |
| download | man-pages-d58fd9181a331c605bd50fbdee13b162ff386905.tar.gz | |
man/: ffix
On Fri, Aug 22, 2025 at 05:09:42PM +0200, Ingo Schwarze wrote:
> > .TS
> > l l l
> > ---
>
> That's terrible style.
>
> Using "-" in the tbl(7) layout only makes sense when the same layout
> line also contains at least one cell that receives data.
>
> A horizontal line that extends across the table as a whole
> should *not* get its own layout line but can be specified purely
> in the data section of the table. That's not only more robust,
> but also results in source code that is easier to read and maintain.
>
> The above is not just convention, but also makes sense logically
> and is related to the root cause of your earlier blank line woes.
> A table line that receives no data should not be specified in the
> layout because every layout line requires at least one data line,
> so a layout line receiving no data is an oxymoron, and that logical
> contradiction is precisely what causes the issue of needing a
> blank line in the first place.
>
> Note that in a layout line that only contains "-" for *some* cells,
> while at leat one cell receives data, the problem does not occur
> because the coressponding data line(s) do contain actual data
> for at least one cell, so they are not blank.
Reported-by: Ingo Schwarze <schwarze@openbsd.org>
Suggested-by: Ingo Schwarze <schwarze@openbsd.org>
Signed-off-by: Alejandro Colomar <alx@kernel.org>
Diffstat (limited to 'man/man7/man-pages.7')
| -rw-r--r-- | man/man7/man-pages.7 | 8 |
1 files changed, 2 insertions, 6 deletions
diff --git a/man/man7/man-pages.7 b/man/man7/man-pages.7 index 6f76f173d9..7c85e9e119 100644 --- a/man/man7/man-pages.7 +++ b/man/man7/man-pages.7 @@ -845,11 +845,9 @@ The following table lists some preferred terms to use in man pages, mainly to ensure consistency across pages. .ad l .TS -l l l ---- l l l. Term Avoid using Notes - +_ bit mask bitmask built-in builtin Epoch epoch T{ @@ -912,11 +910,9 @@ along with some suggested alternatives, mainly to ensure consistency across pages. .ad l .TS -l l l ---- l l l. Avoid Use instead Notes - +_ 32bit 32-bit T{ same for 8-bit, 16-bit, etc. T} |