[API Compatibility] block_diag/broadcast_tensors/cartesian_prod/copysign/index_fill/cross/dist/flip/pow Edit By AI

zhwesky2010 · zhwesky2010 · commit 2c6cbfd08eb7 · 2026-02-05T08:52:22.000Z
diff --git a/docs/api/paddle/block_diag_cn.rst b/docs/api/paddle/block_diag_cn.rst
@@ -3,13 +3,13 @@
 block_diag
 -------------------------------
 
-.. py:function:: paddle.block_diag(inputs, name=None)
+.. py:function:: paddle.block_diag(*inputs, name=None)
 
 根据 `inputs` 创建对角矩阵。
 
 参数
 :::::::::
-    - **inputs**  (list|tuple) - 是一个 Tensor 列表或 Tensor 元组，其子项为 0、1、2 维的 Tensor 。数据类型为： `bool`、 `float16`、 `float32`、 `float64`、 `uint8`、 `int8`、 `int16`、 `int32`、 `int64`、 `bfloat16`、 `complex64`、 `complex128`。
+    - **inputs**  (list|tuple) - 是一个 Tensor 列表或 Tensor 元组，其子项为 0、1、2 维的 Tensor 。数据类型为： `bool`、 `float16`、 `float32`、 `float64`、 `uint8`、 `int8`、 `int16`、 `int32`、 `int64`、 `bfloat16`、 `complex64`、 `complex128`。别名： ``*tensors``。
     - **name**  (str，可选) - 具体用法请参见 :ref:`api_guide_Name`，一般无需设置，默认值为 `None`。
 
 返回
diff --git a/docs/api/paddle/broadcast_tensors_cn.rst b/docs/api/paddle/broadcast_tensors_cn.rst
@@ -3,7 +3,7 @@
 broadcast_tensors
 -------------------------------
 
-.. py:function:: paddle.broadcast_tensors(input, name=None)
+.. py:function:: paddle.broadcast_tensors(*input, name=None)
 
 根据 Broadcast 规范对一组输入 ``input`` 进行 Broadcast 操作
 输入应符合 Broadcast 规范
@@ -29,7 +29,7 @@ broadcast_tensors
    :align: center
 参数
 :::::::::
-    - input (list(Tensor)|tuple(Tensor)) - 一组输入 Tensor，数据类型为：bool、float32、float64、complex64、complex128、int32 或 int64。所有的输入 Tensor 均需要满足 rank <= 5。
+    - input (list(Tensor)|tuple(Tensor)) - 一组输入 Tensor，数据类型为：bool、float32、float64、complex64、complex128、int32 或 int64。所有的输入 Tensor 均需要满足 rank <= 5。别名： ``*tensors``。
     - **name** (str，可选) - 具体用法请参见 :ref:`api_guide_Name`，一般无需设置，默认值为 None。
 
 返回
diff --git a/docs/api/paddle/cartesian_prod_cn.rst b/docs/api/paddle/cartesian_prod_cn.rst
@@ -3,7 +3,7 @@
 cartesian_prod
 -------------------------------
 
-.. py:function:: paddle.cartesian_prod(x, name=None)
+.. py:function:: paddle.cartesian_prod(*x, name=None)
 
 
 对指定的 tensor 序列进行笛卡尔积操作。该行为类似于 python 标准库中的 itertools.product 方法。
@@ -13,7 +13,7 @@ cartesian_prod
 参数
 :::::::::
 
-        - **x** (list[Tensor]|tuple[Tensor]) – 任意数量的 1-D Tensor 序列，支持的数据类型：bfloat16、float16、float32、float64、int32、int64、complex64、complex128。
+        - **x** (list[Tensor]|tuple[Tensor]) – 任意数量的 1-D Tensor 序列，支持的数据类型：bfloat16、float16、float32、float64、int32、int64、complex64、complex128。别名： ``*tensors``。
 
         - **name** (str，可选) - 具体用法请参见 :ref:`api_guide_Name`，一般无需设置，默认值为 None。
 
diff --git a/docs/api/paddle/copysign__cn.rst b/docs/api/paddle/copysign__cn.rst
@@ -7,6 +7,18 @@ copysign\_
 
 Inplace 版本的 :ref:`cn_api_paddle_copysign` API，对输入 `x` 采用 Inplace 策略。
 
+参数
+::::::::::::
+
+    - **x** (Tensor) - 输入的复数值的 Tensor。
+    - **y** (Tensor) - 输入的复数值的 Tensor。别名： ``other``。
+    - **name** (str，可选) - 具体用法请参见 :ref:`api_guide_Name`，一般无需设置，默认值为 None。
+
+返回
+::::::::::::
+
+Tensor，输出数据类型与输入数据类型相同。
+
 更多关于 inplace 操作的介绍请参考 `3.1.3 原位（Inplace）操作和非原位操作的区别`_ 了解详情。
 
 .. _3.1.3 原位（Inplace）操作和非原位操作的区别: https://www.paddlepaddle.org.cn/documentation/docs/zh/develop/guides/beginner/tensor_cn.html#id3
diff --git a/docs/api/paddle/copysign_cn.rst b/docs/api/paddle/copysign_cn.rst
@@ -3,7 +3,7 @@
 copysign
 -------------------------------
 
-.. py:function:: paddle.copysign(x, y, name=None)
+.. py:function:: paddle.copysign(x, y, name=None, *, out=None)
 
 
 按照元素计算两个输入 Tensor 的 copysign 大小，由数值和符号组成，其数值部分来自于第一个 Tensor 中的元素，符号部分来自于第二个 Tensor 中的元素。
@@ -19,10 +19,14 @@ copysign
 参数
 ::::::::::::
 
