Mirror of the gdb-patches mailing list
 help / color / mirror / Atom feed
From: Andrew Burgess <aburgess@redhat.com>
To: gdb-patches@sourceware.org
Cc: Andrew Burgess <aburgess@redhat.com>
Subject: [PATCH 1/5] gdb/doc: use (@value{GDBP}) for the prompt in examples
Date: Mon, 12 Oct 2026 19:54:26 +0100	[thread overview]
Message-ID: <191418904b1320ef05149d612c326f34cfffcaf5.1791831032.git.aburgess@redhat.com> (raw)
In-Reply-To: <cover.1791831032.git.aburgess@redhat.com>

Within examples we should be using (@value{GDBP}) not '(gdb)'.  There
are several places where we don't do this, fix them now.
---
 gdb/doc/gdb.texinfo | 648 ++++++++++++++++++++++----------------------
 gdb/doc/guile.texi  |  50 ++--
 gdb/doc/python.texi |  38 +--
 3 files changed, 368 insertions(+), 368 deletions(-)

diff --git a/gdb/doc/gdb.texinfo b/gdb/doc/gdb.texinfo
index 4bd5357c587..1f7778a1824 100644
--- a/gdb/doc/gdb.texinfo
+++ b/gdb/doc/gdb.texinfo
@@ -4764,9 +4764,9 @@ Set Breaks
 @code{b}).  The debugger convenience variable @samp{$bpnum} records the
 number of the breakpoint you've set most recently:
 @smallexample
-(gdb) b main
+(@value{GDBP}) b main
 Breakpoint 1 at 0x11c6: file zeoes.c, line 24.
-(gdb) p $bpnum
+(@value{GDBP}) p $bpnum
 $1 = 1
 @end smallexample
 
@@ -4775,11 +4775,11 @@ Set Breaks
 @value{GDBN} then indicates the number of code locations in the breakpoint
 command output:
 @smallexample
-(gdb) b some_func
+(@value{GDBP}) b some_func
 Breakpoint 2 at 0x1179: some_func. (3 locations)
-(gdb) p $bpnum
+(@value{GDBP}) p $bpnum
 $2 = 2
-(gdb)
+(@value{GDBP})
 @end smallexample
 
 @vindex $_hit_bpnum@r{, convenience variable}
@@ -4790,11 +4790,11 @@ Set Breaks
 @smallexample
 Thread 1 "zeoes" hit Breakpoint 2.1, some_func () at zeoes.c:8
 8	  printf("some func\n");
-(gdb) p $_hit_bpnum
+(@value{GDBP}) p $_hit_bpnum
 $5 = 2
-(gdb) p $_hit_locno
+(@value{GDBP}) p $_hit_locno
 $6 = 1
-(gdb)
+(@value{GDBP})
 @end smallexample
 
 Note that @samp{$_hit_bpnum} and @samp{$bpnum} are not equivalent:
@@ -4807,11 +4807,11 @@ Set Breaks
 @smallexample
 Breakpoint 1, main (argc=1, argv=0x7fffffffe018) at zeoes.c:24
 24	  if (argc > 1)
-(gdb) p $_hit_bpnum
+(@value{GDBP}) p $_hit_bpnum
 $3 = 1
-(gdb) p $_hit_locno
+(@value{GDBP}) p $_hit_locno
 $4 = 1
-(gdb)
+(@value{GDBP})
 @end smallexample
 
 The @samp{$_hit_bpnum} and @samp{$_hit_locno} variables can typically be used
@@ -4828,8 +4828,8 @@ Set Breaks
 You can also define aliases to easily disable the last hit location or
 last hit breakpoint:
 @smallexample
-(gdb) alias lld = disable $_hit_bpnum.$_hit_locno
-(gdb) alias lbd = disable $_hit_bpnum
+(@value{GDBP}) alias lld = disable $_hit_bpnum.$_hit_locno
+(@value{GDBP}) alias lbd = disable $_hit_bpnum
 @end smallexample
 
 @table @code
@@ -9224,7 +9224,7 @@ Frame Info
 6: @}
 @end group
 @group
-(gdb) info locals
+(@value{GDBP}) info locals
 x = 4	<file.c:3>
 y = 52
 x = 3	<file.c:1, shadowed>
@@ -19886,7 +19886,7 @@ Ravenscar Profile
 announced by @value{GDBN} as if they were threads:
 
 @smallexample
-(gdb) continue
+(@value{GDBP}) continue
 [New Ravenscar Thread 0x2b8f0]
 @end smallexample
 
@@ -19894,7 +19894,7 @@ Ravenscar Profile
 the output of @code{info threads}:
 
 @smallexample
