From 925bbc2166d169962210314772d13270e9ba60a2 Mon Sep 17 00:00:00 2001 From: "Erlend E. Aasland" Date: Wed, 9 Aug 2023 07:55:34 +0200 Subject: gh-80282: Argument Clinic: Add clarifying comment about ASCII docstring limitation (#107764) Co-authored-by: Alex Waygood --- Tools/clinic/clinic.py | 5 +++++ 1 file changed, 5 insertions(+) diff --git a/Tools/clinic/clinic.py b/Tools/clinic/clinic.py index 16f3171..059c2db 100755 --- a/Tools/clinic/clinic.py +++ b/Tools/clinic/clinic.py @@ -5461,6 +5461,11 @@ class DSLParser: def docstring_append(self, obj: Function | Parameter, line: str) -> None: """Add a rstripped line to the current docstring.""" + # gh-80282: We filter out non-ASCII characters from the docstring, + # since historically, some compilers may balk on non-ASCII input. + # If you're using Argument Clinic in an external project, + # you may not need to support the same array of platforms as CPython, + # so you may be able to remove this restriction. matches = re.finditer(r'[^\x00-\x7F]', line) if offending := ", ".join([repr(m[0]) for m in matches]): warn("Non-ascii characters are not allowed in docstrings:", -- cgit v0.12