gdb/doc: extend the documentation of the jump command
authorAndrew Burgess <aburgess@redhat.com>
Mon, 24 Apr 2023 14:27:27 +0000 (15:27 +0100)
committerAndrew Burgess <aburgess@redhat.com>
Thu, 27 Apr 2023 12:59:30 +0000 (13:59 +0100)
commit0d42948f0c822ed3782a45771c8fbc21aa2d6553
tree8f87d0d318f252bbbcca4d242fa4dd7d0213ba02
parent08ec06d6440745ef9204d39197aa1e732df41056
gdb/doc: extend the documentation of the jump command

This commit addresses PR gdb/7946.  While checking for bugs relating
to the jump command I noticed a long standing bug that points out a
deficiency with GDB's documentation of the jump command.

The bug points out that 'jump 0x...' is not always the same as 'set
$pc = 0x...' and then 'continue'.  Writing directly to the $pc
register does not update any auxiliary state, e.g. $npc on SPARC,
while using 'jump' does.

It felt like this would be an easy issue to address by adding a
paragraph to the docs, so I took a stab at writing something suitable.

Bug: https://sourceware.org/bugzilla/show_bug.cgi?id=7946

Approved-By: Eli Zaretskii <eliz@gnu.org>
gdb/doc/gdb.texinfo