-(gdb) info threads
+(@value{GDBP}) info threads
   Id   Target Id                  Frame
   1    Thread 1 (CPU#0 [running]) simple () at simple.adb:10
   2    Thread 2 (CPU#1 [running]) 0x0000000000003d34 in __gnat_initialize_cpu_devices ()
@@ -27345,7 +27345,7 @@ AArch64
 @code{por_el0} when displaying it with the @code{info registers} command.
 
 @smallexample
-(gdb) info registers por_el0
+(@value{GDBP}) info registers por_el0
 por_el0 0x0000000000000007 [ P0=rwx ]
 @end smallexample
 
@@ -27356,11 +27356,11 @@ AArch64
 @code{por_el0}.
 
 @smallexample
-(gdb) set $por_el0 = 0x7
-(gdb) set $por_p1 = 0x7
-(gdb) info registers por_el0
+(@value{GDBP}) set $por_el0 = 0x7
+(@value{GDBP}) set $por_p1 = 0x7
+(@value{GDBP}) info registers por_el0
 por_el0		0x0000000000000077	[ P1=rwx P0=rwx ]
-(gdb) info registers por_p1
+(@value{GDBP}) info registers por_p1
 por_p1		0x7			rwx
 @end smallexample
 
@@ -29763,20 +29763,20 @@ Other Misc Settings
 new context.  For example, the default behavior is below:
 
 @smallexample
-(gdb) inferior 1
+(@value{GDBP}) inferior 1
 [Switching to inferior 1 [process 634] (/tmp/test)]
 [Switching to thread 1 (process 634)]
 #0  main () at test.c:3
 3         return 0;
-(gdb)
+(@value{GDBP})
 @end smallexample
 
 When the notifications are suppressed, the new context is not printed:
 
 @smallexample
-(gdb) set suppress-cli-notifications on
-(gdb) inferior 1
-(gdb)
+(@value{GDBP}) set suppress-cli-notifications on
+(@value{GDBP}) inferior 1
+(@value{GDBP})
 @end smallexample
 
 @item The program being debugged stops:
@@ -29786,25 +29786,25 @@ Other Misc Settings
 below is a breakpoint hit:
 
 @smallexample
-(gdb) break test.c:3
+(@value{GDBP}) break test.c:3
 Breakpoint 2 at 0x555555555155: file test.c, line 3.
-(gdb) continue
+(@value{GDBP}) continue
 Continuing.
 
 Breakpoint 2, main () at test.c:3
 3         return 0;
-(gdb)
+(@value{GDBP})
 @end smallexample
 
 When the notifications are suppressed, the output becomes:
 
 @smallexample
-(gdb) break test.c:3
+(@value{GDBP}) break test.c:3
 Breakpoint 2 at 0x555555555155: file test.c, line 3.
-(gdb) set suppress-cli-notifications on
-(gdb) continue
+(@value{GDBP}) set suppress-cli-notifications on
+(@value{GDBP}) continue
 Continuing.
-(gdb)
+(@value{GDBP})
 @end smallexample
 
 Suppressing CLI notifications may be useful in scripts to obtain a
@@ -31583,7 +31583,7 @@ TUI Commands
 For example:
 
 @example
-(gdb) tui new-layout example src 1 regs 1 status 0 cmd 1
+(@value{GDBP}) tui new-layout example src 1 regs 1 status 0 cmd 1
 @end example
 
 Here, the new layout is called @samp{example}.  It shows the source
@@ -31594,7 +31594,7 @@ TUI Commands
 Here is a more complex example, showing a horizontal layout:
 
 @example
-(gdb) tui new-layout example @{-horizontal src 1 asm 1@} 2 status 0 cmd 1
+(@value{GDBP}) tui new-layout example @{-horizontal src 1 asm 1@} 2 status 0 cmd 1
 @end example
 
 This will result in side-by-side source and assembly windows; with the
@@ -32048,7 +32048,7 @@ Context management
 @smallexample
 -data-evaluate-expression --language c "sizeof (void*)"
 ^done,value="4"
-(gdb)
+(@value{GDBP})
 @end smallexample
 
 The valid language names are the same names accepted by the
@@ -33298,17 +33298,17 @@ GDB/MI Breakpoint Commands
 @subsubheading Example
 
 @smallexample
-(gdb)
+(@value{GDBP})
 -break-insert main
 ^done,bkpt=@{number="1",type="breakpoint",disp="keep",
 enabled="y",addr="0x000100d0",func="main",file="hello.c",
 fullname="/home/foo/hello.c",line="5",thread-groups=["i1"],
 times="0"@}
-(gdb)
+(@value{GDBP})
 -break-after 1 3
 ~
 ^done
-(gdb)
+(@value{GDBP})
 -break-list
 ^done,BreakpointTable=@{nr_rows="1",nr_cols="6",
 hdr=[@{width="3",alignment="-1",col_name="number",colhdr="Num"@},
@@ -33320,7 +33320,7 @@ GDB/MI Breakpoint Commands
 body=[bkpt=@{number="1",type="breakpoint",disp="keep",enabled="y",
 addr="0x000100d0",func="main",file="hello.c",fullname="/home/foo/hello.c",
 line="5",thread-groups=["i1"],times="0",ignore="3"@}]@}
-(gdb)
+(@value{GDBP})
 @end smallexample
 
 @ignore
@@ -33351,16 +33351,16 @@ GDB/MI Breakpoint Commands
 @subsubheading Example
 
 @smallexample
-(gdb)
+(@value{GDBP})
 -break-insert main
 ^done,bkpt=@{number="1",type="breakpoint",disp="keep",
 enabled="y",addr="0x000100d0",func="main",file="hello.c",
 fullname="/home/foo/hello.c",line="5",thread-groups=["i1"],
 times="0"@}
-(gdb)
+(@value{GDBP})
 -break-commands 1 "print v" "continue"
 ^done
-(gdb)
+(@value{GDBP})
 @end smallexample
 
 @findex -break-condition
@@ -33387,10 +33387,10 @@ GDB/MI Breakpoint Commands
 @subsubheading Example
 
 @smallexample
-(gdb)
+(@value{GDBP})
 -break-condition 1 1
 ^done
-(gdb)
+(@value{GDBP})
 -break-list
 ^done,BreakpointTable=@{nr_rows="1",nr_cols="6",
 hdr=[@{width="3",alignment="-1",col_name="number",colhdr="Num"@},
@@ -33402,7 +33402,7 @@ GDB/MI Breakpoint Commands
 body=[bkpt=@{number="1",type="breakpoint",disp="keep",enabled="y",
 addr="0x000100d0",func="main",file="hello.c",fullname="/home/foo/hello.c",
 line="5",cond="1",thread-groups=["i1"],times="0",ignore="3"@}]@}
-(gdb)
+(@value{GDBP})
 @end smallexample
 
 @findex -break-delete
@@ -33424,10 +33424,10 @@ GDB/MI Breakpoint Commands
 @subsubheading Example
 
 @smallexample
-(gdb)
+(@value{GDBP})
 -break-delete 1
 ^done
-(gdb)
+(@value{GDBP})
 -break-list
 ^done,BreakpointTable=@{nr_rows="0",nr_cols="6",
 hdr=[@{width="3",alignment="-1",col_name="number",colhdr="Num"@},
@@ -33437,7 +33437,7 @@ GDB/MI Breakpoint Commands
 @{width="10",alignment="-1",col_name="addr",colhdr="Address"@},
 @{width="40",alignment="2",col_name="what",colhdr="What"@}],
 body=[]@}
-(gdb)
+(@value{GDBP})
 @end smallexample
 
 @findex -break-disable
@@ -33459,10 +33459,10 @@ GDB/MI Breakpoint Commands
 @subsubheading Example
 
 @smallexample
-(gdb)
+(@value{GDBP})
 -break-disable 2
 ^done
-(gdb)
+(@value{GDBP})
 -break-list
 ^done,BreakpointTable=@{nr_rows="1",nr_cols="6",
 hdr=[@{width="3",alignment="-1",col_name="number",colhdr="Num"@},
@@ -33474,7 +33474,7 @@ GDB/MI Breakpoint Commands
 body=[bkpt=@{number="2",type="breakpoint",disp="keep",enabled="n",
 addr="0x000100d0",func="main",file="hello.c",fullname="/home/foo/hello.c",
 line="5",thread-groups=["i1"],times="0"@}]@}
-(gdb)
+(@value{GDBP})
 @end smallexample
 
 @findex -break-enable
@@ -33495,10 +33495,10 @@ GDB/MI Breakpoint Commands
 @subsubheading Example
 
 @smallexample
-(gdb)
+(@value{GDBP})
 -break-enable 2
 ^done
-(gdb)
+(@value{GDBP})
 -break-list
 ^done,BreakpointTable=@{nr_rows="1",nr_cols="6",
 hdr=[@{width="3",alignment="-1",col_name="number",colhdr="Num"@},
@@ -33510,7 +33510,7 @@ GDB/MI Breakpoint Commands
 body=[bkpt=@{number="2",type="breakpoint",disp="keep",enabled="y",
 addr="0x000100d0",func="main",file="hello.c",fullname="/home/foo/hello.c",
 line="5",thread-groups=["i1"],times="0"@}]@}
-(gdb)
+(@value{GDBP})
 @end smallexample
 
 @findex -break-info
@@ -33635,17 +33635,17 @@ GDB/MI Breakpoint Commands
 @subsubheading Example
 
 @smallexample
-(gdb)
+(@value{GDBP})
 -break-insert main
 ^done,bkpt=@{number="1",addr="0x0001072c",file="recursive2.c",
 fullname="/home/foo/recursive2.c,line="4",thread-groups=["i1"],
 times="0"@}
-(gdb)
+(@value{GDBP})
 -break-insert -t foo
 ^done,bkpt=@{number="2",addr="0x00010774",file="recursive2.c",
 fullname="/home/foo/recursive2.c,line="11",thread-groups=["i1"],
 times="0"@}
-(gdb)
+(@value{GDBP})
 -break-list
 ^done,BreakpointTable=@{nr_rows="2",nr_cols="6",
 hdr=[@{width="3",alignment="-1",col_name="number",colhdr="Num"@},
@@ -33662,7 +33662,7 @@ GDB/MI Breakpoint Commands
 addr="0x00010774",func="foo",file="recursive2.c",
 fullname="/home/foo/recursive2.c",line="11",thread-groups=["i1"],
 times="0"@}]@}
-(gdb)
+(@value{GDBP})
 @end smallexample
 
 @findex -dprintf-insert
@@ -33727,21 +33727,21 @@ GDB/MI Breakpoint Commands
 @subsubheading Example
 
 @smallexample
-(gdb)
+(@value{GDBP})
 4-dprintf-insert foo "At foo entry\n"
 4^done,bkpt=@{number="1",type="dprintf",disp="keep",enabled="y",
 addr="0x000000000040061b",func="foo",file="mi-dprintf.c",
 fullname="mi-dprintf.c",line="25",thread-groups=["i1"],
 times="0",script=["printf \"At foo entry\\n\"","continue"],
 original-location="foo"@}
-(gdb)
+(@value{GDBP})
 5-dprintf-insert 26 "arg=%d, g=%d\n" arg g
 5^done,bkpt=@{number="2",type="dprintf",disp="keep",enabled="y",
 addr="0x000000000040062a",func="foo",file="mi-dprintf.c",
 fullname="mi-dprintf.c",line="26",thread-groups=["i1"],
 times="0",script=["printf \"arg=%d, g=%d\\n\", arg, g","continue"],
 original-location="mi-dprintf.c:26"@}
-(gdb)
+(@value{GDBP})
 @end smallexample
 
 @findex -break-list
@@ -33786,7 +33786,7 @@ GDB/MI Breakpoint Commands
 @subsubheading Example
 
 @smallexample
-(gdb)
+(@value{GDBP})
 -break-list
 ^done,BreakpointTable=@{nr_rows="2",nr_cols="6",
 hdr=[@{width="3",alignment="-1",col_name="number",colhdr="Num"@},
@@ -33801,13 +33801,13 @@ GDB/MI Breakpoint Commands
 bkpt=@{number="2",type="breakpoint",disp="keep",enabled="y",
 addr="0x00010114",func="foo",file="hello.c",fullname="/home/foo/hello.c",
 line="13",thread-groups=["i1"],times="0"@}]@}
-(gdb)
+(@value{GDBP})
 @end smallexample
 
 Here's an example of the result when there are no breakpoints:
 
 @smallexample
-(gdb)
+(@value{GDBP})
 -break-list
 ^done,BreakpointTable=@{nr_rows="0",nr_cols="6",
 hdr=[@{width="3",alignment="-1",col_name="number",colhdr="Num"@},
@@ -33817,7 +33817,7 @@ GDB/MI Breakpoint Commands
 @{width="10",alignment="-1",col_name="addr",colhdr="Address"@},
 @{width="40",alignment="2",col_name="what",colhdr="What"@}],
 body=[]@}
-(gdb)
+(@value{GDBP})
 @end smallexample
 
 @findex -break-passcount
@@ -33865,18 +33865,18 @@ GDB/MI Breakpoint Commands
 Setting a watchpoint on a variable in the @code{main} function:
 
 @smallexample
-(gdb)
+(@value{GDBP})
 -break-watch x
 ^done,wpt=@{number="2",exp="x"@}
-(gdb)
+(@value{GDBP})
 -exec-continue
 ^running
-(gdb)
+(@value{GDBP})
 *stopped,reason="watchpoint-trigger",wpt=@{number="2",exp="x"@},
 value=@{old="-268439212",new="55"@},
 frame=@{func="main",args=[],file="recursive2.c",
 fullname="/home/foo/bar/recursive2.c",line="5",arch="i386:x86_64"@}
-(gdb)
+(@value{GDBP})
 @end smallexample
 
 Setting a watchpoint on a variable local to a function.  @value{GDBN} will stop
@@ -33884,30 +33884,30 @@ GDB/MI Breakpoint Commands
 for the watchpoint going out of scope.
 
 @smallexample
-(gdb)
+(@value{GDBP})
 -break-watch C
 ^done,wpt=@{number="5",exp="C"@}
-(gdb)
+(@value{GDBP})
 -exec-continue
 ^running
-(gdb)
+(@value{GDBP})
 *stopped,reason="watchpoint-trigger",
 wpt=@{number="5",exp="C"@},value=@{old="-276895068",new="3"@},
 frame=@{func="callee4",args=[],
 file="../../../devo/gdb/testsuite/gdb.mi/basics.c",
 fullname="/home/foo/bar/devo/gdb/testsuite/gdb.mi/basics.c",line="13",
 arch="i386:x86_64"@}
-(gdb)
+(@value{GDBP})
 -exec-continue
 ^running
-(gdb)
+(@value{GDBP})
 *stopped,reason="watchpoint-scope",wpnum="5",
 frame=@{func="callee3",args=[@{name="strarg",
 value="0x11940 \"A string argument.\""@}],
 file="../../../devo/gdb/testsuite/gdb.mi/basics.c",
 fullname="/home/foo/bar/devo/gdb/testsuite/gdb.mi/basics.c",line="18",
 arch="i386:x86_64"@}
-(gdb)
+(@value{GDBP})
 @end smallexample
 
 Listing breakpoints and watchpoints, at different points in the program
@@ -33915,10 +33915,10 @@ GDB/MI Breakpoint Commands
 deleted.
 
 @smallexample
-(gdb)
+(@value{GDBP})
 -break-watch C
 ^done,wpt=@{number="2",exp="C"@}
-(gdb)
+(@value{GDBP})
 -break-list
 ^done,BreakpointTable=@{nr_rows="2",nr_cols="6",
 hdr=[@{width="3",alignment="-1",col_name="number",colhdr="Num"@},
@@ -33934,17 +33934,17 @@ GDB/MI Breakpoint Commands
 times="1"@},
 bkpt=@{number="2",type="watchpoint",disp="keep",
 enabled="y",addr="",what="C",thread-groups=["i1"],times="0"@}]@}
-(gdb)
+(@value{GDBP})
 -exec-continue
 ^running
-(gdb)
+(@value{GDBP})
 *stopped,reason="watchpoint-trigger",wpt=@{number="2",exp="C"@},
 value=@{old="-276895068",new="3"@},
 frame=@{func="callee4",args=[],
 file="../../../devo/gdb/testsuite/gdb.mi/basics.c",
 fullname="/home/foo/bar/devo/gdb/testsuite/gdb.mi/basics.c",line="13",
 arch="i386:x86_64"@}
-(gdb)
+(@value{GDBP})
 -break-list
 ^done,BreakpointTable=@{nr_rows="2",nr_cols="6",
 hdr=[@{width="3",alignment="-1",col_name="number",colhdr="Num"@},
@@ -33960,7 +33960,7 @@ GDB/MI Breakpoint Commands
 times="1"@},
 bkpt=@{number="2",type="watchpoint",disp="keep",
 enabled="y",addr="",what="C",thread-groups=["i1"],times="-5"@}]@}
-(gdb)
+(@value{GDBP})
 -exec-continue
 ^running
 ^done,reason="watchpoint-scope",wpnum="2",
@@ -33969,7 +33969,7 @@ GDB/MI Breakpoint Commands
 file="../../../devo/gdb/testsuite/gdb.mi/basics.c",
 fullname="/home/foo/bar/devo/gdb/testsuite/gdb.mi/basics.c",line="18",
 arch="i386:x86_64"@}
-(gdb)
+(@value{GDBP})
 -break-list
 ^done,BreakpointTable=@{nr_rows="1",nr_cols="6",
 hdr=[@{width="3",alignment="-1",col_name="number",colhdr="Num"@},
@@ -33983,7 +33983,7 @@ GDB/MI Breakpoint Commands
 file="../../../devo/gdb/testsuite/gdb.mi/basics.c",
 fullname="/home/foo/devo/gdb/testsuite/gdb.mi/basics.c",line="8",
 thread-groups=["i1"],times="1"@}]@}
-(gdb)
+(@value{GDBP})
 @end smallexample
 
 
@@ -34029,7 +34029,7 @@ Shared Library GDB/MI Catchpoint Commands
 -catch-load -t foo.so
 ^done,bkpt=@{number="1",type="catchpoint",disp="del",enabled="y",
 what="load of library matching foo.so",catch-type="load",times="0"@}
-(gdb)
+(@value{GDBP})
 @end smallexample
 
 
@@ -34058,7 +34058,7 @@ Shared Library GDB/MI Catchpoint Commands
 -catch-unload -d bar.so
 ^done,bkpt=@{number="2",type="catchpoint",disp="keep",enabled="n",
 what="load of library matching bar.so",catch-type="unload",times="0"@}
-(gdb)
+(@value{GDBP})
 @end smallexample
 
 @node Ada Exception GDB/MI Catchpoint Commands
@@ -34101,7 +34101,7 @@ Ada Exception GDB/MI Catchpoint Commands
 enabled="y",addr="0x0000000000404888",what="failed Ada assertions",
 thread-groups=["i1"],times="0",
 original-location="__gnat_debug_raise_assert_failure"@}
