[docs] Wrong references to deprecated find_module instead of find_spec (issue 23936)

takowl at gmail.com takowl at gmail.com
Fri Dec 4 07:42:01 EST 2015


http://bugs.python.org/review/23936/diff/16097/Doc/glossary.rst
File Doc/glossary.rst (right):

http://bugs.python.org/review/23936/diff/16097/Doc/glossary.rst#newcode312
Doc/glossary.rst:312: implement at least one of the methods
:meth:`find_spec`,
On 2015/12/04 00:51:30, vadmium wrote:
> Which find_spec()? MetaPathFinder.find_spec() or
PathEntryFinder.find_spec(). Or
> is the assumed signature such that the differences do not matter?

That depends on which kind of finder it is. My understanding is that as
of Python 3.3, 'finder' is a rather abstract notion that encompasses the
two distinct kinds.

Maybe 'finder' should be removed from the glossary entirely, and other
parts of the docs should be explicit about which type of finder they
want. But if there is anywhere appropriate to describe the more abstract
notion of a 'finder', it's probably in the glossary.

http://bugs.python.org/review/23936/diff/16097/Doc/library/sys.rst
File Doc/library/sys.rst (right):

http://bugs.python.org/review/23936/diff/16097/Doc/library/sys.rst#newcode782
Doc/library/sys.rst:782: A list of :term:`meta path finder` objects that
have their :meth:`find_spec`
On 2015/12/04 00:51:30, vadmium wrote:
> :meth:`~importlib.abc.MetaPathFinder.find_spec`; also twice below

Done.

http://bugs.python.org/review/23936/


More information about the docs mailing list