https://github.com/python/cpython/commit/cfdc5e86dde549bac97b8c61b1089d890ca1aaf3 commit: cfdc5e86dde549bac97b8c61b1089d890ca1aaf3 branch: 3.14 author: Miss Islington (bot) <[email protected]> committer: lysnikolaou <[email protected]> date: 2026-03-19T11:08:27Z summary:
[3.14] gh-145254: Fix formatting of thread safety annotations (GH-146111) (#146163) - Add leading space so that the spacing between the previous annotation and the thread safety annotation looks correct. - Remove trailing period from the link to the thread safety level. (cherry picked from commit 580043dfae90331de15cf1504d09e2c7216182a6) Co-authored-by: Lysandros Nikolaou <[email protected]> files: M Doc/tools/extensions/c_annotations.py diff --git a/Doc/tools/extensions/c_annotations.py b/Doc/tools/extensions/c_annotations.py index 58f597c2eb2d0c..724dea625c4e21 100644 --- a/Doc/tools/extensions/c_annotations.py +++ b/Doc/tools/extensions/c_annotations.py @@ -308,27 +308,27 @@ def _unstable_api_annotation() -> nodes.admonition: def _threadsafety_annotation(level: str) -> nodes.emphasis: match level: case "incompatible": - display = sphinx_gettext("Not safe to call from multiple threads.") + display = sphinx_gettext("Not safe to call from multiple threads") reftarget = "threadsafety-level-incompatible" case "compatible": display = sphinx_gettext( "Safe to call from multiple threads" - " with external synchronization only." + " with external synchronization only" ) reftarget = "threadsafety-level-compatible" case "distinct": display = sphinx_gettext( "Safe to call without external synchronization" - " on distinct objects." + " on distinct objects" ) reftarget = "threadsafety-level-distinct" case "shared": display = sphinx_gettext( - "Safe for concurrent use on the same object." + "Safe for concurrent use on the same object" ) reftarget = "threadsafety-level-shared" case "atomic": - display = sphinx_gettext("Atomic.") + display = sphinx_gettext("Atomic") reftarget = "threadsafety-level-atomic" case _: raise AssertionError(f"Unknown thread safety level {level!r}") @@ -340,9 +340,11 @@ def _threadsafety_annotation(level: str) -> nodes.emphasis: reftype="ref", refexplicit="True", ) - prefix = sphinx_gettext("Thread safety:") + " " + prefix = " " + sphinx_gettext("Thread safety:") + " " classes = ["threadsafety", f"threadsafety-{level}"] - return nodes.emphasis("", prefix, ref_node, classes=classes) + return nodes.emphasis( + "", prefix, ref_node, nodes.Text("."), classes=classes + ) def _return_value_annotation(result_refs: int | None) -> nodes.emphasis: _______________________________________________ Python-checkins mailing list -- [email protected] To unsubscribe send an email to [email protected] https://mail.python.org/mailman3//lists/python-checkins.python.org Member address: [email protected]