-(gdb)
+(@value{GDBP})
 @end smallexample
 
 @findex -catch-exception
@@ -34150,7 +34150,7 @@ Ada Exception GDB/MI Catchpoint Commands
 enabled="y",addr="0x0000000000404874",
 what="`Program_Error' Ada exception", thread-groups=["i1"],
 times="0",original-location="__gnat_debug_raise_exception"@}
-(gdb)
+(@value{GDBP})
 @end smallexample
 
 @findex -catch-handlers
@@ -34194,7 +34194,7 @@ Ada Exception GDB/MI Catchpoint Commands
 enabled="y",addr="0x0000000000402f68",
 what="`Constraint_Error' Ada exception handlers",thread-groups=["i1"],
 times="0",original-location="__gnat_begin_handler"@}
-(gdb)
+(@value{GDBP})
 @end smallexample
 
 @node C++ Exception GDB/MI Catchpoint Commands
@@ -34234,10 +34234,10 @@ C++ Exception GDB/MI Catchpoint Commands
   what="exception throw",catch-type="throw",
   thread-groups=["i1"],
   regexp="exception_type",times="0"@}
-(gdb)
+(@value{GDBP})
 -exec-run
 ^running
-(gdb)
+(@value{GDBP})
 ~"\n"
 ~"Catchpoint 1 (exception thrown), 0x00007ffff7ae00ed
   in __cxa_throw () from /lib64/libstdc++.so.6\n"
@@ -34245,7 +34245,7 @@ C++ Exception GDB/MI Catchpoint Commands
   frame=@{addr="0x00007ffff7ae00ed",func="__cxa_throw",
   args=[],from="/lib64/libstdc++.so.6",arch="i386:x86-64"@},
   thread-id="1",stopped-threads="all",core="6"
-(gdb)
+(@value{GDBP})
 @end smallexample
 
 @findex -catch-rethrow
@@ -34278,10 +34278,10 @@ C++ Exception GDB/MI Catchpoint Commands
   what="exception rethrow",catch-type="rethrow",
   thread-groups=["i1"],
   regexp="exception_type",times="0"@}
-(gdb)
+(@value{GDBP})
 -exec-run
 ^running
-(gdb)
+(@value{GDBP})
 ~"\n"
 ~"Catchpoint 1 (exception rethrown), 0x00007ffff7ae00ed
   in __cxa_rethrow () from /lib64/libstdc++.so.6\n"
@@ -34289,7 +34289,7 @@ C++ Exception GDB/MI Catchpoint Commands
   frame=@{addr="0x00007ffff7ae00ed",func="__cxa_rethrow",
   args=[],from="/lib64/libstdc++.so.6",arch="i386:x86-64"@},
   thread-id="1",stopped-threads="all",core="6"
-(gdb)
+(@value{GDBP})
 @end smallexample
 
 @findex -catch-catch
@@ -34322,10 +34322,10 @@ C++ Exception GDB/MI Catchpoint Commands
   what="exception catch",catch-type="catch",
   thread-groups=["i1"],
   regexp="exception_type",times="0"@}
-(gdb)
+(@value{GDBP})
 -exec-run
 ^running
-(gdb)
+(@value{GDBP})
 ~"\n"
 ~"Catchpoint 1 (exception caught), 0x00007ffff7ae00ed
   in __cxa_begin_catch () from /lib64/libstdc++.so.6\n"
@@ -34333,7 +34333,7 @@ C++ Exception GDB/MI Catchpoint Commands
   frame=@{addr="0x00007ffff7ae00ed",func="__cxa_begin_catch",
   args=[],from="/lib64/libstdc++.so.6",arch="i386:x86-64"@},
   thread-id="1",stopped-threads="all",core="6"
-(gdb)
+(@value{GDBP})
 @end smallexample
 
 @c %%%%%%%%%%%%%%%%%%%%%%%%%%%% SECTION %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
@@ -34360,10 +34360,10 @@ GDB/MI Program Context
 @subsubheading Example
 
 @smallexample
-(gdb)
+(@value{GDBP})
 -exec-arguments -v word
 ^done
-(gdb)
+(@value{GDBP})
 @end smallexample
 
 
@@ -34407,10 +34407,10 @@ GDB/MI Program Context
 
 @c codespell:ignore-begin
 @smallexample
-(gdb)
+(@value{GDBP})
 -environment-cd /kwikemart/marge/ezannoni/flathead-dev/devo/gdb
 ^done
-(gdb)
+(@value{GDBP})
 @end smallexample
 @c codespell:ignore-end
 
@@ -34449,19 +34449,19 @@ GDB/MI Program Context
 
 @c codespell:ignore-begin
 @smallexample
-(gdb)
+(@value{GDBP})
 -environment-directory /kwikemart/marge/ezannoni/flathead-dev/devo/gdb
 ^done,source-path="/kwikemart/marge/ezannoni/flathead-dev/devo/gdb:$cdir:$cwd"
-(gdb)
+(@value{GDBP})
 -environment-directory ""
 ^done,source-path="/kwikemart/marge/ezannoni/flathead-dev/devo/gdb:$cdir:$cwd"
-(gdb)
+(@value{GDBP})
 -environment-directory -r /home/jjohnstn/src/gdb /usr/src
 ^done,source-path="/home/jjohnstn/src/gdb:/usr/src:$cdir:$cwd"
-(gdb)
+(@value{GDBP})
 -environment-directory -r
 ^done,source-path="$cdir:$cwd"
-(gdb)
+(@value{GDBP})
 @end smallexample
 @c codespell:ignore-end
 
@@ -34502,16 +34502,16 @@ GDB/MI Program Context
 
 @c codespell:ignore-begin
 @smallexample
-(gdb)
+(@value{GDBP})
 -environment-path
 ^done,path="/usr/bin"
-(gdb)
+(@value{GDBP})
 -environment-path /kwikemart/marge/ezannoni/flathead-dev/ppc-eabi/gdb /bin
 ^done,path="/kwikemart/marge/ezannoni/flathead-dev/ppc-eabi/gdb:/bin:/usr/bin"
-(gdb)
+(@value{GDBP})
 -environment-path -r /usr/local/bin
 ^done,path="/usr/local/bin:/usr/bin"
-(gdb)
+(@value{GDBP})
 @end smallexample
 @c codespell:ignore-end
 
@@ -34535,10 +34535,10 @@ GDB/MI Program Context
 
 @c codespell:ignore-begin
 @smallexample
-(gdb)
+(@value{GDBP})
 -environment-pwd
 ^done,cwd="/kwikemart/marge/ezannoni/flathead-dev/devo/gdb"
-(gdb)
+(@value{GDBP})
 @end smallexample
 @c codespell:ignore-end
 
@@ -34598,7 +34598,7 @@ GDB/MI Thread Commands
            file="/tmp/a.c",fullname="/tmp/a.c",line="158",arch="i386:x86_64"@},
            state="running"@}],
 current-thread-id="1"
-(gdb)
+(@value{GDBP})
 @end smallexample
 
 @findex -thread-list-ids
@@ -34624,11 +34624,11 @@ GDB/MI Thread Commands
 @subsubheading Example
 
 @smallexample
-(gdb)
+(@value{GDBP})
 -thread-list-ids
 ^done,thread-ids=@{thread-id="3",thread-id="2",thread-id="1"@},
 current-thread-id="1",number-of-threads="3"
-(gdb)
+(@value{GDBP})
 @end smallexample
 
 
@@ -34655,24 +34655,24 @@ GDB/MI Thread Commands
 @subsubheading Example
 
 @smallexample
-(gdb)
+(@value{GDBP})
 -exec-next
 ^running
-(gdb)
+(@value{GDBP})
 *stopped,reason="end-stepping-range",thread-id="2",line="187",
 file="../../../devo/gdb/testsuite/gdb.threads/linux-dp.c"
-(gdb)
+(@value{GDBP})
 -thread-list-ids
 ^done,
 thread-ids=@{thread-id="3",thread-id="2",thread-id="1"@},
 number-of-threads="3"
-(gdb)
+(@value{GDBP})
 -thread-select 3
 ^done,new-thread-id="3",
 frame=@{level="0",func="vprintf",
 args=[@{name="format",value="0x8048e9c \"%*s%c %d %c\\n\""@},
 @{name="arg",value="0x2"@}],file="vprintf.c",line="31",arch="i386:x86_64"@}
-(gdb)
+(@value{GDBP})
 @end smallexample
 
 @c %%%%%%%%%%%%%%%%%%%%%%%%%%%% SECTION %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
@@ -34750,7 +34750,7 @@ GDB/MI Ada Tasking Commands
 @{width="1",alignment="2",col_name="name",colhdr="Name"@}],
 body=[@{current="*",id="1",task-id="   644010",thread-id="1",priority="48",
 state="Child Termination Wait",name="main_task"@}]@}
-(gdb)
+(@value{GDBP})
 @end smallexample
 
 @c %%%%%%%%%%%%%%%%%%%%%%%%%%%% SECTION %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
@@ -34801,12 +34801,12 @@ GDB/MI Program Execution
 @smallexample
 -exec-continue
 ^running
-(gdb)
+(@value{GDBP})
 @@Hello world
 *stopped,reason="breakpoint-hit",disp="keep",bkptno="2",frame=@{
 func="foo",args=[],file="hello.c",fullname="/home/foo/bar/hello.c",
 line="13",arch="i386:x86_64"@}
-(gdb)
+(@value{GDBP})
 @end smallexample
 
 For a @samp{breakpoint-hit} stopped reason, when the breakpoint
@@ -34816,12 +34816,12 @@ GDB/MI Program Execution
 @smallexample
 -exec-continue
 ^running
-(gdb)
+(@value{GDBP})
 @@Hello world
 *stopped,reason="breakpoint-hit",disp="keep",bkptno="2",locno="3",frame=@{
 func="foo",args=[],file="hello.c",fullname="/home/foo/bar/hello.c",
 line="13",arch="i386:x86_64"@}
-(gdb)
+(@value{GDBP})
 @end smallexample
 
 @findex -exec-finish
@@ -34850,11 +34850,11 @@ GDB/MI Program Execution
 @smallexample
 -exec-finish
 ^running
-(gdb)
+(@value{GDBP})
 @@hello from foo
 *stopped,reason="function-finished",frame=@{func="main",args=[],
 file="hello.c",fullname="/home/foo/bar/hello.c",line="7",arch="i386:x86_64"@}
