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
signature.asc
Description: PGP signature