address review comments

Author: lucascolley

src/array_api_stubs/_draft/data_type_functions.py

@@ -14,7 +14,7 @@
 
 def astype(
     x: array,
-    dtype_or_kind: Union[dtype, str],
+    dtype: Union[dtype, str],
     /,
     *,
     copy: bool = True,
@@ -45,13 +45,9 @@ def astype(
     ----------
     x: array
         array to cast.
-    dtype_or_kind: Union[dtype, str]
+    dtype: Union[dtype, str]
         desired data type or kind of data type. Supported kinds are:
-        -   ``'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``).
     copy: bool
         specifies whether to copy an array when the specified ``dtype`` matches the data type of the input array ``x``. If ``True``, a newly allocated array must always be returned. If ``False`` and the specified ``dtype`` matches the data type of the input array, the input array must be returned; otherwise, a newly allocated array must be returned. Default: ``True``.
@@ -67,7 +63,6 @@ def astype(
         -   Otherwise, an attempt is made to convert to the specified kind, according to the type promotion rules (see :ref:`type-promotion`).
 
             -   Numeric kinds are interpreted as the lowest-precision standard data type of that kind for the purposes of type promotion. For example, ``astype(x, 'complex floating')`` will return an array with the data type ``complex64`` when ``x.dtype`` is ``float32``, since ``complex64`` is the result of promoting ``float32`` with the lowest-precision standard complex data type, ``complex64``.
-            -   For kind ``integral``, the 'lowest-precision standard data type' is interpreted as ``int8``, not ``uint8``.
 
         The returned array must have the same shape as ``x``.