Document enum values for dpctl enums directly in docstring

Better and more accurate formatting

Author: ndgrigorian

dpctl/enum_types.py

@@ -27,7 +27,16 @@
 
 class device_type(Enum):
     """
-    An enumeration of supported SYCL device types.
+    An :class:`enum.Enum` of supported SYCL device types.
+
+    Accepted enum values are
+
+        ``all``:
+        ``accelerator``
+        ``automatic``
+        ``cpu``
+        ``custom``
+        ``gpu``
 
     :Example:
         .. code-block:: python
@@ -54,7 +63,15 @@ class device_type(Enum):
 
 class backend_type(Enum):
     """
-    An enumeration of supported SYCL backends.
+    An :class:`enum.Enum` of supported SYCL backends.
+
+    Accepted enum values are
+
+        ``all``:
+        ``cuda``
+        ``hip``
+        ``level_zero``
+        ``opencl``
 
     :Example:
         .. code-block:: python
@@ -76,7 +93,7 @@ class backend_type(Enum):
 
 class event_status_type(Enum):
     """
-    An enumeration of SYCL event states.
+    An :class:`enum.Enum` of SYCL event states.
 
     :Example:
         .. code-block:: python
@@ -95,7 +112,14 @@ class event_status_type(Enum):
 
 class global_mem_cache_type(Enum):
     """
-    An enumeration of global memory cache types for a device.
+    An :class:`enum.Enum`  of global memory cache types for a device.
+
+    Accepted enum values are
+
+        ``indeterminate``:
+        ``none``
+        ``read_only``
+        ``read_write``
 
     :Example:
         .. code-block:: python