Clarify how to add a field to a named tuple.

diff --git a/Doc/library/collections.rst b/Doc/library/collections.rst
index b276ab02d9ce931aab7a1ce6f61e77de9e7971e3..1e213fb9cb750fd854df10da4bfa4ed9018b1d9a 100644 (file)
--- a/Doc/library/collections.rst
+++ b/Doc/library/collections.rst
@@ -538,7 +538,7 @@ faster versions that bypass error-checking and that localize variable access::
 Subclassing is not useful for adding new, stored fields.  Instead, simply
 create a new named tuple type from the :attr:`_fields` attribute::
 
-    >>> Pixel = namedtuple('Pixel', Point._fields + Color._fields)
+    >>> Point3D = namedtuple('Point3D', Point._fields + ('z',))
 
 Default values can be implemented by using :meth:`_replace` to
 customize a prototype instance::

diff --git a/Lib/collections.py b/Lib/collections.py
index 47b0397d0b89cc52e0a107d9948b2ccae8f4e1df..267c39f9e43d0aef29210afbcd2a2eaadcc1b7a7 100644 (file)
--- a/Lib/collections.py
+++ b/Lib/collections.py
@@ -137,6 +137,9 @@ if __name__ == '__main__':
 
     print Point(11, 22)._replace(x=100)
 
+    Point3D = namedtuple('Point3D', Point._fields + ('z',))
+    print Point3D.__doc__
+
     import doctest
     TestResults = namedtuple('TestResults', 'failed attempted')
     print TestResults(*doctest.testmod())