gdb/python: have PendingFrame methods accept keyword arguments
authorAndrew Burgess <aburgess@redhat.com>
Tue, 14 Mar 2023 11:43:14 +0000 (11:43 +0000)
committerAndrew Burgess <aburgess@redhat.com>
Thu, 6 Apr 2023 14:01:43 +0000 (15:01 +0100)
commit56fcb715a9f6abddd51f981e15a14d88ae766fc5
tree30dce3b3c70c1b6f88a54e450ab92cfdb50657a6
parentd2d62da62ec9c5486b19d8ffc7b4ef4070e8df7a
gdb/python: have PendingFrame methods accept keyword arguments

Update the two gdb.PendingFrame methods gdb.PendingFrame.read_register
and gdb.PendingFrame.create_unwind_info to accept keyword arguments.

There's no huge benefit for making this change, both of these methods
only take a single argument, so it is (maybe) less likely that a user
will take advantage of the keyword arguments in these cases, but I
think it's nice to be consistent, and I don't see any particular draw
backs to making this change.

For PendingFrame.read_register I've changed the argument name from
'reg' to 'register' in the documentation and used 'register' as the
argument name in GDB.  My preference for APIs is to use full words
where possible, and given we didn't support named arguments before
this change should not break any existing code.

There should be no user visible changes (for existing code) after this
commit.

Reviewed-By: Eli Zaretskii <eliz@gnu.org>
Reviewed-By: Tom Tromey <tom@tromey.com>
gdb/doc/python.texi
gdb/python/py-unwind.c
gdb/testsuite/gdb.python/py-unwind.py