Apply suggestions from code review

Co-authored-by: Hugo van Kemenade <1324225+hugovk@users.noreply.github.com>

Author: ZeroIntensity

Makefile.pre.in

@@ -3314,7 +3314,7 @@ check-c-globals:
 		--traceback
 
 # Check for undocumented C APIs.
-.PHONY: check-c-globals
+.PHONY: check-c-api-docs
 check-c-api-docs:
 	$(PYTHON_FOR_REGEN) $(srcdir)/Tools/check-c-api-docs/main.py
 

Tools/check-c-api-docs/main.py

@@ -9,15 +9,15 @@
 SIMPLE_DATA_REGEX = re.compile(r"PyAPI_DATA\(.+\) (\w+)")
 
 MISTAKE = """\
-If this is a mistake and this script should not be failing, please create an
+If this is a mistake and this script should not be failing, create an
 issue and tag Peter (@ZeroIntensity) on it.\
 """
 
 FOUND_UNDOCUMENTED = f"""\
 Found some undocumented C API(s)!
 
 Python requires documentation on all public C API symbols, macros, and types.
-If these API(s) were not meant to be public, please prefix them with a
+If these API(s) were not meant to be public, prefix them with a
 leading underscore (_PySomething_API) or move them to the internal C API
 (pycore_*.h files).
 
@@ -29,8 +29,8 @@
 
 FOUND_IGNORED_DOCUMENTED = f"""\
 Some C API(s) were listed in Tools/c-api-docs-check/ignored_c_api.txt, but
-they were found in the documentation. To fix this, simply update ignored_c_api.txt
-accordingly.
+they were found in the documentation. To fix this, remove them from
+ignored_c_api.txt.
 
 {MISTAKE}\
 """
@@ -112,7 +112,7 @@ def check_for_name(name: str) -> None:
 
         check_for_name(name)
 
-    # Remove duplicates and sort alphabetically to keep the output non-deterministic
+    # Remove duplicates and sort alphabetically to keep the output deterministic
     undocumented = list(set(undocumented))
     undocumented.sort()