-(gdb)
+(@value{GDBP})
 @end smallexample
 
 Function returning other than @code{void}.  The name of the internal
@@ -34864,13 +34864,13 @@ GDB/MI Program Execution
 @smallexample
 -exec-finish
 ^running
-(gdb)
+(@value{GDBP})
 *stopped,reason="function-finished",frame=@{addr="0x000107b0",func="foo",
 args=[@{name="a",value="1"],@{name="b",value="9"@}@},
 file="recursive2.c",fullname="/home/foo/bar/recursive2.c",line="14",
 arch="i386:x86_64"@},
 gdb-result-var="$1",return-value="0"
-(gdb)
+(@value{GDBP})
 @end smallexample
 
 
@@ -34906,23 +34906,23 @@ GDB/MI Program Execution
 @subsubheading Example
 
 @smallexample
-(gdb)
+(@value{GDBP})
 111-exec-continue
 111^running
 
-(gdb)
+(@value{GDBP})
 222-exec-interrupt
 222^done
-(gdb)
+(@value{GDBP})
 111*stopped,signal-name="SIGINT",signal-meaning="Interrupt",
 frame=@{addr="0x00010140",func="foo",args=[],file="try.c",
 fullname="/home/foo/bar/try.c",line="13",arch="i386:x86_64"@}
-(gdb)
+(@value{GDBP})
 
-(gdb)
+(@value{GDBP})
 -exec-interrupt
 ^error,msg="mi_cmd_exec_interrupt: Inferior not executing."
-(gdb)
+(@value{GDBP})
 @end smallexample
 
 @findex -exec-jump
@@ -34979,9 +34979,9 @@ GDB/MI Program Execution
 @smallexample
 -exec-next
 ^running
-(gdb)
+(@value{GDBP})
 *stopped,reason="end-stepping-range",line="8",file="hello.c"
-(gdb)
+(@value{GDBP})
 @end smallexample
 
 
@@ -35012,14 +35012,14 @@ GDB/MI Program Execution
 @subsubheading Example
 
 @smallexample
-(gdb)
+(@value{GDBP})
 -exec-next-instruction
 ^running
 
-(gdb)
+(@value{GDBP})
 *stopped,reason="end-stepping-range",
 addr="0x000100d4",line="5",file="hello.c"
-(gdb)
+(@value{GDBP})
 @end smallexample
 
 
@@ -35042,23 +35042,23 @@ GDB/MI Program Execution
 @subsubheading Example
 
 @smallexample
-(gdb)
+(@value{GDBP})
 200-break-insert callee4
 200^done,bkpt=@{number="1",addr="0x00010734",
 file="../../../devo/gdb/testsuite/gdb.mi/basics.c",line="8"@}
-(gdb)
+(@value{GDBP})
 000-exec-run
 000^running
-(gdb)
+(@value{GDBP})
 000*stopped,reason="breakpoint-hit",disp="keep",bkptno="1",
 frame=@{func="callee4",args=[],
 file="../../../devo/gdb/testsuite/gdb.mi/basics.c",
 fullname="/home/foo/bar/devo/gdb/testsuite/gdb.mi/basics.c",line="8",
 arch="i386:x86_64"@}
-(gdb)
+(@value{GDBP})
 205-break-delete
 205^done
-(gdb)
+(@value{GDBP})
 111-exec-return
 111^done,frame=@{level="0",func="callee3",
 args=[@{name="strarg",
@@ -35066,7 +35066,7 @@ GDB/MI Program Execution
 file="../../../devo/gdb/testsuite/gdb.mi/basics.c",
 fullname="/home/foo/bar/devo/gdb/testsuite/gdb.mi/basics.c",line="18",
 arch="i386:x86_64"@}
-(gdb)
+(@value{GDBP})
 @end smallexample
 
 
@@ -35102,50 +35102,50 @@ GDB/MI Program Execution
 @subsubheading Examples
 
 @smallexample
-(gdb)
+(@value{GDBP})
 -break-insert main
 ^done,bkpt=@{number="1",addr="0x0001072c",file="recursive2.c",line="4"@}
-(gdb)
+(@value{GDBP})
 -exec-run
 ^running
-(gdb)
+(@value{GDBP})
 *stopped,reason="breakpoint-hit",disp="keep",bkptno="1",
 frame=@{func="main",args=[],file="recursive2.c",
 fullname="/home/foo/bar/recursive2.c",line="4",arch="i386:x86_64"@}
-(gdb)
+(@value{GDBP})
 @end smallexample
 
 @noindent
 Program exited normally:
 
 @smallexample
-(gdb)
+(@value{GDBP})
 -exec-run
 ^running
-(gdb)
+(@value{GDBP})
 x = 55
 *stopped,reason="exited-normally"
-(gdb)
+(@value{GDBP})
 @end smallexample
 
 @noindent
 Program exited exceptionally:
 
 @smallexample
-(gdb)
+(@value{GDBP})
 -exec-run
 ^running
-(gdb)
+(@value{GDBP})
 x = 55
 *stopped,reason="exited",exit-code="01"
-(gdb)
+(@value{GDBP})
 @end smallexample
 
 Another way the program can terminate is if it receives a signal such as
 @code{SIGINT}.  In this case, @sc{gdb/mi} displays this:
 
 @smallexample
-(gdb)
+(@value{GDBP})
 *stopped,reason="exited-signalled",signal-name="SIGINT",
 signal-meaning="Interrupt"
 @end smallexample
@@ -35181,12 +35181,12 @@ GDB/MI Program Execution
 @smallexample
 -exec-step
 ^running
-(gdb)
+(@value{GDBP})
 *stopped,reason="end-stepping-range",
 frame=@{func="foo",args=[@{name="a",value="10"@},
 @{name="b",value="0"@}],file="recursive2.c",
 fullname="/home/foo/bar/recursive2.c",line="11",arch="i386:x86_64"@}
-(gdb)
+(@value{GDBP})
 @end smallexample
 
 Regular stepping:
@@ -35194,9 +35194,9 @@ GDB/MI Program Execution
 @smallexample
 -exec-step
 ^running
-(gdb)
+(@value{GDBP})
 *stopped,reason="end-stepping-range",line="14",file="recursive2.c"
-(gdb)
+(@value{GDBP})
 @end smallexample
 
 
@@ -35224,23 +35224,23 @@ GDB/MI Program Execution
 @subsubheading Example
 
 @smallexample
-(gdb)
+(@value{GDBP})
 -exec-step-instruction
 ^running
 
-(gdb)
+(@value{GDBP})
 *stopped,reason="end-stepping-range",
 frame=@{func="foo",args=[],file="try.c",
 fullname="/home/foo/bar/try.c",line="10",arch="i386:x86_64"@}
-(gdb)
+(@value{GDBP})
 -exec-step-instruction
 ^running
 
-(gdb)
+(@value{GDBP})
 *stopped,reason="end-stepping-range",
 frame=@{addr="0x000100f4",func="foo",args=[],file="try.c",
 fullname="/home/foo/bar/try.c",line="10",arch="i386:x86_64"@}
-(gdb)
+(@value{GDBP})
 @end smallexample
 
 
@@ -35265,15 +35265,15 @@ GDB/MI Program Execution
 @subsubheading Example
 
 @smallexample
-(gdb)
+(@value{GDBP})
 -exec-until recursive2.c:6
 ^running
-(gdb)
+(@value{GDBP})
 x = 55
 *stopped,reason="location-reached",frame=@{func="main",args=[],
 file="recursive2.c",fullname="/home/foo/bar/recursive2.c",line="6",
 arch="i386:x86_64"@}
-(gdb)
+(@value{GDBP})
 @end smallexample
 
 @ignore
@@ -35321,13 +35321,13 @@ GDB/MI Stack Manipulation
 @subsubheading Example
 
 @smallexample
-(gdb)
+(@value{GDBP})
 -stack-info-frame
 ^done,frame=@{level="1",addr="0x0001076c",func="callee3",
 file="../../../devo/gdb/testsuite/gdb.mi/basics.c",
 fullname="/home/foo/bar/devo/gdb/testsuite/gdb.mi/basics.c",line="17",
 arch="i386:x86_64"@}
-(gdb)
+(@value{GDBP})
 @end smallexample
 
 @findex -stack-info-depth
@@ -35351,22 +35351,22 @@ GDB/MI Stack Manipulation
 For a stack with frame levels 0 through 11:
 
 @smallexample
-(gdb)
+(@value{GDBP})
 -stack-info-depth
 ^done,depth="12"
-(gdb)
+(@value{GDBP})
 -stack-info-depth 4
 ^done,depth="4"
-(gdb)
+(@value{GDBP})
 -stack-info-depth 12
 ^done,depth="12"
-(gdb)
+(@value{GDBP})
 -stack-info-depth 11
 ^done,depth="11"
-(gdb)
+(@value{GDBP})
 -stack-info-depth 13
 ^done,depth="12"
-(gdb)
+(@value{GDBP})
 @end smallexample
 
 @anchor{-stack-list-arguments}
@@ -35412,7 +35412,7 @@ GDB/MI Stack Manipulation
 @subsubheading Example
 
 @smallexample
-(gdb)
+(@value{GDBP})
 -stack-list-frames
 ^done,
 stack=[
@@ -35436,7 +35436,7 @@ GDB/MI Stack Manipulation
 file="../../../devo/gdb/testsuite/gdb.mi/basics.c",
 fullname="/home/foo/bar/devo/gdb/testsuite/gdb.mi/basics.c",line="32",
 arch="i386:x86_64"@}]
-(gdb)
+(@value{GDBP})
 -stack-list-arguments 0
 ^done,
 stack-args=[
@@ -35445,7 +35445,7 @@ GDB/MI Stack Manipulation
 frame=@{level="2",args=[name="intarg",name="strarg"]@},
 frame=@{level="3",args=[name="intarg",name="strarg",name="fltarg"]@},
 frame=@{level="4",args=[]@}]
-(gdb)
+(@value{GDBP})
 -stack-list-arguments 1
 ^done,
 stack-args=[
@@ -35460,15 +35460,15 @@ GDB/MI Stack Manipulation
 @{name="strarg",value="0x11940 \"A string argument.\""@},
 @{name="fltarg",value="3.5"@}]@},
 frame=@{level="4",args=[]@}]
-(gdb)
+(@value{GDBP})
 -stack-list-arguments 0 2 2
 ^done,stack-args=[frame=@{level="2",args=[name="intarg",name="strarg"]@}]
-(gdb)
+(@value{GDBP})
 -stack-list-arguments 1 2 2
 ^done,stack-args=[frame=@{level="2",
 args=[@{name="intarg",value="2"@},
 @{name="strarg",value="0x11940 \"A string argument.\""@}]@}]
-(gdb)
+(@value{GDBP})
 @end smallexample
 
 @c @subheading -stack-list-exception-handlers
@@ -35526,7 +35526,7 @@ GDB/MI Stack Manipulation
 Full stack backtrace:
 
 @smallexample
