bug-bash
[Top][All Lists]
Advanced

[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]

[PATCH 19/25] Spell key sequences with spaces, not hyphens.


From: G. Branden Robinson
Subject: [PATCH 19/25] Spell key sequences with spaces, not hyphens.
Date: Thu, 21 Nov 2024 22:23:09 -0600

The hyphen indicates simultaneity, not sequence.

Also use Texinfo `kbd` command to denote key strokes in parallel
material in rluser.texi.
---
 doc/bash.1                   | 9 ++++++---
 lib/readline/doc/readline.3  | 9 ++++++---
 lib/readline/doc/rluser.texi | 7 +++++--
 3 files changed, 17 insertions(+), 8 deletions(-)

diff --git a/doc/bash.1 b/doc/bash.1
index f893fbfc..fe87c7e7 100644
--- a/doc/bash.1
+++ b/doc/bash.1
@@ -6347,7 +6347,7 @@ .SS "Readline Notation"
 .I x
 key, in sequence.
 This makes ESC the \fImeta prefix\fP.
-The combination M\-C\-\fIx\fP means ESC\-Control\-\fIx\fP:
+The combination M\-C\-\fIx\fP means ESC Control\-\fIx\fP:
 press and release the Escape key,
 then press and hold the Control key while pressing the
 .I x
@@ -7930,13 +7930,16 @@ .SS Miscellaneous
 .B skip\-csi\-sequence
 Read enough characters to consume a multi-key sequence such as those
 defined for keys like Home and End.
-CSI sequences begin with a Control Sequence Indicator (CSI), usually ESC\-[.
+CSI sequences begin with a Control Sequence Indicator (CSI),
+usually
+.IR "ESC [" .
 If this sequence is bound to
 .Q \ee[ ,
 keys producing CSI sequences will have no effect
 unless explicitly bound to a \fBreadline\fP command, instead of inserting
 stray characters into the editing buffer.
-This is unbound by default, but usually bound to ESC\-[.
+This is unbound by default, but usually bound to
+.IR "ESC [" .
 .TP
 .B insert\-comment (M\-#)
 Without a numeric argument, insert the value of the \fBreadline\fP
diff --git a/lib/readline/doc/readline.3 b/lib/readline/doc/readline.3
index ce719a14..42fd6b18 100644
--- a/lib/readline/doc/readline.3
+++ b/lib/readline/doc/readline.3
@@ -129,7 +129,7 @@ .SH NOTATION
 .I x
 key, in sequence.
 This makes ESC the \fImeta prefix\fP.
-The combination M\-C\-\fIx\fP means ESC\-Control\-\fIx\fP:
+The combination M\-C\-\fIx\fP means ESC Control\-\fIx\fP:
 press and release the Escape key,
 then press and hold the Control key while pressing the
 .I x
@@ -1557,13 +1557,16 @@ .SS Miscellaneous
 .B skip\-csi\-sequence
 Read enough characters to consume a multi-key sequence such as those
 defined for keys like Home and End.
-CSI sequences begin with a Control Sequence Indicator (CSI), usually ESC\-[.
+CSI sequences begin with a Control Sequence Indicator (CSI),
+usually
+.IR "ESC [" .
 If this sequence is bound to
 .Q \ee[ ,
 keys producing CSI sequences will have no effect
 unless explicitly bound to a \fBreadline\fP command, instead of inserting
 stray characters into the editing buffer.
-This is unbound by default, but usually bound to ESC\-[.
+This is unbound by default, but usually bound to
+.IR "ESC [" .
 .TP
 .B insert\-comment (M\-#)
 Without a numeric argument, insert the value of the \fBreadline\fP
diff --git a/lib/readline/doc/rluser.texi b/lib/readline/doc/rluser.texi
index d5b08409..cfa36c79 100644
--- a/lib/readline/doc/rluser.texi
+++ b/lib/readline/doc/rluser.texi
@@ -1988,12 +1988,15 @@
 @item skip-csi-sequence ()
 Read enough characters to consume a multi-key sequence such as those
 defined for keys like Home and End.
-CSI sequences begin with a Control Sequence Indicator (CSI), usually ESC-[.
+CSI sequences begin with a Control Sequence Indicator (CSI),
+usually
+@kbd{ESC [}.
 If this sequence is bound to "\e[",
 keys producing CSI sequences will have no effect
 unless explicitly bound to a Readline command, instead of inserting
 stray characters into the editing buffer.
-This is unbound by default, but usually bound to ESC-[.
+This is unbound by default, but usually bound to
+@kbd{ESC [}.
 
 @item insert-comment (M-#)
 Without a numeric argument, insert the value of the @code{comment-begin}
-- 
2.30.2

Attachment: signature.asc
Description: PGP signature


reply via email to

[Prev in Thread] Current Thread [Next in Thread]