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.rs... File Doc/tutorial/datastructures.rst (right): http://bugs.python.org/review/16470/diff/6577/Doc/tutorial/datastructures.rs... 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.rs... 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/