[Python-checkins] bpo-33609: small wording fixes to dict ordering docs (#7497)

Yury Selivanov webhook-mailer at python.org
Thu Jun 7 20:38:25 EDT 2018


https://github.com/python/cpython/commit/9b0d4d04a15a97a1055f1b729f14e9257f149fd3
commit: 9b0d4d04a15a97a1055f1b729f14e9257f149fd3
branch: 3.7
author: Miss Islington (bot) <31488909+miss-islington at users.noreply.github.com>
committer: Yury Selivanov <yury at magic.io>
date: 2018-06-07T20:38:22-04:00
summary:

bpo-33609: small wording fixes to dict ordering docs (#7497)

A few wording improvements to dict ordering documentation.
(cherry picked from commit d3ed67d14ed401dfe2b5d07b6941adc3ecacb268)

Co-authored-by: Neil Schemenauer <nas-github at arctrix.com>

files:
M Doc/library/stdtypes.rst

diff --git a/Doc/library/stdtypes.rst b/Doc/library/stdtypes.rst
index 90864d497b52..62373c1810c5 100644
--- a/Doc/library/stdtypes.rst
+++ b/Doc/library/stdtypes.rst
@@ -4229,9 +4229,8 @@ pairs within braces, for example: ``{'jack': 4098, 'sjoerd': 4127}`` or ``{4098:
    value)`` pairs. Order comparisons ('<', '<=', '>=', '>') raise
    :exc:`TypeError`.
 
-   Dict preserves insertion order.  Note that updating key doesn't affects the
-   order.  On the other hand, keys added after deletion are inserted to the
-   last. ::
+   Dictionaries preserve insertion order.  Note that updating a key does not
+   affect the order.  Keys added after deletion are inserted at the end. ::
 
       >>> d = {"one": 1, "two": 2, "three": 3, "four": 4}
       >>> d
@@ -4249,7 +4248,7 @@ pairs within braces, for example: ``{'jack': 4098, 'sjoerd': 4127}`` or ``{4098:
       {'one': 42, 'three': 3, 'four': 4, 'two': None}
 
    .. versionchanged:: 3.7
-      Dict order is guaranteed to be insertion order.  This behavior was
+      Dictionary order is guaranteed to be insertion order.  This behavior was
       implementation detail of CPython from 3.6.
 
 .. seealso::
@@ -4288,7 +4287,7 @@ support membership tests:
    a :exc:`RuntimeError` or fail to iterate over all entries.
 
    .. versionchanged:: 3.7
-      Dict order is guaranteed to be insertion order.
+      Dictionary order is guaranteed to be insertion order.
 
 .. describe:: x in dictview
 
@@ -4702,3 +4701,4 @@ types, where they are relevant.  Some of these are not reported by the
 
 .. [5] To format only a tuple you should therefore provide a singleton tuple whose only
    element is the tuple to be formatted.
+



More information about the Python-checkins mailing list