docs(typing): fix RST bullet format, accuracy issues, and version notes in StrEnum docstrings

- Convert all enum member descriptions to RST bullet list format
  (* ``MEMBER`` -- description) so Sphinx renders them as a list
  rather than a run-on paragraph
- Fix VirtualMemoryAllocationType.PINNED: remove incorrect
  "page-locked host memory" wording; backing location is
  device by default and controlled by VirtualMemoryLocationType
- Fix CompilerBackendType class summary: backend is inferred from
  Program.code_type and exposed on Program.backend, not selected
  via ProgramOptions
- Move CUDA 13+ version note from ManagedMemoryLocationType.HOST_NUMA
  to VirtualMemoryAllocationType.MANAGED (the actual 13+-gated member;
  ManagedMemoryResource already requires CUDA 13 so the HOST_NUMA note
  was misleading)
- Fix ObjectCodeFormatType summary to mention Linker.link and
  Program.as_bytes alongside Program.compile

Author: aryanputta

cuda_core/cuda/core/typing.py

@@ -45,8 +45,9 @@
 class SourceCodeType(StrEnum):
     """Source language passed to :class:`~cuda.core.Program`.
 
-    ``CXX`` selects CUDA C++, ``PTX`` selects PTX assembly text, and
-    ``NVVM`` selects NVVM IR (LLVM bitcode).
+    * ``CXX`` — CUDA C++ source.
+    * ``PTX`` — PTX assembly text.
+    * ``NVVM`` — NVVM IR (LLVM bitcode).
     """
 
     CXX = "c++"
@@ -55,14 +56,14 @@ class SourceCodeType(StrEnum):
 
 
 class ObjectCodeFormatType(StrEnum):
-    """Output format produced by :meth:`~cuda.core.Program.compile`.
-
-    ``PTX`` — PTX assembly text.
-    ``CUBIN`` — device-native CUDA binary.
-    ``LTOIR`` — LTO (link-time optimization) IR for later linking.
-    ``FATBIN`` — fat binary bundling multiple device images.
-    ``OBJECT`` — relocatable device object.
-    ``LIBRARY`` — device code library.
+    """Output format for :meth:`~cuda.core.Program.compile`, :meth:`~cuda.core.Linker.link`, and :meth:`~cuda.core.Program.as_bytes`.
+
+    * ``PTX`` — PTX assembly text.
+    * ``CUBIN`` — device-native CUDA binary.
+    * ``LTOIR`` — LTO (link-time optimization) IR for later linking.
+    * ``FATBIN`` — fat binary bundling multiple device images.
+    * ``OBJECT`` — relocatable device object.
+    * ``LIBRARY`` — device code library.
     """
 
     PTX = "ptx"
@@ -74,12 +75,12 @@ class ObjectCodeFormatType(StrEnum):
 
 
 class CompilerBackendType(StrEnum):
-    """Compiler backend selected via :class:`~cuda.core.ProgramOptions`.
+    """Compiler backend inferred from the program's code type and exposed on :attr:`~cuda.core.Program.backend`.
 
-    ``NVRTC`` — NVIDIA Runtime Compilation.
-    ``NVVM`` — NVVM LLVM backend.
-    ``NVJITLINK`` — nvJitLink device-side linker.
-    ``DRIVER`` — CUDA driver PTX JIT compiler.
+    * ``NVRTC`` — NVIDIA Runtime Compilation.
+    * ``NVVM`` — NVVM LLVM backend.
+    * ``NVJITLINK`` — nvJitLink device-side linker.
+    * ``DRIVER`` — CUDA driver PTX JIT compiler.
     """
 
     NVRTC = "NVRTC"
@@ -91,10 +92,9 @@ class CompilerBackendType(StrEnum):
 class PCHStatusType(StrEnum):
     """Precompiled-header (PCH) outcome reported by :meth:`~cuda.core.Program.compile`.
 
-    ``CREATED`` — PCH was successfully written.
-    ``NOT_ATTEMPTED`` — PCH creation was skipped (backend does not support it or
-    the option was not requested).
-    ``FAILED`` — PCH creation was attempted but failed.
+    * ``CREATED`` — PCH was successfully written.
+    * ``NOT_ATTEMPTED`` — PCH creation was skipped (backend does not support it or the option was not requested).
+    * ``FAILED`` — PCH creation was attempted but failed.
     """
 
     CREATED = "created"
