[PATCH 0/8] man/man4/console_codes.4: content and style fixes

[PATCH 0/8] man/man4/console_codes.4: content and style fixes

[G. Branden Robinson]

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

Hi Alex,

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

Regards,
Branden

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

[PATCH 1/8] man/man4/console_codes.4: Document codes better

[G. Branden Robinson]

[-- 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 --]

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

[G. Branden Robinson]

[-- 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 --]

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

[G. Branden Robinson]

[-- 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 --]

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

[G. Branden Robinson]

[-- 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 --]

[PATCH 5/8] man/man4/console_codes.4: wfix

[G. Branden Robinson]

[-- 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 --]

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

[G. Branden Robinson]

[-- 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 --]

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

[G. Branden Robinson]

[-- 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 --]

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

[G. Branden Robinson]

[-- 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 --]

Re: [PATCH 0/8] man/man4/console_codes.4: content and style fixes

[Alejandro Colomar]

[-- 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 --]

Re: [PATCH 0/8] man/man4/console_codes.4: content and style fixes

[Alejandro Colomar]

[-- 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 --]

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

[Alejandro Colomar]

[-- 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 --]

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

[G. Branden Robinson]

[-- 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 --]

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

[G. Branden Robinson]

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

At 2025-10-09T18:00:48-0500, G. Branden Robinson wrote:
> However, I have an idea that might resolve this problem _and_ the one
> with centering making the indentation huge on wide terminals.
> 
> Will advise.

Nope, never mind.  My clever idea died.

tbl:man/man4/console_codes.4:155: error: cannot change column separation in continued format

Regards,
Branden

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