Fixed docstrings with remnants of old header style

Author: oleksandr-pavlyk

dpctl/tensor/_dlpack.pyx

@@ -469,13 +469,25 @@ cpdef usm_ndarray from_dlpack_capsule(object py_caps) except +:
 
 
 cpdef from_dlpack(array):
-    """
-    dpctl.tensor.from_dlpack(obj) -> dpctl.tensor.usm_ndarray
+    """ from_dlpack(obj)
 
     Constructs :class:`dpctl.tensor.usm_ndarray` instance from a Python
     object `obj` that implements `__dlpack__` protocol. The output
     array is always a zero-copy view of the input.
 
+    Args:
+        obj: A Python object representing an array that supports `__dlpack__`
+            protocol.
+
+    Returns:
+        out (usm_ndarray):
+            An array with a view into the tensor underlying the input `obj`.
+
+    Raises:
+        TypeError: if `obj` does not implement `__dlpack__` method.
+        ValueError: if zero copy view can not be constructed because
+            the input array resides on an unsupported device.
+
     See https://dmlc.github.io/dlpack/latest/ for more details.
 
     :Example:
@@ -498,13 +510,6 @@ cpdef from_dlpack(array):
             C = Container(dpt.linspace(0, 100, num=20, dtype="int16"))
             X = dpt.from_dlpack(C)
 
-    Args:
-        obj: A Python object representing an array that supports `__dlpack__`
-            protocol.
-    Raises:
-        TypeError: if `obj` does not implement `__dlpack__` method.
-        ValueError: if zero copy view can not be constructed because
-            the input array resides on an unsupported device.
     """
     if not hasattr(array, "__dlpack__"):
         raise TypeError(

dpctl/tensor/_reshape.py

@@ -76,11 +76,26 @@ def reshaped_strides(old_sh, old_sts, new_sh, order="C"):
 
 
 def reshape(X, shape, order="C", copy=None):
-    """
-    reshape(X: usm_ndarray, shape: tuple, order="C") -> usm_ndarray
+    """reshape(x, shape, order="C")
+
+    Reshapes array `x` into new shape.
+
+    Args:
+        x (usm_ndarray):
+            input array
+        shape (tuple):
+            the desired shape of the resulting array.
+        order ({"C", "F"}, optional):
+            memory layout of the resulting array
+            if a copy is found to be necessary. Supported
+            choices are `"C"` for C-contiguous, or row-major layout;
+            and `"F"` for F-contiguous, or column-major layout.
 
-    Reshapes given usm_ndarray into new shape. Returns a view, if possible,
-    a copy otherwise. Memory layout of the copy is controlled by order keyword.
+    Returns:
+        out (usm_ndarray):
+            Reshaped array is a view, if possible,
+            and a copy otherwise with memory layout as indicated
+            by `order` keyword.
     """
     if not isinstance(X, dpt.usm_ndarray):
         raise TypeError