[3.14] gh-141004: Improve `make check-c-api-docs` (GH-143564) (GH-143593)

[3.14] gh-141004: Improve `make check-c-api-docs` (GH-143564) (GH-143593)

- Gather all documented names into a set in a single pass.
  This makes the check much faster.

- Do not match substrings (e.g. documenting `PyErr_WarnEx`
  doesn't mean that `PyErr_Warn` is documented)

- Consider `PY`-prefixed names (a lot of old macros use this)

(cherry picked from commit 234a15dc4ec2d8f8ababea91532ebe896a96387a)