[issue21575] list.sort() should show arguments in tutorial

2014-06-29 Thread Ezio Melotti
Changes by Ezio Melotti ezio.melo...@gmail.com: -- stage: - resolved type: - enhancement ___ Python tracker rep...@bugs.python.org http://bugs.python.org/issue21575 ___

[issue21575] list.sort() should show arguments in tutorial

2014-05-26 Thread Jan-Philip Gehrcke
Jan-Philip Gehrcke added the comment: I have updated the patch with a cross-reference to the sorted() built-in, which explains the arguments. W.r.t. to Éric's suggestion: the sorted() doc refers to the sorting howto in the wiki. Now everything is connected. -- Added file:

[issue21575] list.sort() should show arguments in tutorial

2014-05-26 Thread Raymond Hettinger
Changes by Raymond Hettinger raymond.hettin...@gmail.com: -- assignee: docs@python - rhettinger ___ Python tracker rep...@bugs.python.org http://bugs.python.org/issue21575 ___

[issue21575] list.sort() should show arguments in tutorial

2014-05-26 Thread Roundup Robot
Roundup Robot added the comment: New changeset 1b96949bfc97 by Raymond Hettinger in branch 'default': Issue 21575: Show list.sort() arguments in the tutorial. http://hg.python.org/cpython/rev/1b96949bfc97 -- nosy: +python-dev ___ Python tracker

[issue21575] list.sort() should show arguments in tutorial

2014-05-26 Thread Roundup Robot
Roundup Robot added the comment: New changeset be77b213ace0 by Raymond Hettinger in branch '2.7': Issue 21575: Show list.sort() arguments in the tutorial. http://hg.python.org/cpython/rev/be77b213ace0 -- ___ Python tracker rep...@bugs.python.org

[issue21575] list.sort() should show arguments in tutorial

2014-05-26 Thread Raymond Hettinger
Changes by Raymond Hettinger raymond.hettin...@gmail.com: -- resolution: - fixed status: open - closed ___ Python tracker rep...@bugs.python.org http://bugs.python.org/issue21575 ___

[issue21575] list.sort() should show arguments in tutorial

2014-05-25 Thread Jan-Philip Gehrcke
New submission from Jan-Philip Gehrcke: 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

[issue21575] list.sort() should show arguments in tutorial

2014-05-25 Thread Éric Araujo
Éric Araujo added the comment: I assume it is on purpose that the tutorial does not show all methods with all their arguments. It could overwhelm readers with too much information, and would also duplicate the full doc that’s in the reference. A link from this tutorial page to the list

[issue21575] list.sort() should show arguments in tutorial

2014-05-25 Thread Raymond Hettinger
Raymond Hettinger added the comment: Is there a reason why we do not show the arguments there? It was likely an oversight. I think it should be updated so that people know the options are there. -- nosy: +rhettinger ___ Python tracker

[issue21575] list.sort() should show arguments in tutorial

2014-05-25 Thread Raymond Hettinger
Changes by Raymond Hettinger raymond.hettin...@gmail.com: -- keywords: +patch Added file: http://bugs.python.org/file35358/sort_tut.diff ___ Python tracker rep...@bugs.python.org http://bugs.python.org/issue21575