[issue34259] Improve docstring of list.sort

[Raymond Hettinger]

Change by Raymond Hettinger :


--
resolution:  -> fixed
stage:  -> resolved
status: open -> closed

___
Python tracker 

___
___
Python-bugs-list mailing list
Unsubscribe: 
https://mail.python.org/mailman/options/python-bugs-list/archive%40mail-archive.com

[issue34259] Improve docstring of list.sort

[Raymond Hettinger]

Change by Raymond Hettinger :


--
assignee:  -> rhettinger
nosy: +rhettinger

___
Python tracker 

___
___
Python-bugs-list mailing list
Unsubscribe: 
https://mail.python.org/mailman/options/python-bugs-list/archive%40mail-archive.com

[issue34259] Improve docstring of list.sort

[Josh Rosenberg]

Josh Rosenberg  added the comment:

Copying from the sorted built-in's docstring would make sense here, given that 
sorted is implemented in terms of list.sort in the first place.

--
nosy: +josh.r

___
Python tracker 

___
___
Python-bugs-list mailing list
Unsubscribe: 
https://mail.python.org/mailman/options/python-bugs-list/archive%40mail-archive.com

[issue34259] Improve docstring of list.sort

[Tim Hoffmann]

New submission from Tim Hoffmann :

The current docstring of list.sort is just "Stable sort *IN PLACE*."

This is missing a description of the arguments key and reverse. Also a short 
explanation of stable and in-place would be helpful for less experienced users.

--
messages: 322545
nosy: timhoffm
priority: normal
pull_requests: 8036
severity: normal
status: open
title: Improve docstring of list.sort
type: enhancement
versions: Python 3.8

___
Python tracker 

___
___
Python-bugs-list mailing list
Unsubscribe: 
https://mail.python.org/mailman/options/python-bugs-list/archive%40mail-archive.com