[RFA]: Document TUI SingleKey

[Stephane Carrez <stcarrez at nerim dot fr>]

Hi!

This patch represents the TUI SingleKey documentation (already sent in
http://sources.redhat.com/ml/gdb-patches/2002-08/msg00907.html).  I split
the previous patch in two for clarity.

I tested/reviewed the result on gdb.ps/gdb.dvi and gdb.info.

Can you approve this patch?

	Stephane

2002-08-31  Stephane Carrez  <stcarrez@nerim.fr>

	* gdb.texinfo (TUI Single Key Mode): Document new SingleKey mode.
	(TUI Keys): Likewise.
Index: gdb.texinfo
===================================================================
RCS file: /cvs/src/src/gdb/doc/gdb.texinfo,v
retrieving revision 1.115
diff -u -p -r1.115 gdb.texinfo
--- gdb.texinfo	25 Aug 2002 19:10:15 -0000	1.115
+++ gdb.texinfo	31 Aug 2002 15:54:13 -0000
@@ -13101,6 +13101,7 @@ letter.
 @menu
 * TUI Overview::                TUI overview
 * TUI Keys::                    TUI key bindings
+* TUI Single Key Mode::         TUI single key mode
 * TUI Commands::                TUI specific commands
 * TUI Configuration::           TUI configuration variables
 @end menu
@@ -13186,7 +13187,9 @@ assembly and registers
 The TUI installs several key bindings in the readline keymaps
 (@pxref{Command Line Editing}).
 They allow to leave or enter in the TUI mode or they operate
-directly on the TUI layout and windows.  The following key bindings
+directly on the TUI layout and windows.  The TUI also provides
+a @emph{SingleKey} keymap which binds several keys directly to
+@value{GDBN} commands.  The following key bindings
 are installed for both TUI mode and the @value{GDBN} standard mode.
 
 @table @kbd
@@ -13219,6 +13222,11 @@ previous layout and the new one.
 
 Think of it as the Emacs @kbd{C-x 2} binding.
 
+@kindex C-x s
+@item C-x s
+Use the TUI @emph{SingleKey} keymap that binds single key to gdb commands
+(@pxref{TUI Single Key Mode}).
+
 @end table
 
 The following key bindings are handled only by the TUI mode:
@@ -13258,6 +13266,65 @@ In the TUI mode, the arrow keys are used
 for scrolling.  This means they are not available for readline.  It is
 necessary to use other readline key bindings such as @key{C-p}, @key{C-n},
 @key{C-b} and @key{C-f}.
+
+@node TUI Single Key Mode
+@section TUI Single Key Mode
+@cindex TUI single key mode
+
+The TUI provides a @emph{SingleKey} mode in which it installs a particular
+key binding in the readline keymaps to connect single keys to
+some gdb commands. 
+
+@table @kbd
+@kindex c
+@item c
+continue
+
+@kindex d
+@item d
+down
+
+@kindex f
+@item f
+finish
+
+@kindex n
+@item n
+next
+
+@kindex q
+@item q
+exit the @emph{SingleKey} mode.
+
+@kindex r
+@item r
+run
+
+@kindex s
+@item s
+step
+
+@kindex u
+@item u
+up
+
+@kindex v
+@item v
+info locals
+
+@kindex w
+@item w
+where
+
+@end table
+
+Other keys temporarily switch to the @value{GDBN} command prompt.
+The key that was pressed is inserted in the editing buffer so that
+it is possible to type most @value{GDBN} commands without interaction
+with the TUI @emph{SingleKey} mode.  Once the command is entered the TUI
+@emph{SingleKey} mode is restored.  The only way to permanently leave
+this mode is by hitting @key{q} or @samp{@key{C-x} @key{s}}.
+
 
 @node TUI Commands
 @section TUI specific commands