[Python-checkins] r87872 - python/branches/release27-maint/Doc/glossary.rst

[raymond.hettinger]

Author: raymond.hettinger
Date: Sun Jan  9 00:50:39 2011
New Revision: 87872

Log:
Issue 10357: Clarify what it means to be a mapping.

Modified:
   python/branches/release27-maint/Doc/glossary.rst

Modified: python/branches/release27-maint/Doc/glossary.rst
==============================================================================
--- python/branches/release27-maint/Doc/glossary.rst	(original)
+++ python/branches/release27-maint/Doc/glossary.rst	Sun Jan  9 00:50:39 2011
@@ -442,9 +442,11 @@
       :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 <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