Broken `bdb.Bdb.user_call` API

[George-Ogden]

Bug report

Bug description:

This is an issue with how bdb.Bdb.user_call is documented.
According to the bdb documentation, bdb.BdB.user_call has two arguments, frame and argument_list.
This is implemented in the bdb library here.
However, according to the sys documentation, sys.settrace will always set the arg to None and the code above acknowledges that "# XXX 'arg' is no longer used".
I don't know if this is based on a previous version that would give the call arguments, but I think we should change the signature of bdb.Bdb.user_call to exclude the argument_list parameter or state in the documentation that it will be None.

CPython versions tested on:

3.12

Operating systems tested on:

Linux

Linked PRs

• gh-118359: Add notes for Bdb.user_call #118368
• [3.12] gh-118359: Improve docs for Bdb.user_call (GH-118368) #118410

[gaogaotiantian]

Yes, we should change the documentation. We can't change the signature of the function because that would break backward compatibility.

[gaogaotiantian]

Thank you for reporting this. The docs is fixed in main and will be backported to 3.12.