Document required return values -1, 0, 1 for tp_compare handler, as

suggested in SF patch #424475.  Also document exception return.