Skip to content

gh-151950: Fix dangling class reference in pickletools docs#152209

Open
BHUVANSH855 wants to merge 1 commit into
python:mainfrom
BHUVANSH855:gh-151950-pickletools
Open

gh-151950: Fix dangling class reference in pickletools docs#152209
BHUVANSH855 wants to merge 1 commit into
python:mainfrom
BHUVANSH855:gh-151950-pickletools

Conversation

@BHUVANSH855

Copy link
Copy Markdown

Issue

gh-151950

Description

This PR fixes a dangling Sphinx class reference in Doc/library/pickletools.rst.

The reference to OpcodeInfo pointed to an undocumented internal class, producing a Sphinx warning. This change replaces the cross-reference with :class:!OpcodeInfo`` to preserve the formatting while suppressing the unresolved reference.

Comment thread Doc/library/pickletools.rst Outdated
@bedevere-app

bedevere-app Bot commented Jun 25, 2026

Copy link
Copy Markdown

A Python core developer has requested some changes be made to your pull request before we can consider merging it. If you could please address their requests along with any other requests in other reviews from core developers that would be appreciated.

Once you have made the requested changes, please leave a comment on this pull request containing the phrase I have made the requested changes; please review again. I will then notify any core developers who have left a review that you're ready for them to take another look at this pull request.

@read-the-docs-community

read-the-docs-community Bot commented Jun 26, 2026

Copy link
Copy Markdown

Documentation build overview

📚 cpython-previews | 🛠️ Build #33499518 | 📁 Comparing c819cac against main (56ae0b8)

  🔍 Preview build  

92 files changed · ± 91 modified · - 1 deleted

± Modified

- Deleted

@BHUVANSH855

Copy link
Copy Markdown
Author

I have made the requested changes; please review again.

@bedevere-app

bedevere-app Bot commented Jun 27, 2026

Copy link
Copy Markdown

Thanks for making the requested changes!

@StanFromIreland: please review the changes made to this pull request.

Comment thread Doc/library/pickletools.rst
opcode's argument; *pos* is the position at which this opcode is located.
*pickle* can be a string or a file-like object.

.. class:: OpcodeInfo

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.

This isn't in pickletools.__all__ so if we're documenting it we should add it there, and also ArgumentDescriptor and StackObject. They are technically already public per PEP 387, and we do return them, so I think we should expose them properly.

@BHUVANSH855 BHUVANSH855 force-pushed the gh-151950-pickletools branch from c17a831 to c819cac Compare July 8, 2026 16:27
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

Projects

Status: Todo

Development

Successfully merging this pull request may close these issues.

2 participants