Merge branch 'develop' into improvement_20251223_diag

Author: algorithm1832

docs/api/paddle/angle_cn.rst

@@ -3,7 +3,7 @@
 angle
 -------------------------------
 
-.. py:function:: paddle.angle(x, name=None)
+.. py:function:: paddle.angle(x, name=None, *, out=None)
 
 
 逐元素计算复数的相位角。对于非负实数，相位角为 0，而对于负实数，相位角为 :math:`\pi`。
@@ -14,9 +14,13 @@ angle
 
 参数
 :::::::::
-    - **x** (Tensor) - 输入的 Tensor，数据类型为：complex64, complex128 或 float32, float64。
+    - **x** (Tensor) - 输入的 Tensor，数据类型为：complex64, complex128 或 float32, float64。别名 ``input``。
     - **name** (str，可选) - 具体用法请参见 :ref:`api_guide_Name`，一般无需设置，默认值为 None。
 
+关键字参数
+:::::::::
+    - **out** (Tensor，可选) - 输出 Tensor，若不为 ``None``，计算结果将保存在该 Tensor 中，默认值为 ``None``。
+
 返回
 :::::::::
 输出实数 Tensor，与 ``x`` 的数值精度一致。

docs/api/paddle/asinh_cn.rst

@@ -3,7 +3,7 @@
 asinh
 -------------------------------
 
-.. py:function:: paddle.asinh(x, name=None)
+.. py:function:: paddle.asinh(x, name=None, *, out=None)
 
 Arcsinh 函数。
 
@@ -12,9 +12,13 @@ Arcsinh 函数。
 
 参数
 :::::::::
-    - **x** (Tensor) - 输入的 Tensor，数据类型为：float32、float64、complex64、complex128。
+    - **x** (Tensor) - 输入的 Tensor，数据类型为：float32、float64、complex64、complex128。别名 ``input``。
     - **name** (str，可选) - 具体用法请参见 :ref:`api_guide_Name`，一般无需设置，默认值为 None。
 
+关键字参数
+:::::::::
+    - **out** (Tensor，可选) - 输出 Tensor，若不为 ``None``，计算结果将保存在该 Tensor 中，默认值为 ``None``。
+
 返回
 :::::::::
 输出 Tensor，与 ``x`` 维度相同、数据类型相同。

docs/api/paddle/atan_cn.rst

@@ -3,7 +3,7 @@
 atan
 -------------------------------
 
-.. py:function:: paddle.atan(x, name=None)
+.. py:function:: paddle.atan(x, name=None, *, out=None)
 
 
 
@@ -16,9 +16,13 @@ arctangent 函数。
 参数
 ::::::::::::
 
-    - **x** (Tensor) - 输入的 Tensor，数据类型为：float32、float64、float16、complex64、complex128。
+    - **x** (Tensor) - 输入的 Tensor，数据类型为：float32、float64、float16、complex64、complex128。别名 ``input`` 。
     - **name** (str，可选) - 具体用法请参见 :ref:`api_guide_Name`，一般无需设置，默认值为 None。
 
+关键字参数
+:::::::::
+    - **out** (Tensor，可选) - 输出 Tensor，若不为 ``None``，计算结果将保存在该 Tensor 中，默认值为 ``None``。
+
 返回
 ::::::::::::
 输出 Tensor，与 ``x`` 维度相同、数据类型相同。

docs/api/paddle/bincount_cn.rst

@@ -10,7 +10,7 @@ bincount
 参数
 ::::::::::::
 
-    - **x** (Tensor) - 输入 Tensor。必须是一维 Tensor，其中元素必须大于等于 0，数据类型为 int32, int64。
+    - **x** (Tensor) - 输入 Tensor。必须是一维 Tensor，其中元素必须大于等于 0，数据类型为 int32, int64。别名 ``input`` 。
     - **weights** (Tensor，可选) - weights Tensor，代表输入 Tensor 中每个元素的权重。长度必须与输入 Tensor 相同。数据类型为 int32, int64, float32 或 float64。默认为 None
     - **minlength** (int，可选) - 输出 Tensor 的最小长度，如果大于输入 Tensor 中的最大值，则多出的位置补 0。该值必须大于等于 0。默认为 0。
     - **name** (str，可选) - 具体用法请参见 :ref:`api_guide_Name`，一般无需设置，默认值为 None。

docs/api/paddle/bitwise_and_cn.rst

@@ -3,7 +3,7 @@
 bitwise_and
 -------------------------------
 
-.. py:function:: paddle.bitwise_and(x, y, out=None, name=None)
+.. py:function:: paddle.bitwise_and(x, y, name=None, *, out=None)
 
 对 Tensor ``x`` 和 ``y`` 逐元素进行 ``按位与`` 运算。
 
@@ -17,11 +17,15 @@ bitwise_and
 参数
 ::::::::::::
 
