aboutsummaryrefslogtreecommitdiffstats
diff options
context:
space:
mode:
authorG. Branden Robinson <g.branden.robinson@gmail.com>2025-10-09 16:58:11 -0500
committerAlejandro Colomar <alx@kernel.org>2025-10-10 00:13:06 +0200
commit5ad7c36ee44ff4abfb6252c63e9030b67fb45f68 (patch)
treee61a62617c2fe1602bb8f627b5c78bf0ad44bc97
parente7d84606852298399e4450e8da4c3facb8159802 (diff)
downloadman-pages-5ad7c36ee44ff4abfb6252c63e9030b67fb45f68.tar.gz
man/man4/console_codes.4: ffix
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> Message-ID: <20251009215811.3a6ughmxcskgae3s@illithid> Signed-off-by: Alejandro Colomar <alx@kernel.org>
-rw-r--r--man/man4/console_codes.46
1 files changed, 0 insertions, 6 deletions
diff --git a/man/man4/console_codes.4 b/man/man4/console_codes.4
index 2fd9631283..04723c01e7 100644
--- a/man/man4/console_codes.4
+++ b/man/man4/console_codes.4
@@ -124,7 +124,6 @@ CSI (0x9B)
is equivalent to ESC [.
.P
.B "ESC- but not CSI-sequences"
-.ad l
.P
.TS
l l lx.
@@ -201,7 +200,6 @@ indicates
the red/green/blue values (0\[en]255).
T}
.TE
-.ad
.P
.B "ECMA-48 CSI sequences"
.P
@@ -216,7 +214,6 @@ and this entire sequence is ignored.
(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 @@ u SCORC Restore cursor location.
Move cursor to indicated column in current row.
T}
.TE
-.ad
.P
.B ECMA-48 Select Graphic Rendition
.P
@@ -334,7 +330,6 @@ Several attributes can be set in the same sequence, separated by
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 @@ T}
set background, same as 40..47 (bright not supported)
T}
.TE
-.ad
.P
Commands 38 and 48 require further arguments:
.P