Repository navigation
Fix all Sphinx reference warnings in the documentation (meta issue) #151940
Description
This supersedes the previous closed issue for this: #101100
I have created several sub-issues (see table below) to split the work up and avoid what happened the last time. This is the meta issue for this task, any general discussion on this topic should go here, not on the sub-issues, and vice-versa.
In each of the issues, I've added the current list of warnings. Note that the warnings themselves, and their line numbers may change.
There are some warnings that come up with no file:
TODO: Figure these out.
<unknown>:922: c:type reference target not found: PyWeakReference [ref.type]
<unknown>:956: c:data reference target not found: Py_FileSystemDefaultEncodeErrors [ref.data]
<unknown>:957: c:data reference target not found: Py_FileSystemDefaultEncoding [ref.data]
<unknown>:970: c:data reference target not found: Py_HasFileSystemDefaultEncoding [ref.data]
<unknown>:1026: c:data reference target not found: Py_UTF8Mode [ref.data]
<unknown>:1037: c:type reference target not found: Py_intptr_t [ref.type]
<unknown>:1141: c:type reference target not found: Py_uintptr_t [ref.type]
<unknown>:1168: c:type reference target not found: ssizessizeargfunc [ref.type]
<unknown>:1169: c:type reference target not found: ssizessizeobjargproc [ref.type]
<unknown>:1170: c:type reference target not found: symtable [ref.type]
Activity
Doc/c-api/#151941Doc/whatsnew/#151942Doc/library/{xml*,pyexpat}.rst#151943Doc/library/urllib.{parse,request}.rst#151944Doc/library/http.{cookiejar,server}.rst#151945Doc/library/logging.{config,handlers}.rst#151946Doc/library/email.{charset,parser}.rst#151947Doc/library/select.rst#151948Doc/library/lzma.rst#151949Doc/library/files #151950picnixz commentedon Jul 5, 2026
@StanFromIreland
The "bad" references in your TODO list is coming from
stable_abi.dat(though with some incorrect line numbers shifted by 1). The problem is the Sphinx extension that is processing that file. I'll fix it.