-        - **x** （Tensor）- 输入的 N-D `Tensor`，数据类型为：bool，uint8，int8，int16，int32，int64。
-        - **y** （Tensor）- 输入的 N-D `Tensor`，数据类型为：bool，uint8，int8，int16，int32，int64。
-        - **out** （Tensor，可选）- 输出的结果 `Tensor`，是与输入数据类型相同的 N-D `Tensor`。默认值为 None，此时将创建新的 Tensor 来保存输出结果。
+        - **x** （Tensor）- 输入的 N-D `Tensor`，数据类型为：bool，uint8，int8，int16，int32，int64。别名 ``input``。
+        - **y** （Tensor）- 输入的 N-D `Tensor`，数据类型为：bool，uint8，int8，int16，int32，int64。别名 ``other``。
         - **name** (str，可选) - 具体用法请参见 :ref:`api_guide_Name`，一般无需设置，默认值为 None。
 
+关键字参数
+::::::::::::
+
+        - **out** （Tensor，可选）- 输出的结果 `Tensor`，是与输入数据类型相同的 N-D `Tensor`。默认值为 None，此时将创建新的 Tensor 来保存输出结果。
+
 返回
 ::::::::::::
  ``按位与`` 运算后的结果 ``Tensor``，数据类型与 ``x`` 相同。

docs/api/paddle/bitwise_not_cn.rst

@@ -3,7 +3,7 @@
 bitwise_not
 -------------------------------
 
-.. py:function:: paddle.bitwise_not(x, out=None, name=None)
+.. py:function:: paddle.bitwise_not(x, name=None, *, out=None)
 
 对 Tensor ``x`` 逐元素进行 ``按位取反`` 运算。
 
@@ -18,10 +18,14 @@ bitwise_not
 参数
 ::::::::::::
 
-        - **x** （Tensor）- 输入的 N-D `Tensor`，数据类型为：bool，uint8，int8，int16，int32，int64。
-        - **out** （Tensor，可选）- 输出的结果 `Tensor`，是与输入数据类型相同的 N-D `Tensor`。默认值为 None，此时将创建新的 Tensor 来保存输出结果。
+        - **x** （Tensor）- 输入的 N-D `Tensor`，数据类型为：bool，uint8，int8，int16，int32，int64。别名 ``input``。
         - **name** (str，可选) - 具体用法请参见 :ref:`api_guide_Name`，一般无需设置，默认值为 None。
 
+关键字参数
+::::::::::::
+
+        - **out** （Tensor，可选）- 输出的结果 `Tensor`，是与输入数据类型相同的 N-D `Tensor`。默认值为 None，此时将创建新的 Tensor 来保存输出结果。
+
 返回
 ::::::::::::
  ``按位取反`` 运算后的结果 ``Tensor``，数据类型与 ``x`` 相同。

docs/api/paddle/bitwise_xor_cn.rst

@@ -3,7 +3,7 @@
 bitwise_xor
 -------------------------------
 
-.. py:function:: paddle.bitwise_xor(x, y, out=None, name=None)
+.. py:function:: paddle.bitwise_xor(x, y, name=None, *, out=None)
 
 对 Tensor ``x`` 和 ``y`` 逐元素进行 ``按位异或`` 运算。
 
@@ -18,11 +18,15 @@ bitwise_xor
 参数
 ::::::::::::
 
-        - **x** （Tensor）- 输入的 N-D `Tensor`，数据类型为：bool，uint8，int8，int16，int32，int64。
-        - **y** （Tensor）- 输入的 N-D `Tensor`，数据类型为：bool，uint8，int8，int16，int32，int64。
-        - **out** （Tensor，可选）- 输出的结果 `Tensor`，是与输入数据类型相同的 N-D `Tensor`。默认值为 None，此时将创建新的 Tensor 来保存输出结果。
+        - **x** （Tensor）- 输入的 N-D `Tensor`，数据类型为：bool，uint8，int8，int16，int32，int64。别名 ``input``。
+        - **y** （Tensor）- 输入的 N-D `Tensor`，数据类型为：bool，uint8，int8，int16，int32，int64。别名 ``other``。
         - **name** (str，可选) - 具体用法请参见 :ref:`api_guide_Name`，一般无需设置，默认值为 None。
 
+关键字参数
+::::::::::::
+
+        - **out** （Tensor，可选）- 输出的结果 `Tensor`，是与输入数据类型相同的 N-D `Tensor`。默认值为 None，此时将创建新的 Tensor 来保存输出结果。
+
 返回
 ::::::::::::
  ``按位异或`` 运算后的结果 ``Tensor``，数据类型与 ``x`` 相同。

docs/api/paddle/diag_cn.rst

@@ -22,12 +22,16 @@ diag
 
 参数
 :::::::::
-    - **x** (Tensor) - 输入的 `Tensor`。它的形状可以是一维或二维。其数据类型应为 float16、float32、float64、int32、int64、complex64、complex128。
-    - **offset** (int，可选) - 对角线偏移量。正值表示上对角线，0 表示主对角线，负值表示下对角线。默认值为 0。
+    - **x** (Tensor) - 输入的 `Tensor`。它的形状可以是一维或二维。其数据类型应为 float16、float32、float64、int32、int64、complex64、complex128。别名 ``input`` 。
+    - **offset** (int，可选) - 对角线偏移量。正值表示上对角线，0 表示主对角线，负值表示下对角线。默认值为 0。别名 ``diagonal`` 。
     - **padding_value** (int|float，可选) -使用此值来填充指定对角线以外的区域。仅在输入为一维 Tensor 时生效。默认值为 0。
     - **name** (str，可选) - 具体用法请参见 :ref:`api_guide_Name`，一般无需设置，默认值为 None。
     - **out** (Tensor，可选) - 输出的结果。该参数为仅关键字参数，默认值为 None。
 
