[docs] [issue17858] Different documentation for identical methods

Andriy Mysyk report at bugs.python.org
Sun Apr 28 00:58:05 CEST 2013


New submission from Andriy Mysyk:

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.

----------
assignee: docs at python
components: Documentation
messages: 187945
nosy: amysyk, docs at python
priority: normal
severity: normal
status: open
title: Different documentation for identical methods
type: enhancement
versions: Python 3.4

_______________________________________
Python tracker <report at bugs.python.org>
<http://bugs.python.org/issue17858>
_______________________________________


More information about the docs mailing list