From patchwork Mon Feb 13 16:47:19 2023 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Pedro Alves X-Patchwork-Id: 64912 Return-Path: X-Original-To: patchwork@sourceware.org Delivered-To: patchwork@sourceware.org Received: from server2.sourceware.org (localhost [IPv6:::1]) by sourceware.org (Postfix) with ESMTP id 85A1E3858C36 for ; Mon, 13 Feb 2023 16:47:51 +0000 (GMT) X-Original-To: gdb-patches@sourceware.org Delivered-To: gdb-patches@sourceware.org Received: from mail-wm1-f51.google.com (mail-wm1-f51.google.com [209.85.128.51]) by sourceware.org (Postfix) with ESMTPS id 070B63857B9B for ; Mon, 13 Feb 2023 16:47:26 +0000 (GMT) DMARC-Filter: OpenDMARC Filter v1.4.2 sourceware.org 070B63857B9B Authentication-Results: sourceware.org; dmarc=none (p=none dis=none) header.from=palves.net Authentication-Results: sourceware.org; spf=pass smtp.mailfrom=gmail.com Received: by mail-wm1-f51.google.com with SMTP id f47-20020a05600c492f00b003dc584a7b7eso11718430wmp.3 for ; Mon, 13 Feb 2023 08:47:25 -0800 (PST) X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20210112; h=content-transfer-encoding:content-language:in-reply-to:mime-version :user-agent:date:message-id:from:references:cc:to:subject :x-gm-message-state:from:to:cc:subject:date:message-id:reply-to; bh=r4bOxF7hXIEzZB9cgEzsnvyXy4GVXzZ9yh9JpUw4BOc=; b=QIM3lURNS8NRTINGapRclWfMqy1BfkINiiti4zBQ86GUBeFoL2OAh+qk+rGV8d82eR Qc1kuJ42IL2WFZPKUKmG8M98T0uvRSC8ll689cN9XoIXg5y8Dmv0WV5A4NFW8voFw31n lzI6bBahZguprMuI2NAIw+MvApHe0GFc/juQu97FWTc0EoZQppibGU3U4vgv0qqcFoF7 ZtQjxhdmP48mugiF0eygV1pzYpzZpIbLXHUp+ifQYJKiGFwbwdv8PqwGIbuZcbRoEHib 2jrzV7VUFOD3WslDtmlWTW3cxJV7O4B4CfqwWWgr708zRt3O3c8gs7FGrow1uZPSF9kG K66w== X-Gm-Message-State: AO0yUKX8dggDa/zyRPLL3gNCrc/wp4c/C7f9GDZ1Vh4O0BKfb+UeeOZ2 DpFwAXjmPXm4pQ29TVnYCCRaGusnrYf9UA== X-Google-Smtp-Source: AK7set8PujyZDDWXiAAEjvYtEmVUgzfdIYuTzc6gIEXfFpVjonR7+SyMOZWWTicSd8oRJThA1uqblQ== X-Received: by 2002:a05:600c:1895:b0:3dc:4aa6:a8a9 with SMTP id x21-20020a05600c189500b003dc4aa6a8a9mr18933185wmp.7.1676306844030; Mon, 13 Feb 2023 08:47:24 -0800 (PST) Received: from ?IPv6:2001:8a0:f92b:9e00::1fe? ([2001:8a0:f92b:9e00::1fe]) by smtp.gmail.com with ESMTPSA id k7-20020a05600c080700b003daf672a616sm13707529wmp.22.2023.02.13.08.47.23 (version=TLS1_3 cipher=TLS_AES_128_GCM_SHA256 bits=128/128); Mon, 13 Feb 2023 08:47:23 -0800 (PST) Subject: [PATCH] gdb/manual: Move @findex entries (was: Re: [PATCH 3/6] Add new "$_shell(CMD)" internal function) To: Eli Zaretskii Cc: gdb-patches@sourceware.org References: <20230210233604.2228450-1-pedro@palves.net> <20230210233604.2228450-4-pedro@palves.net> <83r0uwk4tm.fsf@gnu.org> <439ab6f5-ec2d-87ef-d84c-3ace9ead93a8@palves.net> <833579fugd.fsf@gnu.org> From: Pedro Alves Message-ID: Date: Mon, 13 Feb 2023 16:47:19 +0000 User-Agent: Mozilla/5.0 (X11; Linux x86_64; rv:78.0) Gecko/20100101 Thunderbird/78.10.1 MIME-Version: 1.0 In-Reply-To: <833579fugd.fsf@gnu.org> Content-Language: en-US X-Spam-Status: No, score=-10.2 required=5.0 tests=BAYES_00, FREEMAIL_FORGED_FROMDOMAIN, FREEMAIL_FROM, GIT_PATCH_0, HEADER_FROM_DIFFERENT_DOMAINS, KAM_DMARC_STATUS, RCVD_IN_DNSWL_NONE, RCVD_IN_MSPIKE_H2, SPF_HELO_NONE, SPF_PASS, TXREP autolearn=ham autolearn_force=no version=3.4.6 X-Spam-Checker-Version: SpamAssassin 3.4.6 (2021-04-09) on server2.sourceware.org X-BeenThere: gdb-patches@sourceware.org X-Mailman-Version: 2.1.29 Precedence: list List-Id: Gdb-patches mailing list List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: gdb-patches-bounces+patchwork=sourceware.org@sourceware.org Sender: "Gdb-patches" On 2023-02-13 3:36 p.m., Eli Zaretskii wrote: >> From: Pedro Alves >>>> +@anchor{$_shell convenience function} >>>> +@item $_shell (@var{command-string}) >>>> +@findex $_shell@r{, convenience function} >>> >>> @fined should be _before_ @item, so that the index records the >>> position of @item, and the Info reader places you before the @item >>> when you use index-search. >> >> But the whole "Convenience Funs" node has has item/findex sorted like that, >> I just copied the preceding example. Here's what we have: >> >> @item $_isvoid (@var{expr}) >> @findex $_isvoid@r{, convenience function} >> ... >> @item $_gdb_setting_str (@var{setting}) >> @findex $_gdb_setting_str@r{, convenience function} >> ... >> @item $_gdb_setting (@var{setting}) >> @findex $_gdb_setting@r{, convenience function} >> ... >> @item $_gdb_maint_setting_str (@var{setting}) >> @findex $_gdb_maint_setting_str@r{, convenience function} >> ... >> @item $_gdb_maint_setting (@var{setting}) >> @findex $_gdb_maint_setting@r{, convenience function} >> >> Are all these wrong? Sounds like they should all be fixed in one go. > > Yes, they are all wrong. The result is not a catastrophe, it's just > sub-optimal. > >> I don't usually use the info reader, so I'm not really sure what to look for. > > In an Info reader, type "i NAME" where NAME is the name of a function, > and see where it lands you. Thanks, I see now. Here's a patch fixing that throughout the manual. Turns out that most if not all @findex calls in gdb.texinfo needed to be fixed. WDYT? From: Pedro Alves Subject: [PATCH] gdb/manual: Move @findex entries The manual currently has many cases like these: @item $_gdb_setting_str (@var{setting}) @findex $_gdb_setting_str@r{, convenience function} As suggested by Eli, move the @findex entries before @item so that the index records the position of @item, and the Info reader places you there when you use index-search. I went over all @findex calls in the manual, and most are like the above. Most either appear before @item, or before @subheading, like: @subheading The @code{-break-after} Command @findex -break-after I fixed all of them. There are findex entries in annotate.texinfo,python.texi, and stabs.texinfo as well, though those all look right to me already. Tested by typing "i _isvoid" (@item case) and "i -complete" (@subheading case) in an Info reader, and checking where those took me. Change-Id: Idb6903b0bb39ff03f93524628dcef86b5585c97e Suggested-By: Eli Zaretskii --- gdb/doc/gdb.texinfo | 330 ++++++++++++++++++++++---------------------- 1 file changed, 165 insertions(+), 165 deletions(-) base-commit: 5036bde964bc1a18282dde536a95aecd0d2c08fb diff --git a/gdb/doc/gdb.texinfo b/gdb/doc/gdb.texinfo index 7b128053b5a..79cb06e496e 100644 --- a/gdb/doc/gdb.texinfo +++ b/gdb/doc/gdb.texinfo @@ -12824,8 +12824,8 @@ These functions do not require @value{GDBN} to be configured with @table @code -@item $_isvoid (@var{expr}) @findex $_isvoid@r{, convenience function} +@item $_isvoid (@var{expr}) Return one if the expression @var{expr} is @code{void}. Otherwise it returns zero. @@ -12880,8 +12880,8 @@ $3 = void $4 = 1 @end smallexample -@item $_gdb_setting_str (@var{setting}) @findex $_gdb_setting_str@r{, convenience function} +@item $_gdb_setting_str (@var{setting}) Return the value of the @value{GDBN} @var{setting} as a string. @var{setting} is any setting that can be used in a @code{set} or @code{show} command (@pxref{Controlling GDB}). @@ -12896,8 +12896,8 @@ $2 = "30" (@value{GDBP}) @end smallexample -@item $_gdb_setting (@var{setting}) @findex $_gdb_setting@r{, convenience function} +@item $_gdb_setting (@var{setting}) Return the value of the @value{GDBN} @var{setting}. The type of the returned value depends on the setting. @@ -12959,13 +12959,13 @@ Other setting types (enum, filename, optional filename, string, string noescape) are returned as string values. -@item $_gdb_maint_setting_str (@var{setting}) @findex $_gdb_maint_setting_str@r{, convenience function} +@item $_gdb_maint_setting_str (@var{setting}) Like the @code{$_gdb_setting_str} function, but works with @code{maintenance set} variables. -@item $_gdb_maint_setting (@var{setting}) @findex $_gdb_maint_setting@r{, convenience function} +@item $_gdb_maint_setting (@var{setting}) Like the @code{$_gdb_setting} function, but works with @code{maintenance set} variables. @@ -12976,30 +12976,30 @@ The following functions require @value{GDBN} to be configured with @table @code -@item $_memeq(@var{buf1}, @var{buf2}, @var{length}) @findex $_memeq@r{, convenience function} +@item $_memeq(@var{buf1}, @var{buf2}, @var{length}) Returns one if the @var{length} bytes at the addresses given by @var{buf1} and @var{buf2} are equal. Otherwise it returns zero. -@item $_regex(@var{str}, @var{regex}) @findex $_regex@r{, convenience function} +@item $_regex(@var{str}, @var{regex}) Returns one if the string @var{str} matches the regular expression @var{regex}. Otherwise it returns zero. The syntax of the regular expression is that specified by @code{Python}'s regular expression support. -@item $_streq(@var{str1}, @var{str2}) @findex $_streq@r{, convenience function} +@item $_streq(@var{str1}, @var{str2}) Returns one if the strings @var{str1} and @var{str2} are equal. Otherwise it returns zero. -@item $_strlen(@var{str}) @findex $_strlen@r{, convenience function} +@item $_strlen(@var{str}) Returns the length of string @var{str}. -@item $_caller_is(@var{name}@r{[}, @var{number_of_frames}@r{]}) @findex $_caller_is@r{, convenience function} +@item $_caller_is(@var{name}@r{[}, @var{number_of_frames}@r{]}) Returns one if the calling function's name is equal to @var{name}. Otherwise it returns zero. @@ -13025,8 +13025,8 @@ $1 = 1 $1 = 1 @end smallexample -@item $_caller_matches(@var{regexp}@r{[}, @var{number_of_frames}@r{]}) @findex $_caller_matches@r{, convenience function} +@item $_caller_matches(@var{regexp}@r{[}, @var{number_of_frames}@r{]}) Returns one if the calling function's name matches the regular expression @var{regexp}. Otherwise it returns zero. @@ -13034,8 +13034,8 @@ If the optional argument @var{number_of_frames} is provided, it is the number of frames up in the stack to look. The default is 1. -@item $_any_caller_is(@var{name}@r{[}, @var{number_of_frames}@r{]}) @findex $_any_caller_is@r{, convenience function} +@item $_any_caller_is(@var{name}@r{[}, @var{number_of_frames}@r{]}) Returns one if any calling function's name is equal to @var{name}. Otherwise it returns zero. @@ -13048,8 +13048,8 @@ checks all stack frames from the immediate caller to the frame specified by @var{number_of_frames}, whereas @code{$_caller_is} only checks the frame specified by @var{number_of_frames}. -@item $_any_caller_matches(@var{regexp}@r{[}, @var{number_of_frames}@r{]}) @findex $_any_caller_matches@r{, convenience function} +@item $_any_caller_matches(@var{regexp}@r{[}, @var{number_of_frames}@r{]}) Returns one if any calling function's name matches the regular expression @var{regexp}. Otherwise it returns zero. @@ -13062,8 +13062,8 @@ checks all stack frames from the immediate caller to the frame specified by @var{number_of_frames}, whereas @code{$_caller_matches} only checks the frame specified by @var{number_of_frames}. -@item $_as_string(@var{value}) @findex $_as_string@r{, convenience function} +@item $_as_string(@var{value}) Return the string representation of @var{value}. This function is useful to obtain the textual label (enumerator) of an @@ -13075,10 +13075,10 @@ an enumerated type: Visiting node of type NODE_INTEGER @end smallexample -@item $_cimag(@var{value}) -@itemx $_creal(@var{value}) @findex $_cimag@r{, convenience function} @findex $_creal@r{, convenience function} +@item $_cimag(@var{value}) +@itemx $_creal(@var{value}) Return the imaginary (@code{$_cimag}) or real (@code{$_creal}) part of the complex number @var{value}. @@ -24260,15 +24260,15 @@ The debugging stub for your architecture supplies these three subroutines: @table @code -@item set_debug_traps @findex set_debug_traps +@item set_debug_traps @cindex remote serial stub, initialization This routine arranges for @code{handle_exception} to run when your program stops. You must call this subroutine explicitly in your program's startup code. -@item handle_exception @findex handle_exception +@item handle_exception @cindex remote serial stub, main routine This is the central workhorse, but your program never calls it explicitly---the setup code arranges for @code{handle_exception} to @@ -24315,14 +24315,14 @@ First of all you need to tell the stub how to communicate with the serial port. @table @code -@item int getDebugChar() @findex getDebugChar +@item int getDebugChar() Write this subroutine to read a single character from the serial port. It may be identical to @code{getchar} for your target system; a different name is used to allow you to distinguish the two if you wish. -@item void putDebugChar(int) @findex putDebugChar +@item void putDebugChar(int) Write this subroutine to write a single character to the serial port. It may be identical to @code{putchar} for your target system; a different name is used to allow you to distinguish the two if you wish. @@ -24344,8 +24344,8 @@ is to just execute a breakpoint instruction (the ``dirty'' part is that Other routines you need to supply are: @table @code -@item void exceptionHandler (int @var{exception_number}, void *@var{exception_address}) @findex exceptionHandler +@item void exceptionHandler (int @var{exception_number}, void *@var{exception_address}) Write this function to install @var{exception_address} in the exception handling tables. You need to do this because the stub does not have any way of knowing what the exception handling tables on your target system @@ -24366,8 +24366,8 @@ should be at privilege level 0 (the most privileged level). The @sc{sparc} and 68k stubs are able to mask interrupts themselves without help from @code{exceptionHandler}. -@item void flush_i_cache() @findex flush_i_cache +@item void flush_i_cache() On @sc{sparc} and @sc{sparclite} only, write this subroutine to flush the instruction cache, if any, on your target machine. If there is no instruction cache, this subroutine may be a no-op. @@ -24380,8 +24380,8 @@ function to make certain that the state of your program is stable. You must also make sure this library routine is available: @table @code -@item void *memset(void *, int, int) @findex memset +@item void *memset(void *, int, int) This is the standard library function @code{memset} that sets an area of memory to a known value. If you have one of the free versions of @code{libc.a}, @code{memset} can be found there; otherwise, you must @@ -31068,8 +31068,8 @@ In addition to a number of out-of-band notifications, the response to a The synchronous operation was successful, @code{@var{results}} are the return values. -@item "^running" @findex ^running +@item "^running" This result record is equivalent to @samp{^done}. Historically, it was output instead of @samp{^done} if the command has resumed the target. This behaviour is maintained for backward compatibility, but @@ -31077,12 +31077,12 @@ all frontends should treat @samp{^done} and @samp{^running} identically and rely on the @samp{*running} output record to determine which threads are resumed. -@item "^connected" @findex ^connected +@item "^connected" @value{GDBN} has connected to a remote target. -@item "^error" "," "msg=" @var{c-string} [ "," "code=" @var{c-string} ] @findex ^error +@item "^error" "," "msg=" @var{c-string} [ "," "code=" @var{c-string} ] The operation failed. The @code{msg=@var{c-string}} variable contains the corresponding error message. @@ -31095,8 +31095,8 @@ error condition. At present, only one error code is defined: Indicates that the command causing the error does not exist. @end table -@item "^exit" @findex ^exit +@item "^exit" @value{GDBN} has terminated. @end table @@ -31752,8 +31752,8 @@ not been implemented yet and these are labeled N.A.@: (not available). This section documents @sc{gdb/mi} commands for manipulating breakpoints. -@subheading The @code{-break-after} Command @findex -break-after +@subheading The @code{-break-after} Command @subsubheading Synopsis @@ -31799,12 +31799,12 @@ line="5",thread-groups=["i1"],times="0",ignore="3"@}]@} @end smallexample @ignore -@subheading The @code{-break-catch} Command @findex -break-catch +@subheading The @code{-break-catch} Command @end ignore -@subheading The @code{-break-commands} Command @findex -break-commands +@subheading The @code{-break-commands} Command @subsubheading Synopsis @@ -31838,8 +31838,8 @@ times="0"@} (gdb) @end smallexample -@subheading The @code{-break-condition} Command @findex -break-condition +@subheading The @code{-break-condition} Command @subsubheading Synopsis @@ -31880,8 +31880,8 @@ line="5",cond="1",thread-groups=["i1"],times="0",ignore="3"@}]@} (gdb) @end smallexample -@subheading The @code{-break-delete} Command @findex -break-delete +@subheading The @code{-break-delete} Command @subsubheading Synopsis @@ -31915,8 +31915,8 @@ body=[]@} (gdb) @end smallexample -@subheading The @code{-break-disable} Command @findex -break-disable +@subheading The @code{-break-disable} Command @subsubheading Synopsis @@ -31952,8 +31952,8 @@ line="5",thread-groups=["i1"],times="0"@}]@} (gdb) @end smallexample -@subheading The @code{-break-enable} Command @findex -break-enable +@subheading The @code{-break-enable} Command @subsubheading Synopsis @@ -31988,8 +31988,8 @@ line="5",thread-groups=["i1"],times="0"@}]@} (gdb) @end smallexample -@subheading The @code{-break-info} Command @findex -break-info +@subheading The @code{-break-info} Command @subsubheading Synopsis @@ -32011,9 +32011,9 @@ The corresponding @value{GDBN} command is @samp{info break @var{breakpoint}}. @subsubheading Example N.A. -@subheading The @code{-break-insert} Command @findex -break-insert @anchor{-break-insert} +@subheading The @code{-break-insert} Command @subsubheading Synopsis @@ -32134,8 +32134,8 @@ times="0"@}]@} (gdb) @end smallexample -@subheading The @code{-dprintf-insert} Command @findex -dprintf-insert +@subheading The @code{-dprintf-insert} Command @subsubheading Synopsis @@ -32208,8 +32208,8 @@ original-location="mi-dprintf.c:26"@} (gdb) @end smallexample -@subheading The @code{-break-list} Command @findex -break-list +@subheading The @code{-break-list} Command @subsubheading Synopsis @@ -32284,8 +32284,8 @@ body=[]@} (gdb) @end smallexample -@subheading The @code{-break-passcount} Command @findex -break-passcount +@subheading The @code{-break-passcount} Command @subsubheading Synopsis @@ -32298,8 +32298,8 @@ Set the passcount for tracepoint @var{tracepoint-number} to is not a tracepoint, error is emitted. This corresponds to CLI command @samp{passcount}. -@subheading The @code{-break-watch} Command @findex -break-watch +@subheading The @code{-break-watch} Command @subsubheading Synopsis @@ -32467,8 +32467,8 @@ catchpoints. @node Shared Library GDB/MI Catchpoint Commands @subsection Shared Library @sc{gdb/mi} Catchpoints -@subheading The @code{-catch-load} Command @findex -catch-load +@subheading The @code{-catch-load} Command @subsubheading Synopsis @@ -32497,8 +32497,8 @@ what="load of library matching foo.so",catch-type="load",times="0"@} @end smallexample -@subheading The @code{-catch-unload} Command @findex -catch-unload +@subheading The @code{-catch-unload} Command @subsubheading Synopsis @@ -32531,8 +32531,8 @@ what="load of library matching bar.so",catch-type="unload",times="0"@} The following @sc{gdb/mi} commands can be used to create catchpoints that stop the execution when Ada exceptions are being raised. -@subheading The @code{-catch-assert} Command @findex -catch-assert +@subheading The @code{-catch-assert} Command @subsubheading Synopsis @@ -32568,8 +32568,8 @@ original-location="__gnat_debug_raise_assert_failure"@} (gdb) @end smallexample -@subheading The @code{-catch-exception} Command @findex -catch-exception +@subheading The @code{-catch-exception} Command @subsubheading Synopsis @@ -32617,8 +32617,8 @@ times="0",original-location="__gnat_debug_raise_exception"@} (gdb) @end smallexample -@subheading The @code{-catch-handlers} Command @findex -catch-handlers +@subheading The @code{-catch-handlers} Command @subsubheading Synopsis @@ -32668,8 +32668,8 @@ The following @sc{gdb/mi} commands can be used to create catchpoints that stop the execution when C@t{++} exceptions are being throw, rethrown, or caught. -@subheading The @code{-catch-throw} Command @findex -catch-throw +@subheading The @code{-catch-throw} Command @subsubheading Synopsis @@ -32712,8 +32712,8 @@ and @samp{tcatch throw} (@pxref{Set Catchpoints}). (gdb) @end smallexample -@subheading The @code{-catch-rethrow} Command @findex -catch-rethrow +@subheading The @code{-catch-rethrow} Command @subsubheading Synopsis @@ -32756,8 +32756,8 @@ and @samp{tcatch rethrow} (@pxref{Set Catchpoints}). (gdb) @end smallexample -@subheading The @code{-catch-catch} Command @findex -catch-catch +@subheading The @code{-catch-catch} Command @subsubheading Synopsis @@ -32804,8 +32804,8 @@ and @samp{tcatch catch} (@pxref{Set Catchpoints}). @node GDB/MI Program Context @section @sc{gdb/mi} Program Context -@subheading The @code{-exec-arguments} Command @findex -exec-arguments +@subheading The @code{-exec-arguments} Command @subsubheading Synopsis @@ -32832,8 +32832,8 @@ The corresponding @value{GDBN} command is @samp{set args}. @ignore -@subheading The @code{-exec-show-arguments} Command @findex -exec-show-arguments +@subheading The @code{-exec-show-arguments} Command @subsubheading Synopsis @@ -32852,8 +32852,8 @@ N.A. @end ignore -@subheading The @code{-environment-cd} Command @findex -environment-cd +@subheading The @code{-environment-cd} Command @subsubheading Synopsis @@ -32877,8 +32877,8 @@ The corresponding @value{GDBN} command is @samp{cd}. @end smallexample -@subheading The @code{-environment-directory} Command @findex -environment-directory +@subheading The @code{-environment-directory} Command @subsubheading Synopsis @@ -32926,8 +32926,8 @@ The corresponding @value{GDBN} command is @samp{dir}. @end smallexample -@subheading The @code{-environment-path} Command @findex -environment-path +@subheading The @code{-environment-path} Command @subsubheading Synopsis @@ -32974,8 +32974,8 @@ The corresponding @value{GDBN} command is @samp{path}. @end smallexample -@subheading The @code{-environment-pwd} Command @findex -environment-pwd +@subheading The @code{-environment-pwd} Command @subsubheading Synopsis @@ -33003,8 +33003,8 @@ The corresponding @value{GDBN} command is @samp{pwd}. @section @sc{gdb/mi} Thread Commands -@subheading The @code{-thread-info} Command @findex -thread-info +@subheading The @code{-thread-info} Command @subsubheading Synopsis @@ -33057,8 +33057,8 @@ current-thread-id="1" (gdb) @end smallexample -@subheading The @code{-thread-list-ids} Command @findex -thread-list-ids +@subheading The @code{-thread-list-ids} Command @subsubheading Synopsis @@ -33088,8 +33088,8 @@ current-thread-id="1",number-of-threads="3" @end smallexample -@subheading The @code{-thread-select} Command @findex -thread-select +@subheading The @code{-thread-select} Command @subsubheading Synopsis @@ -33135,8 +33135,8 @@ args=[@{name="format",value="0x8048e9c \"%*s%c %d %c\\n\""@}, @node GDB/MI Ada Tasking Commands @section @sc{gdb/mi} Ada Tasking Commands -@subheading The @code{-ada-task-info} Command @findex -ada-task-info +@subheading The @code{-ada-task-info} Command @subsubheading Synopsis @@ -33218,8 +33218,8 @@ record @samp{*stopped}. Currently @value{GDBN} only really executes asynchronously with remote targets and this interaction is mimicked in other cases. -@subheading The @code{-exec-continue} Command @findex -exec-continue +@subheading The @code{-exec-continue} Command @subsubheading Synopsis @@ -33280,8 +33280,8 @@ line="13",arch="i386:x86_64"@} (gdb) @end smallexample -@subheading The @code{-exec-finish} Command @findex -exec-finish +@subheading The @code{-exec-finish} Command @subsubheading Synopsis @@ -33330,8 +33330,8 @@ gdb-result-var="$1",return-value="0" @end smallexample -@subheading The @code{-exec-interrupt} Command @findex -exec-interrupt +@subheading The @code{-exec-interrupt} Command @subsubheading Synopsis @@ -33381,8 +33381,8 @@ fullname="/home/foo/bar/try.c",line="13",arch="i386:x86_64"@} (gdb) @end smallexample -@subheading The @code{-exec-jump} Command @findex -exec-jump +@subheading The @code{-exec-jump} Command @subsubheading Synopsis @@ -33407,8 +33407,8 @@ The corresponding @value{GDBN} command is @samp{jump}. @end smallexample -@subheading The @code{-exec-next} Command @findex -exec-next +@subheading The @code{-exec-next} Command @subsubheading Synopsis @@ -33441,8 +33441,8 @@ The corresponding @value{GDBN} command is @samp{next}. @end smallexample -@subheading The @code{-exec-next-instruction} Command @findex -exec-next-instruction +@subheading The @code{-exec-next-instruction} Command @subsubheading Synopsis @@ -33479,8 +33479,8 @@ addr="0x000100d4",line="5",file="hello.c" @end smallexample -@subheading The @code{-exec-return} Command @findex -exec-return +@subheading The @code{-exec-return} Command @subsubheading Synopsis @@ -33526,8 +33526,8 @@ arch="i386:x86_64"@} @end smallexample -@subheading The @code{-exec-run} Command @findex -exec-run +@subheading The @code{-exec-run} Command @subsubheading Synopsis @@ -33610,8 +33610,8 @@ signal-meaning="Interrupt" @c @subheading -exec-signal -@subheading The @code{-exec-step} Command @findex -exec-step +@subheading The @code{-exec-step} Command @subsubheading Synopsis @@ -33656,8 +33656,8 @@ Regular stepping: @end smallexample -@subheading The @code{-exec-step-instruction} Command @findex -exec-step-instruction +@subheading The @code{-exec-step-instruction} Command @subsubheading Synopsis @@ -33700,8 +33700,8 @@ fullname="/home/foo/bar/try.c",line="10",arch="i386:x86_64"@} @end smallexample -@subheading The @code{-exec-until} Command @findex -exec-until +@subheading The @code{-exec-until} Command @subsubheading Synopsis @@ -33741,8 +33741,8 @@ Is this going away???? @node GDB/MI Stack Manipulation @section @sc{gdb/mi} Stack Manipulation Commands -@subheading The @code{-enable-frame-filters} Command @findex -enable-frame-filters +@subheading The @code{-enable-frame-filters} Command @smallexample -enable-frame-filters @@ -33758,8 +33758,8 @@ Once enabled, this feature cannot be disabled. Note that if Python support has not been compiled into @value{GDBN}, this command will still succeed (and do nothing). -@subheading The @code{-stack-info-frame} Command @findex -stack-info-frame +@subheading The @code{-stack-info-frame} Command @subsubheading Synopsis @@ -33786,8 +33786,8 @@ arch="i386:x86_64"@} (gdb) @end smallexample -@subheading The @code{-stack-info-depth} Command @findex -stack-info-depth +@subheading The @code{-stack-info-depth} Command @subsubheading Synopsis @@ -33826,8 +33826,8 @@ For a stack with frame levels 0 through 11: @end smallexample @anchor{-stack-list-arguments} -@subheading The @code{-stack-list-arguments} Command @findex -stack-list-arguments +@subheading The @code{-stack-list-arguments} Command @subsubheading Synopsis @@ -33931,8 +33931,8 @@ args=[@{name="intarg",value="2"@}, @anchor{-stack-list-frames} -@subheading The @code{-stack-list-frames} Command @findex -stack-list-frames +@subheading The @code{-stack-list-frames} Command @subsubheading Synopsis @@ -34055,9 +34055,9 @@ Show a single frame: @end smallexample -@subheading The @code{-stack-list-locals} Command @findex -stack-list-locals @anchor{-stack-list-locals} +@subheading The @code{-stack-list-locals} Command @subsubheading Synopsis @@ -34104,8 +34104,8 @@ This command is deprecated in favor of the @end smallexample @anchor{-stack-list-variables} -@subheading The @code{-stack-list-variables} Command @findex -stack-list-variables +@subheading The @code{-stack-list-variables} Command @subsubheading Synopsis @@ -34135,8 +34135,8 @@ available arguments and local variables are still displayed, however. @end smallexample -@subheading The @code{-stack-select-frame} Command @findex -stack-select-frame +@subheading The @code{-stack-select-frame} Command @subsubheading Synopsis @@ -34332,8 +34332,8 @@ how it can be used. @subheading Description And Use of Operations on Variable Objects -@subheading The @code{-enable-pretty-printing} Command @findex -enable-pretty-printing +@subheading The @code{-enable-pretty-printing} Command @smallexample -enable-pretty-printing @@ -34349,8 +34349,8 @@ Once enabled, this feature cannot be disabled. Note that if Python support has not been compiled into @value{GDBN}, this command will still succeed (and do nothing). -@subheading The @code{-var-create} Command @findex -var-create +@subheading The @code{-var-create} Command @subsubheading Synopsis @@ -34449,8 +34449,8 @@ Typical output will look like this: @end smallexample -@subheading The @code{-var-delete} Command @findex -var-delete +@subheading The @code{-var-delete} Command @subsubheading Synopsis @@ -34464,8 +34464,8 @@ With the @samp{-c} option, just deletes the children. Returns an error if the object @var{name} is not found. -@subheading The @code{-var-set-format} Command @findex -var-set-format +@subheading The @code{-var-set-format} Command @subsubheading Synopsis @@ -34496,8 +34496,8 @@ zero-hexadecimal format. For a variable with children, the format is set only on the variable itself, and the children are not affected. -@subheading The @code{-var-show-format} Command @findex -var-show-format +@subheading The @code{-var-show-format} Command @subsubheading Synopsis @@ -34513,8 +34513,8 @@ Returns the format used to display the value of the object @var{name}. @end smallexample -@subheading The @code{-var-info-num-children} Command @findex -var-info-num-children +@subheading The @code{-var-info-num-children} Command @subsubheading Synopsis @@ -34533,8 +34533,8 @@ It will return the current number of children, but more children may be available. -@subheading The @code{-var-list-children} Command @findex -var-list-children +@subheading The @code{-var-list-children} Command @subsubheading Synopsis @@ -34650,8 +34650,8 @@ remaining after the end of the selected range. @end smallexample -@subheading The @code{-var-info-type} Command @findex -var-info-type +@subheading The @code{-var-info-type} Command @subsubheading Synopsis @@ -34668,8 +34668,8 @@ returned as a string in the same format as it is output by the @end smallexample -@subheading The @code{-var-info-expression} Command @findex -var-info-expression +@subheading The @code{-var-info-expression} Command @subsubheading Synopsis @@ -34697,8 +34697,8 @@ Note that the output of the @code{-var-list-children} command also includes those expressions, so the @code{-var-info-expression} command is of limited use. -@subheading The @code{-var-info-path-expression} Command @findex -var-info-path-expression +@subheading The @code{-var-info-path-expression} Command @subsubheading Synopsis @@ -34726,8 +34726,8 @@ For example, suppose @code{C} is a C@t{++} class, derived from class ^done,path_expr=((Base)c).m_size) @end smallexample -@subheading The @code{-var-show-attributes} Command @findex -var-show-attributes +@subheading The @code{-var-show-attributes} Command @subsubheading Synopsis @@ -34744,8 +34744,8 @@ List attributes of the specified variable object @var{name}: @noindent where @var{attr} is @code{@{ @{ editable | noneditable @} | TBD @}}. -@subheading The @code{-var-evaluate-expression} Command @findex -var-evaluate-expression +@subheading The @code{-var-evaluate-expression} Command @subsubheading Synopsis @@ -34768,8 +34768,8 @@ can be changed using the @code{-var-set-format} command. Note that one must invoke @code{-var-list-children} for a variable before the value of a child variable can be evaluated. -@subheading The @code{-var-assign} Command @findex -var-assign +@subheading The @code{-var-assign} Command @subsubheading Synopsis @@ -34794,8 +34794,8 @@ subsequent @code{-var-update} list. (gdb) @end smallexample -@subheading The @code{-var-update} Command @findex -var-update +@subheading The @code{-var-update} Command @subsubheading Synopsis @@ -34922,9 +34922,9 @@ type_changed="false"@}] (gdb) @end smallexample -@subheading The @code{-var-set-frozen} Command @findex -var-set-frozen @anchor{-var-set-frozen} +@subheading The @code{-var-set-frozen} Command @subsubheading Synopsis @@ -34953,9 +34953,9 @@ Unfreezing a variable does not update it, only subsequent (gdb) @end smallexample -@subheading The @code{-var-set-update-range} command @findex -var-set-update-range @anchor{-var-set-update-range} +@subheading The @code{-var-set-update-range} command @subsubheading Synopsis @@ -34979,9 +34979,9 @@ children will be reported. Otherwise, children starting at @var{from} ^done @end smallexample -@subheading The @code{-var-set-visualizer} command @findex -var-set-visualizer @anchor{-var-set-visualizer} +@subheading The @code{-var-set-visualizer} command @subsubheading Synopsis @@ -35058,8 +35058,8 @@ For details about what an addressable memory unit is, @c @subsubheading Example @c N.A. -@subheading The @code{-data-disassemble} Command @findex -data-disassemble +@subheading The @code{-data-disassemble} Command @subsubheading Synopsis @@ -35314,8 +35314,8 @@ inst="sethi %hi(0x11800), %o2"@}]@}] @end smallexample -@subheading The @code{-data-evaluate-expression} Command @findex -data-evaluate-expression +@subheading The @code{-data-evaluate-expression} Command @subsubheading Synopsis @@ -35356,8 +35356,8 @@ output. @end smallexample -@subheading The @code{-data-list-changed-registers} Command @findex -data-list-changed-registers +@subheading The @code{-data-list-changed-registers} Command @subsubheading Synopsis @@ -35394,8 +35394,8 @@ line="5",arch="powerpc"@} @end smallexample -@subheading The @code{-data-list-register-names} Command @findex -data-list-register-names +@subheading The @code{-data-list-register-names} Command @subsubheading Synopsis @@ -35435,8 +35435,8 @@ For the PPC MBX board: (gdb) @end smallexample -@subheading The @code{-data-list-register-values} Command @findex -data-list-register-values +@subheading The @code{-data-list-register-values} Command @subsubheading Synopsis @@ -35526,8 +35526,8 @@ don't appear in the actual output): @end smallexample -@subheading The @code{-data-read-memory} Command @findex -data-read-memory +@subheading The @code{-data-read-memory} Command This command is deprecated, use @code{-data-read-memory-bytes} instead. @@ -35642,8 +35642,8 @@ next-page="0x000013c0",prev-page="0x00001380",memory=[ (gdb) @end smallexample -@subheading The @code{-data-read-memory-bytes} Command @findex -data-read-memory-bytes +@subheading The @code{-data-read-memory-bytes} Command @subsubheading Synopsis @@ -35728,8 +35728,8 @@ The corresponding @value{GDBN} command is @samp{x}. @end smallexample -@subheading The @code{-data-write-memory-bytes} Command @findex -data-write-memory-bytes +@subheading The @code{-data-write-memory-bytes} Command @subsubheading Synopsis @@ -35786,8 +35786,8 @@ There's no corresponding @value{GDBN} command. The commands defined in this section implement MI support for tracepoints. For detailed introduction, see @ref{Tracepoints}. -@subheading The @code{-trace-find} Command @findex -trace-find +@subheading The @code{-trace-find} Command @subsubheading Synopsis @@ -35861,8 +35861,8 @@ frame. This field is present only if a trace frame was found. The corresponding @value{GDBN} command is @samp{tfind}. -@subheading -trace-define-variable @findex -trace-define-variable +@subheading -trace-define-variable @subsubheading Synopsis @@ -35879,8 +35879,8 @@ with the @samp{$} character. The corresponding @value{GDBN} command is @samp{tvariable}. -@subheading The @code{-trace-frame-collected} Command @findex -trace-frame-collected +@subheading The @code{-trace-frame-collected} Command @subsubheading Synopsis @@ -35996,8 +35996,8 @@ There is no corresponding @value{GDBN} command. @subsubheading Example -@subheading -trace-list-variables @findex -trace-list-variables +@subheading -trace-list-variables @subsubheading Synopsis @@ -36042,8 +36042,8 @@ body=[variable=@{name="$trace_timestamp",initial="0"@} (gdb) @end smallexample -@subheading -trace-save @findex -trace-save +@subheading -trace-save @subsubheading Synopsis @@ -36065,8 +36065,8 @@ supply the optional @samp{-ctf} argument to save it the CTF format. See The corresponding @value{GDBN} command is @samp{tsave}. -@subheading -trace-start @findex -trace-start +@subheading -trace-start @subsubheading Synopsis @@ -36081,8 +36081,8 @@ have any fields. The corresponding @value{GDBN} command is @samp{tstart}. -@subheading -trace-status @findex -trace-status +@subheading -trace-status @subsubheading Synopsis @@ -36156,8 +36156,8 @@ optional, and only present when examining a trace file. The corresponding @value{GDBN} command is @samp{tstatus}. -@subheading -trace-stop @findex -trace-stop +@subheading -trace-stop @subsubheading Synopsis @@ -36180,8 +36180,8 @@ The corresponding @value{GDBN} command is @samp{tstop}. @ignore -@subheading The @code{-symbol-info-address} Command @findex -symbol-info-address +@subheading The @code{-symbol-info-address} Command @subsubheading Synopsis @@ -36199,8 +36199,8 @@ The corresponding @value{GDBN} command is @samp{info address}. N.A. -@subheading The @code{-symbol-info-file} Command @findex -symbol-info-file +@subheading The @code{-symbol-info-file} Command @subsubheading Synopsis @@ -36219,9 +36219,9 @@ There's no equivalent @value{GDBN} command. @code{gdbtk} has N.A. @end ignore -@subheading The @code{-symbol-info-functions} Command @findex -symbol-info-functions @anchor{-symbol-info-functions} +@subheading The @code{-symbol-info-functions} Command @subsubheading Synopsis @@ -36331,9 +36331,9 @@ The corresponding @value{GDBN} command is @samp{info functions}. @end group @end smallexample -@subheading The @code{-symbol-info-module-functions} Command @findex -symbol-info-module-functions @anchor{-symbol-info-module-functions} +@subheading The @code{-symbol-info-module-functions} Command @subsubheading Synopsis @@ -36397,9 +36397,9 @@ The corresponding @value{GDBN} command is @samp{info module functions}. @end group @end smallexample -@subheading The @code{-symbol-info-module-variables} Command @findex -symbol-info-module-variables @anchor{-symbol-info-module-variables} +@subheading The @code{-symbol-info-module-variables} Command @subsubheading Synopsis @@ -36473,9 +36473,9 @@ The corresponding @value{GDBN} command is @samp{info module variables}. @end group @end smallexample -@subheading The @code{-symbol-info-modules} Command @findex -symbol-info-modules @anchor{-symbol-info-modules} +@subheading The @code{-symbol-info-modules} Command @subsubheading Synopsis @@ -36534,9 +36534,9 @@ The corresponding @value{GDBN} command is @samp{info modules}. @end group @end smallexample -@subheading The @code{-symbol-info-types} Command @findex -symbol-info-types @anchor{-symbol-info-types} +@subheading The @code{-symbol-info-types} Command @subsubheading Synopsis @@ -36599,9 +36599,9 @@ The corresponding @value{GDBN} command is @samp{info types}. @end group @end smallexample -@subheading The @code{-symbol-info-variables} Command @findex -symbol-info-variables @anchor{-symbol-info-variables} +@subheading The @code{-symbol-info-variables} Command @subsubheading Synopsis @@ -36717,8 +36717,8 @@ The corresponding @value{GDBN} command is @samp{info variables}. @end smallexample @ignore -@subheading The @code{-symbol-info-line} Command @findex -symbol-info-line +@subheading The @code{-symbol-info-line} Command @subsubheading Synopsis @@ -36737,8 +36737,8 @@ The corresponding @value{GDBN} command is @samp{info line}. N.A. -@subheading The @code{-symbol-info-symbol} Command @findex -symbol-info-symbol +@subheading The @code{-symbol-info-symbol} Command @subsubheading Synopsis @@ -36756,8 +36756,8 @@ The corresponding @value{GDBN} command is @samp{info symbol}. N.A. -@subheading The @code{-symbol-list-functions} Command @findex -symbol-list-functions +@subheading The @code{-symbol-list-functions} Command @subsubheading Synopsis @@ -36777,8 +36777,8 @@ N.A. @end ignore -@subheading The @code{-symbol-list-lines} Command @findex -symbol-list-lines +@subheading The @code{-symbol-list-lines} Command @subsubheading Synopsis @@ -36804,8 +36804,8 @@ There is no corresponding @value{GDBN} command. @ignore -@subheading The @code{-symbol-list-types} Command @findex -symbol-list-types +@subheading The @code{-symbol-list-types} Command @subsubheading Synopsis @@ -36824,8 +36824,8 @@ The corresponding commands are @samp{info types} in @value{GDBN}, N.A. -@subheading The @code{-symbol-list-variables} Command @findex -symbol-list-variables +@subheading The @code{-symbol-list-variables} Command @subsubheading Synopsis @@ -36843,8 +36843,8 @@ List all the global and static variable names. N.A. -@subheading The @code{-symbol-locate} Command @findex -symbol-locate +@subheading The @code{-symbol-locate} Command @subsubheading Synopsis @@ -36860,8 +36860,8 @@ N.A. N.A. -@subheading The @code{-symbol-type} Command @findex -symbol-type +@subheading The @code{-symbol-type} Command @subsubheading Synopsis @@ -36888,8 +36888,8 @@ N.A. This section describes the GDB/MI commands to specify executable file names and to read in and obtain symbol table information. -@subheading The @code{-file-exec-and-symbols} Command @findex -file-exec-and-symbols +@subheading The @code{-file-exec-and-symbols} Command @subsubheading Synopsis @@ -36918,8 +36918,8 @@ The corresponding @value{GDBN} command is @samp{file}. @end smallexample -@subheading The @code{-file-exec-file} Command @findex -file-exec-file +@subheading The @code{-file-exec-file} Command @subsubheading Synopsis @@ -36948,8 +36948,8 @@ The corresponding @value{GDBN} command is @samp{exec-file}. @ignore -@subheading The @code{-file-list-exec-sections} Command @findex -file-list-exec-sections +@subheading The @code{-file-list-exec-sections} Command @subsubheading Synopsis @@ -36970,8 +36970,8 @@ N.A. @end ignore -@subheading The @code{-file-list-exec-source-file} Command @findex -file-list-exec-source-file +@subheading The @code{-file-list-exec-source-file} Command @subsubheading Synopsis @@ -36998,9 +36998,9 @@ The @value{GDBN} equivalent is @samp{info source} @end smallexample +@findex -file-list-exec-source-files @subheading The @code{-file-list-exec-source-files} Command @kindex info sources -@findex -file-list-exec-source-files @subsubheading Synopsis @@ -37138,8 +37138,8 @@ The @value{GDBN} equivalent is @samp{info sources}. sources=[]@}] @end smallexample -@subheading The @code{-file-list-shared-libraries} Command @findex -file-list-shared-libraries +@subheading The @code{-file-list-shared-libraries} Command @subsubheading Synopsis @@ -37177,8 +37177,8 @@ The address defining the exclusive upper bound of the segment. @ignore -@subheading The @code{-file-list-symbol-files} Command @findex -file-list-symbol-files +@subheading The @code{-file-list-symbol-files} Command @subsubheading Synopsis @@ -37197,8 +37197,8 @@ N.A. @end ignore -@subheading The @code{-file-symbol-file} Command @findex -file-symbol-file +@subheading The @code{-file-symbol-file} Command @subsubheading Synopsis @@ -37263,8 +37263,8 @@ Signal handling commands are not implemented. @section @sc{gdb/mi} Target Manipulation Commands -@subheading The @code{-target-attach} Command @findex -target-attach +@subheading The @code{-target-attach} Command @subsubheading Synopsis @@ -37292,8 +37292,8 @@ The corresponding @value{GDBN} command is @samp{attach}. @end smallexample @ignore -@subheading The @code{-target-compare-sections} Command @findex -target-compare-sections +@subheading The @code{-target-compare-sections} Command @subsubheading Synopsis @@ -37313,8 +37313,8 @@ N.A. @end ignore -@subheading The @code{-target-detach} Command @findex -target-detach +@subheading The @code{-target-detach} Command @subsubheading Synopsis @@ -37340,8 +37340,8 @@ The corresponding @value{GDBN} command is @samp{detach}. @end smallexample -@subheading The @code{-target-disconnect} Command @findex -target-disconnect +@subheading The @code{-target-disconnect} Command @subsubheading Synopsis @@ -37366,8 +37366,8 @@ The corresponding @value{GDBN} command is @samp{disconnect}. @end smallexample -@subheading The @code{-target-download} Command @findex -target-download +@subheading The @code{-target-download} Command @subsubheading Synopsis @@ -37471,8 +37471,8 @@ write-rate="429" @ignore -@subheading The @code{-target-exec-status} Command @findex -target-exec-status +@subheading The @code{-target-exec-status} Command @subsubheading Synopsis @@ -37491,8 +37491,8 @@ There's no equivalent @value{GDBN} command. N.A. -@subheading The @code{-target-list-available-targets} Command @findex -target-list-available-targets +@subheading The @code{-target-list-available-targets} Command @subsubheading Synopsis @@ -37510,8 +37510,8 @@ The corresponding @value{GDBN} command is @samp{help target}. N.A. -@subheading The @code{-target-list-current-targets} Command @findex -target-list-current-targets +@subheading The @code{-target-list-current-targets} Command @subsubheading Synopsis @@ -37530,8 +37530,8 @@ other things). N.A. -@subheading The @code{-target-list-parameters} Command @findex -target-list-parameters +@subheading The @code{-target-list-parameters} Command @subsubheading Synopsis @@ -37549,8 +37549,8 @@ No equivalent. @subsubheading Example N.A. -@subheading The @code{-target-flash-erase} Command @findex -target-flash-erase +@subheading The @code{-target-flash-erase} Command @subsubheading Synopsis @@ -37572,8 +37572,8 @@ addresses and memory region sizes. (gdb) @end smallexample -@subheading The @code{-target-select} Command @findex -target-select +@subheading The @code{-target-select} Command @subsubheading Synopsis @@ -37617,8 +37617,8 @@ The corresponding @value{GDBN} command is @samp{target}. @section @sc{gdb/mi} File Transfer Commands -@subheading The @code{-target-file-put} Command @findex -target-file-put +@subheading The @code{-target-file-put} Command @subsubheading Synopsis @@ -37643,8 +37643,8 @@ The corresponding @value{GDBN} command is @samp{remote put}. @end smallexample -@subheading The @code{-target-file-get} Command @findex -target-file-get +@subheading The @code{-target-file-get} Command @subsubheading Synopsis @@ -37669,8 +37669,8 @@ The corresponding @value{GDBN} command is @samp{remote get}. @end smallexample -@subheading The @code{-target-file-delete} Command @findex -target-file-delete +@subheading The @code{-target-file-delete} Command @subsubheading Synopsis @@ -37698,8 +37698,8 @@ The corresponding @value{GDBN} command is @samp{remote delete}. @node GDB/MI Ada Exceptions Commands @section Ada Exceptions @sc{gdb/mi} Commands -@subheading The @code{-info-ada-exceptions} Command @findex -info-ada-exceptions +@subheading The @code{-info-ada-exceptions} Command @subsubheading Synopsis @@ -37756,9 +37756,9 @@ 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} @findex -info-gdb-mi-command +@subheading The @code{-info-gdb-mi-command} Command @subsubheading Synopsis @@ -37807,9 +37807,9 @@ to the debugger: ^done,command=@{exists="true"@} @end smallexample -@subheading The @code{-list-features} Command @findex -list-features @cindex supported @sc{gdb/mi} features, list +@subheading The @code{-list-features} Command Returns a list of particular features of the MI protocol that this version of gdb implements. A feature can be a command, @@ -37871,8 +37871,8 @@ Indicates that the @code{-data-disassemble} command supports the @option{-a} option (@pxref{GDB/MI Data Manipulation}). @end ftable -@subheading The @code{-list-target-features} Command @findex -list-target-features +@subheading The @code{-list-target-features} Command Returns a list of particular features that are supported by the target. Those features affect the permitted MI commands, but @@ -37908,8 +37908,8 @@ Indicates that the target is capable of reverse execution. @c @subheading -gdb-complete -@subheading The @code{-gdb-exit} Command @findex -gdb-exit +@subheading The @code{-gdb-exit} Command @subsubheading Synopsis @@ -37933,8 +37933,8 @@ Approximately corresponds to @samp{quit}. @ignore -@subheading The @code{-exec-abort} Command @findex -exec-abort +@subheading The @code{-exec-abort} Command @subsubheading Synopsis @@ -37953,8 +37953,8 @@ N.A. @end ignore -@subheading The @code{-gdb-set} Command @findex -gdb-set +@subheading The @code{-gdb-set} Command @subsubheading Synopsis @@ -37979,8 +37979,8 @@ The corresponding @value{GDBN} command is @samp{set}. @end smallexample -@subheading The @code{-gdb-show} Command @findex -gdb-show +@subheading The @code{-gdb-show} Command @subsubheading Synopsis @@ -38006,8 +38006,8 @@ The corresponding @value{GDBN} command is @samp{show}. @c @subheading -gdb-source -@subheading The @code{-gdb-version} Command @findex -gdb-version +@subheading The @code{-gdb-version} Command @subsubheading Synopsis @@ -38043,8 +38043,8 @@ default shows this information when you start an interactive session. (gdb) @end smallexample -@subheading The @code{-list-thread-groups} Command @findex -list-thread-groups +@subheading The @code{-list-thread-groups} Command @subheading Synopsis @@ -38164,8 +38164,8 @@ and only if there is a corresponding executable file. @{id="2",target-id="Thread 0xb7e14b90",cores=[2]@}]@},...] @end smallexample -@subheading The @code{-info-os} Command @findex -info-os +@subheading The @code{-info-os} Command @subsubheading Synopsis @@ -38239,8 +38239,8 @@ for MI clients that want to enumerate the types of data, such as in a popup menu, but is needless clutter on the command line, and @code{info os} omits it.) -@subheading The @code{-add-inferior} Command @findex -add-inferior +@subheading The @code{-add-inferior} Command @subheading Synopsis @@ -38293,8 +38293,8 @@ The corresponding @value{GDBN} command is @samp{add-inferior} ^done,inferior="i3" @end smallexample -@subheading The @code{-interpreter-exec} Command @findex -interpreter-exec +@subheading The @code{-interpreter-exec} Command @subheading Synopsis @@ -38321,8 +38321,8 @@ The corresponding @value{GDBN} command is @samp{interpreter-exec}. (gdb) @end smallexample -@subheading The @code{-inferior-tty-set} Command @findex -inferior-tty-set +@subheading The @code{-inferior-tty-set} Command @subheading Synopsis @@ -38345,8 +38345,8 @@ The corresponding @value{GDBN} command is @samp{set inferior-tty} /dev/pts/1. (gdb) @end smallexample -@subheading The @code{-inferior-tty-show} Command @findex -inferior-tty-show +@subheading The @code{-inferior-tty-show} Command @subheading Synopsis @@ -38372,8 +38372,8 @@ The corresponding @value{GDBN} command is @samp{show inferior-tty}. (gdb) @end smallexample -@subheading The @code{-enable-timings} Command @findex -enable-timings +@subheading The @code{-enable-timings} Command @subheading Synopsis @@ -38417,8 +38417,8 @@ fullname="/home/nickrob/myprog.c",line="73",arch="i386:x86_64"@} (gdb) @end smallexample -@subheading The @code{-complete} Command @findex -complete +@subheading The @code{-complete} Command @subheading Synopsis