[New-bugs-announce] [issue7864] Deprecation markers in unittest docs are unclear

[Justin Lebar]

New submission from Justin Lebar <starwiz at gmail.com>:

The documentation for assertTrue/assert_/failUnless reads:

assertTrue(expr, msg=None)
assert_(expr, msg=None)
failUnless(expr, msg=None)
    ...
    Deprecated since version 3.1: failUnless().

The deprecation warning is confusing, since it appears to suggest that failUnless is also deprecated.

Perhaps the last line could read 

  assertTrue and assert_ are deprecated since version 3.1: Use failUnless() instead.

And similarly for the rest of the assertX methods.

----------
assignee: georg.brandl
components: Documentation
messages: 98933
nosy: Justin.Lebar, georg.brandl
severity: normal
status: open
title: Deprecation markers in unittest docs are unclear
versions: Python 3.1

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