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.

diff --git a/Doc/api/abstract.tex b/Doc/api/abstract.tex
index 1d87c0562b96eed06c29cd87c4f326c77e117ae3..dd237683f6a411fc2c7981f34147a3fa1da3470f 100644 (file)
--- a/Doc/api/abstract.tex
+++ b/Doc/api/abstract.tex
@@ -310,7 +310,14 @@ determination.
 \begin{cfuncdesc}{int}{PyObject_IsTrue}{PyObject *o}
   Returns \code{1} if the object \var{o} is considered to be true, and
   \code{0} otherwise.  This is equivalent to the Python expression
-  \samp{not not \var{o}}.  This function always succeeds.
+  \samp{not not \var{o}}.  On failure, return \code{-1}. 
+\end{cfuncdesc}
+
+
+\begin{cfuncdesc}{int}{PyObject_Not}{PyObject *o}
+  Returns \code{0} if the object \var{o} is considered to be true, and
+  \code{1} otherwise.  This is equivalent to the Python expression
+  \samp{not \var{o}}.  On failure, return \code{-1}. 
 \end{cfuncdesc}