diff options
| author | G. Branden Robinson <g.branden.robinson@gmail.com> | 2025-10-09 16:58:11 -0500 |
|---|---|---|
| committer | Alejandro Colomar <alx@kernel.org> | 2025-10-10 00:13:06 +0200 |
| commit | 5ad7c36ee44ff4abfb6252c63e9030b67fb45f68 (patch) | |
| tree | e61a62617c2fe1602bb8f627b5c78bf0ad44bc97 | |
| parent | e7d84606852298399e4450e8da4c3facb8159802 (diff) | |
| download | man-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.4 | 6 |
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 |
