Update bitwise docs adding broadcast info

Author: vlad-perevezentsev

dpnp/dpnp_iface_bitwise.py

@@ -134,15 +134,15 @@ def binary_repr(num, width=None):
 
 Parameters
 ----------
-x1 : {dpnp.ndarray, usm_ndarray, scalar}
-    First input array, expected to have integer or boolean data type.
+x1, x2 : {dpnp.ndarray, usm_ndarray, scalar}
+    Input arrays, expected to have integer or boolean data type.
     Both inputs `x1` and `x2` can not be scalars at the same time.
-x2 : {dpnp.ndarray, usm_ndarray, scalar}
-    Second input array, also expected to have integer or boolean data
-    type. Both inputs `x1` and `x2` can not be scalars at the same time.
+    If ``x1.shape != x2.shape``, they must be broadcastable to a common shape
+    (which becomes the shape of the output).
 out : {None, dpnp.ndarray, usm_ndarray}, optional
     Output array to populate.
-    Array must have the correct shape and the expected data type.
+    Array must have a shape that the inputs broadcast to and
+    the expected data type.
     Default: ``None``.
 order : {"C", "F", "A", "K"}, optional
     Memory layout of the newly output array, if parameter `out` is ``None``.
@@ -218,15 +218,15 @@ def binary_repr(num, width=None):
 
 Parameters
 ----------
-x1 : {dpnp.ndarray, usm_ndarray, scalar}
-    First input array, expected to have integer or boolean data type.
+x1, x2 : {dpnp.ndarray, usm_ndarray, scalar}
+    Input arrays, expected to have integer or boolean data type.
     Both inputs `x1` and `x2` can not be scalars at the same time.
-x2 : {dpnp.ndarray, usm_ndarray, scalar}
-    Second input array, also expected to have integer or boolean data
-    type. Both inputs `x1` and `x2` can not be scalars at the same time.
+    If ``x1.shape != x2.shape``, they must be broadcastable to a common shape
+    (which becomes the shape of the output).
 out : {None, dpnp.ndarray, usm_ndarray}, optional
     Output array to populate.
-    Array must have the correct shape and the expected data type.
+    Array must have a shape that the inputs broadcast to and
+    the expected data type.
     Default: ``None``.
 order : {"C", "F", "A", "K"}, optional
     Memory layout of the newly output array, if parameter `out` is ``None``.
@@ -293,15 +293,15 @@ def binary_repr(num, width=None):
 
 Parameters
 ----------
-x1 : {dpnp.ndarray, usm_ndarray, scalar}
-    First input array, expected to have integer or boolean data type.
+x1, x2 : {dpnp.ndarray, usm_ndarray, scalar}
+    Input arrays, expected to have integer or boolean data type.
     Both inputs `x1` and `x2` can not be scalars at the same time.
-x2 : {dpnp.ndarray, usm_ndarray, scalar}
-    Second input array, also expected to have integer or boolean data
-    type. Both inputs `x1` and `x2` can not be scalars at the same time.
+    If ``x1.shape != x2.shape``, they must be broadcastable to a common shape
+    (which becomes the shape of the output).
 out : {None, dpnp.ndarray, usm_ndarray}, optional
     Output array to populate.
-    Array must have the correct shape and the expected data type.
+    Array must have a shape that the inputs broadcast to and
+    the expected data type.
     Default: ``None``.
 order : {"C", "F", "A", "K"}, optional
     Memory layout of the newly output array, if parameter `out` is ``None``.
@@ -376,7 +376,8 @@ def binary_repr(num, width=None):
     Input array, expected to have integer or boolean data type.
 out : {None, dpnp.ndarray, usm_ndarray}, optional
     Output array to populate.
-    Array must have the correct shape and the expected data type.
+    Array must have a shape that the input broadcast to and
+    the expected data type.
     Default: ``None``.
 order : {"C", "F", "A", "K"}, optional
     Memory layout of the newly output array, if parameter `out` is ``None``.
@@ -458,9 +459,12 @@ def binary_repr(num, width=None):
     Second input array, also expected to have integer data type.
     Each element must be greater than or equal to ``0``.
     Both inputs `x1` and `x2` can not be scalars at the same time.
+    If ``x1.shape != x2.shape``, they must be broadcastable to a common shape
+    (which becomes the shape of the output).
 out : {None, dpnp.ndarray, usm_ndarray}, optional
     Output array to populate.
-    Array must have the correct shape and the expected data type.
+    Array must have a shape that the inputs broadcast to and
+    the expected data type.
     Default: ``None``.
 order : {"C", "F", "A", "K"}, optional
     Memory layout of the newly output array, if parameter `out` is ``None``.
@@ -532,9 +536,12 @@ def binary_repr(num, width=None):
     Second input array, also expected to have integer data type.
     Each element must be greater than or equal to ``0``.
     Both inputs `x1` and `x2` can not be scalars at the same time.
+    If ``x1.shape != x2.shape``, they must be broadcastable to a common shape
+    (which becomes the shape of the output).
 out : {None, dpnp.ndarray, usm_ndarray}, optional
     Output array to populate.
-    Array must have the correct shape and the expected data type.
+    Array must have a shape that the inputs broadcast to and
+    the expected data type.
     Default: ``None``.
 order : {"C", "F", "A", "K"}, optional
     Memory layout of the newly output array, if parameter `out` is ``None``.