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 — Docs: Prepare for Sphinx 9 by AA-Turner · Pull Request #142057 · python/cpython

Conversation

@AA-Turner

@AA-Turner AA-Turner commented Nov 29, 2025 •
edited by github-actions Bot
Loading

Uh oh!

There was an error while loading. Please reload this page.

Copy link
Copy Markdown
Member

cc @hugovk @picnixz

Resolves the following:

...\Doc\howto\urllib2.rst:479: ERROR: Duplicate target name, cannot be used as a unique reference: "basic authentication". [docutils]
...\Doc\library\socket.rst:2099: WARNING: more than one target found for cross-reference 'buffer': io.TextIOBase.buffer, unittest.TestResult.buffer [ref.python]

A

📚 Documentation preview 📚: https://cpython-previews--142057.org.readthedocs.build/

Sorry, something went wrong.

Uh oh!

There was an error while loading. Please reload this page.
All reactions
@AA-Turner
Prepare for Sphinx 9
e7eedd6
@AA-Turner
AA-Turner requested a review from hugovk as a code owner November 29, 2025 00:54
@AA-Turner AA-Turner added docs Documentation in the Doc dir skip news needs backport to 3.13 only security fixes needs backport to 3.14 bugs and security fixes labels Nov 29, 2025
@github-project-automation github-project-automation Bot added this to Docs PRs Nov 29, 2025
@github-project-automation github-project-automation Bot moved this to Todo in Docs PRs Nov 29, 2025
@bedevere-app bedevere-app Bot added the awaiting core review label Nov 29, 2025
hugovk
hugovk approved these changes Nov 29, 2025
View reviewed changes
Comment thread Doc/tools/extensions/glossary_search.py
terms[term.lower()] = {
'title': term,
'body': rendered['html_body'],
'body': rendered['fragment'],

@hugovk hugovk Nov 29, 2025

Copy link
Copy Markdown
Member

There was a problem hiding this comment.

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

What does this do?

Sorry, something went wrong.

Uh oh!

There was an error while loading. Please reload this page.
All reactions

@AA-Turner AA-Turner Nov 29, 2025

Copy link
Copy Markdown
Member Author

There was a problem hiding this comment.

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

body and fragment are aliases. html_body wraps the fragment content in <main> tags, but that's not needed/helpful for this use-case (inserting into the search results).

A

Sorry, something went wrong.

Uh oh!

There was an error while loading. Please reload this page.
All reactions
Comment thread Doc/howto/urllib2.rst
with Python:

* `Basic Authentication <https://web.archive.org/web/20201215133350/http://www.voidspace.org.uk/python/articles/authentication.shtml>`_
* `Basic Authentication <https://web.archive.org/web/20201215133350/http://www.voidspace.org.uk/python/articles/authentication.shtml>`__

@hugovk hugovk Nov 29, 2025

Copy link
Copy Markdown
Member

There was a problem hiding this comment.

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I guess we should generally use anonymous targets as a default, unless we specifically want a named one?

Needing a named one is probably rare.

If so, we could update the examples in the devguide, perhaps with a brief explanation.

And suggest anonymous in reviews.

Sorry, something went wrong.

Uh oh!

There was an error while loading. Please reload this page.
AA-Turner reacted with thumbs up emoji
All reactions
  • 👍 1 reaction

@hugovk hugovk Nov 29, 2025

Copy link
Copy Markdown
Member

There was a problem hiding this comment.

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

PR opened: python/devguide#1709

Sorry, something went wrong.

Uh oh!

There was an error while loading. Please reload this page.
All reactions
@bedevere-app bedevere-app Bot added awaiting merge and removed awaiting core review labels Nov 29, 2025
@picnixz picnixz added the skip issue label Nov 29, 2025
@picnixz picnixz mentioned this pull request Nov 29, 2025
GH-139257 Use an explicitly named link #142090
Closed
@hugovk
hugovk merged commit 7739943 into python:main Nov 29, 2025
45 checks passed

Uh oh!

There was an error while loading. Please reload this page.
@github-project-automation github-project-automation Bot moved this from Todo to Done in Docs PRs Nov 29, 2025
@miss-islington-app

miss-islington-app Bot commented Nov 29, 2025

Copy link
Copy Markdown

Thanks @AA-Turner for the PR, and @hugovk for merging it 🌮🎉.. I'm working now to backport this PR to: 3.13, 3.14.
🐍🍒⛏🤖
All reactions

Sorry, something went wrong.

Uh oh!

There was an error while loading. Please reload this page.
@bedevere-app bedevere-app Bot removed the awaiting merge label Nov 29, 2025
miss-islington pushed a commit to miss-islington/cpython that referenced this pull request Nov 29, 2025
@AA-Turner @miss-islington
Docs: Prepare for Sphinx 9 (pythonGH-142057)
71e6c14 
(cherry picked from commit 7739943)

Co-authored-by: Adam Turner <[email protected]>
@bedevere-app

bedevere-app Bot commented Nov 29, 2025

Copy link
Copy Markdown

GH-142091 is a backport of this pull request to the 3.14 branch.
All reactions

Sorry, something went wrong.

Uh oh!

There was an error while loading. Please reload this page.
miss-islington pushed a commit to miss-islington/cpython that referenced this pull request Nov 29, 2025
@AA-Turner @miss-islington
Docs: Prepare for Sphinx 9 (pythonGH-142057)
d136a22 
(cherry picked from commit 7739943)

Co-authored-by: Adam Turner <[email protected]>
@bedevere-app bedevere-app Bot removed the needs backport to 3.14 bugs and security fixes label Nov 29, 2025
@picnixz picnixz mentioned this pull request Nov 29, 2025
Documentation doesn't generate with docutils >= 0.22 #139257
Closed
@bedevere-app

bedevere-app Bot commented Nov 29, 2025

Copy link
Copy Markdown

GH-142092 is a backport of this pull request to the 3.13 branch.
All reactions

Sorry, something went wrong.

Uh oh!

There was an error while loading. Please reload this page.
@bedevere-app bedevere-app Bot removed the needs backport to 3.13 only security fixes label Nov 29, 2025
@AA-Turner
AA-Turner deleted the docs/sphinx-9-prep branch November 29, 2025 14:50
hugovk pushed a commit that referenced this pull request Nov 29, 2025
@miss-islington @AA-Turner
[3.14] Docs: Prepare for Sphinx 9 (GH-142057) (#142091)
8559100 
Co-authored-by: Adam Turner <[email protected]>
@hugovk hugovk mentioned this pull request Nov 29, 2025
RST markup: recommend anonymous hyperlinks python/devguide#1709
Merged
AA-Turner pushed a commit that referenced this pull request Nov 29, 2025
@miss-islington
[3.13] Docs: Prepare for Sphinx 9 (GH-142057) (#142092)
bb8984f
StanFromIreland pushed a commit to StanFromIreland/cpython that referenced this pull request Dec 6, 2025
@AA-Turner @StanFromIreland
Docs: Prepare for Sphinx 9 (python#142057)
d22c13f
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Reviewers

@hugovk hugovk hugovk approved these changes

Uh oh!

There was an error while loading. Please reload this page.

Assignees

No one assigned

Labels

docs Documentation in the Doc dir skip issue skip news

Projects

Docs PRs
Status: Done

Milestone

No milestone

Development

Successfully merging this pull request may close these issues.

Uh oh!

There was an error while loading. Please reload this page.

3 participants

@AA-Turner @hugovk @picnixz
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
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.