darkkirb/old-cross-binutils
1
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity

Move GDB/MI commands related to support-query to their own @node.

Browse source 
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 Variable Objects): Adjust reference to "-list-features"
        command, now in a new node.
        (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.
This commit is contained in:
Joel Brobecker 2013-12-13 07:01:33 +01:00
parent 8c707abce7
commit d192b37306
2 changed files with 168 additions and 144 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

14
gdb/doc/ChangeLog
View file

@ -1,3 +1,17 @@
2013-12-23 Joel Brobecker <brobecker@adacore.com>
* gdb.texinfo (GDB/MI): Add "GDB/MI Support Commands" entry
in menu.
(GDB/MI Variable Objects): Adjust reference to "-list-features"
command, now in a new node.
(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.
2013-12-12 Siva Chandra Reddy <sivachandra@google.com>
PR python/16113

288
gdb/doc/gdb.texinfo
View file

@ -28845,6 +28845,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
@ -33003,7 +33004,7 @@ select a visualizer by following the built-in process
a varobj is created, and so ordinarily is not needed.
This feature is only available if Python support is enabled. The MI
command @code{-list-features} (@pxref{GDB/MI Miscellaneous Commands})
command @code{-list-features} (@pxref{GDB/MI Support Commands})
can be used to check this.
@subsubheading Example
@ -35029,145 +35030,13 @@ Catchpoint Commands}.
@c %%%%%%%%%%%%%%%%%%%%%%%%%%%% SECTION %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
@node GDB/MI Miscellaneous Commands
@section Miscellaneous @sc{gdb/mi} Commands
@node GDB/MI Support Commands
@section @sc{gdb/mi} Support 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
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}
@ -35312,6 +35181,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