# HG changeset patch
# User J. H. Palmieri
# Date 1300910500 25200
# Node ID 8e4982d972cb5e788833092cea197a5ce849422f
# Parent d60c4a0bb2b2bd7f3d18ef252ab1eede21ca31cd
#10470: document the fact that list(X) doesn't work as well as X.list().
diff -r d60c4a0bb2b2 -r 8e4982d972cb sage/structure/parent.pyx
--- a/sage/structure/parent.pyx Wed Jan 12 08:22:32 2011 -0800
+++ b/sage/structure/parent.pyx Wed Mar 23 13:01:40 2011 -0700
@@ -1074,6 +1074,11 @@
Traceback (most recent call last):
...
NotImplementedError
+
+ Note that if an object ``X`` is infinite, then running
+ ``X.list()`` will raise an appropriate error, while running
+ ``list(X)`` will run indefinitely. For many Sage objects
+ ``X``, using ``X.list()`` is preferable to using ``list(X)``.
"""
try:
if self._list is not None: