[issue41455] Python Devguide differs from python docs

[Ned Deily]

Ned Deily  added the comment:


New changeset f3b6f3cd9ac6931ae346cf298fae7b691d5656bb by Miss Islington (bot) 
in branch '3.7':
bpo-41455: Provide a link to how the third generation is collected in the GC 
docs (GH-21703) (GH-21788)
https://github.com/python/cpython/commit/f3b6f3cd9ac6931ae346cf298fae7b691d5656bb


--
nosy: +ned.deily

___
Python tracker 

___
___
Python-bugs-list mailing list
Unsubscribe: 
https://mail.python.org/mailman/options/python-bugs-list/archive%40mail-archive.com

[issue41455] Python Devguide differs from python docs

[miss-islington]

miss-islington  added the comment:


New changeset 105cfb5b182da63e8481fcb009e92546d240c6b5 by Miss Islington (bot) 
in branch '3.8':
bpo-41455: Provide a link to how the third generation is collected in the GC 
docs (GH-21703)
https://github.com/python/cpython/commit/105cfb5b182da63e8481fcb009e92546d240c6b5


--

___
Python tracker 

___
___
Python-bugs-list mailing list
Unsubscribe: 
https://mail.python.org/mailman/options/python-bugs-list/archive%40mail-archive.com

[issue41455] Python Devguide differs from python docs

[miss-islington]

miss-islington  added the comment:


New changeset 103ce3debf07a48e79319acd0890be0c53e64fff by Miss Islington (bot) 
in branch '3.9':
bpo-41455: Provide a link to how the third generation is collected in the GC 
docs (GH-21703)
https://github.com/python/cpython/commit/103ce3debf07a48e79319acd0890be0c53e64fff


--

___
Python tracker 

___
___
Python-bugs-list mailing list
Unsubscribe: 
https://mail.python.org/mailman/options/python-bugs-list/archive%40mail-archive.com

[issue41455] Python Devguide differs from python docs

[Pablo Galindo Salgado]

Change by Pablo Galindo Salgado :


--
resolution:  -> fixed
stage: patch review -> resolved
status: open -> closed

___
Python tracker 

___
___
Python-bugs-list mailing list
Unsubscribe: 
https://mail.python.org/mailman/options/python-bugs-list/archive%40mail-archive.com

[issue41455] Python Devguide differs from python docs

[miss-islington]

Change by miss-islington :


--
pull_requests: +20930
pull_request: https://github.com/python/cpython/pull/21788

___
Python tracker 

___
___
Python-bugs-list mailing list
Unsubscribe: 
https://mail.python.org/mailman/options/python-bugs-list/archive%40mail-archive.com

[issue41455] Python Devguide differs from python docs

[miss-islington]

Change by miss-islington :


--
nosy: +miss-islington
nosy_count: 4.0 -> 5.0
pull_requests: +20928
pull_request: https://github.com/python/cpython/pull/21786

___
Python tracker 

___
___
Python-bugs-list mailing list
Unsubscribe: 
https://mail.python.org/mailman/options/python-bugs-list/archive%40mail-archive.com

[issue41455] Python Devguide differs from python docs

[miss-islington]

Change by miss-islington :


--
pull_requests: +20929
pull_request: https://github.com/python/cpython/pull/21787

___
Python tracker 

___
___
Python-bugs-list mailing list
Unsubscribe: 
https://mail.python.org/mailman/options/python-bugs-list/archive%40mail-archive.com

[issue41455] Python Devguide differs from python docs

[Pablo Galindo Salgado]

Pablo Galindo Salgado  added the comment:


New changeset 82ca8fada15b121866530f2cdac1b7055be4a244 by Yaroslav Pankovych in 
branch 'master':
bpo-41455: Provide a link to how the third generation is collected in the GC 
docs (GH-21703)
https://github.com/python/cpython/commit/82ca8fada15b121866530f2cdac1b7055be4a244


--

___
Python tracker 

___
___
Python-bugs-list mailing list
Unsubscribe: 
https://mail.python.org/mailman/options/python-bugs-list/archive%40mail-archive.com

[issue41455] Python Devguide differs from python docs

[Terry J. Reedy]

Change by Terry J. Reedy :


--
nosy: +pablogsal, pitrou

___
Python tracker 

___
___
Python-bugs-list mailing list
Unsubscribe: 
https://mail.python.org/mailman/options/python-bugs-list/archive%40mail-archive.com

[issue41455] Python Devguide differs from python docs

[Terry J. Reedy]

Change by Terry J. Reedy :


--
versions:  -Python 3.5, Python 3.6, Python 3.7

___
Python tracker 

___
___
Python-bugs-list mailing list
Unsubscribe: 
https://mail.python.org/mailman/options/python-bugs-list/archive%40mail-archive.com

[issue41455] Python Devguide differs from python docs

[Yaroslav]

Yaroslav  added the comment:

Here's opened PR. https://github.com/python/cpython/pull/21703

--
nosy:  -python-dev

___
Python tracker 

___
___
Python-bugs-list mailing list
Unsubscribe: 
https://mail.python.org/mailman/options/python-bugs-list/archive%40mail-archive.com

[issue41455] Python Devguide differs from python docs

[Roundup Robot]

Change by Roundup Robot :


--
keywords: +patch
nosy: +python-dev
nosy_count: 2.0 -> 3.0
pull_requests: +20846
stage:  -> patch review
pull_request: https://github.com/python/cpython/pull/21703

___
Python tracker 

___
___
Python-bugs-list mailing list
Unsubscribe: 
https://mail.python.org/mailman/options/python-bugs-list/archive%40mail-archive.com

[issue41455] Python Devguide differs from python docs

[Yaroslav]

Yaroslav  added the comment:

As I can see here 
https://github.com/python/devguide/blob/master/garbage_collector.rst#collecting-the-oldest-generation

> the GC only triggers a full collection of the oldest generation if the ratio 
> long_lived_pending / long_lived_total is above a given value (hardwired to 
> 25%)

But in the python docs here 
https://docs.python.org/3.10/library/gc.html#gc.set_threshold

> When the number of allocations minus the number of deallocations exceeds 
> threshold0, collection starts. Initially only generation 0 is examined. If 
> generation 0 has been examined more than threshold1 times since generation 1 
> has been examined, then generation 1 is examined as well. Similarly, 
> threshold2 controls the number of collections of generation 1 before 
> collecting generation 2.

As I can see here: 
https://github.com/python/cpython/blob/master/Modules/gcmodule.c#L1456 the 
first one is correct.

We should probably fix python docs accordingly.

--

___
Python tracker 

___
___
Python-bugs-list mailing list
Unsubscribe: 
https://mail.python.org/mailman/options/python-bugs-list/archive%40mail-archive.com

[issue41455] Python Devguide differs from python docs

[Yaroslac]

New submission from Yaroslac :

As I can see here 
https://github.com/python/devguide/blob/master/garbage_collector.rst#collecting-the-oldest-generation

> the GC only triggers a full collection of the oldest generation if the ratio 
> long_lived_pending / long_lived_total is above a given value (hardwired to 
> 25%)

But in the python docs here 
https://docs.python.org/3.10/library/gc.html#gc.set_threshold

> When the number of allocations minus the number of deallocations exceeds 
> threshold0, collection starts. Initially only generation 0 is examined. If 
> generation 0 has been examined more than threshold1 times since generation 1 
> has been examined, then generation 1 is examined as well. Similarly, 
> threshold2 controls the number of collections of generation 1 before 
> collecting generation 2.

So, which one is correct?

--
assignee: docs@python
components: Documentation
messages: 374665
nosy: Yaroslav, docs@python
priority: normal
severity: normal
status: open
title: Python Devguide differs from python docs
type: resource usage
versions: Python 3.10, Python 3.5, Python 3.6, Python 3.7, Python 3.8, Python 
3.9

___
Python tracker 

___
___
Python-bugs-list mailing list
Unsubscribe: 
https://mail.python.org/mailman/options/python-bugs-list/archive%40mail-archive.com