[New-bugs-announce] [issue34948] Document __warningregister__

[Steven D'Aprano]

New submission from Steven D'Aprano <steve+python at pearwood.info>:

The warnings module makes use of a per-module global ``__warningregister__`` which is briefly mentioned in the docs but not documented.

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

Given that it is part of the warn_explicit API, we should accept that the registry file is now part of the public API not just an implementation detail, and so we should explicitly document its existence and state the expected format.

----------
components: Library (Lib)
messages: 327449
nosy: steven.daprano
priority: normal
severity: normal
status: open
title: Document __warningregister__
type: behavior

_______________________________________
Python tracker <report at bugs.python.org>
<https://bugs.python.org/issue34948>
_______________________________________