mostly fix the documentation oddities

Author: ksimpson-work

cuda_core/cuda/core/experimental/__init__.py

@@ -7,4 +7,4 @@
 from cuda.core.experimental._launcher import LaunchConfig, launch
 from cuda.core.experimental._program import Program
 from cuda.core.experimental._stream import Stream, StreamOptions
-from cuda.core.experimental._system import _system as system
+from cuda.core.experimental._system import _system_instance as system

cuda_core/cuda/core/experimental/_system.py

@@ -61,4 +61,4 @@ def devices(self) -> tuple:
         self._devices = tuple(Device(device_id) for device_id in range(total))
         return self._devices
 
-_system = System.__new__(System)
+_system_instance = System.__new__(System)

cuda_core/docs/source/api.rst

@@ -16,6 +16,7 @@ CUDA runtime
 
    Device
    launch
+   system
 
    :template: dataclass.rst
 

cuda_core/docs/source/conf.py

@@ -25,6 +25,18 @@ def __getattr__(cls, name):
 MOCK_MODULES = ['cuda.core.experimental._system']
 sys.modules.update((mod_name, Mock()) for mod_name in MOCK_MODULES)
 
+class SystemMock(MagicMock):
+    __doc__ = "Singleton instance of :class:`cuda.core.experimental._system.System`"
+
+
+# Mock the System class within the _system module
+sys.modules['cuda.core.experimental._system'].System = SystemMock
+
+# Create a specific mock for the system instance
+system_mock = SystemMock()
+
+# Ensure the system instance is correctly mocked
+sys.modules['cuda.core.experimental._system']._system_instance = system_mock
 
 # -- Project information -----------------------------------------------------