Adjust comments

Author: encukou

Include/object.h

@@ -316,21 +316,24 @@ Py_SET_TYPE(PyObject *ob, PyTypeObject *type)
 }
 
 #if !defined(Py_LIMITED_API) || Py_LIMITED_API+0 < _Py_PACK_VERSION(3, 11)
-// Non-limited API & limited API 3.11 & below: the user can omit casts
+// Non-limited API & limited API 3.11 & below: use static inline functions and
+// use _PyObject_CAST so that users don't need their own casts
 #  define Py_TYPE(ob) _Py_TYPE_impl(_PyObject_CAST(ob))
 #  define Py_SIZE(ob) _Py_SIZE_impl(_PyObject_CAST(ob))
 #  define Py_IS_TYPE(ob, type) _Py_IS_TYPE_impl(_PyObject_CAST(ob), (type))
 #  define Py_SET_SIZE(ob, size) _Py_SET_SIZE_impl(_PyVarObject_CAST(ob), (size))
 #  define Py_SET_TYPE(ob, type) Py_SET_TYPE(_PyObject_CAST(ob), type)
 #elif Py_LIMITED_API+0 < _Py_PACK_VERSION(3, 15)
-#  if Py_LIMITED_API+0 < _Py_PACK_VERSION(3, 14)
-//   Py_TYPE() is a function call on Limited API 3.14 and newer
-#    define Py_TYPE(ob) _Py_TYPE_impl(ob)
-#  endif
-// These are function calls on Limited API 3.15 and newer:
+// Limited API 3.11-3.14: use static inline functions, without casts
 #  define Py_SIZE(ob) _Py_SIZE_impl(ob)
 #  define Py_IS_TYPE(ob, type) _Py_IS_TYPE_impl((ob), (type))
 #  define Py_SET_SIZE(ob, size) _Py_SET_SIZE_impl((ob), (size))
+#  if Py_LIMITED_API+0 < _Py_PACK_VERSION(3, 14)
+//   Py_TYPE() is static inline only on Limited API 3.13 and below
+#    define Py_TYPE(ob) _Py_TYPE_impl(ob)
+#  endif
+#else
+// Limited API 3.15+: use function calls
 #endif
 
 #endif // !defined(_Py_OPAQUE_PYOBJECT)