Issue #1717, continued: Doc fixes and other cleanup related

to renaming of tp_compare.