James Henstridge pointed out a misleading comment.

diff --git a/Include/abstract.h b/Include/abstract.h
index 237e950c43e601beaf3d2c88fb1fa592ea670195..e3292bad1786b45336021a53cc9e0d1bf2bedd3d 100644 (file)
--- a/Include/abstract.h
+++ b/Include/abstract.h
@@ -384,24 +384,20 @@ xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx*/
 
      int PyObject_IsTrue(PyObject *o);
 
-        Returns 1 if the object, o, is considered to be true, and
-        0 otherwise. This is equivalent to the Python expression:
-        not not o
+        Returns 1 if the object, o, is considered to be true, 0 if o is
+        considered to be false and -1 on failure. This is equivalent to the
+        Python expression: not not o
 
-        This function always succeeds.
-        
        */
 
      /* Implemented elsewhere:
 
      int PyObject_Not(PyObject *o);
 
-        Returns 0 if the object, o, is considered to be true, and
-        1 otherwise. This is equivalent to the Python expression:
-        not o
+        Returns 0 if the object, o, is considered to be true, 1 if o is
+        considered to be false and -1 on failure. This is equivalent to the
+        Python expression: not o
 
-        This function always succeeds.
-        
        */
 
      PyAPI_FUNC(PyObject *) PyObject_Type(PyObject *o);