Message 187945 - Python tracker

➜

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	amysyk
Recipients	amysyk, docs@python
Date	2013-04-27.22:58:04
SpamBayes Score	-1.0
Marked as misclassified	Yes
Message-id	<1367103485.02.0.041609834341.issue17858@psf.upfronthosting.co.za>
In-reply-to

Content
Use _thread.Lock.acquire() documentation for threading.Lock.acquire(). threading.Lock inherits acquire() method from _thread.Lock. The two acquire() methods are identical in their functionality yet have different documentation. Documentation for threading.Lock.acquire() creates the impression that the function is more complex or harder to use than it actually is. See http://docs.python.org/devguide/documenting.html#economy-of-expression for guidelines.

Use _thread.Lock.acquire() documentation for threading.Lock.acquire().

threading.Lock inherits acquire() method from _thread.Lock.  The two acquire() methods are identical in their functionality yet have different documentation. Documentation for threading.Lock.acquire() creates the impression that the function is more complex or harder to use than it actually is. See http://docs.python.org/devguide/documenting.html#economy-of-expression for guidelines.

History
Date	User	Action	Args
2013-04-27 22:58:05	amysyk	set	recipients: + amysyk, docs@python
2013-04-27 22:58:05	amysyk	set	messageid: <1367103485.02.0.041609834341.issue17858@psf.upfronthosting.co.za>
2013-04-27 22:58:04	amysyk	link	issue17858 messages
2013-04-27 22:58:04	amysyk	create