warnings.catch_warnings docs: dubious mention of sys.stdout

[jwilk]

https://docs.python.org/3/library/warnings.html#warnings.catch_warnings reads:

If record is True, a list is returned that is progressively populated with objects as seen by a custom showwarning() function (which also suppresses output to sys.stdout).

Was it meant to say sys.stderr instead?
Otherwise, I don't understand why it mentions stdout specifically. I don't see anything about stdout elsewhere in the module docs or in the implementation.

Linked PRs

• gh-129846: docs(warnings): clarify suppression of warning output in catch_warnings #130768

[Mr-Sunglasses]

https://docs.python.org/3/library/warnings.html#warnings.catch_warnings reads:

If record is True, a list is returned that is progressively populated with objects as seen by a custom showwarning() function (which also suppresses output to sys.stdout).

Was it meant to say sys.stderr instead? Otherwise, I don't understand why it mentions stdout specifically. I don't see anything about stdout elsewhere in the module docs or in the implementation.

The mention of sys.stdout in the documentation is likely included to highlight that the warning output is suppressed entirely, including any potential redirection of sys.stderr to sys.stdout. But, it is true that warnings are typically written to sys.stderr by default, not sys.stdout. So it is good that we can change

If record is True, a list is returned that is progressively populated with objects as seen by a custom showwarning() function (which also suppresses output to sys.stdout).

to

If record is True, a list is returned that is progressively populated with objects as seen by a custom showwarning() function (which also suppresses output to sys.stderr).

to make it more specific and clear to understand.