New submission from Éric Araujo merwok@netwok.org:
Built-in containers like dict use an ellipsis to represent a recursive item. In the symbols index, “...” only links to the secondary prompt; I think it should also link to a paragraph explaining the display of recursive containers.
---------- assignee: docs@python components: Documentation keywords: easy messages: 116256 nosy: docs@python, eric.araujo priority: normal severity: normal stage: needs patch status: open title: Document ... used in recursive repr of containers versions: Python 2.7, Python 3.1, Python 3.2
_______________________________________ Python tracker report@bugs.python.org http://bugs.python.org/issue9842 _______________________________________
R. David Murray rdmurray@bitdance.com added the comment:
... is also the Ellipsis object, and it is probably even more important that the index cross reference that usage :)
---------- nosy: +r.david.murray
_______________________________________ Python tracker report@bugs.python.org http://bugs.python.org/issue9842 _______________________________________
Changes by Terry J. Reedy tjreedy@udel.edu:
---------- nosy: +terry.reedy
_______________________________________ Python tracker report@bugs.python.org http://bugs.python.org/issue9842 _______________________________________
Changes by Terry J. Reedy tjreedy@udel.edu:
---------- versions: +Python 3.3, Python 3.4 -Python 3.1
_______________________________________ Python tracker report@bugs.python.org http://bugs.python.org/issue9842 _______________________________________
Changes by Éric Araujo merwok@netwok.org:
---------- versions: +Python 3.6, Python 3.7 -Python 3.2, Python 3.3, Python 3.4
_______________________________________ Python tracker report@bugs.python.org https://bugs.python.org/issue9842 _______________________________________
Changes by Mike Hoy veozev@gmail.com:
---------- nosy: +vexoxev
_______________________________________ Python tracker report@bugs.python.org https://bugs.python.org/issue9842 _______________________________________
Change by Pablo Galindo Salgado pablogsal@gmail.com:
---------- keywords: +patch pull_requests: +4033 stage: needs patch -> patch review
_______________________________________ Python tracker report@bugs.python.org https://bugs.python.org/issue9842 _______________________________________
Raymond Hettinger raymond.hettinger@gmail.com added the comment:
Since the appearance of reprs is not guaranteed. I don't think this should be documented (because doing so makes it a guaranteed behavior). In fact, the appearance has changed over time from ... to [...] in and may change at some point to <...> so that it can't be confused with an actual Ellipsis object. At best this should be a FAQ entry or we can defer to behaviors that are documented and guaranteed (such as reprlib.recursive_repr() and its default fillvalue).
I concur with David Murray that the Ellipsis object should be indexed and cross-referenced.
---------- nosy: +rhettinger
_______________________________________ Python tracker report@bugs.python.org https://bugs.python.org/issue9842 _______________________________________
miss-islington mariatta.wijaya+miss-islington@gmail.com added the comment:
New changeset b4db249c9544fc4425c32feb86d610f3224ca3d8 by Miss Islington (bot) (Pablo Galindo) in branch 'master': bpo-9842: Add cross-reference to the ellipsis object (GH-4063) https://github.com/python/cpython/commit/b4db249c9544fc4425c32feb86d610f3224...
---------- nosy: +miss-islington
_______________________________________ Python tracker report@bugs.python.org https://bugs.python.org/issue9842 _______________________________________
Change by Serhiy Storchaka storchaka+cpython@gmail.com:
---------- pull_requests: +9634
_______________________________________ Python tracker report@bugs.python.org https://bugs.python.org/issue9842 _______________________________________
Serhiy Storchaka storchaka+cpython@gmail.com added the comment:
PR 10330 adds few references for using an ellipsis as a placeholder.
---------- nosy: +serhiy.storchaka
_______________________________________ Python tracker report@bugs.python.org https://bugs.python.org/issue9842 _______________________________________
Serhiy Storchaka storchaka+cpython@gmail.com added the comment:
Could anybody please look at PR 10330?
----------
_______________________________________ Python tracker report@bugs.python.org https://bugs.python.org/issue9842 _______________________________________
Serhiy Storchaka storchaka+cpython@gmail.com added the comment:
New changeset 6c48bf2d9e1e18dfbfa35f7582ddd32f11f75129 by Serhiy Storchaka in branch 'master': bpo-9842: Add references for using "..." as a placeholder to the index. (GH-10330) https://github.com/python/cpython/commit/6c48bf2d9e1e18dfbfa35f7582ddd32f11f...
----------
_______________________________________ Python tracker report@bugs.python.org https://bugs.python.org/issue9842 _______________________________________
Change by miss-islington mariatta.wijaya+miss-islington@gmail.com:
---------- pull_requests: +9855
_______________________________________ Python tracker report@bugs.python.org https://bugs.python.org/issue9842 _______________________________________
Change by miss-islington mariatta.wijaya+miss-islington@gmail.com:
---------- pull_requests: +9856
_______________________________________ Python tracker report@bugs.python.org https://bugs.python.org/issue9842 _______________________________________
miss-islington mariatta.wijaya+miss-islington@gmail.com added the comment:
New changeset f8f9915f9585a5d4f4a4457ef43ac66607c5f380 by Miss Islington (bot) in branch '3.7': bpo-9842: Add references for using "..." as a placeholder to the index. (GH-10330) https://github.com/python/cpython/commit/f8f9915f9585a5d4f4a4457ef43ac66607c...
----------
_______________________________________ Python tracker report@bugs.python.org https://bugs.python.org/issue9842 _______________________________________
miss-islington mariatta.wijaya+miss-islington@gmail.com added the comment:
New changeset dac5124ba498b51a2c46e2bda751150ae244ed47 by Miss Islington (bot) in branch '3.6': bpo-9842: Add references for using "..." as a placeholder to the index. (GH-10330) https://github.com/python/cpython/commit/dac5124ba498b51a2c46e2bda751150ae24...
----------
_______________________________________ Python tracker report@bugs.python.org https://bugs.python.org/issue9842 _______________________________________
Change by Serhiy Storchaka storchaka+cpython@gmail.com:
---------- resolution: -> fixed stage: patch review -> resolved status: open -> closed
_______________________________________ Python tracker report@bugs.python.org https://bugs.python.org/issue9842 _______________________________________
-
Mike Hoy -
miss-islington
-
Pablo Galindo Salgado
-
R. David Murray
-
Raymond Hettinger
-
Serhiy Storchaka
-
Terry J. Reedy
-
Éric Araujo