RichCompare and RichCompareBool

[Terry Reedy]

Gabriel Genellina wrote:
> En Mon, 02 Mar 2009 17:54:09 -0200, Terry Reedy <tjreedy at udel.edu> 
> escribió:
> 
>> Aaron Brady wrote:
>>> Hi,
>>>  In the source for 3.0.1, PyObject_RichCompareBool seems to perform an
>>> extra check on identity that PyObjecct_RichCompare does not perform.
>>
>> To me, the existence of two functions suggests that they are 
>> *intended* to act differently.
> 
> Mmm, but then the documentation is misleading and incomplete, at least. 
> PyObject_RichCompareBool is not equivalent of "o1 op o2" as it claims, 
> and both functions differ in more than return value (the only documented 
> difference).

Could be.  I believe the C API docs have had must less testing by naive 
users than the Python docs, and even those are not quite perfect yet.