[Python-Dev] more details of list comprehension in tutorial than in language reference

[R. David Murray]

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
> (python_2.6.5_reference.pdf, glossary) than in the tutorial
> (python_2.6.5_tutorial.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