]> granicus.if.org Git - python/commitdiff
#6034: clarify __reversed__ doc.
authorGeorg Brandl <georg@python.org>
Sat, 16 May 2009 11:13:21 +0000 (11:13 +0000)
committerGeorg Brandl <georg@python.org>
Sat, 16 May 2009 11:13:21 +0000 (11:13 +0000)
Doc/reference/datamodel.rst

index b87909df27c4517aa364ca60ec82f47b6a6b5e80..5d612b814edc5c9e76736c7824b41edbc5ea0f2f 100644 (file)
@@ -1869,11 +1869,11 @@ sequences, it should iterate through the values.
    reverse iteration.  It should return a new iterator object that iterates
    over all the objects in the container in reverse order.
 
-   If the :meth:`__reversed__` method is not provided, the
-   :func:`reversed` builtin will fall back to using the sequence protocol
-   (:meth:`__len__` and :meth:`__getitem__`).  Objects should normally
-   only provide :meth:`__reversed__` if they do not support the sequence
-   protocol and an efficient implementation of reverse iteration is possible.
+   If the :meth:`__reversed__` method is not provided, the :func:`reversed`
+   builtin will fall back to using the sequence protocol (:meth:`__len__` and
+   :meth:`__getitem__`).  Objects that support the sequence protocol should
+   only provide :meth:`__reversed__` if they can provide an implementation
+   that is more efficient than the one provided by :func:`reversed`.
 
    .. versionadded:: 2.6