]> granicus.if.org Git - python/commitdiff
Issue #25286: Dictionary views are not sequences
authorMartin Panter <vadmium+py@gmail.com>
Wed, 7 Oct 2015 09:56:46 +0000 (09:56 +0000)
committerMartin Panter <vadmium+py@gmail.com>
Wed, 7 Oct 2015 09:56:46 +0000 (09:56 +0000)
Also change glossary heading from view

Doc/glossary.rst
Doc/library/collections.abc.rst

index 1de86ef8c02684cd1219aaf8d56d293885509ec5..c8af5f30907b8793c22990320b01881235298a12 100644 (file)
@@ -183,6 +183,14 @@ Glossary
       keys can be any object with :meth:`__hash__` and :meth:`__eq__` methods.
       Called a hash in Perl.
 
+   dictionary view
+      The objects returned from :meth:`dict.keys`, :meth:`dict.values`, and
+      :meth:`dict.items` are called dictionary views. They provide a dynamic
+      view on the dictionary’s entries, which means that when the dictionary
+      changes, the view reflects these changes. To force the
+      dictionary view to become a full list use ``list(dictview)``.  See
+      :ref:`dict-views`.
+
    docstring
       A string literal which appears as the first expression in a class,
       function or module.  While ignored when the suite is executed, it is
@@ -853,13 +861,6 @@ Glossary
       ``'\r'``.  See :pep:`278` and :pep:`3116`, as well as
       :func:`bytes.splitlines` for an additional use.
 
-   view
-      The objects returned from :meth:`dict.keys`, :meth:`dict.values`, and
-      :meth:`dict.items` are called dictionary views.  They are lazy sequences
-      that will see changes in the underlying dictionary.  To force the
-      dictionary view to become a full list use ``list(dictview)``.  See
-      :ref:`dict-views`.
-
    virtual environment
       A cooperatively isolated runtime environment that allows Python users
       and applications to install and upgrade Python distribution packages
index 99c43113e3d0138414dab8503c4a71aae40cd3db..d73f05ae56b9a884f069d68544fb7ec289c3ebaa 100644 (file)
@@ -122,7 +122,7 @@ ABC                        Inherits from          Abstract Methods        Mixin
            KeysView
            ValuesView
 
-   ABCs for mapping, items, keys, and values :term:`views <view>`.
+   ABCs for mapping, items, keys, and values :term:`views <dictionary view>`.
 
 
 These ABCs allow us to ask classes or instances if they provide