-(gdb)
+(@value{GDBP})
 -stack-list-frames
 ^done,stack=
 [frame=@{level="0",addr="0x0001076c",func="foo",
@@ -35565,13 +35565,13 @@ GDB/MI Stack Manipulation
 frame=@{level="11",addr="0x00010738",func="main",
   file="recursive2.c",fullname="/home/foo/bar/recursive2.c",line="4",
   arch="i386:x86_64"@}]
-(gdb)
+(@value{GDBP})
 @end smallexample
 
 Show frames between @var{low_frame} and @var{high_frame}:
 
 @smallexample
-(gdb)
+(@value{GDBP})
 -stack-list-frames 3 5
 ^done,stack=
 [frame=@{level="3",addr="0x000107a4",func="foo",
@@ -35583,19 +35583,19 @@ GDB/MI Stack Manipulation
 frame=@{level="5",addr="0x000107a4",func="foo",
   file="recursive2.c",fullname="/home/foo/bar/recursive2.c",line="14",
   arch="i386:x86_64"@}]
-(gdb)
+(@value{GDBP})
 @end smallexample
 
 Show a single frame:
 
 @smallexample
-(gdb)
+(@value{GDBP})
 -stack-list-frames 3 3
 ^done,stack=
 [frame=@{level="3",addr="0x000107a4",func="foo",
   file="recursive2.c",fullname="/home/foo/bar/recursive2.c",line="14",
   arch="i386:x86_64"@}]
-(gdb)
+(@value{GDBP})
 @end smallexample
 
 
@@ -35634,17 +35634,17 @@ GDB/MI Stack Manipulation
 @subsubheading Example
 
 @smallexample
-(gdb)
+(@value{GDBP})
 -stack-list-locals 0
 ^done,locals=[name="A",name="B",name="C"]
-(gdb)
+(@value{GDBP})
 -stack-list-locals --all-values
 ^done,locals=[@{name="A",value="1"@},@{name="B",value="2"@},
   @{name="C",value="@{1, 2, 3@}"@}]
 -stack-list-locals --simple-values
 ^done,locals=[@{name="A",type="int",value="1"@},
   @{name="B",type="int",value="2"@},@{name="C",type="int [3]"@}]
-(gdb)
+(@value{GDBP})
 @end smallexample
 
 @anchor{-stack-list-variables}
@@ -35679,7 +35679,7 @@ GDB/MI Stack Manipulation
 6: @}
 @end group
 @group
-(gdb) -stack-list-variables 2
+(@value{GDBP}) -stack-list-variables 2
 ^done,variables=[@{name="x",type="int",value="4",
 filename="name.c",fullname="/home/src/name.c",line="3"@},
 @{name="y",type="int",value="5"@},@{name="x",type="int",
@@ -35694,10 +35694,10 @@ GDB/MI Stack Manipulation
 @subsubheading Example
 
 @smallexample
-(gdb)
+(@value{GDBP})
 -stack-list-variables --thread 1 --frame 0 --all-values
 ^done,variables=[@{name="x",value="11"@},@{name="s",value="@{a = 1, b = 2@}"@}]
-(gdb)
+(@value{GDBP})
 @end smallexample
 
 
@@ -35724,10 +35724,10 @@ GDB/MI Stack Manipulation
 @subsubheading Example
 
 @smallexample
-(gdb)
+(@value{GDBP})
 -stack-select-frame 2
 ^done
-(gdb)
+(@value{GDBP})
 @end smallexample
 
 @c %%%%%%%%%%%%%%%%%%%%%%%%%%%% SECTION %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
@@ -36206,11 +36206,11 @@ GDB/MI Variable Objects
 @subsubheading Example
 
 @smallexample
-(gdb)
+(@value{GDBP})
  -var-list-children n
  ^done,numchild=@var{n},children=[child=@{name=@var{name},exp=@var{exp},
  numchild=@var{n},type=@var{type}@},@r{(repeats N times)}]
-(gdb)
+(@value{GDBP})
  -var-list-children --all-values n
  ^done,numchild=@var{n},children=[child=@{name=@var{name},exp=@var{exp},
  numchild=@var{n},value=@var{value},type=@var{type}@},@r{(repeats N times)}]
@@ -36252,7 +36252,7 @@ GDB/MI Variable Objects
 @code{A} was created for @code{a}, then we'll get this output:
 
 @smallexample
-(gdb) -var-info-expression A.1
+(@value{GDBP}) -var-info-expression A.1
 ^done,lang="C",exp="1"
 @end smallexample
 
@@ -36289,7 +36289,7 @@ GDB/MI Variable Objects
 @code{C} and a variable object @code{C} was created for variable
 @code{c}.  Then, we'll get this output:
 @smallexample
-(gdb) -var-info-path-expression C.Base.public.m_size
+(@value{GDBP}) -var-info-path-expression C.Base.public.m_size
 ^done,path_expr=((Base)c).m_size)
 @end smallexample
 
@@ -36352,13 +36352,13 @@ GDB/MI Variable Objects
 @subsubheading Example
 
 @smallexample
-(gdb)
+(@value{GDBP})
 -var-assign var1 3
 ^done,value="3"
-(gdb)
+(@value{GDBP})
 -var-update *
 ^done,changelist=[@{name="var1",in_scope="true",type_changed="false"@}]
-(gdb)
+(@value{GDBP})
 @end smallexample
 
 @findex -var-update
@@ -36479,14 +36479,14 @@ GDB/MI Variable Objects
 @subsubheading Example
 
 @smallexample
-(gdb)
+(@value{GDBP})
 -var-assign var1 3
 ^done,value="3"
-(gdb)
+(@value{GDBP})
 -var-update --all-values var1
 ^done,changelist=[@{name="var1",value="3",in_scope="true",
 type_changed="false"@}]
-(gdb)
+(@value{GDBP})
 @end smallexample
 
 @findex -var-set-frozen
@@ -36514,10 +36514,10 @@ GDB/MI Variable Objects
 @subsubheading Example
 
 @smallexample
-(gdb)
+(@value{GDBP})
 -var-set-frozen V 1
 ^done
-(gdb)
+(@value{GDBP})
 @end smallexample
 
 @findex -var-set-update-range
@@ -36541,7 +36541,7 @@ GDB/MI Variable Objects
 @subsubheading Example
 
 @smallexample
-(gdb)
+(@value{GDBP})
 -var-set-update-range V 1 2
 ^done
 @end smallexample
@@ -36583,7 +36583,7 @@ GDB/MI Variable Objects
 Resetting the visualizer:
 
 @smallexample
-(gdb)
+(@value{GDBP})
 -var-set-visualizer V None
 ^done
 @end smallexample
@@ -36591,7 +36591,7 @@ GDB/MI Variable Objects
 Reselecting the default (type-based) visualizer:
 
 @smallexample
-(gdb)
+(@value{GDBP})
 -var-set-visualizer V gdb.default_visualizer
 ^done
 @end smallexample
@@ -36600,7 +36600,7 @@ GDB/MI Variable Objects
 can be used to instantiate this class for a varobj:
 
 @smallexample
-(gdb)
+(@value{GDBP})
 -var-set-visualizer V "lambda val: SomeClass()"
 ^done
 @end smallexample
@@ -36809,7 +36809,7 @@ GDB/MI Data Manipulation
 Disassemble from the current value of @code{$pc} to @code{$pc + 20}:
 
 @smallexample
-(gdb)
+(@value{GDBP})
 -data-disassemble -s $pc -e "$pc + 20" -- 0
 ^done,
 asm_insns=[
@@ -36823,7 +36823,7 @@ GDB/MI Data Manipulation
 inst="sethi  %hi(0x11800), %o2"@},
 @{address="0x000107d0",func-name="main",offset="20",
 inst="or  %o2, 0x168, %o4\t! 0x11968 <_lib_version+48>"@}]
-(gdb)
+(@value{GDBP})
 @end smallexample
 
 Disassemble the whole @code{main} function.  Line 32 is part of
@@ -36841,13 +36841,13 @@ GDB/MI Data Manipulation
 [@dots{}]
 @{address="0x0001081c",func-name="main",offset="96",inst="ret "@},
 @{address="0x00010820",func-name="main",offset="100",inst="restore "@}]
-(gdb)
+(@value{GDBP})
 @end smallexample
 
 Disassemble 3 instructions from the start of @code{main}:
 
 @smallexample
-(gdb)
+(@value{GDBP})
 -data-disassemble -f basics.c -l 32 -n 3 -- 0
 ^done,asm_insns=[
 @{address="0x000107bc",func-name="main",offset="0",
@@ -36856,13 +36856,13 @@ GDB/MI Data Manipulation
 inst="mov  2, %o0"@},
 @{address="0x000107c4",func-name="main",offset="8",
 inst="sethi  %hi(0x11800), %o2"@}]
-(gdb)
+(@value{GDBP})
 @end smallexample
 
 Disassemble 3 instructions from the start of @code{main} in mixed mode:
 
 @smallexample
-(gdb)
+(@value{GDBP})
 -data-disassemble -f basics.c -l 32 -n 3 -- 1
 ^done,asm_insns=[
 src_and_asm_line=@{line="31",
@@ -36877,7 +36877,7 @@ GDB/MI Data Manipulation
 func-name="main",offset="4",inst="mov  2, %o0"@},
 @{address="0x000107c4",func-name="main",offset="8",
 inst="sethi  %hi(0x11800), %o2"@}]@}]
-(gdb)
+(@value{GDBP})
 @end smallexample
 
 
@@ -36910,16 +36910,16 @@ GDB/MI Data Manipulation
 @smallexample
 211-data-evaluate-expression A
 211^done,value="1"
-(gdb)
+(@value{GDBP})
 311-data-evaluate-expression &A
 311^done,value="0xefffeb7c"
-(gdb)
+(@value{GDBP})
 411-data-evaluate-expression A+3
 411^done,value="4"
-(gdb)
+(@value{GDBP})
 511-data-evaluate-expression "A + 3"
 511^done,value="4"
-(gdb)
+(@value{GDBP})
 @end smallexample
 
 
@@ -36944,20 +36944,20 @@ GDB/MI Data Manipulation
 On a PPC MBX board:
 
 @smallexample
-(gdb)
+(@value{GDBP})
 -exec-continue
 ^running
 
-(gdb)
+(@value{GDBP})
 *stopped,reason="breakpoint-hit",disp="keep",bkptno="1",frame=@{
 func="main",args=[],file="try.c",fullname="/home/foo/bar/try.c",
 line="5",arch="powerpc"@}
-(gdb)
+(@value{GDBP})
 -data-list-changed-registers
 ^done,changed-registers=["0","1","2","4","5","6","7","8","9",
 "10","11","13","14","15","16","17","18","19","20","21","22","23",
 "24","25","26","27","28","30","31","64","65","66","67","69"]
-(gdb)
+(@value{GDBP})
 @end smallexample
 
 
@@ -36987,7 +36987,7 @@ GDB/MI Data Manipulation
 
 For the PPC MBX board:
 @smallexample
-(gdb)
+(@value{GDBP})
 -data-list-register-names
 ^done,register-names=["r0","r1","r2","r3","r4","r5","r6","r7",
 "r8","r9","r10","r11","r12","r13","r14","r15","r16","r17","r18",
@@ -36996,10 +36996,10 @@ GDB/MI Data Manipulation
 "f10","f11","f12","f13","f14","f15","f16","f17","f18","f19","f20",
 "f21","f22","f23","f24","f25","f26","f27","f28","f29","f30","f31",
 "", "pc","ps","cr","lr","ctr","xer"]
-(gdb)
+(@value{GDBP})
 -data-list-register-names 1 2 3
 ^done,register-names=["r1","r2","r3"]
-(gdb)
+(@value{GDBP})
 @end smallexample
 
 @findex -data-list-register-values
