aboutsummaryrefslogtreecommitdiffstats
diff options
context:
space:
mode:
authorAlejandro Colomar <alx@kernel.org>2025-08-22 21:53:15 +0200
committerAlejandro Colomar <alx@kernel.org>2025-08-22 22:19:15 +0200
commitd58fd9181a331c605bd50fbdee13b162ff386905 (patch)
treecc58a604be6b17a2767acb649f0dc8f463638749
parent089c5b3b57095d9533d5efbc1c9a836103b32de8 (diff)
downloadman-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>
-rw-r--r--man/man4/smartpqi.42
-rw-r--r--man/man7/man-pages.78
-rw-r--r--man/man7/signal.74
3 files changed, 5 insertions, 9 deletions
diff --git a/man/man4/smartpqi.4 b/man/man4/smartpqi.4
index 5dd43d944c..33f1a6ec81 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 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}
diff --git a/man/man7/signal.7 b/man/man7/signal.7
index 48ced5264c..0d56e852f6 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