@@ -105,9 +105,9 @@ class PCHStatusType(StrEnum):
 class GraphConditionalType(StrEnum):
     """Conditional node flavor for :class:`~cuda.core.graph.GraphBuilder`.
 
-    ``IF`` — body graph executes at most once based on a condition.
-    ``WHILE`` — body graph loops while the condition is true.
-    ``SWITCH`` — selects one child graph by an integer index.
+    * ``IF`` — body graph executes at most once based on a condition.
+    * ``WHILE`` — body graph loops while the condition is true.
+    * ``SWITCH`` — selects one child graph by an integer index.
     """
 
     IF = "if"
@@ -118,9 +118,9 @@ class GraphConditionalType(StrEnum):
 class GraphMemoryType(StrEnum):
     """Memory space for a graph memory-allocation or free node.
 
-    ``DEVICE`` — GPU device memory.
-    ``HOST`` — pinned host memory.
-    ``MANAGED`` — CUDA managed (unified) memory.
+    * ``DEVICE`` — GPU device memory.
+    * ``HOST`` — pinned host memory.
+    * ``MANAGED`` — CUDA managed (unified) memory.
     """
 
     DEVICE = "device"
@@ -131,9 +131,9 @@ class GraphMemoryType(StrEnum):
 class ManagedMemoryLocationType(StrEnum):
     """Destination type for managed-memory prefetch and advise operations.
 
-    ``DEVICE`` — target a GPU device.
-    ``HOST`` — target the CPU host (any NUMA node).
-    ``HOST_NUMA`` — target a specific host NUMA node (CUDA 13+ only).
+    * ``DEVICE`` — target a GPU device.
+    * ``HOST`` — target the CPU host (any NUMA node).
+    * ``HOST_NUMA`` — target a specific host NUMA node.
     """
 
     DEVICE = "device"
@@ -144,9 +144,9 @@ class ManagedMemoryLocationType(StrEnum):
 class VirtualMemoryHandleType(StrEnum):
     """OS handle type for exporting virtual memory allocations across processes.
 
-    ``POSIX_FD`` — POSIX file descriptor (Linux).
-    ``WIN32_KMT`` — Win32 kernel-mode handle (Windows).
-    ``FABRIC`` — NVLink/NVSwitch fabric handle for multi-node topologies.
+    * ``POSIX_FD`` — POSIX file descriptor (Linux).
+    * ``WIN32_KMT`` — Win32 kernel-mode handle (Windows).
+    * ``FABRIC`` — NVLink/NVSwitch fabric handle for multi-node topologies.
     """
 
     POSIX_FD = "posix_fd"
@@ -157,10 +157,10 @@ class VirtualMemoryHandleType(StrEnum):
 class VirtualMemoryLocationType(StrEnum):
     """Physical backing location for a virtual memory allocation.
 
-    ``DEVICE`` — GPU device memory.
-    ``HOST`` — pinned host memory.
-    ``HOST_NUMA`` — host memory pinned to a specific NUMA node.
-    ``HOST_NUMA_CURRENT`` — host memory on the calling thread's NUMA node.
+    * ``DEVICE`` — GPU device memory.
+    * ``HOST`` — pinned host memory.
+    * ``HOST_NUMA`` — host memory pinned to a specific NUMA node.
+    * ``HOST_NUMA_CURRENT`` — host memory on the calling thread's NUMA node.
     """
 
     DEVICE = "device"
@@ -172,8 +172,8 @@ class VirtualMemoryLocationType(StrEnum):
 class VirtualMemoryGranularityType(StrEnum):
     """Granularity query type for virtual memory allocations.
 
-    ``MINIMUM`` — smallest allocation size supported by the device.
-    ``RECOMMENDED`` — granularity that yields best performance on the device.
+    * ``MINIMUM`` — smallest allocation size supported by the device.
+    * ``RECOMMENDED`` — granularity that yields best performance on the device.
     """
 
     MINIMUM = "minimum"
@@ -183,8 +183,8 @@ class VirtualMemoryGranularityType(StrEnum):
 class VirtualMemoryAccessType(StrEnum):
     """Access permissions for a virtual memory mapping.
 
-    ``READ_WRITE`` — both read and write access.
-    ``READ`` — read-only access.
+    * ``READ_WRITE`` — both read and write access.
+    * ``READ`` — read-only access.
     """
 
     READ_WRITE = "rw"
@@ -194,8 +194,8 @@ class VirtualMemoryAccessType(StrEnum):
 class VirtualMemoryAllocationType(StrEnum):
     """Physical memory type for a virtual memory backing allocation.
 
-    ``PINNED`` — page-locked (pinned) host memory.
-    ``MANAGED`` — CUDA managed (unified) memory.
+    * ``PINNED`` — pinned/non-migratable physical allocation (placement via :class:`VirtualMemoryLocationType`).
+    * ``MANAGED`` — CUDA managed (unified) memory (CUDA 13+ only).
     """
 
     PINNED = "pinned"