[PATCH 21/25] Improve presentation of symbolic character names.

[G. Branden Robinson]

Since so many are synonymous, say so and organize them into pairs.

Sync rluser.texi's wording with that of bash.1 and readline.3.
---
 doc/bash.1                   | 28 +++++++++++++++++-----------
 lib/readline/doc/readline.3  | 28 +++++++++++++++++-----------
 lib/readline/doc/rluser.texi | 28 +++++++++++++++++-----------
 3 files changed, 51 insertions(+), 33 deletions(-)

diff --git a/doc/bash.1 b/doc/bash.1
index c6d60aa9..dd58e0d1 100644
--- a/doc/bash.1
+++ b/doc/bash.1
@@ -6440,18 +6440,24 @@ .SS "Readline Initialization"
 would make M\-C\-u execute the \fBreadline\fP command
 .IR universal\-argument .
 .PP
-Key bindings may contain the following symbolic character names:
-.IR DEL ,
-.IR ESC ,
-.IR ESCAPE ,
-.IR LFD ,
-.IR NEWLINE ,
-.IR RET ,
-.IR RETURN ,
+Key bindings may use the following symbolic character names,
+most of which have synonymous pairs:
+.I DEL
+or
 .I RUBOUT
-(a destructive backspace),
-.IR SPACE ,
-.IR SPC ,
+(a destructive backspace);
+.I ESC
+or
+.IR ESCAPE ;
+.I LFD
+or
+.IR NEWLINE ;
+.I RET
+or
+.IR RETURN ;
+.I SPC
+or
+.IR SPACE ;
 and
 .IR TAB .
 .PP
diff --git a/lib/readline/doc/readline.3 b/lib/readline/doc/readline.3
index 46bd9b96..348465fc 100644
--- a/lib/readline/doc/readline.3
+++ b/lib/readline/doc/readline.3
@@ -216,18 +216,24 @@ .SH INITIALIZATION FILE
 would make M\-C\-u execute the \fBreadline\fP command
 .IR universal\-argument .
 .PP
-Key bindings may contain the following symbolic character names:
-.IR DEL ,
-.IR ESC ,
-.IR ESCAPE ,
-.IR LFD ,
-.IR NEWLINE ,
-.IR RET ,
-.IR RETURN ,
+Key bindings may use the following symbolic character names,
+most of which have synonymous pairs:
+.I DEL
+or
 .I RUBOUT
-(a destructive backspace),
-.IR SPACE ,
-.IR SPC ,
+(a destructive backspace);
+.I ESC
+or
+.IR ESCAPE ;
+.I LFD
+or
+.IR NEWLINE ;
+.I RET
+or
+.IR RETURN ;
+.I SPC
+or
+.IR SPACE ;
 and
 .IR TAB .
 .PP
diff --git a/lib/readline/doc/rluser.texi b/lib/readline/doc/rluser.texi
index 96a99c5b..fa046a15 100644
--- a/lib/readline/doc/rluser.texi
+++ b/lib/readline/doc/rluser.texi
@@ -965,18 +965,24 @@
 expressed on the right hand side (that is, to insert the text
 @samp{> output} into the line).
 
-This key binding syntax recognizes a number of symbolic character names:
-@var{DEL},
-@var{ESC},
-@var{ESCAPE},
-@var{LFD},
-@var{NEWLINE},
-@var{RET},
-@var{RETURN},
+Key bindings may use the following symbolic character names,
+most of which have synonymous pairs:
+@var{DEL}
+or
 @var{RUBOUT}
-(a destructive backspace),
-@var{SPACE},
-@var{SPC},
+(a destructive backspace);
+@var{ESC}
+or
+@var{ESCAPE};
+@var{LFD}
+or
+@var{NEWLINE};
+@var{RET}
+or
+@var{RETURN};
+@var{SPC}
+or
+@var{SPACE};
 and
 @var{TAB}.
 
-- 
2.30.2

signature.asc
Description: PGP signature