GV

GeezerVison

The World Wide Web, restored to 800 pixels of glory.

Home|About|Gaming cabinet|Archives|How it works|Starter sites

On this site

  • Sign in
  • ActionsCI/CD and automation
  • CodespacesCloud development environments
  • All Features
  • Documentation
  • Training
  • Certifications
  • Build with Copilot
  • Customize Copilot
  • Integrations
  • Trending repos
  • GitHub Sponsors
  • Developer articles
  • Enterprises

This view

  • Original page
  • New address

GeezerVison is showing github.com — Fix all Sphinx reference warnings in the documentation (meta issue) · Issue #151940 · python/cpython

Fix all Sphinx reference warnings in the documentation (meta issue) #151940

New issue
Copy link
New issue
Copy link
Open
5 / 105 of 10 issues completed
Open
Fix all Sphinx reference warnings in the documentation (meta issue)#151940
5 / 105 of 10 issues completed
Copy link
Labels
docsDocumentation in the Doc dirDocumentation in the Doc dirtype-bugAn unexpected behavior, bug, or errorAn unexpected behavior, bug, or error

Description

@StanFromIreland
StanFromIreland
opened on Jun 22, 2026
Issue body actions

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]

Linked PRs

  • gh-151940: fix Sphinx warnings arising from stable_abi.dat #153086
Reacted by Carol Willing

Activity

  1. StanFromIreland
    added
    type-bugAn unexpected behavior, bug, or errorAn unexpected behavior, bug, or error
    docsDocumentation in the Doc dirDocumentation in the Doc dir
    on Jun 22, 2026
  2. github-project-automation
    added this to docs issueson Jun 22, 2026
  3. github-project-automation
    moved this to Todo in docs issueson Jun 22, 2026
  4. StanFromIreland
    added sub-issues on Jun 22, 2026
    • Fix all Sphinx reference warnings in Doc/c-api/ #151941
    • Fix all Sphinx reference warnings in Doc/whatsnew/ #151942
    • Fix all Sphinx reference warnings in Doc/library/{xml*,pyexpat}.rst #151943
    • Fix all Sphinx reference warnings in Doc/library/urllib.{parse,request}.rst #151944
    • Fix all Sphinx reference warnings in Doc/library/http.{cookiejar,server}.rst #151945
    • Fix all Sphinx reference warnings in Doc/library/logging.{config,handlers}.rst #151946
    • Fix all Sphinx reference warnings in Doc/library/email.{charset,parser}.rst #151947
    • Fix all Sphinx reference warnings in Doc/library/select.rst #151948
    • Fix all Sphinx reference warnings in Doc/library/lzma.rst #151949
    • Fix Sphinx reference warnings in various Doc/library/ files #151950

  5. picnixz commented on Jul 5, 2026

    @picnixz
    picnixz
    on Jul 5, 2026
    Member
    More actions

    @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.

    Reacted by Stan Ulbrych
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Metadata

Metadata

Assignees

No one assigned

    Labels

    docsDocumentation in the Doc dirDocumentation in the Doc dirtype-bugAn unexpected behavior, bug, or errorAn unexpected behavior, bug, or error

    Projects

    • docs issues
      Status
      Todo
      Show more project fields

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions
    You are visitor 01402503 — GeezerVison does not store the pages you look up.
    Best viewed with Netscape Navigator 4.7 or Internet Explorer 6 at 800×600. No cookies required.