As discussed on python-dev, revised docs to note that

PyObject_IsTrue() can have an error result.

Also, added missing docs for PyObject_Not().

Will backport.