Issue #21545: Add .pop example and tweak comment about pure mutation methods.

Patch prepared by David Harrigan.

diff --git a/Doc/tutorial/datastructures.rst b/Doc/tutorial/datastructures.rst
index 28e6ad71b9545e5a2ebca9cfab53e44819c8ec19..02ba11509f2ca4f1e3f402d3c40fa10e7b51710d 100644 (file)
--- a/Doc/tutorial/datastructures.rst
+++ b/Doc/tutorial/datastructures.rst
@@ -99,6 +99,15 @@ An example that uses most of the list methods::
    >>> a.sort()
    >>> a
    [-1, 1, 66.25, 333, 333, 1234.5]
+   >>> a.pop()
+   1234.5
+   >>> a
+   [-1, 1, 66.25, 333, 333]
+
+You might have noticed that methods like ``insert``, ``remove`` or ``sort`` that
+only modify the list have no return value printed -- they return the default
+``None``. [1]_  This is a design principle for all mutable data structures in
+Python.
 
 
 .. _tut-lists-as-stacks:

diff --git a/Misc/ACKS b/Misc/ACKS
index c8c388079701e5fbd9ad3140fddba68af78b1f90..9ae334149090fcc8e53834bab9cea93ea289cdf3 100644 (file)
--- a/Misc/ACKS
+++ b/Misc/ACKS
@@ -506,6 +506,7 @@ Barry Hantman
 Lynda Hardman
 Derek Harland
 Jason Harper
+David Harrigan
 Brian Harring
 Jonathan Hartley
 Travis B. Hartwell