From c86e8d9c1734e91f86cd2731ad176042bc9e8987 Mon Sep 17 00:00:00 2001 From: Antoine Pitrou Date: Wed, 1 Aug 2012 14:53:22 +0200 Subject: [PATCH] Improve wording for __hash__ --- Doc/reference/datamodel.rst | 8 ++++---- 1 file changed, 4 insertions(+), 4 deletions(-) diff --git a/Doc/reference/datamodel.rst b/Doc/reference/datamodel.rst index 8dca8aa997b..b2ce4ffe73f 100644 --- a/Doc/reference/datamodel.rst +++ b/Doc/reference/datamodel.rst @@ -1291,7 +1291,7 @@ Basic customization .. note:: - Note by default the :meth:`__hash__` values of str, bytes and datetime + By default, the :meth:`__hash__` values of str, bytes and datetime objects are "salted" with an unpredictable random value. Although they remain constant within an individual Python process, they are not predictable between repeated invocations of Python. @@ -1301,9 +1301,9 @@ Basic customization dict insertion, O(n^2) complexity. See http://www.ocert.org/advisories/ocert-2011-003.html for details. - Changing hash values affects the order in which keys are retrieved from a - dict. Note Python has never made guarantees about this ordering (and it - typically varies between 32-bit and 64-bit builds). + Changing hash values affects the iteration order of dicts, sets and + other mappings. Python has never made guarantees about this ordering + (and it typically varies between 32-bit and 64-bit builds). See also :envvar:`PYTHONHASHSEED`.