cuda_core: drop unused enum doc cleanup helper

Remove the old Doxygen ``::`` normalization path now that error explanations no longer depend on dict-vs-docstring parity checks. This keeps the helper focused on the cleanup rules that still affect user-facing CUDAError messages.

Made-with: Cursor

Author: rwgk

cuda_core/cuda/core/_utils/enum_explanations_helpers.py

@@ -8,11 +8,11 @@
 the 12.x backport line at ``cuda-bindings`` 12.9.6, and in the mainline 13.x
 series at ``cuda-bindings`` 13.2.0. This module decides which source to use
 and normalizes generated docstrings so user-facing ``CUDAError`` messages stay
-close to the long-form explanation prose.
+presentable.
 
-The cleanup rules here were derived while validating docstring-vs-dict parity
-in PR #1805. Keep them narrow and remove them when codegen / fallback support is
-no longer needed.
+The cleanup rules here were derived while validating generated enum docstrings
+in PR #1805. Keep them narrow and remove them when codegen quirks or fallback
+support are no longer needed.
 """
 
 from __future__ import annotations
@@ -43,25 +43,11 @@ def _binding_version_has_usable_enum_docstrings(version: tuple[int, int, int]) -
     )
 
 
-def _strip_doxygen_double_colon_prefixes(s: str) -> str:
-    """Remove Doxygen-style ``::`` before CUDA identifiers (not C++ ``Foo::Bar`` scope).
-
-    The frozen fallback tables come from CUDA header comments and therefore use
-    Doxygen ``::name`` references. Generated enum ``__doc__`` text uses Sphinx
-    roles instead, so parity checks need a small amount of normalization.
-    """
-    prev = None
-    while prev != s:
-        prev = s
-        s = re.sub(r"(?<![A-Za-z0-9_])::+([A-Za-z_][A-Za-z0-9_]*)", r"\1", s)
-    return s
-
-
 def _fix_hyphenation_wordwrap_spacing(s: str) -> str:
     """Remove spaces around hyphens introduced by line wrapping in generated ``__doc__`` text.
 
     This is a narrow workaround for wrapped forms such as ``non- linear`` that
-    otherwise differ from the single-line fallback prose.
+    would otherwise look awkward in user-facing messages.
     """
     prev = None
     while prev != s:
@@ -74,10 +60,10 @@ def _fix_hyphenation_wordwrap_spacing(s: str) -> str:
 def clean_enum_member_docstring(doc: str | None) -> str | None:
     """Turn an enum member ``__doc__`` into plain text.
 
-    The generated enum docstrings are already close to the fallback explanation
-    prose, but not byte-identical: they may contain Sphinx inline roles, line
-    wrapping, or a small known codegen defect. Normalize only those differences
-    so the text is suitable for user-facing error messages.
+    The generated enum docstrings are already close to user-facing prose, but
+    they may contain Sphinx inline roles, line wrapping, or a small known
+    codegen defect. Normalize only those differences so the text is suitable
+    for error messages.
     """
     if doc is None:
         return None

cuda_core/tests/test_utils_enum_explanations_helpers.py

@@ -7,7 +7,6 @@
 from cuda.core._utils.enum_explanations_helpers import (
     DocstringBackedExplanations,
     _binding_version_has_usable_enum_docstrings,
-    _strip_doxygen_double_colon_prefixes,
     clean_enum_member_docstring,
 )
 
@@ -63,18 +62,6 @@ def test_clean_enum_member_docstring_none_input():
     assert clean_enum_member_docstring(None) is None
 
 
-@pytest.mark.parametrize(
-    ("raw", "expected"),
-    [
-        pytest.param("see ::CUDA_SUCCESS", "see CUDA_SUCCESS", id="type_ref"),
-        pytest.param("Foo::Bar unchanged", "Foo::Bar unchanged", id="cpp_scope_preserved"),
-        pytest.param("::cuInit() and ::CUstream", "cuInit() and CUstream", id="multiple_prefixes"),
-    ],
-)
-def test_strip_doxygen_double_colon_prefixes(raw, expected):
-    assert _strip_doxygen_double_colon_prefixes(raw) == expected
-
-
 def test_docstring_backed_get_returns_default_for_non_enum_code():
     lut = DocstringBackedExplanations(_FakeEnumType({}))
     assert lut.get(-1) is None