[PATCH 7/8] man/man4/console_codes.4: ffix

["G. Branden Robinson" <g.branden.robinson@gmail.com>]

[-- Attachment #1: Type: text/plain, Size: 2977 bytes --]

Stop meddling with adjustment.

A lengthy comment in groff's man(7) package explains why attempts to
meddle with text alignment and adjustment with the `ad` and `na`
requests--outside of tbl(1) text blocks--exhibits contempt for reader
preferences and often comes to grief anyway.

.\" Resetting the adjustment mode is a complicated dance.
.\"   1.  Man pages sometimes disable adjustment--when they do, they
.\"       often forget to put it back the way it was.
.\"   2.  When they do remember to put it back, they often fail to do
.\"       so correctly because of the `ad` request's quirky semantics
.\"       starting from Seventh Edition Unix troff/nroff.  Briefly, the
.\"       `ad` request without arguments turns adjustment back on after
.\"       an `na` even if the previous adjustment mode was `l` (align to
.\"       the left with NO adjustment).
.\"   3.  The default adjustment mode historically has not been
.\"       predictable; it can depend on nroff vs. troff mode and on the
.\"       vendor of the *roff system in use.
.\"   4.  It's possible (and portable) to obtain the previous adjustment
.\"       mode via the `.j` register so that it can be saved prior to
.\"       meddling and restored later, but in practice man page authors
.\"       neglect to do so.
.\"   5.  groff man(7)'s `AD` string isn't supported everywhere.
.\"   6.  We want user preferences, if expressed, to override the page
.\"       author's.
.\"   7.  Even if we didn't want (6), one page author's can override
.\"       another's when formatting multiple man(7) documents in
.\"       sequence[.]

Signed-off-by: "G. Branden Robinson" <g.branden.robinson@gmail.com>
---
 man/man4/console_codes.4 | 6 ------
 1 file changed, 6 deletions(-)

diff --git a/man/man4/console_codes.4 b/man/man4/console_codes.4
index 2fd963128..04723c01e 100644
--- a/man/man4/console_codes.4
+++ b/man/man4/console_codes.4
@@ -124,7 +124,6 @@ .SS Linux console controls
 is equivalent to ESC [.
 .P
 .B "ESC- but not CSI-sequences"
-.ad l
 .P
 .TS
 l l lx.
@@ -201,7 +200,6 @@ .SS Linux console controls
 the red/green/blue values (0\[en]255).
 T}
 .TE
-.ad
 .P
 .B "ECMA-48 CSI sequences"
 .P
@@ -216,7 +214,6 @@ .SS Linux console controls
 (The idea is to ignore an echoed function key.)
 .P
 The action of a CSI sequence is determined by its final character.
-.ad l
 .P
 .TS
 l l lx.
@@ -322,7 +319,6 @@ .SS Linux console controls
 Move cursor to indicated column in current row.
 T}
 .TE
-.ad
 .P
 .B ECMA-48 Select Graphic Rendition
 .P
@@ -334,7 +330,6 @@ .SS Linux console controls
 semicolons.
 An empty parameter (between semicolons or string initiator or
 terminator) is interpreted as a zero.
-.ad l
 .P
 .TS
 l lx.
@@ -417,7 +412,6 @@ .SS Linux console controls
 set background, same as 40..47 (bright not supported)
 T}
 .TE
-.ad
 .P
 Commands 38 and 48 require further arguments:
 .P
-- 
2.30.2


[-- Attachment #2: signature.asc --]
[-- Type: application/pgp-signature, Size: 833 bytes --]