@@ -37047,11 +37047,11 @@ GDB/MI Data Manipulation
 don't appear in the actual output):
 
 @smallexample
-(gdb)
+(@value{GDBP})
 -data-list-register-values r 64 65
 ^done,register-values=[@{number="64",value="0xfe00a300"@},
 @{number="65",value="0x00029002"@}]
-(gdb)
+(@value{GDBP})
 -data-list-register-values x
 ^done,register-values=[@{number="0",value="0xfe0043c8"@},
 @{number="1",value="0x3fff88"@},@{number="2",value="0xfffffffe"@},
@@ -37089,7 +37089,7 @@ GDB/MI Data Manipulation
 @{number="65",value="0x29002"@},@{number="66",value="0x202f04b5"@},
 @{number="67",value="0xfe0043b0"@},@{number="68",value="0xfe00b3e4"@},
 @{number="69",value="0x20002b03"@}]
-(gdb)
+(@value{GDBP})
 @end smallexample
 
 
@@ -37164,7 +37164,7 @@ GDB/MI Data Manipulation
 word.  Display each word in hex.
 
 @smallexample
-(gdb)
+(@value{GDBP})
 9-data-read-memory -o -6 -- bytes+6 x 1 3 2
 9^done,addr="0x00001390",nr-bytes="6",total-bytes="6",
 next-row="0x00001396",prev-row="0x0000138e",next-page="0x00001396",
@@ -37172,20 +37172,20 @@ GDB/MI Data Manipulation
 @{addr="0x00001390",data=["0x00","0x01"]@},
 @{addr="0x00001392",data=["0x02","0x03"]@},
 @{addr="0x00001394",data=["0x04","0x05"]@}]
-(gdb)
+(@value{GDBP})
 @end smallexample
 
 Read two bytes of memory starting at address @code{shorts + 64} and
 display as a single word formatted in decimal.
 
 @smallexample
-(gdb)
+(@value{GDBP})
 5-data-read-memory shorts+64 d 2 1 1
 5^done,addr="0x00001510",nr-bytes="2",total-bytes="2",
 next-row="0x00001512",prev-row="0x0000150e",
 next-page="0x00001512",prev-page="0x0000150e",memory=[
 @{addr="0x00001510",data=["128"]@}]
-(gdb)
+(@value{GDBP})
 @end smallexample
 
 Read thirty two bytes of memory starting at @code{bytes+16} and format
@@ -37193,7 +37193,7 @@ GDB/MI Data Manipulation
 used as the non-printable character.
 
 @smallexample
-(gdb)
+(@value{GDBP})
 4-data-read-memory bytes+16 x 1 8 4 x
 4^done,addr="0x000013a0",nr-bytes="32",total-bytes="32",
 next-row="0x000013c0",prev-row="0x0000139c",
@@ -37206,7 +37206,7 @@ GDB/MI Data Manipulation
 @{addr="0x000013b4",data=["0x24","0x25","0x26","0x27"],ascii="$%&'"@},
 @{addr="0x000013b8",data=["0x28","0x29","0x2a","0x2b"],ascii="()*+"@},
 @{addr="0x000013bc",data=["0x2c","0x2d","0x2e","0x2f"],ascii=",-./"@}]
-(gdb)
+(@value{GDBP})
 @end smallexample
 
 @findex -data-read-memory-bytes
@@ -37286,12 +37286,12 @@ GDB/MI Data Manipulation
 @subsubheading Example
 
 @smallexample
-(gdb)
+(@value{GDBP})
 -data-read-memory-bytes &a 10
 ^done,memory=[@{begin="0xbffff154",offset="0x00000000",
               end="0xbffff15e",
               contents="01000000020000000300"@}]
-(gdb)
+(@value{GDBP})
 @end smallexample
 
 
@@ -37333,17 +37333,17 @@ GDB/MI Data Manipulation
 @subsubheading Example
 
 @smallexample
-(gdb)
+(@value{GDBP})
 -data-write-memory-bytes &a "aabbccdd"
 ^done
-(gdb)
+(@value{GDBP})
 @end smallexample
 
 @smallexample
-(gdb)
+(@value{GDBP})
 -data-write-memory-bytes &a "aabbccdd" 16e
 ^done
-(gdb)
+(@value{GDBP})
 @end smallexample
 
 @c %%%%%%%%%%%%%%%%%%%%%%%%%%%% SECTION %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
@@ -37486,7 +37486,7 @@ GDB/MI Tracepoint Commands
 An example output would be:
 
 @smallexample
-(gdb)
+(@value{GDBP})
 -trace-frame-collected
 ^done,
   explicit-variables=[@{name="myVar",value="1"@}],
@@ -37503,7 +37503,7 @@ GDB/MI Tracepoint Commands
   tvars=[@{name="$tvar1",current="43970026"@}],
   memory=[@{address="0x0000000000602264",length="4"@},
           @{address="0x0000000000615bc0",length="4"@}]
-(gdb)
+(@value{GDBP})
 @end smallexample
 
 Where:
@@ -37598,7 +37598,7 @@ GDB/MI Tracepoint Commands
 @subsubheading Example
 
 @smallexample
-(gdb)
+(@value{GDBP})
 -trace-list-variables
 ^done,trace-variables=@{nr_rows="1",nr_cols="3",
 hdr=[@{width="15",alignment="-1",col_name="name",colhdr="Name"@},
@@ -37606,7 +37606,7 @@ GDB/MI Tracepoint Commands
      @{width="11",alignment="-1",col_name="current",colhdr="Current"@}],
 body=[variable=@{name="$trace_timestamp",initial="0"@}
       variable=@{name="$foo",initial="10",current="15"@}]@}
-(gdb)
+(@value{GDBP})
 @end smallexample
 
 @findex -trace-save
@@ -37820,7 +37820,7 @@ GDB/MI Symbol Query
 @subsubheading Example
 @smallexample
 @group
-(gdb)
+(@value{GDBP})
 -symbol-info-functions
 ^done,symbols=
   @{debug=
@@ -37842,7 +37842,7 @@ GDB/MI Symbol Query
                 description="static another_float_t f1(int);"@}]@}]@}
 @end group
 @group
-(gdb)
+(@value{GDBP})
 -symbol-info-functions --name f1
 ^done,symbols=
   @{debug=
@@ -37856,7 +37856,7 @@ GDB/MI Symbol Query
                 description="static another_float_t f1(int);"@}]@}]@}
 @end group
 @group
-(gdb)
+(@value{GDBP})
 -symbol-info-functions --type void
 ^done,symbols=
   @{debug=
@@ -37866,7 +37866,7 @@ GDB/MI Symbol Query
                 description="void f4(int *);"@}]@}]@}
 @end group
 @group
-(gdb)
+(@value{GDBP})
 -symbol-info-functions --include-nondebug
 ^done,symbols=
   @{debug=
@@ -37925,7 +37925,7 @@ GDB/MI Symbol Query
 
 @smallexample
 @group
-(gdb)
+(@value{GDBP})
 -symbol-info-module-functions
 ^done,symbols=
   [@{module="mod1",
@@ -37991,7 +37991,7 @@ GDB/MI Symbol Query
 
 @smallexample
 @group
-(gdb)
+(@value{GDBP})
 -symbol-info-module-variables
 ^done,symbols=
   [@{module="mod1",
@@ -38068,7 +38068,7 @@ GDB/MI Symbol Query
 @subsubheading Example
 @smallexample
 @group
-(gdb)
+(@value{GDBP})
 -symbol-info-modules
 ^done,symbols=
   @{debug=
@@ -38083,7 +38083,7 @@ GDB/MI Symbol Query
                @{line="26",name="moduse"@}]@}]@}
 @end group
 @group
-(gdb)
+(@value{GDBP})
 -symbol-info-modules --name mod[123]
 ^done,symbols=
   @{debug=
@@ -38132,7 +38132,7 @@ GDB/MI Symbol Query
 @subsubheading Example
 @smallexample
 @group
-(gdb)
+(@value{GDBP})
 -symbol-info-types
 ^done,symbols=
   @{debug=
@@ -38149,7 +38149,7 @@ GDB/MI Symbol Query
                 @{name="int"@}]@}]@}
 @end group
 @group
-(gdb)
+(@value{GDBP})
 -symbol-info-types --name _int_
 ^done,symbols=
   @{debug=
@@ -38201,7 +38201,7 @@ GDB/MI Symbol Query
 @subsubheading Example
 @smallexample
 @group
-(gdb)
+(@value{GDBP})
 -symbol-info-variables
 ^done,symbols=
   @{debug=
@@ -38223,7 +38223,7 @@ GDB/MI Symbol Query
                 description="static int global_i1;"@}]@}]@}
 @end group
 @group
-(gdb)
+(@value{GDBP})
 -symbol-info-variables --name f1
 ^done,symbols=
   @{debug=
@@ -38237,7 +38237,7 @@ GDB/MI Symbol Query
                 description="static float global_f1;"@}]@}]@}
 @end group
 @group
-(gdb)
+(@value{GDBP})
 -symbol-info-variables --type float
 ^done,symbols=
   @{debug=
@@ -38251,7 +38251,7 @@ GDB/MI Symbol Query
                 description="static float global_f1;"@}]@}]@}
 @end group
 @group
