[3.14] gh-141004: Document Py_RETURN_NAN and Py_RETURN_INF (GH-141029)

[3.14] gh-141004: Document Py_RETURN_NAN and Py_RETURN_INF (GH-141029) #172315