cuda.core v0.5.0 doc final pass (NVIDIA#1401)

* fix warnings and hyperlinks

* mention experimental namespace

* remove win32 from VirtualMemoryHandleTypeT

* fix typo

Author: leofang

cuda_core/cuda/core/_memory/_virtual_memory_resource.py

@@ -24,7 +24,7 @@
 
 __all__ = ["VirtualMemoryResourceOptions", "VirtualMemoryResource"]
 
-VirtualMemoryHandleTypeT = Union[Literal["posix_fd", "generic", "win32", "win32_kmt", "fabric"], None]
+VirtualMemoryHandleTypeT = Union[Literal["posix_fd", "generic", "win32_kmt", "fabric"], None]
 VirtualMemoryLocationTypeT = Literal["device", "host", "host_numa", "host_numa_current"]
 VirtualMemoryGranularityT = Literal["minimum", "recommended"]
 VirtualMemoryAccessTypeT = Union[Literal["rw", "r"], None]
@@ -81,7 +81,6 @@ class VirtualMemoryResourceOptions:
     _handle_types = {
         None: _h.CU_MEM_HANDLE_TYPE_NONE,
         "posix_fd": _h.CU_MEM_HANDLE_TYPE_POSIX_FILE_DESCRIPTOR,
-        "win32": _h.CU_MEM_HANDLE_TYPE_WIN32,
         "win32_kmt": _h.CU_MEM_HANDLE_TYPE_WIN32_KMT,
         "fabric": _h.CU_MEM_HANDLE_TYPE_FABRIC,
     }

cuda_core/docs/source/api_private.rst

@@ -16,16 +16,15 @@ CUDA runtime
 .. autosummary::
    :toctree: generated/
 
-   _memory.PyCapsule
-   _memory.DevicePointerT
-   _memory.VirtualMemoryAllocationTypeT
-   _memory.VirtualMemoryLocationTypeT
-   _memory.VirtualMemoryGranularityT
-   _memory.VirtualMemoryAccessTypeT
-   _memory.VirtualMemoryHandleTypeT
+   _memory._buffer.DevicePointerT
+   _memory._virtual_memory_resource.VirtualMemoryAllocationTypeT
+   _memory._virtual_memory_resource.VirtualMemoryLocationTypeT
+   _memory._virtual_memory_resource.VirtualMemoryGranularityT
+   _memory._virtual_memory_resource.VirtualMemoryAccessTypeT
+   _memory._virtual_memory_resource.VirtualMemoryHandleTypeT
    _device.DeviceProperties
-   _memory.IPCAllocationHandle
-   _memory.IPCBufferDescriptor
+   _memory._ipc.IPCAllocationHandle
+   _memory._ipc.IPCBufferDescriptor
    _module.KernelAttributes
    _module.KernelOccupancy
    _module.ParamInfo

cuda_core/docs/source/release/0.5.0-notes.rst

@@ -21,6 +21,8 @@ Breaking Changes
 
 The support for setting :attr:`VirtualMemoryResourceOptions.handle_type` to ``"win32"`` is removed. Please reach out to us on GitHub if you have a use case.
 
+All public APIs accessible under the ``cuda.core.experimental`` namespace are now moved to the top-level ``cuda.core`` namespace. For example, ``cuda.core.experimental.Device`` is now accessible as :class:`cuda.core.Device`. The ``cuda.core.experimental`` namespace is still retained for backward compatibility, but is considered deprecated and will be removed by ``cuda.core`` v1.0.0.
+
 The following APIs have been deprecated and will be removed in 0.6.0:
 
 - ``cuda.core.experimental.system.driver_version`` has been replaced with