+关键字参数
+:::::::::
+    - **out** (Tensor，可选) - 输出 Tensor，若不为 ``None``，计算结果将保存在该 Tensor 中，默认值为 ``None``。
+
 返回
 :::::::::
 ``Tensor``，方阵或向量。输出数据类型与输入数据类型相同。

docs/api/paddle/fmax_cn.rst

@@ -3,7 +3,7 @@
 fmax
 -------------------------------
 
-.. py:function:: paddle.fmax(x, y, name=None)
+.. py:function:: paddle.fmax(x, y, name=None, *, out=None)
 
 
 比较两个 Tensor 对应位置的元素，返回一个包含该元素最大值的新 Tensor。如果两个元素其中一个是 nan 值，则直接返回另一个值，如果两者都是 nan 值，则返回第一个 nan 值。
@@ -20,10 +20,14 @@ fmax
 
 参数
 :::::::::
-   - **x** （Tensor）- 输入的 Tensor。数据类型为 ``bfloat16`` 、 ``float16`` 、 ``float32`` 、 ``float64`` 、 ``int32`` 或  ``int64`` 。
-   - **y** （Tensor）- 输入的 Tensor。数据类型为 ``bfloat16`` 、 ``float16`` 、 ``float32`` 、 ``float64`` 、 ``int32`` 或  ``int64`` 。
+   - **x** （Tensor）- 输入的 Tensor。数据类型为 ``bfloat16`` 、 ``float16`` 、 ``float32`` 、 ``float64`` 、 ``int32`` 或  ``int64`` 。别名 ``input`` 。
+   - **y** （Tensor）- 输入的 Tensor。数据类型为 ``bfloat16`` 、 ``float16`` 、 ``float32`` 、 ``float64`` 、 ``int32`` 或  ``int64`` 。别名 ``other`` 。
    - **name** (str，可选) - 具体用法请参见 :ref:`api_guide_Name`，一般无需设置，默认值为 None。
 
+关键字参数
+:::::::::
+   - **out** (Tensor，可选) - 输出 Tensor，若不为 ``None``，计算结果将保存在该 Tensor 中，默认值为 ``None``。
+
 返回
 :::::::::
    ``Tensor``，存储运算后的结果。如果 x 和 y 有不同的 shape 且是可以广播的，返回 Tensor 的 shape 是 x 和 y 经过广播后的 shape。如果 x 和 y 有相同的 shape，返回 Tensor 的 shape 与 x，y 相同。

docs/api/paddle/fmin_cn.rst

@@ -3,7 +3,7 @@
 fmin
 -------------------------------
 
-.. py:function:: paddle.fmin(x, y, name=None)
+.. py:function:: paddle.fmin(x, y, name=None, *, out=None)
 
 
 比较两个 Tensor 对应位置的元素，返回一个包含该元素最小值的新 Tensor。如果两个元素其中一个是 nan 值，则直接返回另一个值，如果两者都是 nan 值，则返回第一个 nan 值。
@@ -20,10 +20,14 @@ fmin
 
 参数
 :::::::::
-   - **x** （Tensor）- 输入的 Tensor。数据类型为 ``bfloat16`` 、 ``float16`` 、 ``float32`` 、 ``float64`` 、 ``int32`` 或  ``int64`` 。
-   - **y** （Tensor）- 输入的 Tensor。数据类型为 ``bfloat16`` 、 ``float16`` 、 ``float32`` 、 ``float64`` 、 ``int32`` 或  ``int64`` 。
+   - **x** （Tensor）- 输入的 Tensor。数据类型为 ``bfloat16`` 、 ``float16`` 、 ``float32`` 、 ``float64`` 、 ``int32`` 或  ``int64`` 。别名 ``input`` 。
+   - **y** （Tensor）- 输入的 Tensor。数据类型为 ``bfloat16`` 、 ``float16`` 、 ``float32`` 、 ``float64`` 、 ``int32`` 或  ``int64`` 。别名 ``other`` 。
    - **name** (str，可选) - 具体用法请参见 :ref:`api_guide_Name`，一般无需设置，默认值为 None。
 
+关键字参数
+:::::::::
+   - **out** (Tensor，可选) - 输出 Tensor，若不为 ``None``，计算结果将保存在该 Tensor 中，默认值为 ``None``。
+
 返回
 :::::::::
    ``Tensor``，存储运算后的结果。如果 x 和 y 有不同的 shape 且是可以广播的，返回 Tensor 的 shape 是 x 和 y 经过广播后的 shape。如果 x 和 y 有相同的 shape，返回 Tensor 的 shape 与 x，y 相同。