-(gdb)
+(@value{GDBP})
 -symbol-info-variables --include-nondebug
 ^done,symbols=
   @{debug=
@@ -38359,10 +38359,10 @@ GDB/MI Symbol Query
 
 @subsubheading Example
 @smallexample
-(gdb)
+(@value{GDBP})
 -symbol-list-lines basics.c
 ^done,lines=[@{pc="0x08048554",line="7"@},@{pc="0x0804855a",line="8"@}]
-(gdb)
+(@value{GDBP})
 @end smallexample
 
 
@@ -38475,10 +38475,10 @@ GDB/MI File Commands
 
 @c codespell:ignore-begin
 @smallexample
-(gdb)
+(@value{GDBP})
 -file-exec-and-symbols /kwikemart/marge/ezannoni/TRUNK/mbx/hello.mbx
 ^done
-(gdb)
+(@value{GDBP})
 @end smallexample
 @c codespell:ignore-end
 
@@ -38506,10 +38506,10 @@ GDB/MI File Commands
 
 @c codespell:ignore-begin
 @smallexample
-(gdb)
+(@value{GDBP})
 -file-exec-file /kwikemart/marge/ezannoni/TRUNK/mbx/hello.mbx
 ^done
-(gdb)
+(@value{GDBP})
 @end smallexample
 @c codespell:ignore-end
 
@@ -38558,10 +38558,10 @@ GDB/MI File Commands
 @subsubheading Example
 
 @smallexample
-(gdb)
+(@value{GDBP})
 123-file-list-exec-source-file
 123^done,line="1",file="foo.c",fullname="/home/bar/foo.c,macro-info="1"
-(gdb)
+(@value{GDBP})
 @end smallexample
 
 
@@ -38734,12 +38734,12 @@ GDB/MI File Commands
 
 @subsubheading Example
 @smallexample
-(gdb)
+(@value{GDBP})
 -file-list-exec-source-files
 ^done,shared-libraries=[
 @{id="/lib/libfoo.so",target-name="/lib/libfoo.so",host-name="/lib/libfoo.so",symbols-loaded="1",thread-group="i1",ranges=[@{from="0x72815989",to="0x728162c0"@}]@},
 @{id="/lib/libbar.so",target-name="/lib/libbar.so",host-name="/lib/libbar.so",symbols-loaded="1",thread-group="i1",ranges=[@{from="0x76ee48c0",to="0x76ee9160"@}]@}]
-(gdb)
+(@value{GDBP})
 @end smallexample
 
 
@@ -38785,10 +38785,10 @@ GDB/MI File Commands
 
 @c codespell:ignore-begin
 @smallexample
-(gdb)
+(@value{GDBP})
 -file-symbol-file /kwikemart/marge/ezannoni/TRUNK/mbx/hello.mbx
 ^done
-(gdb)
+(@value{GDBP})
 @end smallexample
 @c codespell:ignore-end
 
@@ -38852,12 +38852,12 @@ GDB/MI Target Manipulation
 
 @subsubheading Example
 @smallexample
-(gdb)
+(@value{GDBP})
 -target-attach 34
 =thread-created,id="1"
 *stopped,thread-id="1",frame=@{addr="0xb7f7e410",func="bar",args=[]@}
 ^done
-(gdb)
+(@value{GDBP})
 @end smallexample
 
 @ignore
@@ -38902,10 +38902,10 @@ GDB/MI Target Manipulation
 @subsubheading Example
 
 @smallexample
-(gdb)
+(@value{GDBP})
 -target-detach
 ^done
-(gdb)
+(@value{GDBP})
 @end smallexample
 
 
@@ -38928,10 +38928,10 @@ GDB/MI Target Manipulation
 @subsubheading Example
 
 @smallexample
-(gdb)
+(@value{GDBP})
 -target-disconnect
 ^done
-(gdb)
+(@value{GDBP})
 @end smallexample
 
 
@@ -38989,7 +38989,7 @@ GDB/MI Target Manipulation
 have been broken down so that they can fit onto a page.
 
 @smallexample
-(gdb)
+(@value{GDBP})
 -target-download
 +download,@{section=".text",section-size="6668",total-size="9880"@}
 +download,@{section=".text",section-sent="512",section-size="6668",
@@ -39035,7 +39035,7 @@ GDB/MI Target Manipulation
 total-sent="9796",total-size="9880"@}
 ^done,address="0x10004",load-size="9880",transfer-rate="6586",
 write-rate="429"
-(gdb)
+(@value{GDBP})
 @end smallexample
 
 
@@ -39135,10 +39135,10 @@ GDB/MI Target Manipulation
 addresses and memory region sizes.
 
 @smallexample
-(gdb)
+(@value{GDBP})
 -target-flash-erase
 ^done,erased-regions=@{address="0x0",size="0x40000"@}
-(gdb)
+(@value{GDBP})
 @end smallexample
 
 @findex -target-select
@@ -39175,10 +39175,10 @@ GDB/MI Target Manipulation
 @subsubheading Example
 
 @smallexample
-(gdb)
+(@value{GDBP})
 -target-select remote /dev/ttya
 ^connected,addr="0xfe00a300",func="??",args=[]
-(gdb)
+(@value{GDBP})
 @end smallexample
 
 @c %%%%%%%%%%%%%%%%%%%%%%%%%%%% SECTION %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
@@ -39205,10 +39205,10 @@ GDB/MI File Transfer Commands
 @subsubheading Example
 
 @smallexample
-(gdb)
+(@value{GDBP})
 -target-file-put localfile remotefile
 ^done
-(gdb)
+(@value{GDBP})
 @end smallexample
 
 
@@ -39231,10 +39231,10 @@ GDB/MI File Transfer Commands
 @subsubheading Example
 
 @smallexample
-(gdb)
+(@value{GDBP})
 -target-file-get remotefile localfile
 ^done
-(gdb)
+(@value{GDBP})
 @end smallexample
 
 
@@ -39256,10 +39256,10 @@ GDB/MI File Transfer Commands
 @subsubheading Example
 
 @smallexample
-(gdb)
+(@value{GDBP})
 -target-file-delete remotefile
 ^done
-(gdb)
+(@value{GDBP})
 @end smallexample
 
 
@@ -39395,7 +39395,7 @@ GDB/MI Support Commands
 Example output:
 
 @smallexample
-(gdb) -list-features
+(@value{GDBP}) -list-features
 ^done,features=["feature1","feature2"]
 @end smallexample
 
@@ -39460,7 +39460,7 @@ GDB/MI Support Commands
 Example output:
 
 @smallexample
-(gdb) -list-target-features
+(@value{GDBP}) -list-target-features
 ^done,features=["async"]
 @end smallexample
 
@@ -39502,7 +39502,7 @@ GDB/MI Miscellaneous Commands
 @subsubheading Example
 
 @smallexample
-(gdb)
+(@value{GDBP})
 -gdb-exit
 ^exit
 @end smallexample
@@ -39548,10 +39548,10 @@ GDB/MI Miscellaneous Commands
 @subsubheading Example
 
 @smallexample
-(gdb)
+(@value{GDBP})
 -gdb-set $foo=3
 ^done
-(gdb)
+(@value{GDBP})
 @end smallexample
 
 
@@ -39573,10 +39573,10 @@ GDB/MI Miscellaneous Commands
 @subsubheading Example
 
 @smallexample
-(gdb)
+(@value{GDBP})
 -gdb-show annotate
 ^done,value="0"
-(gdb)
+(@value{GDBP})
 @end smallexample
 
 @c @subheading -gdb-source
@@ -39603,7 +39603,7 @@ GDB/MI Miscellaneous Commands
 @c This example modifies the actual output from GDB to avoid overfull
 @c box in TeX.
 @smallexample
-(gdb)
+(@value{GDBP})
 -gdb-version
 ~GNU gdb 5.2.1
 ~Copyright 2000 Free Software Foundation, Inc.
@@ -39616,7 +39616,7 @@ GDB/MI Miscellaneous Commands
 ~This GDB was configured as
  "--host=sparc-sun-solaris2.5.1 --target=ppc-eabi".
 ^done
-(gdb)
+(@value{GDBP})
 @end smallexample
 
 @findex -list-thread-groups
@@ -39926,13 +39926,13 @@ GDB/MI Miscellaneous Commands
 @subsubheading Example
 
 @smallexample
-(gdb)
+(@value{GDBP})
 -interpreter-exec console "break main"
 &"During symbol reading, couldn't parse type; debugger out of date?.\n"
 &"During symbol reading, bad structure-type format.\n"
 ~"Breakpoint 1 at 0x8074fc6: file ../../src/gdb/main.c, line 743.\n"
 ^done
-(gdb)
+(@value{GDBP})
 @end smallexample
 
 @findex -inferior-tty-set
@@ -39953,10 +39953,10 @@ GDB/MI Miscellaneous Commands
 @subsubheading Example
 
 @smallexample
-(gdb)
+(@value{GDBP})
 -inferior-tty-set /dev/pts/1
 ^done
-(gdb)
+(@value{GDBP})
 @end smallexample
 
 @findex -inferior-tty-show
@@ -39977,13 +39977,13 @@ GDB/MI Miscellaneous Commands
 @subsubheading Example
 
 @smallexample
-(gdb)
+(@value{GDBP})
 -inferior-tty-set /dev/pts/1
 ^done
-(gdb)
+(@value{GDBP})
 -inferior-tty-show
 ^done,inferior_tty_terminal="/dev/pts/1"
-(gdb)
+(@value{GDBP})
 @end smallexample
 
 @findex -enable-timings
@@ -40007,28 +40007,28 @@ GDB/MI Miscellaneous Commands
 @subsubheading Example
 
 @smallexample
-(gdb)
+(@value{GDBP})
 -enable-timings
 ^done
-(gdb)
+(@value{GDBP})
 -break-insert main
 ^done,bkpt=@{number="1",type="breakpoint",disp="keep",enabled="y",
 addr="0x080484ed",func="main",file="myprog.c",
 fullname="/home/nickrob/myprog.c",line="73",thread-groups=["i1"],
 times="0"@},
 time=@{wallclock="0.05185",user="0.00800",system="0.00000"@}
-(gdb)
+(@value{GDBP})
 -enable-timings no
 ^done
-(gdb)
+(@value{GDBP})
 -exec-run
 ^running
-(gdb)
+(@value{GDBP})
 *stopped,reason="breakpoint-hit",disp="keep",bkptno="1",thread-id="0",
 frame=@{addr="0x080484ed",func="main",args=[@{name="argc",value="1"@},
 @{name="argv",value="0xbfb60364"@}],file="myprog.c",
 fullname="/home/nickrob/myprog.c",line="73",arch="i386:x86_64"@}
-(gdb)
+(@value{GDBP})
 @end smallexample
 
 @findex -complete
@@ -40072,16 +40072,16 @@ GDB/MI Miscellaneous Commands
 @subsubheading Example
 
 @smallexample
-(gdb)
+(@value{GDBP})
 -complete br
 ^done,completion="break",
       matches=["break","break-range"],
       max_completions_reached="0"
-(gdb)
+(@value{GDBP})
 -complete "b ma"
 ^done,completion="b ma",
       matches=["b madvise","b main"],max_completions_reached="0"
-(gdb)
+(@value{GDBP})
 -complete "b push_b"
 ^done,completion="b push_back(",
       matches=[
@@ -40089,10 +40089,10 @@ GDB/MI Miscellaneous Commands
        "b std::string::push_back(char)",
        "b std::vector<int, std::allocator<int> >::push_back(int&&)"],
       max_completions_reached="0"
-(gdb)
+(@value{GDBP})
 -complete "nonexist"
 ^done,matches=[],max_completions_reached="0"
-(gdb)
+(@value{GDBP})
 
 @end smallexample
 
@@ -43356,12 +43356,12 @@ Maintenance Commands
 
 Here's an example of using @code{maint ignore-probes}:
 @smallexample
-(gdb) maint ignore-probes -verbose libc ^longjmp$
+(@value{GDBP}) maint ignore-probes -verbose libc ^longjmp$
 ignore-probes filter has been set to:
 PROVIDER: 'libc'
 PROBE_NAME: '^longjmp$'
 OBJNAME: ''
-(gdb) start
+(@value{GDBP}) start
 <... more output ...>
 Ignoring SystemTap probe libc longjmp in /lib64/libc.so.6.^M
 Ignoring SystemTap probe libc longjmp in /lib64/libc.so.6.^M
diff --git a/gdb/doc/guile.texi b/gdb/doc/guile.texi
index 95f83802f23..7bf773a649e 100644
--- a/gdb/doc/guile.texi
+++ b/gdb/doc/guile.texi
@@ -229,13 +229,13 @@ Basic Guile
 Example:
 
 @smallexample
-(gdb) guile (value-type (make-value 1))
+(@value{GDBP}) guile (value-type (make-value 1))
 ERROR: Unbound variable: value-type
 Error while executing Scheme code.
-(gdb) guile (use-modules (gdb))
-(gdb) guile (value-type (make-value 1))
+(@value{GDBP}) guile (use-modules (gdb))
+(@value{GDBP}) guile (value-type (make-value 1))
 int
-(gdb)
+(@value{GDBP})
 @end smallexample
 
 The @code{(gdb)} module provides these basic Guile functions.
@@ -565,9 +565,9 @@ Values From Inferior In Guile
 @code{make-value} always returns a fresh object.
 
 @smallexample
-(gdb) guile (eq? (make-value 1) (make-value 1))
+(@value{GDBP}) guile (eq? (make-value 1) (make-value 1))
 $1 = #f
-(gdb) guile (equal? (make-value 1) (make-value 1))
+(@value{GDBP}) guile (equal? (make-value 1) (make-value 1))
 $1 = #t
 @end smallexample
 
@@ -1724,7 +1724,7 @@ Writing a Guile Pretty-Printer
 corresponding output of @samp{info pretty-printer}:
 
 @smallexample
-(gdb) info pretty-printer
+(@value{GDBP}) info pretty-printer
 my_library.so:
   my-library
     foo
@@ -1845,14 +1845,14 @@ Commands In Guile
 say a bad command argument.
 
 @smallexample
-(gdb) guile (use-modules (gdb))
-(gdb) guile
+(@value{GDBP}) guile (use-modules (gdb))
+(@value{GDBP}) guile
 (register-command! (make-command "test-user-error"
   #:command-class COMMAND_OBSCURE
   #:invoke (lambda (self arg from-tty)
     (throw-user-error "Bad argument ~a" arg))))
 end
