Expanded doc-string of dpctl.tensor.usm_ndarray.to_device

Author: oleksandr-pavlyk

dpctl/tensor/_usmarray.pyx

@@ -640,7 +640,21 @@ cdef class usm_ndarray:
 
     def to_device(self, target_device):
         """
-        Transfer array to target device
+        Transfers this array to specified target device.
+
+        Args:
+            target_device: array API concept of target device.
+                target_device can be a oneAPI filter selector string,
+                an instance of :class:`dpctl.SyclDevice` corresponding to a
+                non-partitioned SYCL device, an instance of
+                :class:`dpctl.SyclQueue`, or a :class:`dpctl.tensor.Device`
+                object returned by :property:`dpctl.tensor.usm_array.device`.
+
+        Returns:
+            A view if data copy is not required, and a copy otherwise.
+            If copying is required, it is done by copying from original
+            allocation device to the host, followed by copying from host
+            to the target device.
         """
         cdef c_dpctl.DPCTLSyclQueueRef QRef = NULL
         cdef c_dpmem._Memory arr_buf