From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: from simark.ca by simark.ca with LMTP id Ca/CJmEtzWq/NjwAWB0awg (envelope-from ) for ; Mon, 12 Oct 2026 14:56:33 -0400 Authentication-Results: simark.ca; dkim=pass (1024-bit key; unprotected) header.d=redhat.com header.i=@redhat.com header.a=rsa-sha256 header.s=mimecast20190719 header.b=KBFQv0+q; dkim-atps=neutral Received: by simark.ca (Postfix, from userid 112) id 89ABC1E06B; Mon, 12 Oct 2026 14:56:33 -0400 (EDT) X-Spam-Checker-Version: SpamAssassin 4.0.1 (2024-03-25) on simark.ca X-Spam-Level: X-Spam-Status: No, score=-6.4 required=5.0 tests=ARC_SIGNED,ARC_VALID,BAYES_00, DKIMWL_WL_HIGH,DKIM_SIGNED,DKIM_VALID,DKIM_VALID_AU,MAILING_LIST_MULTI, RCVD_IN_DNSWL_MED autolearn=ham autolearn_force=no version=4.0.1 Received: from vm01.sourceware.org (vm01.sourceware.org [IPv6:2620:52:6:3111::32]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits) key-exchange x25519 server-signature ECDSA (prime256v1) server-digest SHA256) (No client certificate requested) by simark.ca (Postfix) with ESMTPS id 232771E04E for ; Mon, 12 Oct 2026 14:56:18 -0400 (EDT) Received: from vm01.sourceware.org (localhost [IPv6:::1]) by sourceware.org (Postfix) with ESMTP id 2055C4BA23EC for ; Mon, 12 Oct 2026 18:56:17 +0000 (GMT) DKIM-Filter: OpenDKIM Filter v2.11.0 sourceware.org 2055C4BA23EC Authentication-Results: sourceware.org; dkim=pass (1024-bit key, unprotected) header.d=redhat.com header.i=@redhat.com header.a=rsa-sha256 header.s=mimecast20190719 header.b=KBFQv0+q Received: from us-smtp-delivery-124.mimecast.com (us-smtp-delivery-124.mimecast.com [170.10.129.124]) by sourceware.org (Postfix) with ESMTP id 1587A4BA7982 for ; Mon, 12 Oct 2026 18:54:51 +0000 (GMT) DMARC-Filter: OpenDMARC Filter v1.4.2 sourceware.org 1587A4BA7982 Authentication-Results: sourceware.org; dmarc=pass (p=quarantine dis=none) header.from=redhat.com Authentication-Results: sourceware.org; spf=pass smtp.mailfrom=redhat.com ARC-Filter: OpenARC Filter v1.0.0 sourceware.org 1587A4BA7982 Authentication-Results: sourceware.org; arc=none smtp.remote-ip=170.10.129.124 ARC-Seal: i=1; a=rsa-sha256; d=sourceware.org; s=key; t=1791831291; cv=none; b=RZR1+a7ssNm3bJsmhNhcrJeZSLCBGGG0kdifcQ25Oc7QVqsa7m548Clt4OBBkJKvOMZUjbnlFnVRv53YQW3ey6sOCuVg31rCxL3zS/dOUk9pdh4WD00zFc/BJpNSVR7df1jaZ8xCkWCjAc4NTxcuHjmaQ6d8J6e4UQYpabimb5A= ARC-Message-Signature: i=1; a=rsa-sha256; d=sourceware.org; s=key; t=1791831291; c=relaxed/simple; bh=YtqqluCUNnA1Vqp+f+5jadMy9bXMOHz1jcECuKEspM4=; h=DKIM-Signature:From:To:Subject:Date:Message-Id:MIME-Version; b=pkdXELjymCIARu9CQovBob4Dqr7IdLZVqe2UvZjqnclii/PFXjnI5xsCKcXhrTJNj2+qUhHuE74rPVW4QoyZEmQCEsmsEyp1kRYK2PPRTcBabsdGLb/7jTgH342RqfF8yQpQI6lO4EAPgfJmU9rGmEsdFiFlmaon47EMsWKQFgY= ARC-Authentication-Results: i=1; sourceware.org; dkim=pass (1024-bit key, unprotected) header.d=redhat.com header.i=@redhat.com header.a=rsa-sha256 header.s=mimecast20190719 header.b=KBFQv0+q DKIM-Filter: OpenDKIM Filter v2.11.0 sourceware.org 1587A4BA7982 DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=redhat.com; s=mimecast20190719; t=1791831290; h=from:from:reply-to:subject:subject:date:date:message-id:message-id: to:to:cc:cc:mime-version:mime-version:content-type:content-type: content-transfer-encoding:content-transfer-encoding: in-reply-to:in-reply-to:references:references; bh=FzHMe/2tHgnwPfzoeLg0ITPeAnDfbcTcQhTG8qHCg9A=; b=KBFQv0+qXd2GJ9G3wNTo4/U8cJQn0N+HxJTW4B3qQVNMu3cvSDvyCYZXvraDRE2pbA/b4R IwXArFLeA4g8CjBuzGNBrSneERd7SyshRD1oLDVPb/S8u8LFkQCOM2wrwG7sfqnMcoBjWf HYkHJTZF8/ITxYN/NAtSw/9N1a3oHG8= Received: from mail-wr1-f71.google.com (mail-wr1-f71.google.com [209.85.221.71]) by relay.mimecast.com with ESMTP with STARTTLS (version=TLSv1.3, cipher=TLS_AES_256_GCM_SHA384) id us-mta-153-hFTyu9ePMjGZiQbO7se6Yg-1; Mon, 12 Oct 2026 18:54:49 +0000 X-MC-Unique: hFTyu9ePMjGZiQbO7se6Yg-1 X-Mimecast-MFC-AGG-ID: hFTyu9ePMjGZiQbO7se6Yg_1791831288 Received: by mail-wr1-f71.google.com with SMTP id ffacd0b85a97d-48c437ae7dbso1100929f8f.1 for ; Mon, 12 Oct 2026 11:54:48 -0700 (PDT) X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20260707; t=1791831288; x=1792436088; h=content-transfer-encoding:mime-version:references:in-reply-to :message-id:date:subject:cc:to:from:x-gm-gg:x-gm-message-state:from :to:cc:subject:date:message-id:reply-to:content-type; bh=FzHMe/2tHgnwPfzoeLg0ITPeAnDfbcTcQhTG8qHCg9A=; b=B6tAh6MF2XuvCpWMdmPeYbZmqgmrfVKVammSDTwSgiNaRwPGSL2ucI4Rtvs9qxV2AU ZuYBMKOL059p6PXupBHfQRKQqej8Jg4FyEwC7nrbtFAIpDEjuuRSIkFs9vzHpVCnBFPY qfCCONcO2hGrEH2TKngQv27p9vbqpIUOIkWqPkVYUKpxV4LYKIl7FRFOmJ2K+ou7HUbs nzuehENmCllgM0XM5WFpEBrbIU6ribgHrNQ7Lhebh15hiS2lF1+YwQo1TBZ2cXyxnkK7 yhlL/VsoLEIm2oi1ToUpeJk7zIIWFfRyqK2/qrRtUYVeLYSusziiGShj9sGzvHhbETiE zztg== X-Gm-Message-State: AFq9FYJCI5kcKod+u78HRvxQGjenYz/Fiv+aXtymc31/wvsZTv4egsyW l/AugXt9U6B4RPAlY7O9eFOpuIZW2sOoMt2hHu5BwOurzvU+9uCk729QOHe+7b3vOB1H88c7KKg lWYssjNT4orwOaJyqzHYjtNEb+Nzh3R00UecsoxGDjOENHMqSLrgnx9QMFok3BbrTBxFcfs5mUl zex5t4EtbCbLYoQX8RtJql1V7nmL6sDyjAJblB+iqNAfJ1XTs= X-Gm-Gg: AYBFou34oaRBtL69UtiiNbLvx4UQ+Ujo+rKw0dSsmVYr7mpRaBbdIeUzasO+XQm+l5z 5qyGWywXe7ItkVMezGQyfFsAbvVDrkddTPqn3RjsbZKiM1uyUKqR2llyhBRsUJs0qUeRT5SvAVb ZltCLzib1vyRaVr/Il2OMHc9vPtMaVIjYerpWJafmlUwAa2XCeqqdqX8Owox6787blyZho7vgXf vtq4dM+kiaV+V/5gaZz4tW8kF7/jp+jqbPRLSjZR3YcipHywwO5TyDzntMqlwDUYuupoVue4ui3 oZTNscuDG7HhU6LnO8MRrume0KZuPLzvDNIyW22X3aOdSc55t//isFMUtcaHKUkQeMTm X-Received: by 2002:adf:f9cc:0:b0:48d:e005:860a with SMTP id ffacd0b85a97d-48de00588e3mr1300100f8f.28.1791831284811; Mon, 12 Oct 2026 11:54:44 -0700 (PDT) X-Received: by 2002:adf:f9cc:0:b0:48d:e005:860a with SMTP id ffacd0b85a97d-48de00588e3mr1299971f8f.28.1791831281534; Mon, 12 Oct 2026 11:54:41 -0700 (PDT) Received: from localhost ([213.31.44.29]) by smtp.gmail.com with ESMTPSA id ffacd0b85a97d-48de0bd777fsm777609f8f.57.2026.10.12.11.54.40 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Mon, 12 Oct 2026 11:54:40 -0700 (PDT) From: Andrew Burgess To: gdb-patches@sourceware.org Cc: Andrew Burgess Subject: [PATCH 2/5] gdb/doc: fix some incorrect '@table @code' uses Date: Mon, 12 Oct 2026 19:54:27 +0100 Message-Id: X-Mailer: git-send-email 2.25.4 In-Reply-To: References: MIME-Version: 1.0 X-Mimecast-Spam-Score: 0 X-Mimecast-MFC-PROC-ID: 3PYOUmfyP2Eml3hKkAcb1iFL552mkB_kMOLe89CkVLI_1791831288 X-Mimecast-Originator: redhat.com Content-Transfer-Encoding: 8bit content-type: text/plain; charset="US-ASCII"; x-default=true X-BeenThere: gdb-patches@sourceware.org X-Mailman-Version: 2.1.30 Precedence: list List-Id: Gdb-patches mailing list List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: gdb-patches-bounces~public-inbox=simark.ca@sourceware.org When we have something like this: @table @code @item blah This is the text. @end table Then the 'blah' text is formatted as '@code{blah}'. We have several places in the GDB docs where we use '@table @code' when there is a better alternative than @code. I also found a few places where we did something like: @table @code @item @code{blah} This is the text. @end table In this case the @code around 'blah' is unnecessary, as the table already applies @code formatting. In this case I've removed the formatting around the blah text. I also spotted this pattern: @table @code @item @var{blah}, some additional explanation. This is the text. @end table In this case 'blah' is formatted as @var and 'some additional explanation' is formatted as @code, when I think it is really just normal text. In this case I change the @code to @asis which will leave the additional text as-is, i.e. with no special formatting. I have not tried to check every @table in the docs. This patch mostly focused on @code to @kbd, though I did fix up a few other tables where it was obvious that something else should be applied. However, there are a lot of tables in the docs, my strategy was to basically spend no more than a second or two looking at a table, if it wasn't immediately obvious what change was needed then I left the table as @code. My hope is that this patch improves the quality of the docs. --- gdb/doc/gdb.texinfo | 622 ++++++++++++++++++++++---------------------- gdb/doc/guile.texi | 6 +- gdb/doc/python.texi | 16 +- 3 files changed, 322 insertions(+), 322 deletions(-) diff --git a/gdb/doc/gdb.texinfo b/gdb/doc/gdb.texinfo index 1f7778a1824..fd298da584c 100644 --- a/gdb/doc/gdb.texinfo +++ b/gdb/doc/gdb.texinfo @@ -983,7 +983,7 @@ File Options @c way, both those who look for -foo and --foo in the index, will find @c it. -@table @code +@table @option @item -symbols @var{file} @itemx -s @var{file} @cindex @code{--symbols} @@ -1098,7 +1098,7 @@ Mode Options You can run @value{GDBN} in various alternative modes---for example, in batch mode or quiet mode. -@table @code +@table @option @anchor{-nx} @item -nx @itemx -n @@ -1567,15 +1567,15 @@ Initialization Files There are two locations that are searched for system wide initialization files. Both of these locations are always checked: -@table @code +@table @file -@item @file{system.gdbinit} +@item system.gdbinit This is a single system-wide initialization file. Its location is specified with the @code{--with-system-gdbinit} configure option (@pxref{System-wide configuration}). It is loaded first when @value{GDBN} starts, before command line options have been processed. -@item @file{system.gdbinit.d} +@item system.gdbinit.d This is the system-wide initialization directory. Its location is specified with the @code{--with-system-gdbinit-dir} configure option (@pxref{System-wide configuration}). Files in this directory are @@ -1655,7 +1655,7 @@ Quitting GDB @cindex exiting @value{GDBN} @cindex leaving @value{GDBN} -@table @code +@table @kbd @kindex quit @r{[}@var{expression}@r{]} @kindex exit @r{[}@var{expression}@r{]} @kindex q @r{(@code{quit})} @@ -1687,7 +1687,7 @@ Shell Commands debugging session, there is no need to leave or suspend @value{GDBN}; you can just use the @code{shell} command. -@table @code +@table @kbd @kindex shell @kindex ! @cindex shell escape @@ -1709,7 +1709,7 @@ Shell Commands You do not have to use the @code{shell} command for this purpose in @value{GDBN}: -@table @code +@table @kbd @kindex make @cindex calling make @item make @var{make-args} @@ -1717,7 +1717,7 @@ Shell Commands arguments. This is equivalent to @samp{shell make @var{make-args}}. @end table -@table @code +@table @kbd @kindex pipe @kindex | @cindex send the output of a gdb command to a shell command @@ -1787,7 +1787,7 @@ Logging Output You may want to save the output of @value{GDBN} commands to a file. There are several commands to control @value{GDBN}'s logging. -@table @code +@table @kbd @kindex set logging enabled @item set logging enabled [on|off] Enable or disable logging. @@ -1923,7 +1923,7 @@ Command Settings Alternatively, you can use the @code{with} command to change a setting temporarily, for the duration of a command invocation. -@table @code +@table @kbd @kindex with command @kindex w @r{(@code{with})} @cindex settings @@ -2073,7 +2073,7 @@ Completion @noindent This behavior can be controlled with the following commands: -@table @code +@table @kbd @kindex set max-completions @item set max-completions @var{limit} @itemx set max-completions unlimited @@ -2331,7 +2331,7 @@ Help You can always ask @value{GDBN} itself for information on its commands, using the command @code{help}. -@table @code +@table @kbd @kindex h @r{(@code{help})} @item help @itemx h @@ -2495,7 +2495,7 @@ Help Index}. @c @group -@table @code +@table @kbd @kindex info @kindex i @r{(@code{info})} @item info @@ -2534,7 +2534,7 @@ Help Here are several miscellaneous @code{show} subcommands, all of which are exceptional in lacking corresponding @code{set} commands: -@table @code +@table @kbd @kindex show version @cindex @value{GDBN} version number @item show version @@ -2657,7 +2657,7 @@ Starting @cindex starting @cindex running -@table @code +@table @kbd @kindex run @kindex r @r{(@code{run})} @item run @@ -2745,7 +2745,7 @@ Starting table, and reads it again. When it does this, @value{GDBN} tries to retain your current breakpoints. -@table @code +@table @kbd @kindex start @item start @cindex run to main procedure @@ -2974,7 +2974,7 @@ Arguments @code{run} with no arguments uses the same arguments used by the previous @code{run}, or those set by the @code{set args} command. -@table @code +@table @kbd @kindex set args @item set args Specify the arguments to be used the next time your program is run. If @@ -3026,7 +3026,7 @@ Environment debugging, it can be useful to try running your program with a modified environment without having to start @value{GDBN} over again. -@table @code +@table @kbd @kindex path @item path @var{directory} Add @var{directory} to the front of the @env{PATH} environment variable @@ -3128,7 +3128,7 @@ Working Directory inherit the remote server's current working directory if remote debugging. -@table @code +@table @kbd @kindex set cwd @cindex change inferior's working directory @anchor{set cwd command} @@ -3191,7 +3191,7 @@ Input/Output modes your program was using and switches back to them when you continue running your program. -@table @code +@table @kbd @kindex info terminal @item info terminal Displays information recorded by @value{GDBN} about the terminal modes your @@ -3240,7 +3240,7 @@ Input/Output display the name of the terminal that will be used for future runs of your program. -@table @code +@table @kbd @item set inferior-tty [ @var{tty} ] @kindex set inferior-tty Set the tty for the program being debugged to @var{tty}. Omitting @var{tty} @@ -3257,7 +3257,7 @@ Attach @kindex attach @cindex attach -@table @code +@table @kbd @item attach @var{process-id} This command attaches to a running process---one that was started outside @value{GDBN}. (@code{info files} shows your active @@ -3288,7 +3288,7 @@ Attach handle the mismatch. @value{GDBN} tries to compare the files by comparing their build IDs (@pxref{build ID}), if available. -@table @code +@table @kbd @kindex exec-file-mismatch @cindex set exec-file-mismatch @item set exec-file-mismatch @samp{ask|warn|off} @@ -3315,7 +3315,7 @@ Attach process continue running, you may use the @code{continue} command after attaching @value{GDBN} to the process. -@table @code +@table @kbd @kindex detach @item detach When you have finished debugging the attached process, you can use the @@ -3337,7 +3337,7 @@ Attach @node Kill Process @section Killing the Child Process -@table @code +@table @kbd @kindex kill @item kill Kill the child process in which your program is running under @value{GDBN}. @@ -3396,7 +3396,7 @@ Inferiors Connections and Programs inferiors}}: @anchor{info inferiors command} -@table @code +@table @kbd @kindex info inferiors [ @var{id}@dots{} ] @item info inferiors Print a list of all inferiors currently being managed by @value{GDBN}. @@ -3455,7 +3455,7 @@ Inferiors Connections and Programs To get information about the current inferior, use @code{inferior}: -@table @code +@table @kbd @kindex inferior @item inferior Shows information about the current inferior. @@ -3472,7 +3472,7 @@ Inferiors Connections and Programs To find out what open target connections exist at any moment, use @w{@code{info connections}}: -@table @code +@table @kbd @kindex info connections [ @var{id}@dots{} ] @item info connections Print a list of all open target connections currently being managed by @@ -3512,7 +3512,7 @@ Inferiors Connections and Programs To switch focus between inferiors, use the @code{inferior} command: -@table @code +@table @kbd @kindex inferior @var{infno} @item inferior @var{infno} Make inferior number @var{infno} the current inferior. The argument @@ -3534,7 +3534,7 @@ Inferiors Connections and Programs remove inferiors from the debugging session use the @w{@code{remove-inferiors}} command. -@table @code +@table @kbd @anchor{add_inferior_cli} @kindex add-inferior @item add-inferior [ -copies @var{n} ] [ -exec @var{executable} ] [-no-connection ] @@ -3632,7 +3632,7 @@ Inferiors Connections and Programs inferior}} command (allowing it to run independently), or kill it using the @w{@code{kill inferiors}} command: -@table @code +@table @kbd @kindex detach inferiors @var{infno}@dots{} @item detach inferior @var{infno}@dots{} Detach from the inferior or inferiors identified by @value{GDBN} @@ -3657,7 +3657,7 @@ Inferiors Connections and Programs To be notified when inferiors are started or exit under @value{GDBN}'s control use @w{@code{set print inferior-events}}: -@table @code +@table @kbd @kindex set print inferior-events @cindex print messages on inferior start and exit @item set print inferior-events @@ -3684,7 +3684,7 @@ Inferiors Connections and Programs spaces in a debug session. You can do that with the @w{@code{maint info program-spaces}} command. -@table @code +@table @kbd @kindex maint info program-spaces @item maint info program-spaces Print a list of all program spaces currently being managed by @@ -3745,7 +3745,7 @@ Inferior-Specific Breakpoints When debugging multiple inferiors, you can choose whether to set breakpoints for all inferiors, or for a particular inferior. -@table @code +@table @kbd @cindex breakpoints and inferiors @cindex inferior-specific breakpoints @kindex break @dots{} inferior @var{inferior-id} @@ -3953,7 +3953,7 @@ Threads Thread 1 "main" received signal SIGINT, Interrupt. @end smallexample -@table @code +@table @kbd @anchor{info_threads} @kindex info threads @item info threads @r{[}-gid@r{]} @r{[}-stopped@r{]} @r{[}-running@r{]} @r{[}@var{thread-id-list}@r{]} @@ -4029,14 +4029,14 @@ Threads On Solaris, you can display more information about user threads with a Solaris-specific command: -@table @code +@table @kbd @item maint info sol-threads @kindex maint info sol-threads @cindex thread info (Solaris) Display info on Solaris user threads. @end table -@table @code +@table @kbd @kindex thread @var{thread-id} @item thread @var{thread-id} Make thread ID @var{thread-id} the current thread. The command @@ -4187,7 +4187,7 @@ Threads watchpoints in programs with multiple threads. @anchor{set libthread-db-search-path} -@table @code +@table @kbd @kindex set libthread-db-search-path @cindex search path for @code{libthread_db} @item set libthread-db-search-path @r{[}@var{path}@r{]} @@ -4275,7 +4275,7 @@ Threads versions earlier than 2.34, but not with @code{libpthread}, and use of other (non-@acronym{GLIBC}) C libraries. -@table @code +@table @kbd @kindex maint set force-internal-tls-address-lookup @kindex maint show force-internal-tls-address-lookup @cindex internal @acronym{TLS} address lookup @@ -4337,7 +4337,7 @@ Forks If you want to follow the child process instead of the parent process, use the command @w{@code{set follow-fork-mode}}. -@table @code +@table @kbd @kindex set follow-fork-mode @item set follow-fork-mode @var{mode} Set the debugger response to a program call of @code{fork} or @@ -4364,7 +4364,7 @@ Forks On Linux, if you want to debug both the parent and child processes, use the command @w{@code{set detach-on-fork}}. -@table @code +@table @kbd @kindex set detach-on-fork @item set detach-on-fork @var{mode} Tells gdb whether to detach one of the processes after a fork, or @@ -4419,7 +4419,7 @@ Forks You can change this behavior with the @w{@code{set follow-exec-mode}} command. -@table @code +@table @kbd @kindex set follow-exec-mode @item set follow-exec-mode @var{mode} @@ -4514,7 +4514,7 @@ Checkpoint/Restart To use the @code{checkpoint}/@code{restart} method of debugging: -@table @code +@table @kbd @kindex checkpoint @item checkpoint Save a snapshot of the debugged program's current execution state. @@ -4629,7 +4629,7 @@ Stopping ample explanation of the status of your program---but you can also explicitly request this information at any time. -@table @code +@table @kbd @kindex info program @item info program Display information about the status of your program: whether it is @@ -4832,7 +4832,7 @@ Set Breaks (@value{GDBP}) alias lbd = disable $_hit_bpnum @end smallexample -@table @code +@table @kbd @item break @var{locspec} Set a breakpoint at all the code locations in your program that result from resolving the given @var{locspec}. @var{locspec} can specify a @@ -5195,7 +5195,7 @@ Set Breaks @kindex set breakpoint pending @kindex show breakpoint pending -@table @code +@table @kbd @item set breakpoint pending auto This is the default behavior. When @value{GDBN} cannot resolve the location spec, it queries you whether a pending breakpoint should be @@ -5232,7 +5232,7 @@ Set Breaks @kindex set breakpoint auto-hw @kindex show breakpoint auto-hw -@table @code +@table @kbd @item set breakpoint auto-hw on This is the default behavior. When @value{GDBN} sets a breakpoint, it will try to use the target memory map to decide if software or hardware @@ -5256,7 +5256,7 @@ Set Breaks @kindex set breakpoint always-inserted @kindex show breakpoint always-inserted -@table @code +@table @kbd @item set breakpoint always-inserted off All breakpoints, including newly added by the user, are inserted in the target only when the target is resumed. All breakpoints are @@ -5280,7 +5280,7 @@ Set Breaks @kindex set breakpoint condition-evaluation @kindex show breakpoint condition-evaluation -@table @code +@table @kbd @item set breakpoint condition-evaluation host This option commands @value{GDBN} to evaluate the breakpoint conditions on the host's side. Unconditional breakpoints are sent to @@ -5368,7 +5368,7 @@ Set Watchpoints @value{GDBN} includes support for hardware watchpoints, which do not slow down the running of your program. -@table @code +@table @kbd @kindex watch @item watch @r{[}-l@r{|}-location@r{]} @var{expr} @r{[}thread @var{thread-id}@r{]} @r{[}mask @var{maskvalue}@r{]} @r{[}task @var{task-id}@r{]} Set a watchpoint for an expression. @value{GDBN} will break when the @@ -5460,7 +5460,7 @@ Set Watchpoints @code{can-use-hw-watchpoints} to zero will still use the hardware mechanism of watching expression values.) -@table @code +@table @kbd @item set can-use-hw-watchpoints @kindex set can-use-hw-watchpoints Set whether or not to use hardware watchpoints. @@ -5566,12 +5566,12 @@ Set Catchpoints kinds of program events, such as C@t{++} exceptions or the loading of a shared library. Use the @code{catch} command to set a catchpoint. -@table @code +@table @kbd @kindex catch @item catch @var{event} Stop when @var{event} occurs. The @var{event} can be any of the following: -@table @code +@table @kbd @item throw @r{[}@var{regexp}@r{]} @itemx rethrow @r{[}@var{regexp}@r{]} @itemx catch @r{[}@var{regexp}@r{]} @@ -5928,7 +5928,7 @@ Delete Breaks automatically ignores breakpoints on the first instruction to be executed when you continue execution without changing the execution address. -@table @code +@table @kbd @kindex clear @item clear Delete any breakpoints at the next instruction to be executed in the @@ -5942,7 +5942,7 @@ Delete Breaks of @var{locspec}. Which code locations correspond to @var{locspec} depends on the form used in the location specification @var{locspec}: -@table @code +@table @asis @item @var{linenum} @itemx @var{filename}:@var{linenum} @itemx -line @var{linenum} @@ -6020,7 +6020,7 @@ Disabling You can use the following commands to enable or disable breakpoints, watchpoints, tracepoints, and catchpoints: -@table @code +@table @kbd @kindex disable @kindex dis @r{(@code{disable})} @item disable @r{[}breakpoints@r{]} @r{[}@var{list}@dots{}@r{]} @@ -6124,7 +6124,7 @@ Conditions @code{condition} is the only way to impose a further condition on a catchpoint. -@table @code +@table @kbd @kindex condition @item condition @var{bnum} @var{expression} Specify @var{expression} as the break condition for breakpoint, @@ -6170,7 +6170,7 @@ Conditions value is @var{n}, the breakpoint does not stop the next @var{n} times your program reaches it. -@table @code +@table @kbd @kindex ignore @item ignore @var{bnum} @var{count} Set the ignore count of breakpoint number @var{bnum} to @var{count}. @@ -6208,7 +6208,7 @@ Break Commands example, you might want to print the values of certain expressions, or enable other breakpoints. -@table @code +@table @kbd @kindex commands @kindex end@r{ (breakpoint commands)} @item commands @r{[}@var{list}@dots{}@r{]} @@ -6318,7 +6318,7 @@ Dynamic Printf target. Using the stub/agent is also more efficient, as it can do everything without needing to communicate with @value{GDBN}. -@table @code +@table @kbd @kindex dprintf @item dprintf @var{locspec},@var{template},@var{expression}[,@var{expression}@dots{}] Whenever execution reaches a code location that results from resolving @@ -6421,7 +6421,7 @@ Save Breakpoints To save breakpoint definitions to a file use the @w{@code{save breakpoints}} command. -@table @code +@table @kbd @kindex save breakpoints @cindex save breakpoints to a file for future sessions @item save breakpoints [@var{filename}] @@ -6481,7 +6481,7 @@ Static Probe Points You can examine the available static static probes using @code{info probes}, with optional arguments: -@table @code +@table @kbd @kindex info probes @item info probes @r{[}@var{type}@r{]} @r{[}@var{provider} @r{[}@var{name} @r{[}@var{objfile}@r{]}@r{]}@r{]} If given, @var{type} is either @code{stap} for listing @@ -6514,7 +6514,7 @@ Static Probe Points commands, with optional arguments: @anchor{enable probes} -@table @code +@table @kbd @kindex enable probes @item enable probes @r{[}@var{provider} @r{[}@var{name} @r{[}@var{objfile}@r{]}@r{]}@r{]} If given, @var{provider} is a regular expression used to match against @@ -6645,7 +6645,7 @@ Continuing and Stepping or you may step into the signal's handler (@pxref{stepping and signal handlers}).) -@table @code +@table @kbd @kindex continue @kindex c @r{(@code{continue})} @kindex fg @r{(resume foreground execution)} @@ -6680,7 +6680,7 @@ Continuing and Stepping and then step through the suspect area, examining the variables that are interesting, until you see the problem happen. -@table @code +@table @kbd @kindex step @kindex s @r{(@code{step})} @item step @@ -6911,7 +6911,7 @@ Continuing and Stepping enabled. You can use the following command to turn off range stepping if necessary: -@table @code +@table @kbd @kindex set range-stepping @kindex show range-stepping @item set range-stepping @@ -6972,14 +6972,14 @@ Skipping Over Functions and Files See for example @samp{man 7 glob} on @sc{gnu}/Linux systems for a description of @code{glob}-style patterns. -@table @code +@table @kbd @kindex skip @item skip @r{[}@var{options}@r{]} The basic form of the @code{skip} command takes zero or more options that specify what to skip. The @var{options} argument is any useful combination of the following: -@table @code +@table @kbd @item -file @var{file} Functions in @var{file} will be skipped over when stepping. @@ -7090,7 +7090,7 @@ Skipping Over Functions and Files Skips can be listed, deleted, disabled, and enabled, much like breakpoints. These are the commands for managing your list of skips: -@table @code +@table @kbd @kindex info skip @item info skip @r{[}@var{range}@r{]} Print details about the specified skip(s). If @var{range} is not specified, @@ -7214,7 +7214,7 @@ Signals but to stop your program immediately whenever an error signal happens. You can change these settings with the @code{handle} command. -@table @code +@table @kbd @kindex info signals @kindex info handle @item info signals @@ -7478,7 +7478,7 @@ All-Stop Mode On some OSes, you can modify @value{GDBN}'s default behavior by locking the OS scheduler to allow only a single thread to run. -@table @code +@table @kbd @item set scheduler-locking @var{mode} @cindex scheduler-locking @cindex scheduler locking mode @@ -7533,7 +7533,7 @@ All-Stop Mode you can instruct @value{GDBN} to allow all threads of all the inferiors to run with the @w{@code{set schedule-multiple}} command. -@table @code +@table @kbd @kindex set schedule-multiple @item set schedule-multiple Set the mode for allowing threads of multiple processes to be resumed @@ -7580,7 +7580,7 @@ Non-Stop Mode You can use these commands to manipulate the non-stop mode setting: -@table @code +@table @kbd @kindex set non-stop @item set non-stop on Enable non-stop mode. @@ -7648,7 +7648,7 @@ Background Execution just @code{c&}. The execution commands that accept background execution are: -@table @code +@table @kbd @kindex run& @item run @xref{Starting, , Starting your Program}. @@ -7697,7 +7697,7 @@ Background Execution You can interrupt your program while it is running in the background by using the @code{interrupt} command. -@table @code +@table @kbd @kindex interrupt @item interrupt @itemx interrupt -a @@ -7715,7 +7715,7 @@ Thread-Specific Breakpoints Programs with Multiple Threads}), you can choose whether to set breakpoints on all threads, or on a particular thread. -@table @code +@table @kbd @cindex breakpoints and threads @cindex thread breakpoints @kindex break @dots{} thread @var{thread-id} @@ -7832,7 +7832,7 @@ Observer Mode then breakpoints that work by writing trap instructions into the code stream will still not be able to be placed. -@table @code +@table @kbd @kindex observer @item set observer on @@ -7958,7 +7958,7 @@ Reverse Execution If you are debugging in a target environment that supports reverse execution, @value{GDBN} provides the following commands. -@table @code +@table @kbd @kindex reverse-continue @kindex rc @r{(@code{reverse-continue})} @item reverse-continue @r{[}@var{ignore-count}@r{]} @@ -8086,7 +8086,7 @@ Process Record and Replay For architecture environments that support process record and replay, @value{GDBN} provides the following commands: -@table @code +@table @kbd @kindex target record @kindex target record-full @kindex target record-btrace @@ -8201,7 +8201,7 @@ Process Record and Replay Go to a specific location in the execution log. There are several ways to specify the location to go to: -@table @code +@table @kbd @item record goto begin @itemx record goto start Go to the beginning of the execution log. @@ -8517,7 +8517,7 @@ Process Record and Replay There are several ways to specify what part of the execution log to disassemble: -@table @code +@table @kbd @item record instruction-history @var{insn} Disassembles ten instructions starting from instruction number @var{insn}. @@ -8591,7 +8591,7 @@ Process Record and Replay printed in execution order. There are several ways to specify what to print: -@table @code +@table @kbd @item record function-call-history @var{func} Prints ten functions starting from function number @var{func}. @@ -8743,7 +8743,7 @@ Backtrace printed. You can stop the backtrace at any time by typing the system interrupt character, normally @kbd{Ctrl-c}. -@table @code +@table @kbd @item backtrace [@var{option}]@dots{} [@var{qualifier}]@dots{} [@var{count}] @itemx bt [@var{option}]@dots{} [@var{qualifier}]@dots{} [@var{count}] Print the backtrace of the entire stack. @@ -8923,7 +8923,7 @@ Backtrace If you need to examine the startup code, or limit the number of levels in a backtrace, you can change this behavior: -@table @code +@table @kbd @item set backtrace past-main @itemx set backtrace past-main on @anchor{set backtrace past-main} @@ -8966,7 +8966,7 @@ Backtrace You can control how file names are displayed. -@table @code +@table @kbd @item set filename-display @itemx set filename-display relative @cindex filename-display @@ -8990,7 +8990,7 @@ Selection selecting a stack frame; all of them finish by printing a brief description of the stack frame just selected. -@table @code +@table @kbd @kindex frame@r{, selecting} @kindex f @r{(@code{frame})} @item frame @r{[} @var{frame-selection-spec} @r{]} @@ -9102,7 +9102,7 @@ Selection @xref{List, ,Printing Source Lines}, for details. -@table @code +@table @kbd @kindex select-frame @item select-frame @r{[} @var{frame-selection-spec} @r{]} The @code{select-frame} command is a variant of @code{frame} that does @@ -9129,7 +9129,7 @@ Frame Info There are several other commands to print information about the selected stack frame. -@table @code +@table @kbd @item frame @itemx f When used without any argument, this command does not change which @@ -9282,7 +9282,7 @@ Frame Apply @section Applying a Command to Several Frames. @kindex frame apply @cindex apply command to several frames -@table @code +@table @kbd @item frame apply [all | @var{count} | @var{-count} | level @var{level}@dots{}] [@var{option}]@dots{} @var{command} The @code{frame apply} command allows you to apply the named @var{command} to one or more frames. @@ -9395,7 +9395,7 @@ Frame Apply @end table -@table @code +@table @kbd @kindex faas @cindex apply a command to all frames (ignoring errors and empty output) @@ -9428,7 +9428,7 @@ Frame Filter Management Managing frame filters is performed by several commands available within @value{GDBN}, detailed here. -@table @code +@table @kbd @kindex info frame-filter @item info frame-filter Print a list of installed frame filters from all dictionaries, showing @@ -9598,7 +9598,7 @@ List Here are the forms of the @code{list} command most commonly used: -@table @code +@table @kbd @item list @var{linenum} Print lines centered around line number @var{linenum} in the current source file. @@ -9632,7 +9632,7 @@ List By default, @value{GDBN} prints ten source lines with any of these forms of the @code{list} command. You can change this using @code{set listsize}: -@table @code +@table @kbd @kindex set listsize @item set listsize @var{count} @itemx set listsize unlimited @@ -9659,7 +9659,7 @@ List Here is a complete description of the possible arguments for @code{list}: -@table @code +@table @kbd @item list @var{locspec} Print lines centered around the line or lines of all the code locations that result from resolving @var{locspec}. @@ -9983,7 +9983,7 @@ Address Locations that frequently occur during debugging. Here are the various forms of @var{address}: -@table @code +@table @asis @item @var{expression} Any expression valid in the current working language. @@ -10019,7 +10019,7 @@ Edit Alternatively, there are several ways to specify what part of the file you want to print if you want to see other parts of the program: -@table @code +@table @kbd @item edit @var{locspec} Edit the source file of the code location that results from resolving @code{locspec}. Editing starts at the source file and source line @@ -10033,7 +10033,7 @@ Edit Here are the forms of the @code{edit} command most commonly used: -@table @code +@table @kbd @item edit @var{number} Edit the current source file with @var{number} as the active line number. @@ -10075,7 +10075,7 @@ Search There are two commands for searching through the current source file for a regular expression. -@table @code +@table @kbd @kindex search @kindex forward-search @c codespell:ignore-begin @@ -10305,7 +10305,7 @@ Source Path with debug information and corresponding source code are being moved together. -@table @code +@table @kbd @item directory @var{dirname} @dots{} @item dir @var{dirname} @dots{} Add directory @var{dirname} to the front of the source path. Several @@ -10420,7 +10420,7 @@ Machine Code line specified. Also, @code{info line} prints addresses in symbolic form as well as hex. -@table @code +@table @kbd @kindex info line @item info line @itemx info line @var{locspec} @@ -10479,7 +10479,7 @@ Machine Code line. @anchor{disassemble} -@table @code +@table @kbd @kindex disassemble @cindex assembly instructions @cindex instructions, assembly @@ -10719,7 +10719,7 @@ Machine Code location of the relocation table. On some architectures, @value{GDBN} might be able to resolve these to actual function names. -@table @code +@table @kbd @kindex set disassembler-options @cindex disassembler options @item set disassembler-options @var{option1}[,@var{option2}@dots{}] @@ -10740,7 +10740,7 @@ Machine Code Show the current setting of the disassembler options. @end table -@table @code +@table @kbd @kindex set disassembly-flavor @cindex Intel disassembly flavor @cindex AT&T disassembly flavor @@ -10758,7 +10758,7 @@ Machine Code Show the current setting of the disassembly flavor. @end table -@table @code +@table @kbd @kindex set disassemble-next-line @kindex show disassemble-next-line @item set disassemble-next-line @@ -10792,7 +10792,7 @@ Disable Reading Source The following command can be used to control whether @value{GDBN} should access source code files or not: -@table @code +@table @kbd @kindex set source open @kindex show source open @item set source open @r{[}on@r{|}off@r{]} @@ -10820,7 +10820,7 @@ Data Different Languages}). It may also print the expression using a Python-based pretty-printer (@pxref{Pretty Printing}). -@table @code +@table @kbd @item print [[@var{options}] --] @var{expr} @itemx print [[@var{options}] --] /@var{f} @var{expr} @var{expr} is an expression (in the source language). By default the @@ -10976,7 +10976,7 @@ Data itself) and explore all the way down to leaf scalar values/fields embedded in the higher level data types. -@table @code +@table @kbd @item explore @var{arg} @var{arg} is either an expression (in the source language), or a type visible in the current context of the program being debugged. @@ -11091,7 +11091,7 @@ Data being invoked, while the latter is a way to explicitly specify that type exploration of the argument is being invoked. -@table @code +@table @kbd @item explore value @var{expr} @cindex explore value This sub-command of @code{explore} explores the value of the @@ -11256,7 +11256,7 @@ Ambiguous Expressions @end group @end smallexample -@table @code +@table @kbd @kindex set multiple-symbols @item set multiple-symbols @var{mode} @cindex multiple-symbols menu @@ -11880,7 +11880,7 @@ Memory whether the program has corrupted its own read-only sections. The @code{compare-sections} command is provided for such situations. -@table @code +@table @kbd @kindex compare-sections @item compare-sections @r{[}@var{section-name}@r{|}@code{-r}@r{]} Compare the data of a loadable section @var{section-name} in the @@ -11926,7 +11926,7 @@ Memory Tagging The @code{memory-tag} commands are the following: -@table @code +@table @kbd @kindex memory-tag print-logical-tag @item memory-tag print-logical-tag @var{pointer_expression} Print the logical tag stored in @var{pointer_expression}. @@ -11980,7 +11980,7 @@ Auto Display specification---it uses @code{x} if you specify either the @samp{i} or @samp{s} format, or a unit size; otherwise it uses @code{print}. -@table @code +@table @kbd @kindex display @item display @var{expr} Add the expression @var{expr} to the list of expressions to display @@ -12005,7 +12005,7 @@ Auto Display instruction about to be executed each time execution stops (@samp{$pc} is a common name for the program counter; @pxref{Registers, ,Registers}). -@table @code +@table @kbd @kindex delete display @kindex undisplay @item undisplay @var{dnums}@dots{} @@ -12074,7 +12074,7 @@ Print Settings @noindent These settings are useful for debugging programs in any language: -@table @code +@table @kbd @kindex set print @anchor{set print address} @item set print address @@ -12126,7 +12126,7 @@ Print Settings you can set @value{GDBN} to print the source file and line number when it prints a symbolic address: -@table @code +@table @kbd @item set print symbol-filename on @cindex source file and line of a symbol @cindex symbol, source file and line @@ -12149,7 +12149,7 @@ Print Settings Also, you may wish to see the symbolic form only if the address being printed is reasonably close to the closest earlier symbol: -@table @code +@table @kbd @item set print max-symbolic-offset @var{max-offset} @itemx set print max-symbolic-offset unlimited @cindex maximum value for offset of closest symbol @@ -12189,7 +12189,7 @@ Print Settings @samp{set print symbol on}: @anchor{set print symbol} -@table @code +@table @kbd @item set print symbol on Tell @value{GDBN} to print the symbol corresponding to an address, if one exists. @@ -12206,7 +12206,7 @@ Print Settings Other settings control how different kinds of objects are printed: -@table @code +@table @kbd @anchor{set print array} @item set print array @itemx set print array on @@ -12764,7 +12764,7 @@ Print Settings @noindent These settings are of interest when debugging C@t{++} programs: -@table @code +@table @kbd @cindex demangling C@t{++} names @item set print demangle @itemx set print demangle on @@ -12961,7 +12961,7 @@ Pretty-Printer Commands @subsection Pretty-Printer Commands @cindex pretty-printer commands -@table @code +@table @kbd @kindex info pretty-printer @item info pretty-printer [@var{object-regexp} [@var{name-regexp}]] Print the list of installed pretty-printers. @@ -13123,7 +13123,7 @@ Value History then the value recorded in the value history by the @code{print} command remains 4 even though the value of @code{x} has changed. -@table @code +@table @kbd @kindex show values @item show values Print the last ten values in the value history, with their item numbers. @@ -13179,7 +13179,7 @@ Convenience Vars that variable already has a value of a different type. The convenience variable, when used as an expression, has the type of its current value. -@table @code +@table @kbd @kindex show convenience @cindex show all user variables and functions @item show convenience @@ -13740,7 +13740,7 @@ Convenience Funs @value{GDBN} provides the ability to list and get help on convenience functions. -@table @code +@table @kbd @item help function @kindex help function @cindex show all convenience functions @@ -13756,7 +13756,7 @@ Registers for each machine; use @code{info registers} to see the names used on your machine. -@table @code +@table @kbd @kindex info registers @item info registers Print the names and values of all registers except floating-point @@ -13918,7 +13918,7 @@ Floating Point Hardware Depending on the configuration, @value{GDBN} may be able to give you more information about the status of the floating point hardware. -@table @code +@table @kbd @kindex info float @item info float Display hardware-dependent information about the floating @@ -13934,7 +13934,7 @@ Vector Unit Depending on the configuration, @value{GDBN} may be able to give you more information about the status of the vector unit. -@table @code +@table @kbd @kindex info vector @item info vector Display information about the vector unit. The exact contents and @@ -13962,7 +13962,7 @@ OS Information support of the @samp{qXfer:auxv:read} packet, see @ref{qXfer auxiliary vector read}. -@table @code +@table @kbd @kindex info auxv @item info auxv Display the auxiliary vector of the inferior, which can be either a @@ -13982,7 +13982,7 @@ OS Information functionality depends on the remote stub's support of the @samp{qXfer:osdata:read} packet, see @ref{qXfer osdata read}. -@table @code +@table @kbd @kindex info os @item info os @var{infotype} @@ -13991,7 +13991,7 @@ OS Information On @sc{gnu}/Linux, the following values of @var{infotype} are valid: @anchor{linux info os infotypes} -@table @code +@table @kbd @kindex info os cpus @item cpus Display the list of all CPUs/cores. For each CPU/core, @value{GDBN} prints @@ -14108,7 +14108,7 @@ Memory Region Attributes When a memory region is defined, it is given a number to identify it; to enable, disable, or remove a memory region, you specify that number. -@table @code +@table @kbd @kindex mem @item mem @var{lower} @var{upper} @var{attributes}@dots{} Define a memory region bounded by @var{lower} and @var{upper} with @@ -14226,7 +14226,7 @@ Memory Region Attributes regions has undesired effects for a specific target, or to provide better error checking. The following commands control this behavior. -@table @code +@table @kbd @kindex set mem inaccessible-by-default @item set mem inaccessible-by-default [on|off] If @code{on} is specified, make @value{GDBN} treat memory not @@ -14265,7 +14265,7 @@ Dump/Restore Files Tektronix Hex, or Verilog Hex format; however, @value{GDBN} can only append to binary files, and cannot read from Verilog Hex files. -@table @code +@table @kbd @kindex dump @item dump @r{[}@var{format}@r{]} memory @var{filename} @var{start_addr} @var{end_addr} @@ -14335,7 +14335,7 @@ Core File Generation are debugging in order to preserve a snapshot of its state. @value{GDBN} has a special command for that. -@table @code +@table @kbd @kindex gcore @kindex generate-core-file @item generate-core-file [@var{file}] @@ -14429,7 +14429,7 @@ Character Sets Here are the commands for controlling @value{GDBN}'s character set support: -@table @code +@table @kbd @item set target-charset @var{charset} @kindex set target-charset Set the current target character set to @var{charset}. To display the @@ -14640,7 +14640,7 @@ Caching Target Data Other regions of memory can be explicitly marked as cacheable; @pxref{Memory Region Attributes}. -@table @code +@table @kbd @kindex set remotecache @item set remotecache on @itemx set remotecache off @@ -14718,7 +14718,7 @@ Searching Memory Memory can be searched for a particular sequence of bytes with the @code{find} command. -@table @code +@table @kbd @kindex find @item find @r{[}/@var{sn}@r{]} @var{start_addr}, +@var{len}, @var{val1} @r{[}, @var{val2}, @dots{}@r{]} @itemx find @r{[}/@var{sn}@r{]} @var{start_addr}, @var{end_addr}, @var{val1} @r{[}, @var{val2}, @dots{}@r{]} @@ -14825,7 +14825,7 @@ Value Sizes may indicate a value that is incorrectly large, this in turn may cause @value{GDBN} to try and allocate an overly large amount of memory. -@table @code +@table @kbd @anchor{set max-value-size} @kindex set max-value-size @item set max-value-size @var{bytes} @@ -14996,7 +14996,7 @@ Tail Call Frames tries to show at least all the unambiguous top tail callers and all the unambiguous bottom tail callees, if any. -@table @code +@table @kbd @anchor{set debug entry-values} @item set debug entry-values @kindex set debug entry-values @@ -15138,7 +15138,7 @@ Macros macro invocations present in the expression. @value{GDBN} also provides the following commands for working with macros explicitly. -@table @code +@table @kbd @kindex macro expand @cindex macro expansion, showing the results of preprocessor @@ -15479,7 +15479,7 @@ Set Tracepoints @node Create and Delete Tracepoints @subsection Create and Delete Tracepoints -@table @code +@table @kbd @cindex set tracepoint @kindex trace @item trace @var{locspec} @@ -15653,7 +15653,7 @@ Enable and Disable Tracepoints These commands are deprecated; they are equivalent to plain @code{disable} and @code{enable}. -@table @code +@table @kbd @kindex disable tracepoint @item disable tracepoint @r{[}@var{num}@r{]} Disable tracepoint @var{num}, or all tracepoints if no argument @@ -15980,7 +15980,7 @@ Tracepoint Actions @node Listing Tracepoints @subsection Listing Tracepoints -@table @code +@table @kbd @kindex info tracepoints @r{[}@var{n}@dots{}@r{]} @kindex info tp @r{[}@var{n}@dots{}@r{]} @cindex information about tracepoints @@ -16031,7 +16031,7 @@ Listing Tracepoints @node Listing Static Tracepoint Markers @subsection Listing Static Tracepoint Markers -@table @code +@table @kbd @kindex info static-tracepoint-markers @cindex information about static tracepoint markers @item info static-tracepoint-markers @@ -16085,7 +16085,7 @@ Listing Static Tracepoint Markers @node Starting and Stopping Trace Experiments @subsection Starting and Stopping Trace Experiments -@table @code +@table @kbd @kindex tstart [ @var{notes} ] @cindex start a new trace experiment @cindex collected data discarded @@ -16147,7 +16147,7 @@ Starting and Stopping Trace Experiments @code{disconnected-tracing} lets you decide whether the trace should continue running without @value{GDBN}. -@table @code +@table @kbd @item set disconnected-tracing on @itemx set disconnected-tracing off @kindex set disconnected-tracing @@ -16192,7 +16192,7 @@ Starting and Stopping Trace Experiments buffer handling on the fly, otherwise it will not take effect until the next run. -@table @code +@table @kbd @item set circular-trace-buffer on @itemx set circular-trace-buffer off @kindex set circular-trace-buffer @@ -16210,7 +16210,7 @@ Starting and Stopping Trace Experiments @end table -@table @code +@table @kbd @item set trace-buffer-size @var{n} @itemx set trace-buffer-size unlimited @kindex set trace-buffer-size @@ -16230,7 +16230,7 @@ Starting and Stopping Trace Experiments to get a report of the actual buffer size. @end table -@table @code +@table @kbd @item set trace-user @var{text} @kindex set trace-user @@ -16371,7 +16371,7 @@ tfind Here are the various forms of using the @code{tfind} command. -@table @code +@table @kbd @item tfind start Find the first snapshot in the buffer. This is a synonym for @code{tfind 0} (since 0 is the number of the first snapshot). @@ -16620,7 +16620,7 @@ Trace Files dump the trace data into a file, and later use that file as a source of trace data, via the @code{target tfile} command. -@table @code +@table @kbd @kindex tsave @item tsave [ -r ] @var{filename} @@ -16816,7 +16816,7 @@ Overlay Commands @value{GDBN}'s overlay commands all start with the word @code{overlay}; you can abbreviate this as @code{ov} or @code{ovly}. The commands are: -@table @code +@table @kbd @item overlay off @kindex overlay Disable @value{GDBN}'s overlay support. When overlay support is @@ -17197,7 +17197,7 @@ Automatically The warning is enabled by default, but it can be controlled via a setting: -@table @code +@table @kbd @item set warn-language-frame-mismatch [on|off] @kindex warn-language-frame-mismatch Enable or disable the warning that is issued when the current language @@ -17213,7 +17213,7 @@ Show The following commands help you find out which language is the working language, and also what language source files were written in. -@table @code +@table @kbd @item show language @anchor{show language} @kindex show language @@ -17239,7 +17239,7 @@ Show not in the standard list. You can then set the extension associated with a language explicitly: -@table @code +@table @kbd @item set extension-language @var{ext} @var{language} @kindex set extension-language Tell @value{GDBN} that source files with extension @var{ext} are to be @@ -17311,7 +17311,7 @@ Type Checking @kindex set check type @kindex show check type -@table @code +@table @kbd @item set check type on @itemx set check type off Set strict type checking on or off. If any type mismatches occur in @@ -17358,7 +17358,7 @@ Range Checking @kindex set check range @kindex show check range -@table @code +@table @kbd @item set check range auto Set range checking on or off based on the current working language. @xref{Supported Languages, ,Supported Languages}, for the default settings for @@ -17818,7 +17818,7 @@ Debugging C Plus Plus Some @value{GDBN} commands are particularly useful with C@t{++}, and some are designed specifically for use with C@t{++}. Here is a summary: -@table @code +@table @kbd @cindex break in overloaded functions @item @r{breakpoint menus} When you want a breakpoint in a function whose name is overloaded, @@ -18011,7 +18011,7 @@ Go Here is a summary of the Go-specific features and restrictions: -@table @code +@table @asis @cindex current Go package @item The current Go package The name of the current package does not need to be specified when @@ -18379,7 +18379,7 @@ Special Fortran Commands @value{GDBN} has some commands to support Fortran-specific features, such as displaying common blocks. -@table @code +@table @kbd @cindex @code{COMMON} blocks, Fortran @kindex info common @item info common @r{[}@var{common-name}@r{]} @@ -19507,7 +19507,7 @@ Overloading support for Ada Here are a couple of commands to customize @value{GDBN}'s behavior in this case: -@table @code +@table @kbd @kindex set ada print-signatures @item set ada print-signatures @@ -19540,7 +19540,7 @@ Ada Exceptions A command is provided to list all Ada exceptions: -@table @code +@table @kbd @kindex info exceptions @item info exceptions @itemx info exceptions @var{regexp} @@ -19578,7 +19578,7 @@ Ada Tasks Support for Ada tasks is analogous to that for threads (@pxref{Threads}). @value{GDBN} provides the following task-related commands: -@table @code +@table @kbd @kindex info tasks @item info tasks This command shows a list of current Ada tasks, as in the following example: @@ -19859,7 +19859,7 @@ Ravenscar Profile specifically designed for systems with safety-critical real-time requirements. -@table @code +@table @kbd @kindex set ravenscar task-switching on @cindex task switching with program using Ravenscar Profile @item set ravenscar task-switching on @@ -19917,7 +19917,7 @@ Ada Source Character Set files. @xref{Character Set Control, , Character Set Control, gnat_ugn}. @value{GDBN} includes support for this as well. -@table @code +@table @kbd @item set ada source-charset @var{charset} @kindex set ada source-charset Set the source character set for Ada. The character set must be @@ -19981,7 +19981,7 @@ Ada Glitches @kindex set ada trust-PAD-over-XVS @kindex show ada trust-PAD-over-XVS -@table @code +@table @kbd @item set ada trust-PAD-over-XVS on Configure GDB to strictly follow the GNAT encoding when computing the @@ -20018,7 +20018,7 @@ Ada Glitches those descriptive types. It allows the user to quickly evaluate how well @value{GDBN} works without them. -@table @code +@table @kbd @kindex maint ada set ignore-descriptive-types @item maintenance ada set ignore-descriptive-types [on|off] @@ -20078,7 +20078,7 @@ Symbols @noindent looks up the value of @code{x} in the scope of the file @file{foo.c}. -@table @code +@table @kbd @cindex case-insensitive symbol names @cindex case sensitivity in symbol names @kindex set case-sensitive @@ -21127,7 +21127,7 @@ Jumping it stopped, with the @code{continue} command. You can instead continue at an address of your own choosing, with the following commands: -@table @code +@table @kbd @kindex jump @kindex j @r{(@code{jump})} @item jump @var{locspec} @@ -21188,7 +21188,7 @@ Signaling @section Giving your Program a Signal @cindex deliver a signal to a program -@table @code +@table @kbd @kindex signal @item signal @var{signal} Resume execution where your program is stopped, but immediately give it the @@ -21250,7 +21250,7 @@ Signaling @node Returning @section Returning from a Function -@table @code +@table @kbd @cindex returning from a function @kindex return @item return @@ -21328,7 +21328,7 @@ Returning @node Calling @section Calling Program Functions -@table @code +@table @kbd @cindex calling functions @cindex inferior functions, calling @item print @var{expr} @@ -21365,7 +21365,7 @@ Calling @code{set unwind-on-terminating-exception} command. @anchor{stack unwind settings} -@table @code +@table @kbd @item set unwind-on-signal @kindex set unwind-on-signal @kindex set unwindonsignal @@ -21494,7 +21494,7 @@ Calling indefinitely for function call to complete, unless interrupted by the user using @kbd{Ctrl-C}. -@table @code +@table @kbd @item set direct-call-timeout @var{seconds} @kindex set direct-call-timeout @cindex timeout for called functions @@ -21523,7 +21523,7 @@ Calling Conditions}). A different setting controls the timeout used for function calls made from a breakpoint condition. -@table @code +@table @kbd @item set indirect-call-timeout @var{seconds} @kindex set indirect-call-timeout @cindex timeout for called functions @@ -21633,7 +21633,7 @@ Patching want to turn on internal debugging flags, or even to make emergency repairs. -@table @code +@table @kbd @kindex set write @item set write on @itemx set write off @@ -21662,7 +21662,7 @@ Compiling and Injecting Code @file{libcc1.so} must be installed for this functionality to be enabled. This functionality is implemented with the following commands. -@table @code +@table @kbd @kindex compile code @item compile code @var{source-code} @itemx compile code -raw @var{--} @var{source-code} @@ -21728,7 +21728,7 @@ Compiling and Injecting Code @ref{Filename Arguments,,Filenames As Command Arguments}. @end table -@table @code +@table @kbd @item compile print [[@var{options}] --] @var{expr} @itemx compile print [[@var{options}] --] /@var{f} @var{expr} Compile and execute @var{expr} with the compiler language found as the @@ -21751,7 +21751,7 @@ Compiling and Injecting Code @noindent The process of compiling and injecting the code can be inspected using: -@table @code +@table @kbd @anchor{set debug compile} @item set debug compile @cindex compile command debugging info @@ -21804,7 +21804,7 @@ Compiling and Injecting Code @noindent You can override compilation options using the following command: -@table @code +@table @kbd @item set compile-args @cindex compile command options override Set compilation options used for compiling and injecting code with the @@ -22003,7 +22003,7 @@ Compiling and Injecting Code according to the installation of the found compiler --- as possibly specified by the @code{set compile-gcc} command. -@table @code +@table @kbd @item set compile-gcc @cindex compile command driver filename override Set compilation command used for compiling and injecting code with the @@ -22054,7 +22054,7 @@ Files Program}). In these situations the @value{GDBN} commands to specify new files are useful. -@table @code +@table @kbd @cindex executable file @kindex file @item file @var{filename} @@ -22426,7 +22426,7 @@ Files To control the automatic loading of shared library symbols, use the commands: -@table @code +@table @kbd @kindex set auto-solib-add @item set auto-solib-add @var{mode} If @var{mode} is @code{on}, symbols from all shared object libraries @@ -22455,7 +22455,7 @@ Files To explicitly load shared library symbols, use the @code{sharedlibrary} command: -@table @code +@table @kbd @kindex info sharedlibrary @kindex info share @item info share @var{regex} @@ -22516,7 +22516,7 @@ Files less useful than setting a catchpoint, because it does not allow for conditions or commands as a catchpoint does. -@table @code +@table @kbd @kindex info linker-namespaces @item info linker-namespaces @item info linker-namespaces @code{[[@var{n}]]} @@ -22532,7 +22532,7 @@ Files The surrounding square brackets are optional. @end table -@table @code +@table @kbd @item set stop-on-solib-events @r{[}on@r{|}off@r{]} @kindex set stop-on-solib-events This command controls whether @value{GDBN} should give you control @@ -22561,7 +22561,7 @@ Files may try to load the host's libraries. @value{GDBN} has two variables to specify the search directories for target libraries. -@table @code +@table @kbd @cindex prefix for executable and shared library file names @cindex system root, alternate @kindex set solib-absolute-prefix @@ -22747,7 +22747,7 @@ Files pair of file names it needs to compare. This will make file-name comparisons accurate, but at a price of a significant slowdown. -@table @code +@table @kbd @item set basenames-may-differ @kindex set basenames-may-differ Set whether a source file may have multiple base names. @@ -22767,7 +22767,7 @@ File Caching BFD, bfd, The Binary File Descriptor Library}. The following commands allow visibility and control of the caching behavior. -@table @code +@table @kbd @kindex maint info bfds @item maint info bfds This prints information about each @code{bfd} object that is known to @@ -22898,7 +22898,7 @@ Separate Debug Files also set the global debugging info directories, and view the list @value{GDBN} is currently using. -@table @code +@table @kbd @kindex set debug-file-directory @item set debug-file-directory @var{directories} @@ -23197,7 +23197,7 @@ Index Files To create an index file, use the @code{save gdb-index} command: -@table @code +@table @kbd @item save gdb-index [-dwarf-5] @var{directory} @kindex save gdb-index Create index files for all symbol files currently known by @@ -23264,7 +23264,7 @@ Index Files so files without build ID will not have their index cached. The following commands can be used to tweak the behavior of the index cache. -@table @code +@table @kbd @kindex set index-cache @item set index-cache enabled on @@ -23511,7 +23511,7 @@ Data Files You can set the data directory's name, and view the name @value{GDBN} is currently using. -@table @code +@table @kbd @kindex set data-directory @item set data-directory @var{directory} Set the directory which @value{GDBN} searches for auxiliary data files @@ -23556,7 +23556,7 @@ Targets one of the available architectures with the @kbd{set architecture} command. -@table @code +@table @kbd @kindex set architecture @kindex show architecture @item set architecture @var{arch} @@ -23606,7 +23606,7 @@ Active Targets @node Target Commands @section Commands for Managing Targets -@table @code +@table @kbd @item target @var{type} @var{parameters} Connects the @value{GDBN} host environment to a target machine or process. A target is typically a protocol for talking to debugging @@ -23658,7 +23658,7 @@ Target Commands Here are some common targets (available, or not, depending on the GDB configuration): -@table @code +@table @kbd @kindex target @item target exec @var{program} @cindex executable file target @@ -23752,7 +23752,7 @@ Target Commands @value{GDBN} and the remote monitor. @end table -@table @code +@table @kbd @kindex load @var{filename} @var{offset} @item load @var{filename} @var{offset} @@ -23784,7 +23784,7 @@ Target Commands @code{load} does not repeat if you press @key{RET} again after using it. @end table -@table @code +@table @kbd @kindex flash-erase @item flash-erase @@ -23807,7 +23807,7 @@ Byte Order which to use. However, you may still find it useful to adjust @value{GDBN}'s idea of processor endian-ness manually. -@table @code +@table @kbd @kindex set endian @item set endian big Instruct @value{GDBN} to assume the target is big-endian. @@ -24013,7 +24013,7 @@ Connecting establish a connection to the target. Both commands accept the same arguments, which indicate the medium to use: -@table @code +@table @kbd @item target remote @var{serial-device} @itemx target extended-remote @var{serial-device} @@ -24173,7 +24173,7 @@ Connecting In @code{target extended-remote} mode, typing @kbd{n} will leave @value{GDBN} connected to the target. -@table @code +@table @kbd @kindex detach (remote) @item detach When you have finished debugging the remote program, you can use the @@ -24219,7 +24219,7 @@ File Transfer Not all remote targets support these commands. -@table @code +@table @kbd @kindex remote put @item remote put @var{hostfile} @var{targetfile} Copy file @var{hostfile} from the host system (the machine running @@ -24539,7 +24539,7 @@ Server @code{monitor} command to send special requests to @code{gdbserver}. Here are the available commands. -@table @code +@table @kbd @item monitor help List the available monitor commands. @@ -24620,7 +24620,7 @@ Server There are several ways to load the in-process agent in your program: -@table @code +@table @asis @item Specifying it as dependency at link time You can link your program dynamically with the in-process agent @@ -24694,7 +24694,7 @@ Remote Configuration extensions of the remote protocol, see @ref{system, system-call-allowed}. -@table @code +@table @kbd @item set remoteaddresssize @var{bits} @cindex address size for remote targets @cindex bits in remote address @@ -25242,7 +25242,7 @@ Remote Stub @cindex remote serial stub list These working remote stubs are distributed with @value{GDBN}: -@table @code +@table @file @item i386-stub.c @cindex @file{i386-stub.c} @@ -25597,7 +25597,7 @@ Process Information currently available from cores created on @sc{gnu}/Linux and FreeBSD systems. -@table @code +@table @kbd @kindex info proc @cindex process ID @item info proc @@ -25763,7 +25763,7 @@ DJGPP Native defines a few commands specific to the @sc{djgpp} port. This subsection describes those commands. -@table @code +@table @kbd @kindex info dos @item info dos This is a prefix of @sc{djgpp}-specific commands which print @@ -25894,7 +25894,7 @@ DJGPP Native debugging via a serial data link. The following commands are specific to remote serial debugging in the DJGPP port of @value{GDBN}. -@table @code +@table @kbd @kindex set com1base @kindex set com1irq @kindex set com2base @@ -25959,7 +25959,7 @@ Cygwin Native this section. Working with DLLs that have no debugging symbols is described in @ref{Non-debug DLL Symbols}. -@table @code +@table @kbd @kindex info w32 @item info w32 This is a prefix of MS Windows-specific commands which print @@ -26206,7 +26206,7 @@ Hurd Native This subsection describes @value{GDBN} commands specific to the @sc{gnu} Hurd native debugging. -@table @code +@table @kbd @item set signals @itemx set sigs @kindex set signals@r{, Hurd command} @@ -26378,7 +26378,7 @@ Darwin @value{GDBN} provides the following commands specific to the Darwin target: -@table @code +@table @kbd @item set debug darwin @var{num} @kindex set debug darwin When set to a non zero value, enables debugging messages specific to @@ -26456,7 +26456,7 @@ Embedded Processors Whenever a specific embedded processor has a simulator, @value{GDBN} allows to send an arbitrary command to the simulator. -@table @code +@table @kbd @item sim @var{command} @kindex sim@r{, a command} Send an arbitrary @var{command} string to the simulator. Consult the @@ -26490,7 +26490,7 @@ ARC @value{GDBN} provides the following ARC-specific commands: -@table @code +@table @kbd @item set debug arc @kindex set debug arc Control the level of ARC specific debug messages. Use 0 for no messages (the @@ -26511,7 +26511,7 @@ ARM @value{GDBN} provides the following ARM-specific commands: -@table @code +@table @kbd @item set arm disassembler @kindex set arm This commands selects from a list of disassembly styles. The @@ -26593,7 +26593,7 @@ ARM Show whether ARM-specific debugging messages are enabled. @end table -@table @code +@table @kbd @item target sim @r{[}@var{simargs}@r{]} @dots{} The @value{GDBN} ARM simulator accepts the following optional arguments. @@ -26616,7 +26616,7 @@ ARM @node BPF @subsection BPF -@table @code +@table @kbd @item target sim @r{[}@var{simargs}@r{]} @dots{} The @value{GDBN} BPF simulator accepts the following optional arguments. @@ -26653,7 +26653,7 @@ MicroBlaze Use these GDB commands to connect to the MicroBlaze target processor. -@table @code +@table @kbd @item target remote :1234 Use this command to connect to the target if you are running @value{GDBN} on the same system as @code{xmd}. @@ -26678,7 +26678,7 @@ MIPS Embedded @noindent @value{GDBN} supports these special commands for @acronym{MIPS} targets: -@table @code +@table @kbd @item set mipsfpu double @itemx set mipsfpu single @itemx set mipsfpu none @@ -26720,7 +26720,7 @@ OpenRISC 1000 @value{GDBN} for OpenRISC supports the below commands when connecting to a target: -@table @code +@table @kbd @kindex target sim @item target sim @@ -26784,7 +26784,7 @@ PowerPC Embedded @value{GDBN} provides the following PowerPC-specific commands: -@table @code +@table @kbd @kindex break-range @item break-range @var{start-locspec}, @var{end-locspec} Set a breakpoint for an address range given by @var{start-locspec} and @@ -26830,7 +26830,7 @@ AVR When configured for debugging the Atmel AVR, @value{GDBN} supports the following AVR-specific commands: -@table @code +@table @kbd @item info io_registers @kindex info io_registers@r{, AVR} @cindex I/O registers (Atmel AVR) @@ -26845,7 +26845,7 @@ CRIS When configured for debugging CRIS, @value{GDBN} provides the following CRIS-specific commands: -@table @code +@table @kbd @item set cris-version @var{ver} @cindex CRIS version Set the current CRIS version to @var{ver}, either @samp{10} or @samp{32}. @@ -26881,7 +26881,7 @@ Super-H For the Renesas Super-H processor, @value{GDBN} provides these commands: -@table @code +@table @kbd @item set sh calling-convention @var{convention} @kindex set sh calling-convention Set the calling-convention used when calling functions from @value{GDBN}. @@ -26928,7 +26928,7 @@ AArch64 When @value{GDBN} is debugging the AArch64 architecture, it provides the following special commands: -@table @code +@table @kbd @item set debug aarch64 @kindex set debug aarch64 This command determines whether AArch64 architecture-specific debugging @@ -27370,7 +27370,7 @@ AArch64 @node x86 @subsection x86 -@table @code +@table @kbd @item set struct-convention @var{mode} @kindex set struct-convention @cindex struct return convention @@ -27470,7 +27470,7 @@ MIPS you may want to limit the size of this search, using one of these commands: -@table @code +@table @kbd @cindex @code{heuristic-fence-post} (Alpha, @acronym{MIPS}) @item set heuristic-fence-post @var{limit} Restrict @value{GDBN} to examining at most @var{limit} bytes in its @@ -27491,7 +27491,7 @@ MIPS Several @acronym{MIPS}-specific commands are available when debugging @acronym{MIPS} programs: -@table @code +@table @kbd @item set mips abi @var{arg} @kindex set mips abi @cindex set ABI for @acronym{MIPS} @@ -27592,7 +27592,7 @@ HPPA When @value{GDBN} is debugging the HP PA architecture, it provides the following special commands: -@table @code +@table @kbd @item set debug hppa @kindex set debug hppa This command determines whether HPPA architecture-specific debugging @@ -27651,7 +27651,7 @@ Sparc64 cacheline (64 bytes), can be viewed or modified. -@table @code +@table @kbd @kindex adi examine @item adi (examine | x) [ / @var{n} ] @var{addr} @@ -27705,7 +27705,7 @@ S12Z When @value{GDBN} is debugging the S12Z architecture, it provides the following special command: -@table @code +@table @kbd @item maint info bdccsr @kindex maint info bdccsr@r{, S12Z} This command displays the current value of the microprocessor's @@ -27904,7 +27904,7 @@ AMD GPU being incorrect. The following commands can be used to control this behavior: -@table @code +@table @kbd @kindex set amdgpu precise-memory @cindex AMD GPU precise memory event reporting @@ -28016,7 +28016,7 @@ RISC-V When @value{GDBN} is debugging a RISC-V architecture, it provides the following special commands: -@table @code +@table @kbd @item set riscv numeric-register-names @r{[}on@r{|}off@r{]} @kindex set riscv numeric-register-names This command controls whether @value{GDBN} displays RISC-V register names using @@ -28069,7 +28069,7 @@ Prompt prompt you set. This allows you to set a prompt which ends in a space or a prompt that does not. -@table @code +@table @kbd @kindex set prompt @item set prompt @var{newprompt} Directs @value{GDBN} to use @var{newprompt} as its prompt string henceforth. @@ -28093,7 +28093,7 @@ Prompt prompt extensions. The commands for interacting with these extensions are: -@table @code +@table @kbd @kindex set extended-prompt @item set extended-prompt @var{prompt} Set an extended prompt that allows for substitutions. @@ -28133,7 +28133,7 @@ Editing You may control the behavior of command line editing in @value{GDBN} with the command @code{set}. -@table @code +@table @kbd @kindex set editing @cindex editing @item set editing @@ -28207,7 +28207,7 @@ Command History Here is the description of @value{GDBN} commands related to command history. -@table @code +@table @kbd @cindex history substitution @cindex history file @kindex set history filename @@ -28310,7 +28310,7 @@ Command History The commands to control history expansion are: -@table @code +@table @kbd @item set history expansion on @itemx set history expansion @kindex set history expansion @@ -28331,7 +28331,7 @@ Command History @c @end group @end table -@table @code +@table @kbd @kindex show commands @cindex show last commands @cindex display command history @@ -28371,7 +28371,7 @@ Screen Size you can override it with the @code{set height} and @code{set width} commands: -@table @code +@table @kbd @kindex set height @kindex set width @kindex show width @@ -28419,7 +28419,7 @@ Output Styling batch mode (@pxref{Mode Options}). Various style settings are available; and styles can also be disabled entirely. -@table @code +@table @kbd @item set style enabled @samp{on|off} Enable or disable all styling. The default is host-dependent, with most hosts defaulting to @samp{on}. @@ -28525,7 +28525,7 @@ Output Styling For example, the style of file names can be controlled using the @code{set style filename} group of commands: -@table @code +@table @kbd @item set style filename background @var{color} Set the background to @var{color}. @var{color} can be @samp{none} (meaning the terminal's default color), a name of one of the eight standard @@ -28707,7 +28707,7 @@ Numbers format is specified---is base 10. You can change the default base for both input and output with the commands described below. -@table @code +@table @kbd @kindex set input-radix @item set input-radix @var{base} Set the default base for numeric input. Supported choices @@ -28790,7 +28790,7 @@ ABI the @code{--target} configure option) when that is a Windows flavor, and otherwise assumes the GNU flavor. @xref{Configure Options}. -@table @code +@table @kbd @item show osabi Show the OS ABI currently in use. @@ -28814,7 +28814,7 @@ ABI a function is prototyped. If @value{GDBN} calls a function that is not marked as prototyped, it consults @kbd{set coerce-float-to-double}. -@table @code +@table @kbd @kindex set coerce-float-to-double @item set coerce-float-to-double @itemx set coerce-float-to-double on @@ -28844,7 +28844,7 @@ ABI use the ``gnu-v2'' or ``gnu-v3'' ABI's as well. The default setting is ``auto''. -@table @code +@table @kbd @item show cp-abi Show the C@t{++} ABI currently in use. @@ -28878,7 +28878,7 @@ Auto-loading For these reasons, @value{GDBN} includes commands and options to let you control when to auto-load files and which files should be auto-loaded. -@table @code +@table @kbd @anchor{set auto-load off} @kindex set auto-load off @item set auto-load off @@ -29007,7 +29007,7 @@ Init File in the Current Directory Note that loading of this local @file{.gdbinit} file also requires accordingly configured @code{auto-load safe-path} (@pxref{Auto-loading safe path}). -@table @code +@table @kbd @anchor{set auto-load local-gdbinit} @kindex set auto-load local-gdbinit @item set auto-load local-gdbinit [on|off] @@ -29046,7 +29046,7 @@ libthread_db.so.1 file Note that loading of this debugging library also requires accordingly configured @code{auto-load safe-path} (@pxref{Auto-loading safe path}). -@table @code +@table @kbd @anchor{set auto-load libthread-db} @kindex set auto-load libthread-db @item set auto-load libthread-db [on|off] @@ -29099,7 +29099,7 @@ Auto-loading safe path The list of trusted directories is controlled by the following commands: -@table @code +@table @kbd @anchor{set auto-load safe-path} @kindex set auto-load safe-path @item set auto-load safe-path @r{[}@var{directories}@r{]} @@ -29214,7 +29214,7 @@ Auto-loading verbose mode by your `auto-load safe-path' set to "/usr:/opt". @end smallexample -@table @code +@table @kbd @anchor{set debug auto-load} @kindex set debug auto-load @item set debug auto-load [on|off] @@ -29241,7 +29241,7 @@ Messages/Warnings which announce that the symbol table for a source file is being read; see @code{symbol-file} in @ref{Files, ,Commands to Specify Files}. -@table @code +@table @kbd @kindex set verbose @item set verbose on Enables @value{GDBN} output of certain informational messages. @@ -29259,7 +29259,7 @@ Messages/Warnings find this information useful (@pxref{Symbol Errors, ,Errors Reading Symbol Files}). -@table @code +@table @kbd @kindex set complaints @item set complaints @var{limit} @@ -29288,7 +29288,7 @@ Messages/Warnings If you are willing to unflinchingly face the consequences of your own commands, you can disable this ``feature'': -@table @code +@table @kbd @kindex set confirm @cindex flinching @@ -29314,7 +29314,7 @@ Messages/Warnings printed as it is executed, prefixed with one or more @samp{+} symbols, the quantity denoting the call depth of each command. -@table @code +@table @kbd @kindex set trace-commands @cindex command scripts, debugging @item set trace-commands on @@ -29334,7 +29334,7 @@ Debugging Output interest to @value{GDBN} maintainers, or when reporting a bug. This section documents those commands. -@table @code +@table @kbd @kindex set exec-done-display @item set exec-done-display Turns on or off the notification of asynchronous commands' @@ -29725,7 +29725,7 @@ Other Misc Settings @section Other Miscellaneous Settings @cindex miscellaneous settings -@table @code +@table @kbd @kindex set interactive-mode @item set interactive-mode If @code{on}, forces @value{GDBN} to assume that GDB was started @@ -29747,7 +29747,7 @@ Other Misc Settings Displays whether the debugger is operating in interactive mode or not. @end table -@table @code +@table @kbd @kindex set suppress-cli-notifications @item set suppress-cli-notifications If @code{on}, command-line-interface (CLI) notifications that are @@ -29862,7 +29862,7 @@ Extending GDB You can control how @value{GDBN} evaluates these files with the following setting: -@table @code +@table @kbd @kindex set script-extension @kindex show script-extension @item set script-extension off @@ -29987,7 +29987,7 @@ Define end @end smallexample -@table @code +@table @kbd @kindex define @item define @var{commandname} @@ -30216,7 +30216,7 @@ Command Files using the @code{script-extension} setting. @xref{Extending GDB,, Extending GDB}. -@table @code +@table @kbd @kindex source @cindex execute commands from a file @item source [-s] [-v] @var{filename} @@ -30283,7 +30283,7 @@ Command Files complex scripts that loop over data structures, execute commands conditionally, etc. -@table @code +@table @kbd @kindex if @kindex else @item if @@ -30334,7 +30334,7 @@ Output describes three commands useful for generating exactly the output you want. -@table @code +@table @kbd @kindex echo @item echo @var{text} @c I do not consider backslash-space a standard C escape sequence @@ -30521,7 +30521,7 @@ Auto-loading sequences Auto-loading can be enabled or disabled, and the list of auto-loaded scripts can be printed. -@table @code +@table @kbd @anchor{set auto-load gdb-scripts} @kindex set auto-load gdb-scripts @item set auto-load gdb-scripts [on|off] @@ -30563,7 +30563,7 @@ Aliases You can define a new alias with the @samp{alias} command. -@table @code +@table @kbd @kindex alias @item alias [-a] [--] @var{alias} = @var{command} [@var{default-args}] @@ -30792,12 +30792,12 @@ objfile-gdbdotext file where @var{objfile} is the object file's name and where @var{ext} is the file extension for the extension language: -@table @code -@item @file{@var{objfile}-gdb.gdb} +@table @file +@item @var{objfile}-gdb.gdb GDB's own command language -@item @file{@var{objfile}-gdb.py} +@item @var{objfile}-gdb.py Python -@item @file{@var{objfile}-gdb.scm} +@item @var{objfile}-gdb.scm Guile @end table @@ -30824,7 +30824,7 @@ objfile-gdbdotext file is attempted on any platform. This makes the script filenames compatible between Unix and MS-Windows hosts. -@table @code +@table @kbd @anchor{set auto-load scripts-directory} @kindex set auto-load scripts-directory @item set auto-load scripts-directory @r{[}@var{directories}@r{]} @@ -31537,7 +31537,7 @@ TUI Commands these commands will fail with an error, because it would not be possible or desirable to enable curses window management. -@table @code +@table @kbd @item tui enable @kindex tui enable Activate TUI mode. The last active TUI window layout will be used if @@ -31741,7 +31741,7 @@ TUI Configuration Several configuration variables control the appearance of TUI windows. -@table @code +@table @kbd @item set tui border-kind @var{kind} @kindex set tui border-kind Select the border appearance for the source, assembly and register windows. @@ -32068,7 +32068,7 @@ Asynchronous and non-stop modes find if asynchronous execution is enabled using the @code{-list-target-features} command. -@table @code +@table @kbd @cindex foreground execution @cindex background execution @cindex asynchronous execution @@ -40151,7 +40151,7 @@ Annotations Overview been made obsolete (@pxref{Limitations, , Limitations of the Annotation Interface, annotate, GDB's Obsolete Annotations}). -@table @code +@table @kbd @kindex set annotate @item set annotate @var{level} The @value{GDBN} command @code{set annotate} sets the level of @@ -40535,7 +40535,7 @@ Debugger Adapter Protocol DAP mode. These can be set on the command line using the @code{-iex} option (@pxref{File Options}). -@table @code +@table @kbd @item set debug dap-log-file @r{[}@var{filename}@r{]} Enable DAP logging. Logs are written to @var{filename}. If no @var{filename} is given, logging is stopped. @@ -40716,7 +40716,7 @@ Using JIT Debug Info Readers Readers can be loaded and unloaded using the @code{jit-reader-load} and @code{jit-reader-unload} commands. -@table @code +@table @kbd @item jit-reader-load @var{reader} Load the JIT reader named @var{reader}, which is a shared object specified as either an absolute or a relative file name. In @@ -40839,7 +40839,7 @@ In-Process Agent You can control whether the in-process agent is used as an aid for debugging with the following commands: -@table @code +@table @kbd @kindex set agent on @item set agent on Causes the in-process agent to perform some operations on behalf of the @@ -41277,7 +41277,7 @@ In Memoriam The @value{GDBN} project mourns the loss of the following long-time contributors: -@table @code +@table @asis @item Fred Fish Fred was a long-standing contributor to @value{GDBN} (1991-2006), and to Free Software in general. Outside of @value{GDBN}, he was known in @@ -41564,7 +41564,7 @@ Running Configure For example, the @value{GDBN} version @value{GDBVN} distribution is in the @file{gdb-@value{GDBVN}} directory. That directory contains: -@table @code +@table @file @item gdb-@value{GDBVN}/configure @r{(and supporting files)} script for configuring @value{GDBN} and all its supporting libraries @@ -41769,7 +41769,7 @@ Configure Options @samp{--} if you prefer; but you may abbreviate option names if you use @samp{--}. -@table @code +@table @option @item --help Display a quick summary of how to invoke @file{configure}. @@ -41806,7 +41806,7 @@ Configure Options lists just the most common ones; there are some very specialized options not described here. -@table @code +@table @option @item --enable-targets=@r{[}@var{target}@r{]}@dots{} @itemx --enable-targets=all Configure @value{GDBN} for cross-debugging programs running on the @@ -41984,7 +41984,7 @@ System-wide configuration Here are the corresponding configure options: -@table @code +@table @option @item --with-system-gdbinit=@var{file} Specify that the default location of the system-wide init file is @var{file}. @@ -42079,7 +42079,7 @@ Maintenance Commands provided here for reference. (For commands that turn on debugging messages, see @ref{Debugging Output}.) -@table @code +@table @kbd @kindex maint agent @kindex maint agent-eval @item maint agent @r{[}-at @var{linespec}@r{,}@r{]} @var{expression} @@ -42282,7 +42282,7 @@ Maintenance Commands an out-of-line copy of the instruction that was originally at the breakpoint location. It is also known as out-of-line single-stepping. -@table @code +@table @kbd @item set displaced-stepping on If the target architecture supports it, @value{GDBN} will use displaced stepping to step over breakpoints. @@ -43064,7 +43064,7 @@ Maintenance Commands it can be changed to more easily debug problems occurring only in a specific mode. -@table @code +@table @kbd @item maint set target-non-stop auto This is the default mode. @value{GDBN} controls the target in non-stop mode if @code{set non-stop} is @code{on}, or the target tells @@ -43083,8 +43083,8 @@ Maintenance Commands Here is how @code{set non-stop} and @code{maint set target-non-stop} settings combine: -@table @code -@item @code{set non-stop off}, target operating in all-stop mode +@table @asis +@item @kbd{set non-stop off}, target operating in all-stop mode When a thread hits a breakpoint, finishes a step, etc., the target stops all threads, and reports the event to the infrun module in the core of @value{GDBN}. If infrun decides the stop is not to be seen by @@ -43092,7 +43092,7 @@ Maintenance Commands threads stop and are re-resumed for every debug event, even for debug events that are internal and do not cause a user-visible stop. -@item @code{set non-stop off}, target operating in non-stop mode +@item @kbd{set non-stop off}, target operating in non-stop mode When a thread hits a breakpoint, finishes a step, etc., the target does not immediately stop all other threads. If, while processing the event, infrun decides the stop should be reported to the user, it then @@ -43100,10 +43100,10 @@ Maintenance Commands user; otherwise, infrun re-resumes the stopped thread. This scenario is also called ``all-stop on top of non-stop''. -@item @code{set non-stop on}, target operating in all-stop mode +@item @kbd{set non-stop on}, target operating in all-stop mode This combination is invalid. -@item @code{set non-stop on}, target operating in non-stop mode +@item @kbd{set non-stop on}, target operating in non-stop mode When a thread hits a breakpoint, finishes a step, etc., neither the target, nor infrun stop any other thread. @end table @@ -43141,7 +43141,7 @@ Maintenance Commands @value{GDBN} can display the resources used by each command. This is useful in debugging performance problems. -@table @code +@table @kbd @item maint set per-command space [on|off] @itemx maint show per-command space Enable or disable the printing of the memory used by GDB for each command. @@ -43372,7 +43372,7 @@ Maintenance Commands The following command is useful for non-interactive invocations of @value{GDBN}, such as in the test suite. -@table @code +@table @kbd @item set watchdog @var{nsec} @kindex set watchdog @cindex watchdog timer @@ -48669,7 +48669,7 @@ system by @value{GDBN}. The user has to allow this call explicitly with the @code{set remote system-call-allowed 1} command. -@table @code +@table @kbd @item set remote system-call-allowed @kindex set remote system-call-allowed Control whether to allow the @code{system} calls in the File I/O @@ -49486,7 +49486,7 @@ Retrieving Descriptions If a file is set, the target will not be queried. The commands to specify a file are: -@table @code +@table @kbd @cindex set tdesc filename @item set tdesc filename @var{path} Read the target description from @var{path}. @@ -50936,17 +50936,17 @@ M68K Features @subsection M68K Features @cindex target descriptions, M68K features -@table @code -@item @samp{org.gnu.gdb.m68k.core} -@itemx @samp{org.gnu.gdb.coldfire.core} -@itemx @samp{org.gnu.gdb.fido.core} +@table @samp +@item org.gnu.gdb.m68k.core +@itemx org.gnu.gdb.coldfire.core +@itemx org.gnu.gdb.fido.core One of those features must be always present. The feature that is present determines which flavor of m68k is used. The feature that is present should contain registers @samp{d0} through @samp{d7}, @samp{a0} through @samp{a5}, @samp{fp}, @samp{sp}, @samp{ps} and @samp{pc}. -@item @samp{org.gnu.gdb.coldfire.fp} +@item org.gnu.gdb.coldfire.fp This feature is optional. If present, it should contain registers @samp{fp0} through @samp{fp7}, @samp{fpcontrol}, @samp{fpstatus} and @samp{fpiaddr}. @@ -51655,7 +51655,7 @@ Debuginfod Settings @value{GDBN} provides the following commands for configuring @code{debuginfod}. -@table @code +@table @kbd @kindex set debuginfod enabled @anchor{set debuginfod enabled} @item set debuginfod enabled @@ -51807,7 +51807,7 @@ gdb man Here are some of the most frequently needed @value{GDBN} commands: @c pod2man highlights the right hand side of the @item lines. -@table @env +@table @kbd @item break [@var{file}:][@var{function}|@var{line}] Set a breakpoint at @var{function} or @var{line} (in @var{file}). @@ -51884,7 +51884,7 @@ gdb man in sequential order. The order makes a difference when the @option{-x} option is used. -@table @env +@table @option @item --help @itemx -h List all options, with brief explanations. @@ -52297,7 +52297,7 @@ gdbserver man In each of the modes you may specify these options: -@table @env +@table @option @item --help List all options, with brief explanations. @@ -52428,7 +52428,7 @@ gcore man @c man end @c man begin OPTIONS gcore -@table @env +@table @option @item -a Dump all memory mappings. The actual effect of this option depends on the Operating System. On @sc{gnu}/Linux, it will disable @@ -52506,7 +52506,7 @@ gstack man @c man end @c man begin OPTIONS gstack -@table @env +@table @option @item --help @itemx -h List all options, with brief explanations. @@ -52594,12 +52594,12 @@ gdbinit man @ref{Startup}. @end ifclear -@table @env +@table @asis @ifset SYSTEM_GDBINIT -@item @value{SYSTEM_GDBINIT} +@item @file{@value{SYSTEM_GDBINIT}} @end ifset @ifclear SYSTEM_GDBINIT -@item (not enabled with @code{--with-system-gdbinit} during compilation) +@item (not enabled with @option{--with-system-gdbinit} during compilation) @end ifclear System-wide initialization file. It is executed unless user specified @value{GDBN} option @code{-nx} or @code{-n}. @@ -52609,10 +52609,10 @@ gdbinit man -- shell command @code{info -f gdb -n 'System-wide configuration'}. @end ifset @ifset SYSTEM_GDBINIT_DIR -@item @value{SYSTEM_GDBINIT_DIR} +@item @file{@value{SYSTEM_GDBINIT_DIR}} @end ifset @ifclear SYSTEM_GDBINIT_DIR -@item (not enabled with @code{--with-system-gdbinit-dir} during compilation) +@item (not enabled with @option{--with-system-gdbinit-dir} during compilation) @end ifclear System-wide initialization directory. All files in this directory are executed on startup unless user specified @value{GDBN} option @code{-nx} or @@ -52713,7 +52713,7 @@ gdb-add-index man @c man end @c man begin OPTIONS gdb-add-index -@table @env +@table @option @item --dwarf-5 Add DWARF 5 sections instead of previous @code{.gdb_index} section. diff --git a/gdb/doc/guile.texi b/gdb/doc/guile.texi index 7bf773a649e..e7956c01ab6 100644 --- a/gdb/doc/guile.texi +++ b/gdb/doc/guile.texi @@ -55,7 +55,7 @@ Guile Commands @value{GDBN} provides two commands for accessing the Guile interpreter: -@table @code +@table @kbd @kindex guile-repl @kindex gr @item guile-repl @@ -104,7 +104,7 @@ Guile Commands It is also possible to execute a Guile script from the @value{GDBN} interpreter: -@table @code +@table @kbd @item source @file{script-name} The script name must end with @samp{.scm} and @value{GDBN} must be configured to recognize the script language based on filename extension using @@ -3920,7 +3920,7 @@ Guile Auto-loading Auto-loading can be enabled or disabled, and the list of auto-loaded scripts can be printed. -@table @code +@table @kbd @anchor{set auto-load guile-scripts} @kindex set auto-load guile-scripts @item set auto-load guile-scripts [on|off] diff --git a/gdb/doc/python.texi b/gdb/doc/python.texi index 99d11d35aaf..c1eb39360c6 100644 --- a/gdb/doc/python.texi +++ b/gdb/doc/python.texi @@ -48,7 +48,7 @@ Python Commands @value{GDBN} provides two commands for accessing the Python interpreter, and one related setting: -@table @code +@table @kbd @kindex python-interactive @kindex pi @item python-interactive @r{[}@var{command}@r{]} @@ -150,7 +150,7 @@ Python Commands It is also possible to execute a Python script from the @value{GDBN} interpreter: -@table @code +@table @kbd @item source @file{script-name} The script name must end with @samp{.py} and @value{GDBN} must be configured to recognize the script language based on filename extension using @@ -159,7 +159,7 @@ Python Commands The following commands are intended to help debug @value{GDBN} itself: -@table @code +@table @kbd @kindex set debug py-breakpoint @kindex show debug py-breakpoint @item set debug py-breakpoint on@r{|}off @@ -3174,7 +3174,7 @@ Unwinding Frames in Python @value{GDBN} defines 3 commands to manage registered unwinders. These are: -@table @code +@table @kbd @item info unwinder @r{[} @var{locus} @r{[} @var{name-regexp} @r{]} @r{]} Lists all registered unwinders. Arguments @var{locus} and @var{name-regexp} are both optional and can be used to filter which @@ -3949,7 +3949,7 @@ Events In Python @table @code @tindex gdb.InferiorCallPreEvent -@item @code{gdb.InferiorCallPreEvent} +@item gdb.InferiorCallPreEvent Indicates that a function in the inferior is about to be called. @defvar InferiorCallPreEvent.ptid @@ -3961,7 +3961,7 @@ Events In Python @end defvar @tindex gdb.InferiorCallPostEvent -@item @code{gdb.InferiorCallPostEvent} +@item gdb.InferiorCallPostEvent Indicates that a function in the inferior has just been called. @defvar InferiorCallPostEvent.ptid @@ -8949,7 +8949,7 @@ Missing Objfiles In Python @value{GDBN} defines the following commands to manage registered missing-objfile handlers: -@table @code +@table @kbd @kindex info missing-objfile-handlers @item info missing-objfile-handlers @r{[} @var{locus} @r{[} @var{name-regexp} @r{]} @r{]} @@ -9099,7 +9099,7 @@ Python Auto-loading Auto-loading can be enabled or disabled, and the list of auto-loaded scripts can be printed. -@table @code +@table @kbd @anchor{set auto-load python-scripts} @kindex set auto-load python-scripts @item set auto-load python-scripts [on|off] -- 2.55.0