From 0fdc6e271746e064c483b5dbb460cd70e0548ef4 Mon Sep 17 00:00:00 2001
From: Roland Pesch <pesch@cygnus>
Date: Thu, 9 Jul 1992 20:40:39 +0000
Subject: [PATCH] (Finally) doc that GDB sometimes inserts quotes for you, on
 overloaded symbol completion requests.

---
 gdb/doc/gdb.texinfo | 31 ++++++++++++++++++++++++++-----
 1 file changed, 26 insertions(+), 5 deletions(-)

diff --git a/gdb/doc/gdb.texinfo b/gdb/doc/gdb.texinfo
index 5267136a55d..78fedbf9802 100644
--- a/gdb/doc/gdb.texinfo
+++ b/gdb/doc/gdb.texinfo
@@ -1219,8 +1219,12 @@ of a word.  If there's only one possibility, _GDBN__ will fill in the
 word, and wait for you to finish the command (or press @key{RET} to
 enter it).  For example, if you type
 
+@c FIXME "@key" doesn't distinguish its argument sufficiently to permit
+@c complete accuracy in these examples; space introduced for clarity.
+@c If texinfo enhancements make it unnecessary, it would be nice to
+@c replace " @key" by "@key" in the following...
 @example
-(_GDBP__) info bre@key{TAB}
+(_GDBP__) info bre @key{TAB}
 @end example
 
 @noindent
@@ -1250,7 +1254,7 @@ function names in your program that begin with those characters, for
 example:
 
 @example
-(_GDBP__) b make_@key{TAB}
+(_GDBP__) b make_ @key{TAB}
 @exdent _GDBN__ sounds bell; press @key{TAB} again, to see:
 make_a_section_from_file     make_environ               
 make_abs_section             make_function_type         
@@ -1291,11 +1295,28 @@ consider more information than usual when you press @key{TAB} or
 @kbd{M-?} to request word completion:
 
 @example
-(_GDBP__) b 'name(@key{M-?}
-name(int)    name(float)
-(_GDBP__) b 'name(
+(_GDBP__) b 'bubble( @key{M-?}
+bubble(double,double)    bubble(int,int)
+(_GDBP__) b 'bubble(
 @end example
 
+In some cases, _GDBN__ can tell that completing a name will require
+quotes.  When this happens, _GDBN__ will insert the quote for you (while
+completing as much as it can) if you do not type the quote in the first
+place:
+
+@example
+(_GDBP__) b bub @key{TAB}
+@exdent _GDBN__ alters your input line to the following, and rings a bell:
+(_GDBP__) b 'bubble(
+@end example
+
+@noindent
+In general, _GDBN__ can tell that a quote is needed (and inserts it) if
+you have not yet started typing the argument list when you ask for
+completion on an overloaded symbol.
+
+
 @node Help,  , Completion, Commands
 @section Getting Help
 @cindex online documentation
-- 
2.30.2