[docs] [issue25337] weakref.finalize documentation refers to old interpreter shutdown behavior
report at bugs.python.org
Thu Oct 8 04:20:40 CEST 2015
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 at python
nosy: docs at python, josh.r
title: weakref.finalize documentation refers to old interpreter shutdown behavior
versions: Python 3.4, Python 3.5, Python 3.6
Python tracker <report at bugs.python.org>
More information about the docs