Revert "Narrow generated docs markup fixes"

This reverts commit 18ecc23.

Author: kkraus14

cuda_bindings/docs/source/conf.py

@@ -9,6 +9,7 @@
 
 # -- Path setup --------------------------------------------------------------
 
+import inspect
 import os
 import re
 import sys
@@ -141,41 +142,34 @@ def _html_baseurl():
 }
 
 
-_CUDA_BINDING_DOCSTRING_PREFIXES = ("cuda.bindings.driver.", "cuda.bindings.runtime.")
-_CUDA_BINDING_DOCSTRING_NAMES = {
-    "cuda.bindings.nvml.device_get_virtualization_mode",
-    "cuda.bindings.nvml.device_set_virtualization_mode",
-}
-_CUDA_BINDING_ROLE_SUFFIX = re.compile(r"(:py:obj:`[^`]+`)(\[[^\]]*\]|\d+)")
-_CUDA_BINDING_ROLE_POINTER_SUFFIX = re.compile(r"(:py:obj:`[^`]+`) \*(?=[\s.,)])")
-_CUDA_BINDING_LITERAL_ARRAY_TOKEN = re.compile(r"`([A-Za-z_][A-Za-z0-9_]*)`\[([^\]]+)\]")
-_CUDA_BINDING_LITERAL_PLURAL_SUFFIX = re.compile(r"`([A-Za-z_][A-Za-z0-9_]*)`s\b")
-_CUDA_BINDING_POINTER_TOKEN = re.compile(r"(?<![\\*])\*(?=[A-Za-z_(])")
+def _sanitize_generated_docstring(lines):
+    doc_lines = inspect.cleandoc("\n".join(lines)).splitlines()
+    if not doc_lines:
+        return
+
+    if "(" in doc_lines[0] and ")" in doc_lines[0]:
+        doc_lines = doc_lines[1:]
+        while doc_lines and not doc_lines[0].strip():
+            doc_lines.pop(0)
 
+    if not doc_lines:
+        lines[:] = []
+        return
 
-def _separate_cuda_binding_role_suffix(match):
-    role, suffix = match.groups()
-    if suffix.startswith("["):
-        return f"{role} ``{suffix}``"
-    return f"{role} {suffix}"
+    lines[:] = [".. code-block:: text", ""]
+    lines.extend(f"   {line}" if line else "   " for line in doc_lines)
 
 
-def _fix_cuda_binding_docstring_line(line):
-    line = _CUDA_BINDING_ROLE_SUFFIX.sub(_separate_cuda_binding_role_suffix, line)
-    line = _CUDA_BINDING_ROLE_POINTER_SUFFIX.sub(r"\1 \\*", line)
-    line = _CUDA_BINDING_LITERAL_ARRAY_TOKEN.sub(r"``\1[\2]``", line)
-    line = _CUDA_BINDING_LITERAL_PLURAL_SUFFIX.sub(r"``\1``", line)
-    line = line.replace("NVML_GPU_VIRTUALIZATION_?", "``NVML_GPU_VIRTUALIZATION_?``")
-    line = line.replace("void **", "void \\*\\*")
-    line = line.replace("void *", "void \\*")
-    line = line.replace("CUcontext *", "CUcontext \\*")
-    line = line.replace("CUdeviceptr *", "CUdeviceptr \\*")
-    return _CUDA_BINDING_POINTER_TOKEN.sub(r"\\*", line)
+def _escape_generated_docstring_markup(lines):
+    pointer_marker = re.compile(r"(?<!\\)\*(?=[A-Za-z_(])")
+    lines[:] = [pointer_marker.sub(r"\\*", line) for line in lines]
 
 
-def _process_cuda_binding_docstring(app, what, name, obj, options, lines):
-    if name in _CUDA_BINDING_DOCSTRING_NAMES or name.startswith(_CUDA_BINDING_DOCSTRING_PREFIXES):
-        lines[:] = [_fix_cuda_binding_docstring_line(line) for line in lines]
+def autodoc_process_docstring(app, what, name, obj, options, lines):
+    if name.startswith("cuda.bindings."):
+        _sanitize_generated_docstring(lines)
+        if lines and lines[0] != ".. code-block:: text":
+            _escape_generated_docstring_markup(lines)
 
 
 def rewrite_source(app, docname, source):
@@ -194,5 +188,5 @@ def rewrite_source(app, docname, source):
 
 
 def setup(app):
-    app.connect("autodoc-process-docstring", _process_cuda_binding_docstring)
+    app.connect("autodoc-process-docstring", autodoc_process_docstring)
     app.connect("source-read", rewrite_source)