[Docs] Add documentation for dpctl enums

docs/doc_sources/api_reference/dpctl/constants.rst

@@ -0,0 +1,16 @@
+.. _dpctl_constants:
+
+Constants
+========================
+
+The following constants are defined in :py:mod:`dpctl`:
+
+.. currentmodule:: dpctl
+
+.. autodata:: device_type
+
+.. autodata:: backend_type
+
+.. autodata:: event_status_type
+
+.. autodata:: global_mem_cache_type

docs/doc_sources/api_reference/dpctl/index.rst

@@ -62,6 +62,20 @@
     has_cpu_devices
     has_accelerator_devices
 
+.. rubric:: Enums
+
+.. list-table::
+    :widths: 10 50
+
+    * - :py:class:`dpctl.device_type`
+      - An :class:`enum.Enum` of supported SYCL device types.
+    * - :py:class:`dpctl.backend_type`
+      - An :class:`enum.Enum` of supported SYCL backends.
+    * - :py:class:`dpctl.event_status_type`
+      - An :class:`enum.Enum` of SYCL event states.
+    * - :py:class:`dpctl.global_mem_cache_type`
+      - An :class:`enum.Enum`  of global memory cache types for a device.
+
 .. rubric:: Exceptions
 
 .. autosummary::

dpctl/enum_types.py

@@ -27,7 +27,14 @@
 
 class device_type(Enum):
     """
-    An enumeration of supported SYCL device types.
+    An :class:`enum.Enum` of supported SYCL device types.
+
+        |  ``all``
+        |  ``accelerator``
+        |  ``automatic``
+        |  ``cpu``
+        |  ``custom``
+        |  ``gpu``
 
     :Example:
         .. code-block:: python
@@ -54,7 +61,13 @@ class device_type(Enum):
 
 class backend_type(Enum):
     """
-    An enumeration of supported SYCL backends.
+    An :class:`enum.Enum` of supported SYCL backends.
+
+        |  ``all``
+        |  ``cuda``
+        |  ``hip``
+        |  ``level_zero``
+        |  ``opencl``
 
     :Example:
         .. code-block:: python
@@ -76,7 +89,12 @@ class backend_type(Enum):
 
 class event_status_type(Enum):
     """
-    An enumeration of SYCL event states.
+    An :class:`enum.Enum` of SYCL event states.
+
+        |  ``unknown_status``
+        |  ``submitted``
+        |  ``running``
+        |  ``complete``
 
     :Example:
         .. code-block:: python
@@ -95,7 +113,12 @@ 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.
+
+        |  ``indeterminate``
+        |  ``none``
+        |  ``read_only``
+        |  ``read_write``
 
     :Example:
         .. code-block:: python