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 Doug Hoskisson
Recipients Doug Hoskisson, docs@python, r.david.murray, rhettinger, vstinner
Date 2016-07-27.19:40:41
SpamBayes Score -1.0
Marked as misclassified Yes
Message-id <1469648441.39.0.554786795426.issue27624@psf.upfronthosting.co.za>
In-reply-to
Content
My suggestion was not to delete the "approximate" entirely. Just move it out of the first sentence to make it more consistent with the other documentation.

This is the model I'm seeing in empty() and full():

The first sentence is something simple and direct (without nebulous words that will make people wonder what it means), and then after that, comment on the race-condition stuff.

I think that documentation is good, and it would be good to follow the same model for qsize().
History
Date User Action Args
2016-07-27 19:40:41Doug Hoskissonsetrecipients: + Doug Hoskisson, rhettinger, vstinner, r.david.murray, docs@python
2016-07-27 19:40:41Doug Hoskissonsetmessageid: <1469648441.39.0.554786795426.issue27624@psf.upfronthosting.co.za>
2016-07-27 19:40:41Doug Hoskissonlinkissue27624 messages
2016-07-27 19:40:41Doug Hoskissoncreate