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 rhettinger
Recipients Doug Hoskisson, docs@python, r.david.murray, rhettinger, vstinner
Date 2016-07-29.06:22:10
SpamBayes Score -1.0
Marked as misclassified Yes
Message-id <1469773331.06.0.43909440524.issue27624@psf.upfronthosting.co.za>
In-reply-to
Content
Sorry Doug, I don't find any of the suggestions to be an improvement and I concur with David Murray that the docstring for qsize() isn't the place for a tutorial on race conditions and LBYL vs EAPF which are general threading topics rather than a queue specific topics.

Also, I'm reluctant to change Guido's original wording which has served well for a decade.  While I'm sure you can invent ways to misread the word "approximate", it does communicate that this method cannot relied upon to return the exact size.  If we were seeing recurring source of confusion, there might be a basis for a change, but that is not the case.

Sorry, but I'm going to close this one.  Every person might find a different way to wordsmith this one, but I think we should favor Guido's choice.
History
Date User Action Args
2016-07-29 06:22:11rhettingersetrecipients: + rhettinger, vstinner, r.david.murray, docs@python, Doug Hoskisson
2016-07-29 06:22:11rhettingersetmessageid: <1469773331.06.0.43909440524.issue27624@psf.upfronthosting.co.za>
2016-07-29 06:22:11rhettingerlinkissue27624 messages
2016-07-29 06:22:10rhettingercreate