DOC: Add admonition to docstrings for cuda.core handle properties

Author: carterbox

cuda_core/cuda/core/experimental/_event.py

@@ -164,5 +164,11 @@ def is_done(self) -> bool:
 
     @property
     def handle(self) -> cuda.bindings.driver.CUevent:
-        """Return the underlying CUevent object."""
+        """Return the underlying CUevent object.
+
+        .. caution::
+
+            This handle is a python object. To get the memory address of the C struct, call
+            ``int(Event.handle)`` not ``Event.handle.getPtr()``.
+        """
         return self._mnff.handle

cuda_core/cuda/core/experimental/_linker.py

@@ -503,6 +503,11 @@ def handle(self) -> LinkerHandleT:
         .. note::
 
            The type of the returned object depends on the backend.
+
+        .. caution::
+
+            This handle is a python object. To get the memory address of the C struct, call
+            ``int(Linker.handle)`` not ``Linker.handle.getPtr()``.
         """
         return self._mnff.handle
 

cuda_core/cuda/core/experimental/_memory.py

@@ -81,8 +81,14 @@ def close(self, stream=None):
         self._mnff.close(stream)
 
     @property
-    def handle(self):
-        """Return the buffer handle object."""
+    def handle(self) -> driver.CUdeviceptr:
+        """Return the buffer handle object.
+
+        .. caution::
+
+            This handle is a python object. To get the memory address of the C struct, call
+            ``int(Buffer.handle)`` not ``Buffer.handle.getPtr()``.
+        """
         return self._mnff.ptr
 
     @property

cuda_core/cuda/core/experimental/_module.py

@@ -354,5 +354,11 @@ def code(self) -> CodeTypeT:
     @property
     @precondition(_lazy_load_module)
     def handle(self):
-        """Return the underlying handle object."""
+        """Return the underlying handle object.
+
+        .. caution::
+
+            This handle is a python object. To get the memory address of the C struct, call
+            ``int(ObjectCode.handle)`` not ``ObjectCode.handle.getPtr()``.
+        """
         return self._handle

cuda_core/cuda/core/experimental/_program.py

@@ -524,5 +524,10 @@ def handle(self) -> ProgramHandleT:
         .. note::
 
            The type of the returned object depends on the backend.
+
+        .. caution::
+
+            This handle is a python object. To get the memory address of the C struct, call
+            ``int(Program.handle)`` not ``Program.handle.getPtr()``.
         """
         return self._mnff.handle

cuda_core/cuda/core/experimental/_stream.py

@@ -189,7 +189,13 @@ def __cuda_stream__(self) -> Tuple[int, int]:
 
     @property
     def handle(self) -> cuda.bindings.driver.CUstream:
-        """Return the underlying ``CUstream`` object."""
+        """Return the underlying ``CUstream`` object.
+
+        .. caution::
+
+            This handle is a python object. To get the memory address of the C struct, call
+            ``int(Stream.handle)`` not ``Stream.handle.getPtr()``.
+        """
         return self._mnff.handle
 
     @property