-    - **x** (Tensor) - 输入的复数值的 Tensor，数据类型为：bool, uint8, int8, int16, int32, int64, bfloat16, float16, float32, float64。
-    - **y** (Tensor) - 输入的复数值的 Tensor，数据类型为：bool, uint8, int8, int16, int32, int64, bfloat16, float16, float32, float64。
+    - **x** (Tensor) - 输入的复数值的 Tensor，数据类型为：bool, uint8, int8, int16, int32, int64, bfloat16, float16, float32, float64。别名： ``input``。
+    - **y** (Tensor) - 输入的复数值的 Tensor，数据类型为：bool, uint8, int8, int16, int32, int64, bfloat16, float16, float32, float64。别名： ``other``。
     - **name** (str，可选) - 具体用法请参见 :ref:`api_guide_Name`，一般无需设置，默认值为 None。
 
+关键字参数
+:::::::::
+    - **out** (Tensor，可选) - 输出 Tensor，若不为 ``None``，计算结果将保存在该 Tensor 中，默认值为 ``None``。
+
 返回
 ::::::::::::
 
diff --git a/docs/api/paddle/geometric__cn.rst b/docs/api/paddle/geometric__cn.rst
@@ -10,7 +10,7 @@ geometric\_
 ::::::::::::
 
     - **x** (Tensor) - 被填充的 Tensor ，数据类型为： float32、float64。
-    - **probs** (float | Tensor) - 输入的概率参数， probs 的值必须为正，数据类型为 float、Tensor。当该参数类型为 Tensor 时， probs 代表每次试验成功的概率。
+    - **probs** (float | Tensor) - 输入的概率参数， probs 的值必须为正，数据类型为 float、Tensor。当该参数类型为 Tensor 时， probs 代表每次试验成功的概率。别名： ``p``。
     - **name** (str ，可选) - 具体用法请参见 :ref:`api_guide_Name`，一般无需设置，默认值为 None。
 
 返回
diff --git a/docs/api/paddle/hypot__cn.rst b/docs/api/paddle/hypot__cn.rst
@@ -7,6 +7,18 @@ hypot\_
 
 Inplace 版本的 :ref:`cn_api_paddle_hypot` API，对输入 x 采用 Inplace 策略。
 
+参数
+::::::::::::
+
+    - **x** (Tensor) - 输入的 Tensor。
+    - **y** (Tensor) - 输入的 Tensor。别名： ``other``。
+    - **name** (str，可选) - 具体用法请参见 :ref:`api_guide_Name`，一般无需设置，默认值为 None。
+
+返回
+::::::::::::
+
+Tensor，输出数据类型与输入数据类型相同。
+
 更多关于 inplace 操作的介绍请参考 `3.1.3 原位（Inplace）操作和非原位操作的区别`_ 了解详情。
 
 .. _3.1.3 原位（Inplace）操作和非原位操作的区别: https://www.paddlepaddle.org.cn/documentation/docs/zh/develop/guides/beginner/tensor_cn.html#id3
diff --git a/docs/api/paddle/index_fill__cn.rst b/docs/api/paddle/index_fill__cn.rst
@@ -7,6 +7,20 @@ index_fill\_
 
 Inplace 版本的 :ref:`cn_api_paddle_index_fill` API
 
+参数
+:::::::::
+
+    - **x** （Tensor）– 输入 Tensor。
+    - **index** （Tensor）– 包含索引下标的 1-D Tensor。
+    - **axis**    (int) – 索引轴。别名： ``dim``。
+    - **value** （float）– 用于填充目标张量的值。别名： ``values``。
+    - **name** (str，可选) - 具体用法请参见 :ref:`api_guide_Name`，一般无需设置，默认值为 None。
+
+返回
+:::::::::
+
+Tensor，返回一个数据类型同输入的 Tensor。
+
 更多关于 inplace 操作的介绍请参考 `3.1.3 原位（Inplace）操作和非原位操作的区别`_ 了解详情。
 
 .. _3.1.3 原位（Inplace）操作和非原位操作的区别: https://www.paddlepaddle.org.cn/documentation/docs/zh/develop/guides/beginner/tensor_cn.html#id3
diff --git a/docs/api/paddle/index_fill_cn.rst b/docs/api/paddle/index_fill_cn.rst
@@ -3,7 +3,7 @@
 index_fill
 -------------------------------
 
-.. py:function:: paddle.index_fill(x, index, axis, value, name=None)
+.. py:function:: paddle.index_fill(x, index, axis, value, name=None, *, out=None)
 
 依据指定的轴 ``axis`` 和索引 ``indices`` 将指定位置的 ``x`` 填充为 ``value`` 。
 
@@ -18,12 +18,16 @@ index_fill
 参数
 :::::::::
 
-    - **x** （Tensor）– 输入 Tensor。 ``x`` 的数据类型可以是 float16, float32，float64，int32，int64。
+    - **x** （Tensor）– 输入 Tensor。 ``x`` 的数据类型可以是 float16, float32，float64，int32，int64。别名： ``input``。
     - **index** （Tensor）– 包含索引下标的 1-D Tensor。数据类型可以是 int32，int64。
-    - **axis**    (int) – 索引轴。数据类型为 int。
-    - **value** （float）– 用于填充目标张量的值。
+    - **axis**    (int) – 索引轴。数据类型为 int。别名： ``dim``。
+    - **value** （float）– 用于填充目标张量的值。别名： ``values``。
     - **name** (str，可选) - 具体用法请参见 :ref:`api_guide_Name`，一般无需设置，默认值为 None。
 
+关键字参数
+:::::::::
+    - **out** (Tensor，可选) - 输出 Tensor，若不为 ``None``，计算结果将保存在该 Tensor 中，默认值为 ``None``。
+
 返回
 :::::::::
 
