This issue tracker has been migrated to GitHub, and is currently read-only.
For more information, see the GitHub FAQs in the Python's Developer Guide.

Author jgehrcke
Recipients docs@python, eric.araujo, ezio.melotti, georg.brandl, jgehrcke
Date 2014-05-25.12:36:24
SpamBayes Score -1.0
Marked as misclassified Yes
Message-id <1401021385.55.0.784639264396.issue21575@psf.upfronthosting.co.za>
In-reply-to
Content
Currently, the tutorial for the list sort method does not show allowed arguments:


    list.sort()
        Sort the items of the list in place.

(see e.g. https://docs.python.org/3.4/tutorial/datastructures.html)

Is there a reason why we do not show the arguments there? For simplicity? One should note that a web search for Python's list methods ranks that page pretty high. We could list the defaults, as in the built-in help:

     L.sort(cmp=None, key=None, reverse=False)

And could link to https://docs.python.org/2/library/functions.html#sorted for an explanation.
History
Date User Action Args
2014-05-25 12:36:25jgehrckesetrecipients: + jgehrcke, georg.brandl, ezio.melotti, eric.araujo, docs@python
2014-05-25 12:36:25jgehrckesetmessageid: <1401021385.55.0.784639264396.issue21575@psf.upfronthosting.co.za>
2014-05-25 12:36:25jgehrckelinkissue21575 messages
2014-05-25 12:36:24jgehrckecreate