Documentation for date and datetime comparison is outdated

[serhiy-storchaka]

The implementation of comparison for date and datetime objects was changed 18 years ago, in 1996059, but the documentation still describes the old behavior, with special-casing of other objects with a timetuple attribute. There were also other changes in this code. In particularly, there is a significant difference between equality comparison and order comparison. This part of the documentation should be rewritten.

Linked PRs

• gh-114728: Fix documentation for comparison of objects in datetime module #114749
• [3.12] gh-114728: Fix documentation for comparison of objects in datetime module (GH-114749) #114928
• [3.11] gh-114728: Fix documentation for comparison of objects in datetime module (GH-114749) #114929