GeezerVison is showing github.com — Fix all Sphinx reference warnings in `Doc/library/logging.{config,handlers}.rst` · Issue #151946 · python/cpython
Fix all Sphinx reference warnings in Doc/library/logging.{config,handlers}.rst #151946DescriptionBug report
Doc/library/logging.config.rst
Doc/library/logging.config.rst:53: py:class reference target not found: DictConfigurator [ref.class]
Doc/library/logging.config.rst:53: py:meth reference target not found: configure [ref.meth]
Doc/library/logging.config.rst:53: py:attr reference target not found: dictConfigClass [ref.attr]
Doc/library/logging.config.rst:61: py:attr reference target not found: dictConfigClass [ref.attr]
Doc/library/logging.config.rst:61: py:meth reference target not found: configure [ref.meth]
Doc/library/logging.config.rst:68: py:class reference target not found: DictConfigurator [ref.class]
Doc/library/logging.config.rst:68: py:meth reference target not found: __init__ [ref.meth]
Doc/library/logging.config.rst:68: py:meth reference target not found: configure [ref.meth]
Doc/library/logging.config.rst:68: py:attr reference target not found: dictConfigClass [ref.attr]
Doc/library/logging.config.rst:136: py:const reference target not found: DEFAULT_LOGGING_CONFIG_PORT [ref.const]
Doc/library/logging.config.rst:194: py:meth reference target not found: join [ref.meth]
Doc/library/logging.config.rst:705: py:attr reference target not found: importer [ref.attr]
Doc/library/logging.config.rst:705: py:class reference target not found: DictConfigurator [ref.class]
Doc/library/logging.config.rst:705: py:class reference target not found: BaseConfigurator [ref.class]
Doc/library/logging.handlers.rst
Doc/library/logging.handlers.rst:32: py:meth reference target not found: write [ref.meth]
Doc/library/logging.handlers.rst:32: py:meth reference target not found: flush [ref.meth]
Doc/library/logging.handlers.rst:55: py:meth reference target not found: close [ref.meth]
Doc/library/logging.handlers.rst:160: py:class reference target not found: FileHandler [ref.class]
Doc/library/logging.handlers.rst:221: py:class reference target not found: FileHandler [ref.class]
Doc/library/logging.handlers.rst:289: py:meth reference target not found: emit [ref.meth]
Doc/library/logging.handlers.rst:289: py:meth reference target not found: handleError [ref.meth]
Doc/library/logging.handlers.rst:629: py:const reference target not found: LOG_USER [ref.const]
Doc/library/logging.handlers.rst:847: py:meth reference target not found: __init__ [ref.meth]
Doc/library/logging.handlers.rst:847: py:const reference target not found: DEBUG [ref.const]
Doc/library/logging.handlers.rst:847: py:const reference target not found: INFO [ref.const]
Doc/library/logging.handlers.rst:847: py:const reference target not found: WARNING [ref.const]
Doc/library/logging.handlers.rst:847: py:const reference target not found: ERROR [ref.const]
Doc/library/logging.handlers.rst:847: py:const reference target not found: CRITICAL [ref.const]
Doc/library/logging.handlers.rst:915: py:meth reference target not found: shouldFlush [ref.meth]
Doc/library/logging.handlers.rst:915: py:meth reference target not found: flush [ref.meth]
Doc/library/logging.handlers.rst:949: py:const reference target not found: ERROR [ref.const]
Doc/library/logging.handlers.rst:1088: py:attr reference target not found: msg [ref.attr]
Doc/library/logging.handlers.rst:1088: py:attr reference target not found: message [ref.attr]
Doc/library/logging.handlers.rst:1088: py:attr reference target not found: args [ref.attr]
Doc/library/logging.handlers.rst:1088: py:attr reference target not found: exc_info [ref.attr]
Doc/library/logging.handlers.rst:1088: py:attr reference target not found: exc_text [ref.attr]
Linked PRs
ActivityBHUVANSH855 commented on Jun 25, 2026 Hi @StanFromIreland
I'm looking into the unresolved references in Doc/library/logging.config.rst.
Some of the missing targets (such as DictConfigurator, BaseConfigurator, dictConfigClass, and DEFAULT_LOGGING_CONFIG_PORT) don't appear to have any existing Sphinx documentation targets—they're implemented in Lib/logging/config.py but aren't documented with .. class:: or .. data:: directives.
Would you prefer that this issue:
- adds documentation targets for these public objects, or
- replaces the unresolved cross-references with literals where appropriate?
I wanted to check before preparing the patch so it matches the intended approach.
MetadataMetadataStatusShow more project fields StatusShow more project fields
DevelopmentNo branches or pull requestsIssue actions
|