Skip to content

Conversation

@Yashp002
Copy link
Contributor

@Yashp002 Yashp002 commented Jan 19, 2026

Removes an outdated section in the pickle module documentation that incorrectly states marshal does not support object sharing or recursive objects.

As confirmed by core developers, marshal (protocol version 3+) supports both shared references and recursion, making the previous claim inaccurate. This change simply removes the incorrect statement without adding further comparisons, as requested.
Fixes #143298


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

@bedevere-app bedevere-app bot added docs Documentation in the Doc dir skip news awaiting review labels Jan 19, 2026
@github-project-automation github-project-automation bot moved this to Todo in Docs PRs Jan 19, 2026
@Yashp002 Yashp002 changed the title gh-[143298]: Remove outdated documentation comparing pickle and marshal gh-[#143298]: Remove outdated documentation comparing pickle and marshal Jan 19, 2026
@Yashp002 Yashp002 changed the title gh-[#143298]: Remove outdated documentation comparing pickle and marshal gh-#143298: Remove outdated documentation comparing pickle and marshal Jan 19, 2026
@Yashp002 Yashp002 changed the title gh-#143298: Remove outdated documentation comparing pickle and marshal gh-143298: Remove outdated documentation comparing pickle and marshal Jan 19, 2026
@Yashp002 Yashp002 changed the title gh-143298: Remove outdated documentation comparing pickle and marshal gh-143928: Remove outdated comparison between pickle and marshal regarding recursion Jan 19, 2026
@Yashp002
Copy link
Contributor Author

@picnixz Would this PR be satisfactory?

Copy link
Member

@picnixz picnixz left a comment

Choose a reason for hiding this comment

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

Yes, but please check that there is no such comparison in marshal.rst as well (maybe we have this kind of mention in marshal.rst, idk)

@Yashp002
Copy link
Contributor Author

@picnixz The only 4 mentions of the pickle module in marshal.rst seem to be about RPC calls and where pickle can be used. Nothing that suggests marshal doesn't support recursion or object sharing. So i think this is fine

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

Labels

awaiting review docs Documentation in the Doc dir skip news

Projects

Status: Todo

Development

Successfully merging this pull request may close these issues.

2 participants