Ole Laursen o...@iola.dk added the comment:
Okay. I can only say that while the current docstrings are likely good
reminders for you, knowing Python in and out, they were pretty useless to me as
documentation, which I believe docstrings should be, they're called docstrings,
after all, not
Raymond Hettinger rhettin...@users.sourceforge.net added the comment:
After more thought, am leaving the doc strings as-is. They are succinct and
accurate. I have updated the sorting how-to to more thoroughly cover the
basics of sorting.
--
resolution: - wont fix
status: open -
Ole Laursen o...@iola.dk added the comment:
OK, thanks! :) Sorry about the unintended nosy list removal, my browser
got me there.
--
___
Python tracker rep...@bugs.python.org
http://bugs.python.org/issue7257
___
New submission from Ole Laursen o...@iola.dk:
On my Python 3.1, help() for sorted returns
sort(...)
L.sort(key=None, reverse=False) -- stable sort *IN PLACE*
sorted(...)
sorted(iterable, key=None, reverse=False) -- new sorted list
Kindly suggest this be expanded. Here's some text:
Georg Brandl ge...@python.org added the comment:
Raymond, do you have an opinion on this?
--
assignee: georg.brandl - rhettinger
nosy: +rhettinger
___
Python tracker rep...@bugs.python.org
http://bugs.python.org/issue7257
Raymond Hettinger rhettin...@users.sourceforge.net added the comment:
I'm inclined to leave the on-line help docstring as-is (pretty much
everywhere, we adopt a style of terse reminders instead of lengthy prose
with examples).
Instead, was thinking of updating the sorting how-to and providing
Changes by Georg Brandl ge...@python.org:
--
nosy: +rhettinger
___
Python tracker rep...@bugs.python.org
http://bugs.python.org/issue7257
___
___
Python-bugs-list mailing
Ole Laursen o...@iola.dk added the comment:
If you think it's too long, here's a shorter version:
Sorts sequence in place with a fast stable sort, returning None. key is
a function for extracting a comparison key from each element, e.g.
key=lambda x: x['name'] or key=str.lower. reverse=True
Raymond Hettinger rhettin...@users.sourceforge.net added the comment:
Will look at it and make an update, but not right away.
--
___
Python tracker rep...@bugs.python.org
http://bugs.python.org/issue7257
___