From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: (qmail 10116 invoked by alias); 1 Sep 2002 08:45:57 -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 10092 invoked from network); 1 Sep 2002 08:45:54 -0000 Received: from unknown (HELO mallaury.noc.nerim.net) (62.4.17.82) by sources.redhat.com with SMTP; 1 Sep 2002 08:45:54 -0000 Received: from nerim.fr (stcarrez.net1.nerim.net [62.212.108.40]) by mallaury.noc.nerim.net (Postfix) with ESMTP id 7E25762D2F; Sun, 1 Sep 2002 10:45:52 +0200 (CEST) Message-ID: <3D71EFDE.8060005@nerim.fr> Date: Sun, 01 Sep 2002 01:45: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: Eli Zaretskii Cc: gdb-patches@sources.redhat.com Subject: Re: [RFA]: Document TUI SingleKey References: Content-Type: multipart/mixed; boundary="------------070207000901000309060700" X-SW-Source: 2002-09/txt/msg00000.txt.bz2 This is a multi-part message in MIME format. --------------070207000901000309060700 Content-Type: text/plain; charset=us-ascii; format=flowed Content-Transfer-Encoding: 7bit Content-length: 574 Hi Eli! Eli Zaretskii wrote: > > @kindex c@r{, SingleKey TUI key} > Ok! The index looks better. To be homogeneous with other index entries I've used the following: @kindex c @r{(SingleKey TUI key)} so we now see c (continue) c (Single Key TUI Key) I've committed the following patch and verified on pdf (well, is it acroread or a better texinfo, it's the first time I see a good/outstanding PDF for a GNU manual). Stephane 2002-09-01 Stephane Carrez * gdb.texinfo (TUI Single Key Mode): Document new SingleKey mode. (TUI Keys): Likewise. --------------070207000901000309060700 Content-Type: text/plain; name="gdb-tui-key.diffs" Content-Transfer-Encoding: 7bit Content-Disposition: inline; filename="gdb-tui-key.diffs" Content-length: 3001 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 1 Sep 2002 08:30:42 -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 @r{(SingleKey TUI key)} +@item c +continue + +@kindex d @r{(SingleKey TUI key)} +@item d +down + +@kindex f @r{(SingleKey TUI key)} +@item f +finish + +@kindex n @r{(SingleKey TUI key)} +@item n +next + +@kindex q @r{(SingleKey TUI key)} +@item q +exit the @emph{SingleKey} mode. + +@kindex r @r{(SingleKey TUI key)} +@item r +run + +@kindex s @r{(SingleKey TUI key)} +@item s +step + +@kindex u @r{(SingleKey TUI key)} +@item u +up + +@kindex v @r{(SingleKey TUI key)} +@item v +info locals + +@kindex w @r{(SingleKey TUI key)} +@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 --------------070207000901000309060700--