Title: Update Index for set, dict, and generator 'comprehensions'
Type: behavior Stage: patch review
Components: Documentation Versions: Python 3.7, Python 3.6
Status: open Resolution:
Dependencies: Superseder:
Assigned To: docs@python Nosy List: docs@python, louielu, r.david.murray, terry.reedy
Priority: normal Keywords: easy

Created on 2017-04-04 18:01 by terry.reedy, last changed 2017-06-21 20:18 by r.david.murray.

Pull Requests
URL Status Linked Edit
PR 995 closed louielu, 2017-04-05 05:08
Messages (3)
msg291129 - (view) Author: Terry J. Reedy (terry.reedy) * (Python committer) Date: 2017-04-04 18:01
The index currently has


with *list* linked to 6.2.5 List displays.  I suggest:

1. Link *comprehensions* to 6.2.4. Displays for lists, sets and dictionaries
2. Add subentries *set*, *dict*, and *generator* linked to
2a. 6.2.6. Set displays
2b. 6.2.7. Dictionary displays
2c. 6.2.8. Generator expressions

We don't *call* generator expressions 'generator comprehensions', but that is what they are syntactically and one looking for 'comprehensions' should be able to find them there.

There is already

*list comprehensions*

with 'list' and 'list comprehensions' linked to glossary entries, while 'list, comprehensions' links to the same section as 'comprehensions, list'.  

3. Add 'set/dictionary, comprehensions' sub-entries linked like 'list, com
4. Add Glossary entries and links like 'list comprehensions'
msg291132 - (view) Author: Terry J. Reedy (terry.reedy) * (Python committer) Date: 2017-04-04 18:33
See #29983 for expanding the title of the 'atoms' section containing subsections on comprehensions.
msg296580 - (view) Author: R. David Murray (r.david.murray) * (Python committer) Date: 2017-06-21 20:18
On the PR Berker wrote:

   I'm wondering if we should still advertise the use of set([...]). We replaced all instances of it with set literals in the stdlib.

set([...]) is part of the language, and the python documentation is also a specification of the language, so I think the reference *must* stay.
Date User Action Args
2017-06-21 20:18:14r.david.murraysetnosy: + r.david.murray
messages: + msg296580
2017-06-07 18:07:16Mariattasetstage: needs patch -> patch review
2017-04-05 05:08:07louielusetpull_requests: + pull_request1170
2017-04-05 04:35:34louielusetnosy: + louielu
2017-04-04 18:33:04terry.reedysetmessages: + msg291132
title: Update Index set, dict, and generator 'comprehensions' -> Update Index for set, dict, and generator 'comprehensions'
2017-04-04 18:01:11terry.reedycreate