From c4c52dd23d4d365952fb7f653f72f38154e4d331 Mon Sep 17 00:00:00 2001 From: Raymond Hettinger Date: Sat, 8 Jan 2011 23:50:39 +0000 Subject: [PATCH] Issue 10357: Clarify what it means to be a mapping. --- Doc/glossary.rst | 8 +++++--- 1 file changed, 5 insertions(+), 3 deletions(-) diff --git a/Doc/glossary.rst b/Doc/glossary.rst index d16e359afe5..eab35f739c9 100644 --- a/Doc/glossary.rst +++ b/Doc/glossary.rst @@ -442,9 +442,11 @@ Glossary :term:`finder`. See :pep:`302` for details. mapping - A container object (such as :class:`dict`) which supports arbitrary key - lookups using the special method :meth:`__getitem__`. Mappings also - support :meth:`__len__`, :meth:`__iter__`, and :meth:`__contains__`. + A container object that supports arbitrary key lookups and implements the + methods specified in the :class:`Mapping` or :class:`MutableMapping` + :ref:`abstract base classes `. Examples include + :class:`dict`, :class:`collections.defaultdict`, + :class:`collections.OrderedDict` and :class:`collections.Counter`. metaclass The class of a class. Class definitions create a class name, a class