gh-97740: Fix bang in Sphinx C domain ref target syntax

CAM-Gerlach · CAM-Gerlach · commit ce7fc52555e8 · 2022-10-02T10:45:33.000-05:00
diff --git a/Doc/conf.py b/Doc/conf.py
@@ -249,3 +249,18 @@
 # bpo-40204: Disable warnings on Sphinx 2 syntax of the C domain since the
 # documentation is built with -W (warnings treated as errors).
 c_warn_on_allowed_pre_v3 = False
+
+# Fix '!' not working with C domain when pre_v3 is enabled
+import sphinx
+
+if sphinx.version_info[:2] < (5, 3):
+    from sphinx.domains.c import CXRefRole
+
+    original_run = CXRefRole.run
+
+    def new_run(self):
+        if self.disabled:
+            return super(CXRefRole, self).run()
+        return original_run(self)
+
+    CXRefRole.run = new_run
