Skip to content

GH-117759: Update GC docs for incremental collection - #126695

Merged
markshannon merged 5 commits into
python:mainfrom
faster-cpython:update-gc-internal-docs
Nov 14, 2024
Merged

GH-117759: Update GC docs for incremental collection#126695
markshannon merged 5 commits into
python:mainfrom
faster-cpython:update-gc-internal-docs

Conversation

@markshannon

@markshannonmarkshannon commented Nov 11, 2024

Copy link
Copy Markdown
Member

@markshannonmarkshannon changed the title Update GC docsGH-117759: Update GC docs for incremental collectionNov 11, 2024
@bedevere-appbedevere-appBot mentioned this pull request Nov 11, 2024
3 tasks
@markshannon
markshannon marked this pull request as ready for review November 11, 2024 18:24
Comment threadInternalDocs/garbage_collector.md Outdated
Co-authored-by: Daniel Hollas <danekhollas@gmail.com>
Comment threadInternalDocs/garbage_collector.md Outdated
Comment threadInternalDocs/garbage_collector.md Outdated
Comment threadInternalDocs/garbage_collector.md Outdated
Comment threadInternalDocs/garbage_collector.md Outdated
Comment threadInternalDocs/garbage_collector.md Outdated
Comment threadInternalDocs/garbage_collector.md
Comment threadInternalDocs/garbage_collector.md Outdated
Comment threadInternalDocs/garbage_collector.md Outdated
Comment threadInternalDocs/garbage_collector.md Outdated
generations. The main idea behind this concept is the assumption that most
objects have a very short lifespan and can thus be collected soon after their
creation. This has proven to be very close to the reality of many Python
In order to limit the time each garbage collection takes, the GC implementation

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.

Suggested change
In order to limit the time each garbage collection takes, the GC implementation
In order to bound the length of each garbage collection pause, the GC implementation

Comment threadInternalDocs/garbage_collector.md
Comment threadInternalDocs/garbage_collector.md Outdated
Comment threadInternalDocs/garbage_collector.md Outdated
Comment threadInternalDocs/garbage_collector.md Outdated
Comment on lines +369 to +370
The time taken to scan the young generation can be controlled by controlling the
size of the young, but the size of the old generation cannot be controlled.

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.

Suggested change
The time taken to scan the young generation can be controlled by controlling the
size of the young, but the size of the old generation cannot be controlled.
The time taken to scan the young generation can be controlled by controlling its
size, but the size of the old generation cannot be controlled.

Comment threadInternalDocs/garbage_collector.md Outdated
Each full scavenge is performed in a series of increments.
For each full scavenge, the combined increments will cover the whole heap.

For each increment, the portion of the heap scanned by a single collection is

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.

what does "by a single collection" mean here?

@markshannon
markshannon merged commit 3966d8d into python:mainNov 14, 2024
@markshannon
markshannon deleted the update-gc-internal-docs branch November 18, 2024 14:36
picnixz pushed a commit to picnixz/cpython that referenced this pull request Dec 8, 2024
ebonnal pushed a commit to ebonnal/cpython that referenced this pull request Jan 12, 2025
Sign up for freeto join this conversation on GitHub. Already have an account? Sign in to comment

Labels

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants

@markshannon@iritkatriel@danielhollas