* [PATCH 1/8] man/man4/console_codes.4: Document codes better
2025-10-09 21:53 [PATCH 0/8] man/man4/console_codes.4: content and style fixes G. Branden Robinson
@ 2025-10-09 21:57 ` G. Branden Robinson
2025-10-09 21:57 ` [PATCH 2/8] man/man4/console_codes.4: ffix G. Branden Robinson
` (7 subsequent siblings)
8 siblings, 0 replies; 14+ messages in thread
From: G. Branden Robinson @ 2025-10-09 21:57 UTC (permalink / raw)
To: Alejandro Colomar; +Cc: linux-man
[-- Attachment #1: Type: text/plain, Size: 847 bytes --]
Document the names of the "ESC s" and "ESC u" extension controls.
See
<https://invisible-island.net/xterm/ctlseqs/ctlseqs.html#\
h3-Functions-using-CSI-_-ordered-by-the-final-character_s_>.
Signed-off-by: "G. Branden Robinson" <g.branden.robinson@gmail.com>
---
man/man4/console_codes.4 | 4 ++--
1 file changed, 2 insertions(+), 2 deletions(-)
diff --git a/man/man4/console_codes.4 b/man/man4/console_codes.4
index d1dffda65..e4fa71422 100644
--- a/man/man4/console_codes.4
+++ b/man/man4/console_codes.4
@@ -306,8 +306,8 @@ .SS Linux console controls
Set scrolling region;
parameters are top and bottom row.
T}
-s ? Save cursor location.
-u ? Restore cursor location.
+s SCOSC Save cursor location.
+u SCORC Restore cursor location.
\` HPA T{
Move cursor to indicated column in current row.
T}
--
2.30.2
[-- Attachment #2: signature.asc --]
[-- Type: application/pgp-signature, Size: 833 bytes --]
^ permalink raw reply related [flat|nested] 14+ messages in thread* [PATCH 2/8] man/man4/console_codes.4: ffix
2025-10-09 21:53 [PATCH 0/8] man/man4/console_codes.4: content and style fixes G. Branden Robinson
2025-10-09 21:57 ` [PATCH 1/8] man/man4/console_codes.4: Document codes better G. Branden Robinson
@ 2025-10-09 21:57 ` G. Branden Robinson
2025-10-09 21:57 ` [PATCH 3/8] " G. Branden Robinson
` (6 subsequent siblings)
8 siblings, 0 replies; 14+ messages in thread
From: G. Branden Robinson @ 2025-10-09 21:57 UTC (permalink / raw)
To: Alejandro Colomar; +Cc: linux-man
[-- Attachment #1: Type: text/plain, Size: 1938 bytes --]
Consistently put inter-paragraph space before tables.
Signed-off-by: "G. Branden Robinson" <g.branden.robinson@gmail.com>
---
man/man4/console_codes.4 | 9 +++++++++
1 file changed, 9 insertions(+)
diff --git a/man/man4/console_codes.4 b/man/man4/console_codes.4
index e4fa71422..64d914d7f 100644
--- a/man/man4/console_codes.4
+++ b/man/man4/console_codes.4
@@ -125,6 +125,7 @@ .SS Linux console controls
.P
.B "ESC- but not CSI-sequences"
.ad l
+.P
.TS
l l lx.
ESC c RIS Reset.
@@ -208,6 +209,7 @@ .SS Linux console controls
.P
The action of a CSI sequence is determined by its final character.
.ad l
+.P
.TS
l l lx.
@ ICH T{
@@ -325,6 +327,7 @@ .SS Linux console controls
An empty parameter (between semicolons or string initiator or
terminator) is interpreted as a zero.
.ad l
+.P
.TS
l lx.
param result
@@ -409,6 +412,7 @@ .SS Linux console controls
.ad
.P
Commands 38 and 48 require further arguments:
+.P
.TS
l lx.
;5;x T{
@@ -514,6 +518,7 @@ .SS Linux console controls
6 = cyan,
7 = white;
8\[en]15 = bright versions of 0\[en]7.
+.P
.TS
l lx.
ESC [ 1 ; \f[I]n\f[] ] T{
@@ -692,6 +697,7 @@ .SS Comparisons with other terminals
.B Escape sequences
.P
VT100 console sequences not implemented on the Linux console:
+.P
.TS
l l l.
ESC N SS2 T{
@@ -735,6 +741,7 @@ .SS Comparisons with other terminals
accepts a BEL to terminate an OSC string.
These are a few of the OSC control sequences recognized by
.BR xterm (1):
+.P
.TS
l l.
ESC ] 0 ; \f[I]txt\f[] ST T{
@@ -755,6 +762,7 @@ .SS Comparisons with other terminals
.P
It recognizes the following with slightly modified meaning
(saving more state, behaving closer to VT100/VT220):
+.P
.TS
l l l.
ESC 7 DECSC Save cursor
@@ -762,6 +770,7 @@ .SS Comparisons with other terminals
.TE
.P
It also recognizes
+.P
.TS
l l lx.
ESC F T{
--
2.30.2
[-- Attachment #2: signature.asc --]
[-- Type: application/pgp-signature, Size: 833 bytes --]
^ permalink raw reply related [flat|nested] 14+ messages in thread* [PATCH 3/8] man/man4/console_codes.4: ffix
2025-10-09 21:53 [PATCH 0/8] man/man4/console_codes.4: content and style fixes G. Branden Robinson
2025-10-09 21:57 ` [PATCH 1/8] man/man4/console_codes.4: Document codes better G. Branden Robinson
2025-10-09 21:57 ` [PATCH 2/8] man/man4/console_codes.4: ffix G. Branden Robinson
@ 2025-10-09 21:57 ` G. Branden Robinson
2025-10-09 21:57 ` [PATCH 4/8] " G. Branden Robinson
` (5 subsequent siblings)
8 siblings, 0 replies; 14+ messages in thread
From: G. Branden Robinson @ 2025-10-09 21:57 UTC (permalink / raw)
To: Alejandro Colomar; +Cc: linux-man
[-- Attachment #1: Type: text/plain, Size: 1509 bytes --]
Put lengthy table entries into tbl(1) text blocks, so that they don't
cause output lines to overset.
Signed-off-by: "G. Branden Robinson" <g.branden.robinson@gmail.com>
---
man/man4/console_codes.4 | 14 ++++++++++----
1 file changed, 10 insertions(+), 4 deletions(-)
diff --git a/man/man4/console_codes.4 b/man/man4/console_codes.4
index 64d914d7f..77ccca369 100644
--- a/man/man4/console_codes.4
+++ b/man/man4/console_codes.4
@@ -131,7 +131,9 @@ .SS Linux console controls
ESC c RIS Reset.
ESC D IND Linefeed.
ESC E NEL Newline.
-ESC H HTS Set tab stop at current column.
+ESC H HTS T{
+Set tab stop at current column.
+T}
ESC M RI Reverse linefeed.
ESC Z DECID T{
DEC private identification.
@@ -148,7 +150,9 @@ .SS Linux console controls
Restore state most recently saved by ESC 7.
T}
ESC % Start sequence selecting character set
-ESC % @ \0\0\0Select default (ISO/IEC\~646 / ISO/IEC\~8859-1)
+ESC % @ T{
+\0\0\0Select default (ISO/IEC\~646 / ISO/IEC\~8859-1)
+T}
ESC % G \0\0\0Select UTF-8
ESC % 8 \0\0\0Select UTF-8 (obsolete)
ESC # 8 DECALN T{
@@ -780,8 +784,10 @@ .SS Comparisons with other terminals
.B hpLowerleftBugCompat
resource).
T}
-ESC l Memory lock (per HP terminals).
- Locks memory above the cursor.
+ESC l T{
+Memory lock (per HP terminals).
+Locks memory above the cursor.
+T}
ESC m Memory unlock (per HP terminals).
ESC n LS2 Invoke the G2 character set.
ESC o LS3 Invoke the G3 character set.
--
2.30.2
[-- Attachment #2: signature.asc --]
[-- Type: application/pgp-signature, Size: 833 bytes --]
^ permalink raw reply related [flat|nested] 14+ messages in thread* [PATCH 4/8] man/man4/console_codes.4: ffix
2025-10-09 21:53 [PATCH 0/8] man/man4/console_codes.4: content and style fixes G. Branden Robinson
` (2 preceding siblings ...)
2025-10-09 21:57 ` [PATCH 3/8] " G. Branden Robinson
@ 2025-10-09 21:57 ` G. Branden Robinson
2025-10-09 21:57 ` [PATCH 5/8] man/man4/console_codes.4: wfix G. Branden Robinson
` (4 subsequent siblings)
8 siblings, 0 replies; 14+ messages in thread
From: G. Branden Robinson @ 2025-10-09 21:57 UTC (permalink / raw)
To: Alejandro Colomar; +Cc: linux-man
[-- Attachment #1: Type: text/plain, Size: 1136 bytes --]
Use a more idiomatic means (than numeral-width horizontal motion escape
sequences `\0`) of setting table entries that are indented with respect
to other entries in the same column.
Use table region continuation (`.T&`) and the `A` column classifier.
See tbl(1).
Signed-off-by: "G. Branden Robinson" <g.branden.robinson@gmail.com>
---
man/man4/console_codes.4 | 10 +++++++---
1 file changed, 7 insertions(+), 3 deletions(-)
diff --git a/man/man4/console_codes.4 b/man/man4/console_codes.4
index 77ccca369..4ef23a4bd 100644
--- a/man/man4/console_codes.4
+++ b/man/man4/console_codes.4
@@ -150,11 +150,15 @@ .SS Linux console controls
Restore state most recently saved by ESC 7.
T}
ESC % Start sequence selecting character set
+.T&
+l l ax.
ESC % @ T{
-\0\0\0Select default (ISO/IEC\~646 / ISO/IEC\~8859-1)
+Select default (ISO/IEC\~646 / ISO/IEC\~8859-1)
T}
-ESC % G \0\0\0Select UTF-8
-ESC % 8 \0\0\0Select UTF-8 (obsolete)
+ESC % G Select UTF-8
+ESC % 8 Select UTF-8 (obsolete)
+.T&
+l l lx.
ESC # 8 DECALN T{
DEC screen alignment test \- fill screen with E's.
T}
--
2.30.2
[-- Attachment #2: signature.asc --]
[-- Type: application/pgp-signature, Size: 833 bytes --]
^ permalink raw reply related [flat|nested] 14+ messages in thread* [PATCH 5/8] man/man4/console_codes.4: wfix
2025-10-09 21:53 [PATCH 0/8] man/man4/console_codes.4: content and style fixes G. Branden Robinson
` (3 preceding siblings ...)
2025-10-09 21:57 ` [PATCH 4/8] " G. Branden Robinson
@ 2025-10-09 21:57 ` G. Branden Robinson
2025-10-09 21:58 ` [PATCH 6/8] man/man4/console_codes.4: ffix G. Branden Robinson
` (3 subsequent siblings)
8 siblings, 0 replies; 14+ messages in thread
From: G. Branden Robinson @ 2025-10-09 21:57 UTC (permalink / raw)
To: Alejandro Colomar; +Cc: linux-man
[-- Attachment #1: Type: text/plain, Size: 650 bytes --]
Spell out column heading as "parmeter"; "param" is a false economy given
that one of the entries in the same column is "100..107" (only one en
shorter).
Signed-off-by: "G. Branden Robinson" <g.branden.robinson@gmail.com>
---
man/man4/console_codes.4 | 2 +-
1 file changed, 1 insertion(+), 1 deletion(-)
diff --git a/man/man4/console_codes.4 b/man/man4/console_codes.4
index 4ef23a4bd..d258e9888 100644
--- a/man/man4/console_codes.4
+++ b/man/man4/console_codes.4
@@ -338,7 +338,7 @@ .SS Linux console controls
.P
.TS
l lx.
-param result
+parameter result
0 T{
reset all attributes to their defaults
T}
--
2.30.2
[-- Attachment #2: signature.asc --]
[-- Type: application/pgp-signature, Size: 833 bytes --]
^ permalink raw reply related [flat|nested] 14+ messages in thread* [PATCH 6/8] man/man4/console_codes.4: ffix
2025-10-09 21:53 [PATCH 0/8] man/man4/console_codes.4: content and style fixes G. Branden Robinson
` (4 preceding siblings ...)
2025-10-09 21:57 ` [PATCH 5/8] man/man4/console_codes.4: wfix G. Branden Robinson
@ 2025-10-09 21:58 ` G. Branden Robinson
2025-10-09 21:58 ` [PATCH 7/8] " G. Branden Robinson
` (2 subsequent siblings)
8 siblings, 0 replies; 14+ messages in thread
From: G. Branden Robinson @ 2025-10-09 21:58 UTC (permalink / raw)
To: Alejandro Colomar; +Cc: linux-man
[-- Attachment #1: Type: text/plain, Size: 781 bytes --]
Add missing `x` column modifier to the descriptive column of the "VT100
console sequences not implemented on the Linux console" table, making it
format like all the other tables in this man page.
Signed-off-by: "G. Branden Robinson" <g.branden.robinson@gmail.com>
---
man/man4/console_codes.4 | 2 +-
1 file changed, 1 insertion(+), 1 deletion(-)
diff --git a/man/man4/console_codes.4 b/man/man4/console_codes.4
index d258e9888..2fd963128 100644
--- a/man/man4/console_codes.4
+++ b/man/man4/console_codes.4
@@ -707,7 +707,7 @@ .SS Comparisons with other terminals
VT100 console sequences not implemented on the Linux console:
.P
.TS
-l l l.
+l l lx.
ESC N SS2 T{
Single shift 2.
(Select G2 character set for the next character only.)
--
2.30.2
[-- Attachment #2: signature.asc --]
[-- Type: application/pgp-signature, Size: 833 bytes --]
^ permalink raw reply related [flat|nested] 14+ messages in thread* [PATCH 7/8] man/man4/console_codes.4: ffix
2025-10-09 21:53 [PATCH 0/8] man/man4/console_codes.4: content and style fixes G. Branden Robinson
` (5 preceding siblings ...)
2025-10-09 21:58 ` [PATCH 6/8] man/man4/console_codes.4: ffix G. Branden Robinson
@ 2025-10-09 21:58 ` G. Branden Robinson
2025-10-09 21:58 ` [PATCH 8/8] " G. Branden Robinson
2025-10-09 22:17 ` [PATCH 0/8] man/man4/console_codes.4: content and style fixes Alejandro Colomar
8 siblings, 0 replies; 14+ messages in thread
From: G. Branden Robinson @ 2025-10-09 21:58 UTC (permalink / raw)
To: Alejandro Colomar; +Cc: linux-man
[-- 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 --]
^ permalink raw reply related [flat|nested] 14+ messages in thread* [PATCH 8/8] man/man4/console_codes.4: ffix
2025-10-09 21:53 [PATCH 0/8] man/man4/console_codes.4: content and style fixes G. Branden Robinson
` (6 preceding siblings ...)
2025-10-09 21:58 ` [PATCH 7/8] " G. Branden Robinson
@ 2025-10-09 21:58 ` G. Branden Robinson
2025-10-09 22:25 ` Alejandro Colomar
2025-10-09 22:17 ` [PATCH 0/8] man/man4/console_codes.4: content and style fixes Alejandro Colomar
8 siblings, 1 reply; 14+ messages in thread
From: G. Branden Robinson @ 2025-10-09 21:58 UTC (permalink / raw)
To: Alejandro Colomar; +Cc: linux-man
[-- Attachment #1: Type: text/plain, Size: 7467 bytes --]
Disable adjustment in all tbl(1) text blocks whose entries break using a
line length of 65 ens (the historical *roff default and practical
minimum).
Signed-off-by: "G. Branden Robinson" <g.branden.robinson@gmail.com>
---
man/man4/console_codes.4 | 47 ++++++++++++++++++++++++++++++++++++++++
1 file changed, 47 insertions(+)
diff --git a/man/man4/console_codes.4 b/man/man4/console_codes.4
index 04723c01e..4abc97d9b 100644
--- a/man/man4/console_codes.4
+++ b/man/man4/console_codes.4
@@ -135,11 +135,13 @@ .SS Linux console controls
T}
ESC M RI Reverse linefeed.
ESC Z DECID T{
+.na
DEC private identification.
The kernel returns the string ESC [ ? 6 c,
claiming that it is a VT102.
T}
ESC 7 DECSC T{
+.na
Save current state
(cursor coordinates,
attributes,
@@ -152,6 +154,7 @@ .SS Linux console controls
.T&
l l ax.
ESC % @ T{
+.na
Select default (ISO/IEC\~646 / ISO/IEC\~8859-1)
T}
ESC % G Select UTF-8
@@ -159,9 +162,11 @@ .SS Linux console controls
.T&
l l lx.
ESC # 8 DECALN T{
+.na
DEC screen alignment test \- fill screen with E's.
T}
ESC ( T{
+.na
Start sequence defining G0 character set
(followed by one of B, 0, U, K, as below)
T}
@@ -172,13 +177,16 @@ .SS Linux console controls
Select VT100 graphics mapping.
T}
ESC ( U T{
+.na
Select null mapping \- straight to character ROM.
T}
ESC ( K T{
+.na
Select user mapping \- the map that is loaded by the utility
.BR mapscrn (8).
T}
ESC ) T{
+.na
Start sequence defining G1 (followed by one of B, 0, U, K, as above).
T}
ESC > DECPNM Set numeric keypad mode
@@ -188,6 +196,7 @@ .SS Linux console controls
T}
ESC ] R Reset palette.
ESC ] P T{
+.na
Set palette, with parameter given in 7 hexadecimal digits
.I nrrggbb
after the final P.
@@ -233,32 +242,41 @@ .SS Linux console controls
Move cursor left the indicated # of columns.
T}
E CNL T{
+.na
Move cursor down the indicated # of rows, to column 1.
T}
F CPL T{
+.na
Move cursor up the indicated # of rows, to column 1.
T}
G CHA T{
+.na
Move cursor to indicated column in current row.
T}
H CUP T{
+.na
Move cursor to the indicated row, column (origin at 1,1).
T}
J ED T{
+.na
Erase display (default: from cursor to end of display).
T}
T{
+.na
ESC [ 1 J: erase from start to cursor.
T}
T{
+.na
ESC [ 2 J: erase whole display.
T}
T{
+.na
ESC [ 3 J: erase whole display including scroll-back
buffer (since Linux 3.0).
T}
.\" ESC [ 3 J: commit f8df13e0a901fe55631fed66562369b4dba40f8b
K EL T{
+.na
Erase line (default: from cursor to end of line).
T}
T{
@@ -274,9 +292,11 @@ .SS Linux console controls
Delete the indicated # of lines.
T}
P DCH T{
+.na
Delete the indicated # of characters on current line.
T}
X ECH T{
+.na
Erase the indicated # of characters on current line.
T}
a HPR T{
@@ -286,6 +306,7 @@ .SS Linux console controls
Answer ESC [ ? 6 c: "I am a VT102".
T}
d VPA T{
+.na
Move cursor to the indicated row, current column.
T}
e VPR T{
@@ -295,6 +316,7 @@ .SS Linux console controls
Move cursor to the indicated row, column.
T}
g TBC T{
+.na
Without parameter: clear tab stop at current position.
T}
T{
@@ -310,12 +332,14 @@ .SS Linux console controls
ESC [ 2 q: set Num Lock LED
ESC [ 3 q: set Caps Lock LED
r DECSTBM T{
+.na
Set scrolling region;
parameters are top and bottom row.
T}
s SCOSC Save cursor location.
u SCORC Restore cursor location.
\` HPA T{
+.na
Move cursor to indicated column in current row.
T}
.TE
@@ -339,12 +363,15 @@ .SS Linux console controls
T}
1 set bold
2 T{
+.na
set half-bright (simulated with color on a color display)
T}
3 T{
+.na
set italic (since Linux 2.6.22; simulated with color on a color display)
T}
4 T{
+.na
set underscore (simulated with color on a color display)
(the colors used to simulate dim or underline are set
using ESC ] ...)
@@ -352,14 +379,17 @@ .SS Linux console controls
5 set blink
7 set reverse video
10 T{
+.na
reset selected mapping, display control flag,
and toggle meta flag (ECMA-48 says "primary font").
T}
11 T{
+.na
select null mapping, set display control flag,
reset toggle meta flag (ECMA-48 says "first alternate font").
T}
12 T{
+.na
select null mapping, set display control flag,
set toggle meta flag (ECMA-48 says "second alternate font").
The toggle meta flag
@@ -367,6 +397,7 @@ .SS Linux console controls
before the mapping table translation is done.
T}
21 T{
+.na
set underline;
before Linux 4.17,
this value set normal intensity
@@ -386,10 +417,12 @@ .SS Linux console controls
36 set cyan foreground
37 set white foreground
38 T{
+.na
256/24-bit foreground color follows, shoehorned into 16 basic colors
(before Linux 3.16: set underscore on, set default foreground color)
T}
39 T{
+.na
set default foreground color
(before Linux 3.16: set underscore off, set default foreground color)
T}
@@ -402,6 +435,7 @@ .SS Linux console controls
46 set cyan background
47 set white background
48 T{
+.na
256/24-bit background color follows, shoehorned into 8 basic colors
T}
49 set default background color
@@ -409,6 +443,7 @@ .SS Linux console controls
set foreground to bright versions of 30..37
T}
100..107 T{
+.na
set background, same as 40..47 (bright not supported)
T}
.TE
@@ -418,10 +453,12 @@ .SS Linux console controls
.TS
l lx.
;5;x T{
+.na
256 color: values 0..15 are IBGR (black, red, green, ..., white),
16..231 a 6x6x6 color cube, 232..255 a grayscale ramp
T}
;2;r;g;b T{
+.na
24-bit color, r/g/b components are in the range 0..255
T}
.TE
@@ -530,6 +567,7 @@ .SS Linux console controls
Set color \f[I]n\f[] as the dim color.
T}
ESC [ 8 ] T{
+.na
Make the current color pair the default attributes.
T}
ESC [ 9 ; \f[I]n\f[] ] T{
@@ -550,13 +588,16 @@ .SS Linux console controls
Unblank the screen.
T}
ESC [ 14 ; \f[I]n\f[] ] T{
+.na
Set the VESA powerdown interval in minutes.
T}
ESC [ 15 ] T{
+.na
Bring the previous console to the front
(since Linux 2.6.0).
T}
ESC [ 16 ; \f[I]n\f[] ] T{
+.na
Set the cursor blink interval in milliseconds
(since Linux 4.2).
T}
@@ -703,10 +744,12 @@ .SS Comparisons with other terminals
.TS
l l lx.
ESC N SS2 T{
+.na
Single shift 2.
(Select G2 character set for the next character only.)
T}
ESC O SS3 T{
+.na
Single shift 3.
(Select G3 character set for the next character only.)
T}
@@ -747,6 +790,7 @@ .SS Comparisons with other terminals
.TS
l l.
ESC ] 0 ; \f[I]txt\f[] ST T{
+.na
Set icon name and window title to
.IR txt .
T}
@@ -755,6 +799,7 @@ .SS Comparisons with other terminals
ESC ] 4 ; \f[I]num\f[]; \f[I]txt\f[] ST Set ANSI color \f[I]num\f[] to \f[I]txt\f[].
ESC ] 10 ; \f[I]txt\f[] ST Set dynamic text color to \f[I]txt\f[].
ESC ] 4 6 ; \f[I]name\f[] ST T{
+.na
Change log file to
.I name
(normally disabled by a compile-time option).
@@ -776,6 +821,7 @@ .SS Comparisons with other terminals
.TS
l l lx.
ESC F T{
+.na
Cursor to lower left corner of screen (if enabled
by
.BR xterm (1)'s
@@ -783,6 +829,7 @@ .SS Comparisons with other terminals
resource).
T}
ESC l T{
+.na
Memory lock (per HP terminals).
Locks memory above the cursor.
T}
--
2.30.2
[-- Attachment #2: signature.asc --]
[-- Type: application/pgp-signature, Size: 833 bytes --]
^ permalink raw reply related [flat|nested] 14+ messages in thread* Re: [PATCH 8/8] man/man4/console_codes.4: ffix
2025-10-09 21:58 ` [PATCH 8/8] " G. Branden Robinson
@ 2025-10-09 22:25 ` Alejandro Colomar
2025-10-09 23:00 ` G. Branden Robinson
0 siblings, 1 reply; 14+ messages in thread
From: Alejandro Colomar @ 2025-10-09 22:25 UTC (permalink / raw)
To: G. Branden Robinson; +Cc: linux-man
[-- Attachment #1: Type: text/plain, Size: 8432 bytes --]
Hi Branden,
On Thu, Oct 09, 2025 at 04:58:19PM -0500, G. Branden Robinson wrote:
> Disable adjustment in all tbl(1) text blocks whose entries break using a
> line length of 65 ens (the historical *roff default and practical
> minimum).
>
> Signed-off-by: "G. Branden Robinson" <g.branden.robinson@gmail.com>
I'm going to reject this patch. I think I prefer to keep the source
code simpler. I might eventually change my mind, but I'm not convinced
yet.
Cheers,
Alex
> ---
> man/man4/console_codes.4 | 47 ++++++++++++++++++++++++++++++++++++++++
> 1 file changed, 47 insertions(+)
>
> diff --git a/man/man4/console_codes.4 b/man/man4/console_codes.4
> index 04723c01e..4abc97d9b 100644
> --- a/man/man4/console_codes.4
> +++ b/man/man4/console_codes.4
> @@ -135,11 +135,13 @@ .SS Linux console controls
> T}
> ESC M RI Reverse linefeed.
> ESC Z DECID T{
> +.na
> DEC private identification.
> The kernel returns the string ESC [ ? 6 c,
> claiming that it is a VT102.
> T}
> ESC 7 DECSC T{
> +.na
> Save current state
> (cursor coordinates,
> attributes,
> @@ -152,6 +154,7 @@ .SS Linux console controls
> .T&
> l l ax.
> ESC % @ T{
> +.na
> Select default (ISO/IEC\~646 / ISO/IEC\~8859-1)
> T}
> ESC % G Select UTF-8
> @@ -159,9 +162,11 @@ .SS Linux console controls
> .T&
> l l lx.
> ESC # 8 DECALN T{
> +.na
> DEC screen alignment test \- fill screen with E's.
> T}
> ESC ( T{
> +.na
> Start sequence defining G0 character set
> (followed by one of B, 0, U, K, as below)
> T}
> @@ -172,13 +177,16 @@ .SS Linux console controls
> Select VT100 graphics mapping.
> T}
> ESC ( U T{
> +.na
> Select null mapping \- straight to character ROM.
> T}
> ESC ( K T{
> +.na
> Select user mapping \- the map that is loaded by the utility
> .BR mapscrn (8).
> T}
> ESC ) T{
> +.na
> Start sequence defining G1 (followed by one of B, 0, U, K, as above).
> T}
> ESC > DECPNM Set numeric keypad mode
> @@ -188,6 +196,7 @@ .SS Linux console controls
> T}
> ESC ] R Reset palette.
> ESC ] P T{
> +.na
> Set palette, with parameter given in 7 hexadecimal digits
> .I nrrggbb
> after the final P.
> @@ -233,32 +242,41 @@ .SS Linux console controls
> Move cursor left the indicated # of columns.
> T}
> E CNL T{
> +.na
> Move cursor down the indicated # of rows, to column 1.
> T}
> F CPL T{
> +.na
> Move cursor up the indicated # of rows, to column 1.
> T}
> G CHA T{
> +.na
> Move cursor to indicated column in current row.
> T}
> H CUP T{
> +.na
> Move cursor to the indicated row, column (origin at 1,1).
> T}
> J ED T{
> +.na
> Erase display (default: from cursor to end of display).
> T}
> T{
> +.na
> ESC [ 1 J: erase from start to cursor.
> T}
> T{
> +.na
> ESC [ 2 J: erase whole display.
> T}
> T{
> +.na
> ESC [ 3 J: erase whole display including scroll-back
> buffer (since Linux 3.0).
> T}
> .\" ESC [ 3 J: commit f8df13e0a901fe55631fed66562369b4dba40f8b
> K EL T{
> +.na
> Erase line (default: from cursor to end of line).
> T}
> T{
> @@ -274,9 +292,11 @@ .SS Linux console controls
> Delete the indicated # of lines.
> T}
> P DCH T{
> +.na
> Delete the indicated # of characters on current line.
> T}
> X ECH T{
> +.na
> Erase the indicated # of characters on current line.
> T}
> a HPR T{
> @@ -286,6 +306,7 @@ .SS Linux console controls
> Answer ESC [ ? 6 c: "I am a VT102".
> T}
> d VPA T{
> +.na
> Move cursor to the indicated row, current column.
> T}
> e VPR T{
> @@ -295,6 +316,7 @@ .SS Linux console controls
> Move cursor to the indicated row, column.
> T}
> g TBC T{
> +.na
> Without parameter: clear tab stop at current position.
> T}
> T{
> @@ -310,12 +332,14 @@ .SS Linux console controls
> ESC [ 2 q: set Num Lock LED
> ESC [ 3 q: set Caps Lock LED
> r DECSTBM T{
> +.na
> Set scrolling region;
> parameters are top and bottom row.
> T}
> s SCOSC Save cursor location.
> u SCORC Restore cursor location.
> \` HPA T{
> +.na
> Move cursor to indicated column in current row.
> T}
> .TE
> @@ -339,12 +363,15 @@ .SS Linux console controls
> T}
> 1 set bold
> 2 T{
> +.na
> set half-bright (simulated with color on a color display)
> T}
> 3 T{
> +.na
> set italic (since Linux 2.6.22; simulated with color on a color display)
> T}
> 4 T{
> +.na
> set underscore (simulated with color on a color display)
> (the colors used to simulate dim or underline are set
> using ESC ] ...)
> @@ -352,14 +379,17 @@ .SS Linux console controls
> 5 set blink
> 7 set reverse video
> 10 T{
> +.na
> reset selected mapping, display control flag,
> and toggle meta flag (ECMA-48 says "primary font").
> T}
> 11 T{
> +.na
> select null mapping, set display control flag,
> reset toggle meta flag (ECMA-48 says "first alternate font").
> T}
> 12 T{
> +.na
> select null mapping, set display control flag,
> set toggle meta flag (ECMA-48 says "second alternate font").
> The toggle meta flag
> @@ -367,6 +397,7 @@ .SS Linux console controls
> before the mapping table translation is done.
> T}
> 21 T{
> +.na
> set underline;
> before Linux 4.17,
> this value set normal intensity
> @@ -386,10 +417,12 @@ .SS Linux console controls
> 36 set cyan foreground
> 37 set white foreground
> 38 T{
> +.na
> 256/24-bit foreground color follows, shoehorned into 16 basic colors
> (before Linux 3.16: set underscore on, set default foreground color)
> T}
> 39 T{
> +.na
> set default foreground color
> (before Linux 3.16: set underscore off, set default foreground color)
> T}
> @@ -402,6 +435,7 @@ .SS Linux console controls
> 46 set cyan background
> 47 set white background
> 48 T{
> +.na
> 256/24-bit background color follows, shoehorned into 8 basic colors
> T}
> 49 set default background color
> @@ -409,6 +443,7 @@ .SS Linux console controls
> set foreground to bright versions of 30..37
> T}
> 100..107 T{
> +.na
> set background, same as 40..47 (bright not supported)
> T}
> .TE
> @@ -418,10 +453,12 @@ .SS Linux console controls
> .TS
> l lx.
> ;5;x T{
> +.na
> 256 color: values 0..15 are IBGR (black, red, green, ..., white),
> 16..231 a 6x6x6 color cube, 232..255 a grayscale ramp
> T}
> ;2;r;g;b T{
> +.na
> 24-bit color, r/g/b components are in the range 0..255
> T}
> .TE
> @@ -530,6 +567,7 @@ .SS Linux console controls
> Set color \f[I]n\f[] as the dim color.
> T}
> ESC [ 8 ] T{
> +.na
> Make the current color pair the default attributes.
> T}
> ESC [ 9 ; \f[I]n\f[] ] T{
> @@ -550,13 +588,16 @@ .SS Linux console controls
> Unblank the screen.
> T}
> ESC [ 14 ; \f[I]n\f[] ] T{
> +.na
> Set the VESA powerdown interval in minutes.
> T}
> ESC [ 15 ] T{
> +.na
> Bring the previous console to the front
> (since Linux 2.6.0).
> T}
> ESC [ 16 ; \f[I]n\f[] ] T{
> +.na
> Set the cursor blink interval in milliseconds
> (since Linux 4.2).
> T}
> @@ -703,10 +744,12 @@ .SS Comparisons with other terminals
> .TS
> l l lx.
> ESC N SS2 T{
> +.na
> Single shift 2.
> (Select G2 character set for the next character only.)
> T}
> ESC O SS3 T{
> +.na
> Single shift 3.
> (Select G3 character set for the next character only.)
> T}
> @@ -747,6 +790,7 @@ .SS Comparisons with other terminals
> .TS
> l l.
> ESC ] 0 ; \f[I]txt\f[] ST T{
> +.na
> Set icon name and window title to
> .IR txt .
> T}
> @@ -755,6 +799,7 @@ .SS Comparisons with other terminals
> ESC ] 4 ; \f[I]num\f[]; \f[I]txt\f[] ST Set ANSI color \f[I]num\f[] to \f[I]txt\f[].
> ESC ] 10 ; \f[I]txt\f[] ST Set dynamic text color to \f[I]txt\f[].
> ESC ] 4 6 ; \f[I]name\f[] ST T{
> +.na
> Change log file to
> .I name
> (normally disabled by a compile-time option).
> @@ -776,6 +821,7 @@ .SS Comparisons with other terminals
> .TS
> l l lx.
> ESC F T{
> +.na
> Cursor to lower left corner of screen (if enabled
> by
> .BR xterm (1)'s
> @@ -783,6 +829,7 @@ .SS Comparisons with other terminals
> resource).
> T}
> ESC l T{
> +.na
> Memory lock (per HP terminals).
> Locks memory above the cursor.
> T}
> --
> 2.30.2
--
<https://www.alejandro-colomar.es>
Use port 80 (that is, <...:80/>).
[-- Attachment #2: signature.asc --]
[-- Type: application/pgp-signature, Size: 833 bytes --]
^ permalink raw reply [flat|nested] 14+ messages in thread* Re: [PATCH 8/8] man/man4/console_codes.4: ffix
2025-10-09 22:25 ` Alejandro Colomar
@ 2025-10-09 23:00 ` G. Branden Robinson
2025-10-09 23:03 ` G. Branden Robinson
0 siblings, 1 reply; 14+ messages in thread
From: G. Branden Robinson @ 2025-10-09 23:00 UTC (permalink / raw)
To: Alejandro Colomar; +Cc: linux-man
[-- Attachment #1: Type: text/plain, Size: 1125 bytes --]
At 2025-10-10T00:25:01+0200, Alejandro Colomar wrote:
> On Thu, Oct 09, 2025 at 04:58:19PM -0500, G. Branden Robinson wrote:
> > Disable adjustment in all tbl(1) text blocks whose entries break
> > using a line length of 65 ens (the historical *roff default and
> > practical minimum).
> >
> > Signed-off-by: "G. Branden Robinson" <g.branden.robinson@gmail.com>
>
> I'm going to reject this patch. I think I prefer to keep the source
> code simpler. I might eventually change my mind, but I'm not
> convinced yet.
Okay. Be advised that without these `na` requests in the table cells,
text blocks that have line breaks can look a bit funny. Here's an
example.
$ nroff -t -rLL=65n -man -P -cbou man/man4/console_codes.4 \
| grep -C1 'Select.*ISO.*646'
ESC % Start sequence selecting character set
ESC % @ Select default (ISO/IEC 646 /
ISO/IEC 8859‐1)
However, I have an idea that might resolve this problem _and_ the one
with centering making the indentation huge on wide terminals.
Will advise.
Regards,
Branden
[-- Attachment #2: signature.asc --]
[-- Type: application/pgp-signature, Size: 833 bytes --]
^ permalink raw reply [flat|nested] 14+ messages in thread
* Re: [PATCH 0/8] man/man4/console_codes.4: content and style fixes
2025-10-09 21:53 [PATCH 0/8] man/man4/console_codes.4: content and style fixes G. Branden Robinson
` (7 preceding siblings ...)
2025-10-09 21:58 ` [PATCH 8/8] " G. Branden Robinson
@ 2025-10-09 22:17 ` Alejandro Colomar
2025-10-09 22:21 ` Alejandro Colomar
8 siblings, 1 reply; 14+ messages in thread
From: Alejandro Colomar @ 2025-10-09 22:17 UTC (permalink / raw)
To: G. Branden Robinson; +Cc: linux-man
[-- Attachment #1: Type: text/plain, Size: 3395 bytes --]
On Thu, Oct 09, 2025 at 04:53:44PM -0500, G. Branden Robinson wrote:
> Hi Alex,
Hi Branden,
>
> Here's a (slightly revised) set of the changes discussed in:
> https://lore.kernel.org/linux-man/20250925221012.lss5ixmixnqrnrwq@illithid/
>
> $ git log --oneline | head -n 8 | tac
> 58e02f1c8 man/man4/console_codes.4: Document codes better
> 1d3623841 man/man4/console_codes.4: ffix
> 01f5c7adc man/man4/console_codes.4: ffix
> 210b58f97 man/man4/console_codes.4: ffix
> 518789aba man/man4/console_codes.4: wfix
> 9a568cf32 man/man4/console_codes.4: ffix
> f99e7a978 man/man4/console_codes.4: ffix
> a3298688c man/man4/console_codes.4: ffix
I've applied all of the patches. Thanks! (I've tweaked the commit
message of the first one.)
<https://www.alejandro-colomar.es/src/alx/linux/man-pages/man-pages.git/commit/?h=contrib&id=949f47fd471b50ee6f389aa6fc1d2c41b5fbdfb3>
<https://www.alejandro-colomar.es/src/alx/linux/man-pages/man-pages.git/commit/?h=contrib&id=82f4699621d793f12381ea7348dc9a03ebad89d8>
<https://www.alejandro-colomar.es/src/alx/linux/man-pages/man-pages.git/commit/?h=contrib&id=e2b83fe42b8bdd06f353bbe7b4d19a0c812c0a64>
<https://www.alejandro-colomar.es/src/alx/linux/man-pages/man-pages.git/commit/?h=contrib&id=665fad6e3ec8d5449eaa924ed3947054043efbb8>
<https://www.alejandro-colomar.es/src/alx/linux/man-pages/man-pages.git/commit/?h=contrib&id=00182e24fac381ae7734600836eb528cbcd25be6>
<https://www.alejandro-colomar.es/src/alx/linux/man-pages/man-pages.git/commit/?h=contrib&id=54eb53e4e03c98149a34bfd565753024e4d5af89>
<https://www.alejandro-colomar.es/src/alx/linux/man-pages/man-pages.git/commit/?h=contrib&id=9dda144d239e4a4537f9325f50eba3bae9091de0>
(Use port 80.)
BTW, I see something weird with one of the commits:
$ MANWIDTH=200 diffman-git 665fad6e3ec8
--- 665fad6e3ec8^:man/man4/console_codes.4
+++ 665fad6e3ec8:man/man4/console_codes.4
@@ -84,9 +84,9 @@ DESCRIPTION
ESC 7 DECSC Save current state (cursor coordinates, attributes, character sets pointed at by G0, G1).
ESC 8 DECRC Restore state most recently saved by ESC 7.
ESC % Start sequence selecting character set
- ESC % @ Select default (ISO/IEC 646 / ISO/IEC 8859‐1)
- ESC % G Select UTF‐8
- ESC % 8 Select UTF‐8 (obsolete)
+ ESC % @ Select default (ISO/IEC 646 / ISO/IEC 8859‐1)
+ ESC % G Select UTF‐8
+ ESC % 8 Select UTF‐8 (obsolete)
ESC # 8 DECALN DEC screen alignment test - fill screen with E’s.
ESC ( Start sequence defining G0 character set (followed by one of B, 0, U, K, as below)
ESC ( B Select default (ISO/IEC 8859‐1 mapping).
I find it weird that 'a' does center the longest string before indenting
and left-aligning. It results in weird indentation if MANWIDTH is
large.
I've applied the patch, though, as this is not normal, and not too bad
either. We'll see if there's any solution to this.
Have a lovely night!
Alex
--
<https://www.alejandro-colomar.es>
Use port 80 (that is, <...:80/>).
[-- Attachment #2: signature.asc --]
[-- Type: application/pgp-signature, Size: 833 bytes --]
^ permalink raw reply [flat|nested] 14+ messages in thread* Re: [PATCH 0/8] man/man4/console_codes.4: content and style fixes
2025-10-09 22:17 ` [PATCH 0/8] man/man4/console_codes.4: content and style fixes Alejandro Colomar
@ 2025-10-09 22:21 ` Alejandro Colomar
0 siblings, 0 replies; 14+ messages in thread
From: Alejandro Colomar @ 2025-10-09 22:21 UTC (permalink / raw)
To: G. Branden Robinson; +Cc: linux-man
[-- Attachment #1: Type: text/plain, Size: 3777 bytes --]
On Fri, Oct 10, 2025 at 12:17:35AM +0200, Alejandro Colomar wrote:
> On Thu, Oct 09, 2025 at 04:53:44PM -0500, G. Branden Robinson wrote:
> > Hi Alex,
>
> Hi Branden,
>
> >
> > Here's a (slightly revised) set of the changes discussed in:
> > https://lore.kernel.org/linux-man/20250925221012.lss5ixmixnqrnrwq@illithid/
> >
> > $ git log --oneline | head -n 8 | tac
> > 58e02f1c8 man/man4/console_codes.4: Document codes better
> > 1d3623841 man/man4/console_codes.4: ffix
> > 01f5c7adc man/man4/console_codes.4: ffix
> > 210b58f97 man/man4/console_codes.4: ffix
> > 518789aba man/man4/console_codes.4: wfix
> > 9a568cf32 man/man4/console_codes.4: ffix
> > f99e7a978 man/man4/console_codes.4: ffix
> > a3298688c man/man4/console_codes.4: ffix
>
> I've applied all of the patches. Thanks! (I've tweaked the commit
> message of the first one.)
>
> <https://www.alejandro-colomar.es/src/alx/linux/man-pages/man-pages.git/commit/?h=contrib&id=949f47fd471b50ee6f389aa6fc1d2c41b5fbdfb3>
> <https://www.alejandro-colomar.es/src/alx/linux/man-pages/man-pages.git/commit/?h=contrib&id=82f4699621d793f12381ea7348dc9a03ebad89d8>
> <https://www.alejandro-colomar.es/src/alx/linux/man-pages/man-pages.git/commit/?h=contrib&id=e2b83fe42b8bdd06f353bbe7b4d19a0c812c0a64>
> <https://www.alejandro-colomar.es/src/alx/linux/man-pages/man-pages.git/commit/?h=contrib&id=665fad6e3ec8d5449eaa924ed3947054043efbb8>
> <https://www.alejandro-colomar.es/src/alx/linux/man-pages/man-pages.git/commit/?h=contrib&id=00182e24fac381ae7734600836eb528cbcd25be6>
> <https://www.alejandro-colomar.es/src/alx/linux/man-pages/man-pages.git/commit/?h=contrib&id=54eb53e4e03c98149a34bfd565753024e4d5af89>
> <https://www.alejandro-colomar.es/src/alx/linux/man-pages/man-pages.git/commit/?h=contrib&id=9dda144d239e4a4537f9325f50eba3bae9091de0>
> (Use port 80.)
Oops, I have now received patch 8/8. I had only seen (and applied) the
first 7.
Cheers,
Alex
>
> BTW, I see something weird with one of the commits:
>
> $ MANWIDTH=200 diffman-git 665fad6e3ec8
> --- 665fad6e3ec8^:man/man4/console_codes.4
> +++ 665fad6e3ec8:man/man4/console_codes.4
> @@ -84,9 +84,9 @@ DESCRIPTION
> ESC 7 DECSC Save current state (cursor coordinates, attributes, character sets pointed at by G0, G1).
> ESC 8 DECRC Restore state most recently saved by ESC 7.
> ESC % Start sequence selecting character set
> - ESC % @ Select default (ISO/IEC 646 / ISO/IEC 8859‐1)
> - ESC % G Select UTF‐8
> - ESC % 8 Select UTF‐8 (obsolete)
> + ESC % @ Select default (ISO/IEC 646 / ISO/IEC 8859‐1)
> + ESC % G Select UTF‐8
> + ESC % 8 Select UTF‐8 (obsolete)
> ESC # 8 DECALN DEC screen alignment test - fill screen with E’s.
> ESC ( Start sequence defining G0 character set (followed by one of B, 0, U, K, as below)
> ESC ( B Select default (ISO/IEC 8859‐1 mapping).
>
> I find it weird that 'a' does center the longest string before indenting
> and left-aligning. It results in weird indentation if MANWIDTH is
> large.
>
> I've applied the patch, though, as this is not normal, and not too bad
> either. We'll see if there's any solution to this.
>
>
> Have a lovely night!
> Alex
>
> --
> <https://www.alejandro-colomar.es>
> Use port 80 (that is, <...:80/>).
--
<https://www.alejandro-colomar.es>
Use port 80 (that is, <...:80/>).
[-- Attachment #2: signature.asc --]
[-- Type: application/pgp-signature, Size: 833 bytes --]
^ permalink raw reply [flat|nested] 14+ messages in thread