[docs] Backport set and dictionary comprehensions in tutorial to 2.7 (issue 16470)

ezio.melotti at gmail.com ezio.melotti at gmail.com
Wed Nov 14 09:32:19 CET 2012


If these are documented in the 3.x tutorial, you could backport the
changes from there.


http://bugs.python.org/review/16470/diff/6577/Doc/tutorial/datastructures.rst
File Doc/tutorial/datastructures.rst (right):

http://bugs.python.org/review/16470/diff/6577/Doc/tutorial/datastructures.rst#newcode490
Doc/tutorial/datastructures.rst:490: Curly braces or the :func:`set`
function can be used to create sets.  Note: To
On 2012/11/14 09:23:23, berkerpeksag wrote:
> It would be good to use `.. note::` here.
> 
> See http://sphinx-doc.org/markup/para.html#directive-note

Not necessary IMHO.  The "note" directive should be used sparingly.

http://bugs.python.org/review/16470/diff/6577/Doc/tutorial/datastructures.rst#newcode520
Doc/tutorial/datastructures.rst:520: Like :ref:`for lists
<tut-listcomps>`, there is a set comprehension syntax::
The first part of the sentence doesn't sound too good to me.
Maybe it could be rephrased to something like "Similarly to list
comprehensions, set comprehensions are also supported::"

http://bugs.python.org/review/16470/


More information about the docs mailing list