summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorÉric Araujo <merwok@netwok.org>2011-08-19 09:07:46 +0200
committerÉric Araujo <merwok@netwok.org>2011-08-19 09:07:46 +0200
commit04ac59a22a16e2c95a6a86d0127c29016431819e (patch)
tree092053dd214346f9c1ed99c895587937d946dd1d
parent4d71a66a01fec95556bc7f61f7e9ac29d66efe76 (diff)
downloadcpython-git-04ac59a22a16e2c95a6a86d0127c29016431819e.tar.gz
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 9d63bc49c6..63d4c2bd49 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