[issue19412] Add docs for test.support.requires_docstrings decorator

[Ezio Melotti]

Ezio Melotti added the comment:

I was bitten by this in #19535. See the third point about test_contextlib in msg203071.  I would expect support.requires_docstring to skip the test if -OO is used and the docstrings are missing.

----------

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