[Python-Dev] more details of list comprehension in tutorial than in language reference (original) (raw)
R. David Murray rdmurray at bitdance.com
Fri Jul 16 19:37:08 CEST 2010
- Previous message: [Python-Dev] more details of list comprehension in tutorial than in language reference
- Next message: [Python-Dev] Curious datetime method
- Messages sorted by: [ date ] [ thread ] [ subject ] [ author ]
On Fri, 16 Jul 2010 11:32:25 -0500, Peng Yu <pengyu.ut at gmail.com> wrote:
Since this is related to the document, I think that I should send this to the dev mailing list. Please let me know if this is not appropriate.
It is not, really. Documentation issues should be posted as bugs in the bug tracker under the 'Documentation' component.
If I don't miss anything, I feel that there are much less descriptions of list comprehensions in the language reference (python2.6.5reference.pdf, glossary) than in the tutorial (python2.6.5tutorial.pdf). I think that it deserves at least a subsection in the language reference to make the reference complete. May I suggest the maintainer of the document add such a subsection?
The Language Reference is intentionally terse. If there is important syntactic/semantic information missing then it should be added, but if it is just lacking in the detail of the explanations, then the tutorial is the place for those, and you say that is OK.
-- R. David Murray www.bitdance.com
- Previous message: [Python-Dev] more details of list comprehension in tutorial than in language reference
- Next message: [Python-Dev] Curious datetime method
- Messages sorted by: [ date ] [ thread ] [ subject ] [ author ]