summaryrefslogtreecommitdiffstats
diff options
context:
space:
mode:
authorÉric Araujo <merwok@netwok.org>2011-08-19 07:07:46 (GMT)
committerÉric Araujo <merwok@netwok.org>2011-08-19 07:07:46 (GMT)
commit04ac59a22a16e2c95a6a86d0127c29016431819e (patch)
tree092053dd214346f9c1ed99c895587937d946dd1d
parent4d71a66a01fec95556bc7f61f7e9ac29d66efe76 (diff)
downloadcpython-04ac59a22a16e2c95a6a86d0127c29016431819e.zip
cpython-04ac59a22a16e2c95a6a86d0127c29016431819e.tar.gz
cpython-04ac59a22a16e2c95a6a86d0127c29016431819e.tar.bz2
Mention virtual subclasses in the glossary entry for ABCs (#12256).
I added a link from the term “virtual subclass” to the glossary entry for ABCs but this was not enough, now the glossary briefly defines “virtual” and links to the abc module doc which contains more mentions of virtual subclasses.
-rw-r--r--Doc/glossary.rst5
1 files changed, 4 insertions, 1 deletions
diff --git a/Doc/glossary.rst b/Doc/glossary.rst
index 9d63bc4..63d4c2b 100644
--- a/Doc/glossary.rst
+++ b/Doc/glossary.rst
@@ -30,7 +30,10 @@ Glossary
Abstract base classes complement :term:`duck-typing` by
providing a way to define interfaces when other techniques like
:func:`hasattr` would be clumsy or subtly wrong (for example with
- :ref:`magic methods <special-lookup>`). Python comes with many built-in ABCs for
+ :ref:`magic methods <special-lookup>`). ABCs introduce virtual
+ subclasses, which are classes that don't inherit from a class but are
+ still recognized by :func:`isinstance` and :func:`issubclass`; see the
+ :mod:`abc` module documentation. Python comes with many built-in ABCs for
data structures (in the :mod:`collections` module), numbers (in the
:mod:`numbers` module), streams (in the :mod:`io` module), import finders
and loaders (in the :mod:`importlib.abc` module). You can create your own