From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: (qmail 14943 invoked by alias); 31 Aug 2002 16:59:04 -0000 Mailing-List: contact gdb-patches-help@sources.redhat.com; run by ezmlm Precedence: bulk List-Subscribe: List-Archive: List-Post: List-Help: , Sender: gdb-patches-owner@sources.redhat.com Received: (qmail 14936 invoked from network); 31 Aug 2002 16:59:03 -0000 Received: from unknown (HELO kraid.nerim.net) (62.4.16.95) by sources.redhat.com with SMTP; 31 Aug 2002 16:59:03 -0000 Received: from nerim.fr (stcarrez.net1.nerim.net [62.212.108.40]) by kraid.nerim.net (Postfix) with ESMTP id 5A71645938; Sat, 31 Aug 2002 18:03:51 +0200 (CEST) Message-ID: <3D7106FD.7050303@nerim.fr> Date: Sat, 31 Aug 2002 09:59:00 -0000 From: Stephane Carrez User-Agent: Mozilla/5.0 (X11; U; Linux i686; en-US; rv:0.9.8) Gecko/20020204 X-Accept-Language: en-us MIME-Version: 1.0 To: gdb-patches@sources.redhat.com, eliz@is.elta.co.il Subject: [RFA]: Document TUI SingleKey Content-Type: multipart/mixed; boundary="------------080605040800090106090802" X-SW-Source: 2002-08/txt/msg01067.txt.bz2 This is a multi-part message in MIME format. --------------080605040800090106090802 Content-Type: text/plain; charset=us-ascii; format=flowed Content-Transfer-Encoding: 7bit Content-length: 432 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 * gdb.texinfo (TUI Single Key Mode): Document new SingleKey mode. (TUI Keys): Likewise. --------------080605040800090106090802 Content-Type: text/plain; name="gdb-key.diffs" Content-Transfer-Encoding: 7bit Content-Disposition: inline; filename="gdb-key.diffs" Content-length: 2762 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 --------------080605040800090106090802--