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 josh.r
Recipients docs@python, josh.r, krichter
Date 2016-01-05.05:15:48
SpamBayes Score -1.0
Marked as misclassified Yes
Message-id <1451970949.13.0.154622224116.issue26011@psf.upfronthosting.co.za>
In-reply-to
Content
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.
History
Date User Action Args
2016-01-05 05:15:49josh.rsetrecipients: + josh.r, docs@python, krichter
2016-01-05 05:15:49josh.rsetmessageid: <1451970949.13.0.154622224116.issue26011@psf.upfronthosting.co.za>
2016-01-05 05:15:49josh.rlinkissue26011 messages
2016-01-05 05:15:48josh.rcreate