Skip to content

Conversation

@Krishna-web-hub
Copy link

@Krishna-web-hub Krishna-web-hub commented Oct 24, 2025

gh-140281: Doc: Update free-threading how-to

Key changes:

  • Updates text on immortal objects from "expected to be addressed" to "Work to further reduce...".
  • Updates performance overhead text from "expected to be reduced" to "was reduced" and notes that further reduction "remains an active development goal".
  • A NEWS entry has been added.

@python-cla-bot
Copy link

python-cla-bot bot commented Oct 24, 2025

All commit authors signed the Contributor License Agreement.

CLA signed

@bedevere-app bedevere-app bot added docs Documentation in the Doc dir awaiting review labels Oct 24, 2025
@github-project-automation github-project-automation bot moved this to Todo in Docs PRs Oct 24, 2025
@picnixz picnixz changed the title Updating the free-threading doc of python version 3.14 fix #140281 gh-140281: update 3.14 previsions for the free-threaded build Oct 24, 2025
Copy link
Member

@ZeroIntensity ZeroIntensity left a comment

Choose a reason for hiding this comment

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

@colesbury Did you want to keep the information from the old 3.13 FT build here?

Copy link
Member

Choose a reason for hiding this comment

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

Please remove this. We only need blurb entries for changes to the documentation build. I'll apply skip news on this for you.

Comment on lines 119 to 120
objects of these types may see increased memory usage. Work to further reduce
this overhead continued in the 3.14 release.
Copy link
Member

Choose a reason for hiding this comment

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

Immortalization of these objects was removed entirely in the 3.14 release, but this reads as if some of it was left.

Copy link
Author

Choose a reason for hiding this comment

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

Thanks @ZeroIntensity , for the information i will be doing the changes accordingly.

@colesbury
Copy link
Contributor

Thanks for bringing this up. I think this needs to be reworked a bit more and we should limit it to 3.14. I don't think we need to discuss 3.13.

  • Immortalization: It's just code constants: numeric and string literals and tuple literals of those constants. Plus sys.intern
  • Frame objects: Should no longer crash, but we should verify this
  • Iterators: Should no longer crash

@Krishna-web-hub Krishna-web-hub force-pushed the doc-fix-140281 branch 2 times, most recently from b28265c to 2614ffb Compare October 29, 2025 22:37
@Krishna-web-hub
Copy link
Author

Hi @colesbury, thanks for the specific feedback.
I've just pushed a new, clean commit that addresses all your points:

  • The documentation has been refocused on 3.14, and the outdated 3.13 comparisons have been removed.

  • I've corrected the "Immortalization" section to match your clarification (limited to code constants, literals, and sys.intern).

  • The warnings about "Frame objects" and "Iterators" crashing have also been removed.

@Krishna-web-hub
Copy link
Author

hello @colesbury ,
I have done the changes you said about you can see and if you need any more changes then please tell me.

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

Projects

Status: Todo

Development

Successfully merging this pull request may close these issues.

3 participants