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

@vstinner vstinner merged commit 923d9d2 into python:main Jan 26, 2026
40 checks passed
@github-project-automation github-project-automation bot moved this from Todo to Done in Docs PRs Jan 26, 2026
@vstinner vstinner added needs backport to 3.13 bugs and security fixes needs backport to 3.14 bugs and security fixes labels Jan 26, 2026
@miss-islington-app
Copy link

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

@miss-islington-app
Copy link

Thanks @Yashp002 for the PR, and @vstinner for merging it 🌮🎉.. I'm working now to backport this PR to: 3.13.
🐍🍒⛏🤖

miss-islington pushed a commit to miss-islington/cpython that referenced this pull request Jan 26, 2026
…l regarding recursion (pythonGH-144025)

(cherry picked from commit 923d9d2)

Co-authored-by: Yashraj <[email protected]>
miss-islington pushed a commit to miss-islington/cpython that referenced this pull request Jan 26, 2026
…l regarding recursion (pythonGH-144025)

(cherry picked from commit 923d9d2)

Co-authored-by: Yashraj <[email protected]>
@bedevere-app
Copy link

bedevere-app bot commented Jan 26, 2026

GH-144246 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 Jan 26, 2026
@bedevere-app
Copy link

bedevere-app bot commented Jan 26, 2026

GH-144247 is a backport of this pull request to the 3.13 branch.

@bedevere-app bedevere-app bot removed the needs backport to 3.13 bugs and security fixes label Jan 26, 2026
@vstinner
Copy link
Member

Merged, thank you.

vstinner pushed a commit that referenced this pull request Jan 26, 2026
…al regarding recursion (GH-144025) (#144247)

gh-143928: Remove outdated comparison between pickle and marshal regarding recursion (GH-144025)
(cherry picked from commit 923d9d2)

Co-authored-by: Yashraj <[email protected]>
vstinner pushed a commit that referenced this pull request Jan 26, 2026
…al regarding recursion (GH-144025) (#144246)

gh-143928: Remove outdated comparison between pickle and marshal regarding recursion (GH-144025)
(cherry picked from commit 923d9d2)

Co-authored-by: Yashraj <[email protected]>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

docs Documentation in the Doc dir skip news

Projects

Status: Done

Development

Successfully merging this pull request may close these issues.

3 participants