More docstring updates

Author: Diptorup Deb

dpctl/_sycl_device.pyx

@@ -103,6 +103,7 @@ from ._sycl_platform cimport SyclPlatform
 
 import collections
 import warnings
+from typing import Tuple
 
 __all__ = [
     "SyclDevice", "SyclDeviceCreationError", "SyclSubDeviceCreationError",
@@ -737,17 +738,24 @@ cdef class SyclDevice(_SyclDevice):
     def max_work_item_dims(self):
         """ Returns the maximum dimensions that specify the global and local
         work-item IDs used by the data parallel execution model.
+
+        Returns:
+            int: The maximum number of work items supported by the device.
         """
         cdef uint32_t max_work_item_dims = 0
         max_work_item_dims = DPCTLDevice_GetMaxWorkItemDims(self._device_ref)
         return max_work_item_dims
 
     @property
-    def max_work_item_sizes1d(self):
+    def max_work_item_sizes1d(self) -> Tuple[int,]:
         """ Returns the maximum number of work-items that are permitted in each
         dimension of the work-group of the nd_range<1>. The minimum value is
-        `(1 )` for devices that are not of device type
-         ``info::device_type::custom``.
+        `(1 )` for devices that evaluate to False for
+        :py:attr:`~has_aspect_custom`.
+
+        Returns:
+            A tuple with the maximum allowed value for a 1D range used to
+            enqueue a kernel on the device.
         """
         cdef size_t *max_work_item_sizes1d = NULL
         max_work_item_sizes1d = DPCTLDevice_GetMaxWorkItemSizes1d(
@@ -758,11 +766,15 @@ cdef class SyclDevice(_SyclDevice):
         return res
 
     @property
-    def max_work_item_sizes2d(self):
+    def max_work_item_sizes2d(self) -> Tuple[int, int]:
         """ Returns the maximum number of work-items that are permitted in each
         dimension of the work-group of the nd_range<2>. The minimum value is
-        `(1; 1)` for devices that are not of device type
-         ``info::device_type::custom``.
+        `(1; 1)` for devices that evaluate to False for
+        :py:attr:`~has_aspect_custom`.
+
+        Returns:
+            A tuple with the maximum allowed value for each dimension of a 2D
+            range used to enqueue a kernel on the device.
         """
         cdef size_t *max_work_item_sizes2d = NULL
         max_work_item_sizes2d = DPCTLDevice_GetMaxWorkItemSizes2d(
@@ -773,7 +785,7 @@ cdef class SyclDevice(_SyclDevice):
         return res
 
     @property
-    def max_work_item_sizes3d(self):
+    def max_work_item_sizes3d(self) -> Tuple[int, int]:
         """ Returns the maximum number of work-items that are permitted in each
         dimension of the work-group of the nd_range<3>. The minimum value is
         `(1; 1; 1)` for devices that are not of device type