From d58fd9181a331c605bd50fbdee13b162ff386905 Mon Sep 17 00:00:00 2001 From: Alejandro Colomar Date: Fri, 22 Aug 2025 21:53:15 +0200 Subject: [PATCH] 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 Suggested-by: Ingo Schwarze Signed-off-by: Alejandro Colomar --- man/man4/smartpqi.4 | 2 +- man/man7/man-pages.7 | 8 ++------ man/man7/signal.7 | 4 ++-- 3 files changed, 5 insertions(+), 9 deletions(-) diff --git a/man/man4/smartpqi.4 b/man/man4/smartpqi.4 index 5dd43d944..33f1a6ec8 100644 --- a/man/man4/smartpqi.4 +++ b/man/man4/smartpqi.4 @@ -89,9 +89,9 @@ The default action is .BR none . .TS l l ---- lB l. parameter action +_ none take controller offline only reboot reboot the system panic panic the system diff --git a/man/man7/man-pages.7 b/man/man7/man-pages.7 index 6f76f173d..7c85e9e11 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} diff --git a/man/man7/signal.7 b/man/man7/signal.7 index 48ced5264..0d56e852f 100644 --- a/man/man7/signal.7 +++ b/man/man7/signal.7 @@ -344,9 +344,9 @@ in the original POSIX.1-1990 standard; in SUSv2 and POSIX.1-2001. .TS l c c l -____ lB c c l. Signal Standard Action Comment +_ SIGABRT P1990 Core Abort signal from \f[B]abort\f[](3) SIGALRM P1990 Term Timer signal from \f[B]alarm\f[](2) SIGBUS P2001 Core Bus error (bad memory access) @@ -454,10 +454,10 @@ A dash (\-) denotes that a signal is absent on the corresponding architecture. .TS l c c c c l l c c c c l -______ lB c c c c l. Signal x86/ARM Alpha/ MIPS PARISC Notes most others SPARC +_ SIGHUP \01 \01 \01 \01 SIGINT \02 \02 \02 \02 SIGQUIT \03 \03 \03 \03 -- 2.47.3