From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: (qmail 32615 invoked by alias); 13 Dec 2013 15:51:30 -0000 Mailing-List: contact gdb-patches-help@sourceware.org; run by ezmlm Precedence: bulk List-Id: List-Subscribe: List-Archive: List-Post: List-Help: , Sender: gdb-patches-owner@sourceware.org Received: (qmail 32602 invoked by uid 89); 13 Dec 2013 15:51:30 -0000 Authentication-Results: sourceware.org; auth=none X-Virus-Found: No X-Spam-SWARE-Status: No, score=-1.0 required=5.0 tests=AWL,BAYES_00 autolearn=ham version=3.3.2 X-HELO: rock.gnat.com Received: from rock.gnat.com (HELO rock.gnat.com) (205.232.38.15) by sourceware.org (qpsmtpd/0.93/v0.84-503-g423c35a) with (AES256-SHA encrypted) ESMTPS; Fri, 13 Dec 2013 15:51:28 +0000 Received: from localhost (localhost.localdomain [127.0.0.1]) by filtered-rock.gnat.com (Postfix) with ESMTP id 8F0F3116698; Fri, 13 Dec 2013 10:52:05 -0500 (EST) Received: from rock.gnat.com ([127.0.0.1]) by localhost (rock.gnat.com [127.0.0.1]) (amavisd-new, port 10024) with LMTP id nT2zPp9WSiEK; Fri, 13 Dec 2013 10:52:05 -0500 (EST) Received: from joel.gnat.com (localhost.localdomain [127.0.0.1]) by rock.gnat.com (Postfix) with ESMTP id 6981111668F; Fri, 13 Dec 2013 10:52:05 -0500 (EST) Received: by joel.gnat.com (Postfix, from userid 1000) id D3D61E07DF; Fri, 13 Dec 2013 16:51:24 +0100 (CET) Date: Fri, 13 Dec 2013 15:51:00 -0000 From: Joel Brobecker To: Eli Zaretskii Cc: gdb-patches@sourceware.org Subject: Re: [RFA/commit+doco] GDB/MI: Document support for -exec-run --start in -list-features Message-ID: <20131213155124.GD3255@adacore.com> References: <1386051670-28637-1-git-send-email-brobecker@adacore.com> <83wqjm4cwl.fsf@gnu.org> <20131210120252.GD3238@adacore.com> <83eh5ky5b8.fsf@gnu.org> <20131213061036.GA3171@adacore.com> MIME-Version: 1.0 Content-Type: multipart/mixed; boundary="O3RTKUHj+75w1tg5" Content-Disposition: inline In-Reply-To: <20131213061036.GA3171@adacore.com> User-Agent: Mutt/1.5.21 (2010-09-15) X-SW-Source: 2013-12/txt/msg00534.txt.bz2 --O3RTKUHj+75w1tg5 Content-Type: text/plain; charset=us-ascii Content-Disposition: inline Content-length: 1153 > > > After further consideration, and despite the fact that I said that > > > the list might not grow that fast, I still tend to agree with you. > > > I'll do that next. I think we should extract the text out of the > > > "misc[...]" node, and move it up to its own node. > > Attached is a patch that does that. The diff looks different from > the ChangeLog entry, but it's equivalent. As explained in the ChangeLog > entry, I didn't change the text, only moved it, after having added > a small introduction to the section. > > gdb/doc/ChangeLog: > > * gdb.texinfo (GDB/MI): Add "GDB/MI Support Commands" entry > in menu. > (GDB/MI Support Commands): New node, with its contents being > extracted from the "GDB/MI Miscellaneous Commands" node. > A small paragraph introducing the section is also added at > the start. > (GDB/MI Miscellaneous Commands): Delete the description of the > -info-gdb-mi-command, -list-features and -list-target-features > commands, now hosted in the "GDB/MI Support Commands" node. > > OK to install? Sorry, I think I forgot the patch! -- Joel --O3RTKUHj+75w1tg5 Content-Type: text/x-diff; charset=us-ascii Content-Disposition: attachment; filename="0001-Move-GDB-MI-commands-related-to-support-query-to-the.patch" Content-length: 8432 >From 33d128e63dc704bdcf6fa42149ef5961a6b1abd8 Mon Sep 17 00:00:00 2001 From: Joel Brobecker Date: Fri, 13 Dec 2013 07:01:33 +0100 Subject: [PATCH] Move GDB/MI commands related to support-query to their own @node. A number of commands provide the capability to query the debugger about support for various features, and one of them in particular (-list-features), is expected to grow as new features get added. -list-target-features should also grow a bit over time, but probably slower. These commands deserve their own section and @node. gdb/doc/ChangeLog: * gdb.texinfo (GDB/MI): Add "GDB/MI Support Commands" entry in menu. (GDB/MI Support Commands): New node, with its contents being extracted from the "GDB/MI Miscellaneous Commands" node. A small paragraph introducing the section is also added at the start. (GDB/MI Miscellaneous Commands): Delete the description of the -info-gdb-mi-command, -list-features and -list-target-features commands, now hosted in the "GDB/MI Support Commands" node. --- gdb/doc/gdb.texinfo | 290 +++++++++++++++++++++++++++------------------------- 1 file changed, 150 insertions(+), 140 deletions(-) diff --git a/gdb/doc/gdb.texinfo b/gdb/doc/gdb.texinfo index d7c90f5..a497c83 100644 --- a/gdb/doc/gdb.texinfo +++ b/gdb/doc/gdb.texinfo @@ -28831,6 +28831,7 @@ may repeat one or more times. * GDB/MI Target Manipulation:: * GDB/MI File Transfer Commands:: * GDB/MI Ada Exceptions Commands:: +* GDB/MI Support Commands:: * GDB/MI Miscellaneous Commands:: @end menu @@ -35015,145 +35016,13 @@ Catchpoint Commands}. @c %%%%%%%%%%%%%%%%%%%%%%%%%%%% SECTION %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%% -@node GDB/MI Miscellaneous Commands -@section Miscellaneous @sc{gdb/mi} Commands - -@c @subheading -gdb-complete - -@subheading The @code{-gdb-exit} Command -@findex -gdb-exit - -@subsubheading Synopsis - -@smallexample - -gdb-exit -@end smallexample - -Exit @value{GDBN} immediately. - -@subsubheading @value{GDBN} Command - -Approximately corresponds to @samp{quit}. - -@subsubheading Example - -@smallexample -(gdb) --gdb-exit -^exit -@end smallexample - - -@ignore -@subheading The @code{-exec-abort} Command -@findex -exec-abort - -@subsubheading Synopsis - -@smallexample - -exec-abort -@end smallexample - -Kill the inferior running program. - -@subsubheading @value{GDBN} Command - -The corresponding @value{GDBN} command is @samp{kill}. - -@subsubheading Example -N.A. -@end ignore - - -@subheading The @code{-gdb-set} Command -@findex -gdb-set - -@subsubheading Synopsis - -@smallexample - -gdb-set -@end smallexample - -Set an internal @value{GDBN} variable. -@c IS THIS A DOLLAR VARIABLE? OR SOMETHING LIKE ANNOTATE ????? - -@subsubheading @value{GDBN} Command - -The corresponding @value{GDBN} command is @samp{set}. - -@subsubheading Example - -@smallexample -(gdb) --gdb-set $foo=3 -^done -(gdb) -@end smallexample - - -@subheading The @code{-gdb-show} Command -@findex -gdb-show - -@subsubheading Synopsis - -@smallexample - -gdb-show -@end smallexample - -Show the current value of a @value{GDBN} variable. - -@subsubheading @value{GDBN} Command - -The corresponding @value{GDBN} command is @samp{show}. - -@subsubheading Example - -@smallexample -(gdb) --gdb-show annotate -^done,value="0" -(gdb) -@end smallexample - -@c @subheading -gdb-source - - -@subheading The @code{-gdb-version} Command -@findex -gdb-version +@node GDB/MI Support Commands +@section @sc{gdb/mi} Support Commands -@subsubheading Synopsis - -@smallexample - -gdb-version -@end smallexample - -Show version information for @value{GDBN}. Used mostly in testing. - -@subsubheading @value{GDBN} Command - -The @value{GDBN} equivalent is @samp{show version}. @value{GDBN} by -default shows this information when you start an interactive session. - -@subsubheading Example - -@c This example modifies the actual output from GDB to avoid overfull -@c box in TeX. -@smallexample -(gdb) --gdb-version -~GNU gdb 5.2.1 -~Copyright 2000 Free Software Foundation, Inc. -~GDB is free software, covered by the GNU General Public License, and -~you are welcome to change it and/or distribute copies of it under -~ certain conditions. -~Type "show copying" to see the conditions. -~There is absolutely no warranty for GDB. Type "show warranty" for -~ details. -~This GDB was configured as - "--host=sparc-sun-solaris2.5.1 --target=ppc-eabi". -^done -(gdb) -@end smallexample +Since new commands and features get regularly added to @sc{gdb/mi}, +some commands are available to help front-ends query the debugger +about support for these capabilities. Similarly, it is also possible +to query @value{GDBN} about target support of certain features. @subheading The @code{-info-gdb-mi-command} Command @cindex @code{-info-gdb-mi-command} @@ -35215,11 +35084,11 @@ this version of gdb implements. A feature can be a command, or a new field in an output of some command, or even an important bugfix. While a frontend can sometimes detect presence of a feature at runtime, it is easier to perform detection at debugger -startup. +startup. The command returns a list of strings, with each string naming an available feature. Each returned string is just a name, it does not -have any internal structure. The list of possible feature names +have any internal structure. The list of possible feature names is given below. Example output: @@ -35298,6 +35167,147 @@ Indicates that the target is capable of reverse execution. @end table +@c %%%%%%%%%%%%%%%%%%%%%%%%%%%% SECTION %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%% +@node GDB/MI Miscellaneous Commands +@section Miscellaneous @sc{gdb/mi} Commands + +@c @subheading -gdb-complete + +@subheading The @code{-gdb-exit} Command +@findex -gdb-exit + +@subsubheading Synopsis + +@smallexample + -gdb-exit +@end smallexample + +Exit @value{GDBN} immediately. + +@subsubheading @value{GDBN} Command + +Approximately corresponds to @samp{quit}. + +@subsubheading Example + +@smallexample +(gdb) +-gdb-exit +^exit +@end smallexample + + +@ignore +@subheading The @code{-exec-abort} Command +@findex -exec-abort + +@subsubheading Synopsis + +@smallexample + -exec-abort +@end smallexample + +Kill the inferior running program. + +@subsubheading @value{GDBN} Command + +The corresponding @value{GDBN} command is @samp{kill}. + +@subsubheading Example +N.A. +@end ignore + + +@subheading The @code{-gdb-set} Command +@findex -gdb-set + +@subsubheading Synopsis + +@smallexample + -gdb-set +@end smallexample + +Set an internal @value{GDBN} variable. +@c IS THIS A DOLLAR VARIABLE? OR SOMETHING LIKE ANNOTATE ????? + +@subsubheading @value{GDBN} Command + +The corresponding @value{GDBN} command is @samp{set}. + +@subsubheading Example + +@smallexample +(gdb) +-gdb-set $foo=3 +^done +(gdb) +@end smallexample + + +@subheading The @code{-gdb-show} Command +@findex -gdb-show + +@subsubheading Synopsis + +@smallexample + -gdb-show +@end smallexample + +Show the current value of a @value{GDBN} variable. + +@subsubheading @value{GDBN} Command + +The corresponding @value{GDBN} command is @samp{show}. + +@subsubheading Example + +@smallexample +(gdb) +-gdb-show annotate +^done,value="0" +(gdb) +@end smallexample + +@c @subheading -gdb-source + + +@subheading The @code{-gdb-version} Command +@findex -gdb-version + +@subsubheading Synopsis + +@smallexample + -gdb-version +@end smallexample + +Show version information for @value{GDBN}. Used mostly in testing. + +@subsubheading @value{GDBN} Command + +The @value{GDBN} equivalent is @samp{show version}. @value{GDBN} by +default shows this information when you start an interactive session. + +@subsubheading Example + +@c This example modifies the actual output from GDB to avoid overfull +@c box in TeX. +@smallexample +(gdb) +-gdb-version +~GNU gdb 5.2.1 +~Copyright 2000 Free Software Foundation, Inc. +~GDB is free software, covered by the GNU General Public License, and +~you are welcome to change it and/or distribute copies of it under +~ certain conditions. +~Type "show copying" to see the conditions. +~There is absolutely no warranty for GDB. Type "show warranty" for +~ details. +~This GDB was configured as + "--host=sparc-sun-solaris2.5.1 --target=ppc-eabi". +^done +(gdb) +@end smallexample + @subheading The @code{-list-thread-groups} Command @findex -list-thread-groups -- 1.8.1.2 --O3RTKUHj+75w1tg5--