Skip to content

gh-161414: Remove the backquote from the pydoc symbols - #161416

Merged
StanFromIreland merged 3 commits into
python:mainfrom
andresdelfino:gh-161414-pydoc-backquote-symbol
Nov 5, 2026
Merged

StanFromIreland merged 3 commits into
python:mainfrom
andresdelfino:gh-161414-pydoc-backquote-symbol

Conversation

@andresdelfino

@andresdelfino andresdelfino commented Nov 5, 2026 •

Copy link
Copy Markdown
Contributor

pydoc.Helper.symbols mapped the backquote to the BACKQUOTES topic, which no longer exists, so help('`') printed "no documentation found for 'BACKQUOTES'". The backquote is not valid syntax in Python 3, so this removes the entry. It was the only symbol that did not lead to documentation.

The new test calls Helper.showsymbol() for every symbol and checks that each one leads to documentation; it fails without the fix.

🤖 Generated with Claude Code

Helper.symbols mapped the backquote to the BACKQUOTES topic, which was
removed along with Python 2's backquote syntax, so help('`') reported
"no documentation found for 'BACKQUOTES'".

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>

@sobolevn sobolevn left a comment

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

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

Great find! One small nitpick.

I think that this can be safely backported, because previously it did not show anything useful as well.

Comment thread Lib/test/test_pydoc/test_pydoc.py Resolved
Co-authored-by: sobolevn <mail@sobolevn.me>
@StanFromIreland
StanFromIreland enabled auto-merge (squash) November 5, 2026 17:03
@StanFromIreland StanFromIreland added needs backport to 3.14 bugs and security fixes needs backport to 3.15 bugs and security fixes labels Nov 5, 2026
@StanFromIreland
StanFromIreland merged commit d003448 into python:main Nov 5, 2026
57 checks passed
@miss-islington-app

Copy link
Copy Markdown

Thanks @andresdelfino for the PR, and @StanFromIreland for merging it 🌮🎉.. I'm working now to backport this PR to: 3.14, 3.15.
🐍🍒⛏🤖

@bedevere-app

bedevere-app Bot commented Nov 5, 2026

Copy link
Copy Markdown

GH-161438 is a backport of this pull request to the 3.15 branch.

@bedevere-app bedevere-app Bot removed the needs backport to 3.15 bugs and security fixes label Nov 5, 2026
@bedevere-app

bedevere-app Bot commented Nov 5, 2026

Copy link
Copy Markdown

GH-161439 is a backport of this pull request to the 3.14 branch.

@bedevere-app bedevere-app Bot removed the needs backport to 3.14 bugs and security fixes label Nov 5, 2026
@andresdelfino
andresdelfino deleted the gh-161414-pydoc-backquote-symbol branch November 5, 2026 18:31
@andresdelfino

Copy link
Copy Markdown
Contributor Author

Thank you both!

StanFromIreland added a commit that referenced this pull request Nov 5, 2026
…61416) (#161439)

(cherry picked from commit d003448)

Co-authored-by: Andrés Delfino <adelfino@gmail.com>
Co-authored-by: sobolevn <mail@sobolevn.me>
Co-authored-by: Stan Ulbrych <stan@python.org>
StanFromIreland added a commit that referenced this pull request Nov 5, 2026
…61416) (#161438)

(cherry picked from commit d003448)

Co-authored-by: Andrés Delfino <adelfino@gmail.com>
Co-authored-by: sobolevn <mail@sobolevn.me>
Co-authored-by: Stan Ulbrych <stan@python.org>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants