[issue25337] weakref.finalize documentation refers to old interpreter shutdown behavior

[Cheryl Sabella]

Cheryl Sabella  added the comment:

Adding @pitrou to the nosylist as he implemented PEP442 in issue 18112.  If he 
agrees with the proposed change, then I believe this can be marked as 'easy'.

--
nosy: +cheryl.sabella, pitrou
versions: +Python 3.7, Python 3.8 -Python 3.4, Python 3.5, Python 3.6

___
Python tracker 

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

[issue25337] weakref.finalize documentation refers to old interpreter shutdown behavior

[Josh Rosenberg]

New submission from Josh Rosenberg:

In weakref.finalize's documentation ( 
https://docs.python.org/3/library/weakref.html#weakref.finalize ), it says:

"A finalizer will never invoke its callback during the later part of the 
interpreter shutdown when module globals are liable to have been replaced by 
None."

While it may not invoke its callback during shutdown (I don't know if it does, 
or if it should), as of Python 3.4 (which is when weakref.finalize was 
introduced), module globals aren't set to None anymore, right? 
https://docs.python.org/3/whatsnew/3.4.html#whatsnew-pep-442

Presumably the docs should be updated not to mention a behavior that no longer 
occurs (and if it will or should be invoked, weakref.finalizer should have 
documentation or code updated).

--
assignee: docs@python
components: Documentation
messages: 252504
nosy: docs@python, josh.r
priority: normal
severity: normal
status: open
title: weakref.finalize documentation refers to old interpreter shutdown 
behavior
versions: Python 3.4, Python 3.5, Python 3.6

___
Python tracker 

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