-(gdb) test-user-error ugh
+(@value{GDBP}) test-user-error ugh
 ERROR: Bad argument ugh
 @end smallexample
 @end deffn
@@ -2012,13 +2012,13 @@ Commands In Guile
 implemented in Guile:
 
 @smallexample
-(gdb) guile
+(@value{GDBP}) guile
 (register-command! (make-command "hello-world"
   #:command-class COMMAND_USER
   #:doc "Greet the whole world."
   #:invoke (lambda (self args from-tty) (display "Hello, World!\n"))))
 end
-(gdb) hello-world
+(@value{GDBP}) hello-world
 Hello, World!
 @end smallexample
 
@@ -3531,7 +3531,7 @@ Architectures In Guile
 Example:
 
 @smallexample
-(gdb) guile (type-name (arch-uchar-type (current-arch)))
+(@value{GDBP}) guile (type-name (arch-uchar-type (current-arch)))
 "unsigned char"
 @end smallexample
 
@@ -3559,13 +3559,13 @@ Disassembly In Guile
 
 Example:
 @smallexample
-(gdb) guile (use-modules (rnrs io ports))
-(gdb) guile (define pc (value->integer (parse-and-eval "$pc")))
-(gdb) guile (define mem (open-memory #:start pc))
-(gdb) guile (define bv (get-bytevector-n mem 10))
-(gdb) guile (define bv-port (open-bytevector-input-port bv))
-(gdb) guile (define arch (current-arch))
-(gdb) guile (arch-disassemble arch pc #:port bv-port #:offset pc)
+(@value{GDBP}) guile (use-modules (rnrs io ports))
+(@value{GDBP}) guile (define pc (value->integer (parse-and-eval "$pc")))
+(@value{GDBP}) guile (define mem (open-memory #:start pc))
+(@value{GDBP}) guile (define bv (get-bytevector-n mem 10))
+(@value{GDBP}) guile (define bv-port (open-bytevector-input-port bv))
+(@value{GDBP}) guile (define arch (current-arch))
+(@value{GDBP}) guile (arch-disassemble arch pc #:port bv-port #:offset pc)
 (((address . 4195516) (asm . "mov    $0x4005c8,%edi") (length . 5)))
 @end smallexample
 
@@ -3948,7 +3948,7 @@ Guile Auto-loading
 Example:
 
 @smallexample
-(gdb) info auto-load guile-scripts
+(@value{GDBP}) info auto-load guile-scripts
 Loaded Script
 Yes    scm-section-script.scm
        full name: /tmp/scm-section-script.scm
@@ -4026,10 +4026,10 @@ Guile Types Module
 Then in gdb:
 
 @smallexample
-(gdb) start
-(gdb) guile (use-modules (gdb) (gdb types))
-(gdb) guile (define foo-ref (parse-and-eval "foo_ref"))
-(gdb) guile (get-basic-type (value-type foo-ref))
+(@value{GDBP}) start
+(@value{GDBP}) guile (use-modules (gdb) (gdb types))
+(@value{GDBP}) guile (define foo-ref (parse-and-eval "foo_ref"))
+(@value{GDBP}) guile (get-basic-type (value-type foo-ref))
 #<gdb:type int>
 @end smallexample
 @end deffn
diff --git a/gdb/doc/python.texi b/gdb/doc/python.texi
index ddb347361f7..99d11d35aaf 100644
--- a/gdb/doc/python.texi
+++ b/gdb/doc/python.texi
@@ -805,7 +805,7 @@ Exception Handling
 rather recognizes it when thrown from user Python code.  Example:
 
 @smallexample
-(gdb) python
+(@value{GDBP}) python
 >class HelloWorld (gdb.Command):
 >  """Greet the whole world."""
 >  def __init__ (self):
@@ -817,7 +817,7 @@ Exception Handling
 >    print ("Hello, World!")
 >HelloWorld ()
 >end
-(gdb) hello-world 42
+(@value{GDBP}) hello-world 42
 hello-world takes no arguments
 @end smallexample
 @end ftable
@@ -1945,7 +1945,7 @@ Pretty Printing API
 reflect any flags that are temporarily in effect.
 
 @smallexample
-(gdb) python print(gdb.print_options ()['max_elements'])
+(@value{GDBP}) python print(gdb.print_options ()['max_elements'])
 200
 @end smallexample
 @end defun
@@ -2171,7 +2171,7 @@ Writing a Pretty-Printer
 corresponding output of @samp{info pretty-printer}:
 
 @smallexample
-(gdb) info pretty-printer
+(@value{GDBP}) info pretty-printer
 my_library.so:
   my_library
     foo
@@ -3492,10 +3492,10 @@ Writing an Xmethod
 defined above:
 
 @smallexample
-(gdb) p obj.geta()
+(@value{GDBP}) p obj.geta()
 $1 = 5
 
-(gdb) p obj + obj
+(@value{GDBP}) p obj + obj
 $2 = 10
 @end smallexample
 
@@ -5635,7 +5635,7 @@ Functions In Python
 Now you can use the function in an expression:
 
 @smallexample
-(gdb) print $greet("Bob")
+(@value{GDBP}) print $greet("Bob")
 $1 = "Hello, Bob!"
 @end smallexample
 
@@ -9129,7 +9129,7 @@ Python Auto-loading
 Example:
 
 @smallexample
-(gdb) info auto-load python-scripts
+(@value{GDBP}) info auto-load python-scripts
 Loaded Script
 Yes    py-section-script.py
        full name: /tmp/py-section-script.py
@@ -9215,10 +9215,10 @@ gdb.types
 Then in gdb:
 
 @smallexample
-(gdb) start
-(gdb) python import gdb.types
-(gdb) python foo_ref = gdb.parse_and_eval("foo_ref")
-(gdb) python print(gdb.types.get_basic_type(foo_ref.type))
+(@value{GDBP}) start
+(@value{GDBP}) python import gdb.types
+(@value{GDBP}) python foo_ref = gdb.parse_and_eval("foo_ref")
+(@value{GDBP}) python print(gdb.types.get_basic_type(foo_ref.type))
 int
 @end smallexample
 
@@ -9391,11 +9391,11 @@ gdb.ptwrite
 @exdent @value{GDBN} output after recording the sample program in pt format:
 @smallexample
 @group
-(gdb) record instruction-history 12,14
+(@value{GDBP}) record instruction-history 12,14
 12         0x0040074c <ptwrite64+16>:   ptwrite %rbx
 13           [0x42]
 14         0x00400751 <ptwrite64+21>:   mov -0x8(%rbp),%rbx
-(gdb) record function-call-history
+(@value{GDBP}) record function-call-history
 1       main
 2       ptwrite64
           [0x42]
@@ -9432,7 +9432,7 @@ gdb.ptwrite
 
 @smallexample
 @group
-(gdb) python-interactive
+(@value{GDBP}) python-interactive
 >>> class my_filter():
 ...    def __init__(self):
 ...        self.var = 0
@@ -9452,7 +9452,7 @@ gdb.ptwrite
 @end group
 
 @group
-(gdb) record function-call-history 59,64
+(@value{GDBP}) record function-call-history 59,64
 59      pthread_create@@GLIBC_2.2.5
 60      job()
 61      task(void*)
@@ -9464,7 +9464,7 @@ gdb.ptwrite
 @end group
 
 @group
-(gdb) info threads
+(@value{GDBP}) info threads
 * 1    Thread 0x7ffff7fd8740 (LWP 25796) "ptw_threads" task ()
     at bin/ptwrite/ptw_threads.c:45
   2    Thread 0x7ffff6eb8700 (LWP 25797) "ptw_threads" task ()
@@ -9472,14 +9472,14 @@ gdb.ptwrite
 @end group
 
 @group
-(gdb) thread 2
+(@value{GDBP}) thread 2
 [Switching to thread 2 (Thread 0x7ffff6eb8700 (LWP 25797))]
 #0  task (arg=0x0) at ptwrite_threads.c:45
 45        return NULL;
 @end group
 
 @group
-(gdb) record function-call-history 10,14
+(@value{GDBP}) record function-call-history 10,14
 10    start_thread
 11    task(void*)
 12    ptwrite64(unsigned long)
-- 
2.55.0


  reply	other threads:[~2026-10-12 18:56 UTC|newest]

Thread overview: 12+ messages / expand[flat|nested]  mbox.gz  Atom feed  top
2026-10-12 18:54 [PATCH 0/5] gdb/doc: a series of doc clean ups Andrew Burgess
2026-10-12 18:54 ` Andrew Burgess [this message]
2026-10-13 11:43   ` [PATCH 1/5] gdb/doc: use (@value{GDBP}) for the prompt in examples Eli Zaretskii
2026-10-12 18:54 ` [PATCH 2/5] gdb/doc: fix some incorrect '@table @code' uses Andrew Burgess
2026-10-13 11:56   ` Eli Zaretskii
2026-10-12 18:54 ` [PATCH 3/5] gdb/doc: consistent formatting for on|off on @item lines Andrew Burgess
2026-10-13 11:33   ` Eli Zaretskii
2026-10-12 18:54 ` [PATCH 4/5] gdb/doc: make more use of @option{...} formatting Andrew Burgess
2026-10-13 12:00   ` Eli Zaretskii
2026-10-12 18:54 ` [PATCH 5/5] gdb/doc: more @command and @kbd Andrew Burgess
2026-10-13 11:43   ` Eli Zaretskii
2026-10-16 14:52     ` Andrew Burgess

Reply instructions:

You may reply publicly to this message via plain-text email
using any one of the following methods:

* Save the following mbox file, import it into your mail client,
  and reply-to-all from there: mbox

  Avoid top-posting and favor interleaved quoting:
  https://en.wikipedia.org/wiki/Posting_style#Interleaved_style

* Reply using the --to, --cc, and --in-reply-to
  switches of git-send-email(1):

  git send-email \
    --in-reply-to=191418904b1320ef05149d612c326f34cfffcaf5.1791831032.git.aburgess@redhat.com \
    --to=aburgess@redhat.com \
    --cc=gdb-patches@sourceware.org \
    /path/to/YOUR_REPLY

  https://kernel.org/pub/software/scm/git/docs/git-send-email.html

* If your mail client supports setting the In-Reply-To header
  via mailto: links, try the mailto: link
Be sure your reply has a Subject: header at the top and a blank line before the message body.
This is a public inbox, see mirroring instructions
for how to clone and mirror all data and code used for this inbox