Make it clearer that the dtype kinds in isdtype are the string inputs (#610)

Author: asmeurer

src/array_api_stubs/_2022_12/data_type_functions.py

@@ -148,13 +148,13 @@ def isdtype(
         -   If ``kind`` is a dtype, the function must return a boolean indicating whether the input ``dtype`` is equal to the dtype specified by ``kind``.
         -   If ``kind`` is a string, the function must return a boolean indicating whether the input ``dtype`` is of a specified data type kind. The following dtype kinds must be supported:
 
-            -   **bool**: boolean data types (e.g., ``bool``).
-            -   **signed integer**: signed integer data types (e.g., ``int8``, ``int16``, ``int32``, ``int64``).
-            -   **unsigned integer**: unsigned integer data types (e.g., ``uint8``, ``uint16``, ``uint32``, ``uint64``).
-            -   **integral**: integer data types. Shorthand for ``('signed integer', 'unsigned integer')``.
-            -   **real floating**: real-valued floating-point data types (e.g., ``float32``, ``float64``).
-            -   **complex floating**: complex floating-point data types (e.g., ``complex64``, ``complex128``).
-            -   **numeric**: numeric data types. Shorthand for ``('integral', 'real floating', 'complex floating')``.
+            -   ``'bool'``: boolean data types (e.g., ``bool``).
+            -   ``'signed integer'``: signed integer data types (e.g., ``int8``, ``int16``, ``int32``, ``int64``).
+            -   ``'unsigned integer'``: unsigned integer data types (e.g., ``uint8``, ``uint16``, ``uint32``, ``uint64``).
+            -   ``'integral'``: integer data types. Shorthand for ``('signed integer', 'unsigned integer')``.
+            -   ``'real floating'``: real-valued floating-point data types (e.g., ``float32``, ``float64``).
+            -   ``'complex floating'``: complex floating-point data types (e.g., ``complex64``, ``complex128``).
+            -   ``'numeric'``: numeric data types. Shorthand for ``('integral', 'real floating', 'complex floating')``.
 
         -   If ``kind`` is a tuple, the tuple specifies a union of dtypes and/or kinds, and the function must return a boolean indicating whether the input ``dtype`` is either equal to a specified dtype or belongs to at least one specified data type kind.
 

src/array_api_stubs/_draft/data_type_functions.py

@@ -164,13 +164,13 @@ def isdtype(
         -   If ``kind`` is a dtype, the function must return a boolean indicating whether the input ``dtype`` is equal to the dtype specified by ``kind``.
         -   If ``kind`` is a string, the function must return a boolean indicating whether the input ``dtype`` is of a specified data type kind. The following dtype kinds must be supported:
 
-            -   **bool**: boolean data types (e.g., ``bool``).
-            -   **signed integer**: signed integer data types (e.g., ``int8``, ``int16``, ``int32``, ``int64``).
-            -   **unsigned integer**: unsigned integer data types (e.g., ``uint8``, ``uint16``, ``uint32``, ``uint64``).
-            -   **integral**: integer data types. Shorthand for ``('signed integer', 'unsigned integer')``.
-            -   **real floating**: real-valued floating-point data types (e.g., ``float32``, ``float64``).
-            -   **complex floating**: complex floating-point data types (e.g., ``complex64``, ``complex128``).
-            -   **numeric**: numeric data types. Shorthand for ``('integral', 'real floating', 'complex floating')``.
+            -   ``'bool'``: boolean data types (e.g., ``bool``).
+            -   ``'signed integer'``: signed integer data types (e.g., ``int8``, ``int16``, ``int32``, ``int64``).
+            -   ``'unsigned integer'``: unsigned integer data types (e.g., ``uint8``, ``uint16``, ``uint32``, ``uint64``).
+            -   ``'integral'``: integer data types. Shorthand for ``('signed integer', 'unsigned integer')``.
+            -   ``'real floating'``: real-valued floating-point data types (e.g., ``float32``, ``float64``).
+            -   ``'complex floating'``: complex floating-point data types (e.g., ``complex64``, ``complex128``).
+            -   ``'numeric'``: numeric data types. Shorthand for ``('integral', 'real floating', 'complex floating')``.
 
         -   If ``kind`` is a tuple, the tuple specifies a union of dtypes and/or kinds, and the function must return a boolean indicating whether the input ``dtype`` is either equal to a specified dtype or belongs to at least one specified data type kind.