[issue26011] Document necesities for cmp argument of sorted

[Serhiy Storchaka]

Change by Serhiy Storchaka :


--
resolution:  -> not a bug
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

[issue26011] Document necesities for cmp argument of sorted

[Batuhan]

Batuhan  added the comment:

I agree with @josh.r, also for the key (and reverse), they are documented in 
py3.8. IMHO this issue can be resolved as not a bug.

--
nosy: +BTaskaya

___
Python tracker 

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

[issue26011] Document necesities for cmp argument of sorted

[Karl Richter]

New submission from Karl Richter:

The docstring of `sorted` doesn't explain what can be passed to the `cmp` and 
`key` argument of `sorted`.

--
assignee: docs@python
components: Documentation
messages: 257505
nosy: docs@python, krichter
priority: normal
severity: normal
status: open
title: Document necesities for cmp argument of sorted
type: enhancement
versions: Python 2.7

___
Python tracker 

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

[issue26011] Document necesities for cmp argument of sorted

[Josh Rosenberg]

Josh Rosenberg added the comment:

The docstring doesn't give details, but many docstrings don't. The docs 
themselves do; not sure it's a good idea to expand every docstring into 
complete documentation; if you don't know the function you read the real docs, 
the docstrings are useful as a reminder for stuff like argument order and 
names, higher logic, etc., without getting into details.

cmp is almost certainly not going to be documented further in the docstrings; 
2.7 is in bug fix only mode IIRC (and even then, mostly security fix only), and 
tweaking docstrings that aren't wrong, just less detailed than you might like 
isn't likely to meet the bar.

--
nosy: +josh.r

___
Python tracker 

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