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>

diff --git a/man/man4/smartpqi.4 b/man/man4/smartpqi.4
index 5dd43d944c8bca7c2617a998ae1090bcb53c632c..33f1a6ec81a59248d70347b8244457d601407d48 100644 (file)
--- 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 6f76f173d9f9d42dab23512ed8506ddbcfa71327..7c85e9e11938a817d6d0cd3be1be0770effd4d66 100644 (file)
--- 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 48ced5264c452c277f7c1f9a4e888d5dd1d8f469..0d56e852f682285deb8e0d15aa96f001ab6517cb 100644 (file)
--- 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