[API Compatibility] logaddexp/logspace/moveaxis/nan_to_num/nanmean/nansum/sgn/signbit/slice_scatter/take/tensordot/tril_indices/triu_indices/trunc/vander Edit By AI Agent

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

Author: zhwesky2010

docs/api/paddle/logaddexp_cn.rst

@@ -3,7 +3,7 @@
 logaddexp
 -------------------------------
 
-.. py:function:: paddle.logaddexp(x, y, name=None)
+.. py:function:: paddle.logaddexp(x, y, name=None, *, out=None)
 
 计算 ``x`` 和 ``y`` 的以 e 为底的指数的和的自然对数。计算公式如下：
 
@@ -12,10 +12,14 @@ logaddexp
 
 参数
 ::::::::::
-    - **x** (Tensor) - 输入的 Tensor，数据类型为：int32，int64，bfloat16，float16，float32、float64。
-    - **y** (Tensor) - 输入的 Tensor，数据类型为：int32，int64，bfloat16，float16，float32、float64。
+    - **x** (Tensor) - 输入的 Tensor，数据类型为：int32，int64，bfloat16，float16，float32、float64。别名 ``input``。
+    - **y** (Tensor) - 输入的 Tensor，数据类型为：int32，int64，bfloat16，float16，float32、float64。别名 ``other``。
     - **name** (str，可选) - 具体用法请参见 :ref:`api_guide_Name`，一般无需设置，默认值为 None。
 
+关键字参数
+::::::::::
+    - **out** (Tensor，可选) - 输出 Tensor，若不为 ``None``，计算结果将保存在该 Tensor 中，默认值为 ``None``。
+
 返回
 ::::::::::
     ``Tensor``，根据上述公式计算的 logaddexp(x) 结果

docs/api/paddle/logspace_cn.rst

@@ -3,7 +3,7 @@
 logspace
 -------------------------------
 
-.. py:function:: paddle.logspace(start, stop, num, base=10.0, dtype=None, name=None)
+.. py:function:: paddle.logspace(start, stop, num, base=10.0, dtype=None, name=None, *, out=None)
 
 返回一个 Tensor，Tensor 的值为在区间 :math:`[base^{start}, base^{stop}]` 上按对数均匀间隔的 :math:`num` 个值，输出 Tensor 的长度为 num。
 
@@ -14,12 +14,17 @@ logspace
 ::::::::::::
 
     - **start** (int|float|Tensor) – ``start`` 是区间开始值以 ``base`` 为底的指数，可以是一个标量，或是一个 shape 为 [] 的 0-D Tensor，该 Tensor 的数据类型可以是 float32、float64、int32 或者 int64。
-    - **stop** (int|float|Tensor) – ``stop`` 是区间结束值以 ``base`` 为底的指数，可以是一个标量，或是一个 shape 为 [] 的 0-D Tensor，该 Tensor 的数据类型可以是 float32、float64、int32 或者 int64。
-    - **num** (int|Tensor) – ``num`` 是给定区间内需要划分的区间数，可以是一个整型标量，或是一个 shape 为 [] 的 0-D Tensor，该 Tensor 的数据类型需为 int32。
+    - **stop** (int|float|Tensor) – ``stop`` 是区间结束值以 ``base`` 为底的指数，可以是一个标量，或是一个 shape 为 [] 的 0-D Tensor，该 Tensor 的数据类型可以是 float32、float64、int32 或者 int64。别名 ``end``。
+    - **num** (int|Tensor) – ``num`` 是给定区间内需要划分的区间数，可以是一个整型标量，或是一个 shape 为 [] 的 0-D Tensor，该 Tensor 的数据类型需为 int32。别名 ``steps``。
     - **base** (int|float|Tensor) – ``base`` 是对数函数的底数，可以是一个标量，或是一个 shape 为 [] 的 0-D Tensor，该 Tensor 的数据类型可以是 float32、float64、int32 或者 int64。
     - **dtype** (str|paddle.dtype|np.dtype，可选) – 输出 Tensor 的数据类型，可以是 float32、float64、int32 或者 int64。如果 dtype 的数据类型为 None，输出 Tensor 数据类型为 float32。
     - **name** (str，可选) - 具体用法请参见 :ref:`api_guide_Name`，一般无需设置，默认值为 None。
 
+关键字参数
+::::::::::::
+    - **out** (Tensor，可选) - 输出 Tensor，若不为 ``None``，计算结果将保存在该 Tensor 中，默认值为 ``None``。
+    - **device** (str|Place，可选) - 输出 Tensor 的设备位置，可以为字符串或 Place 对象。默认值为 None，表示使用当前设备。
+    - **requires_grad** (bool，可选) - 是否计算梯度。默认值为 False。
 
 返回
 ::::::::::::

docs/api/paddle/moveaxis_cn.rst

@@ -13,7 +13,7 @@ moveaxis
     :width: 600
 参数
 :::::::::
-    - **x** (Tensor) - 输入的 N-D Tensor，数据类型为：bool、int32、int64、float32、float64、complex64、complex128。
+    - **x** (Tensor) - 输入的 N-D Tensor，数据类型为：bool、int32、int64、float32、float64、complex64、complex128。别名 ``input``。
     - **source** (int|tuple|list) - 将被移动的轴的位置，其每个元素必须为不同的整数。
     - **destination** (int|tuple|list) - 轴被移动后的目标位置，其每个元素必须为不同的整数。
     - **name** (str，可选) - 具体用法请参见 :ref:`api_guide_Name`，一般无需设置，默认值为 None。

docs/api/paddle/nan_to_num_cn.rst

@@ -3,18 +3,22 @@
 nan_to_num
 -------------------------------
 
-.. py:function:: paddle.nan_to_num(x, nan=0.0, posinf=None, neginf=None, name=None)
+.. py:function:: paddle.nan_to_num(x, nan=0.0, posinf=None, neginf=None, name=None, *, out=None)
 
 替换 x 中的 NaN、+inf、-inf 为指定值。
 
 参数
 :::::::::
-    - **x** (Tensor) - 输入变量，类型为 Tensor， 支持 float32、float64 数据类型。
+    - **x** (Tensor) - 输入变量，类型为 Tensor， 支持 float32、float64 数据类型。别名 ``input``。
     - **nan** (float，可选) - NaN 的替换值，默认为 0。
     - **posinf** (float，可选) - +inf 的替换值，默认为 None，表示使用输入 Tensor 的数据类型所能表示的最大值作为 +inf 的替换值。
     - **neginf** (float，可选) - -inf 的替换值，默认为 None，表示使用输入 Tensor 的数据类型所能表示的最小值作为 -inf 的替换值。
     - **name** (str，可选) - 具体用法请参见 :ref:`api_guide_Name` ，一般无需设置，默认值为 None。
 
+关键字参数
+:::::::::
+    - **out** (Tensor，可选) - 输出 Tensor，若不为 ``None``，计算结果将保存在该 Tensor 中，默认值为 ``None``。
+
 返回
 :::::::::
     - Tensor (Tensor)，将输入 Tensor 中的 NaN、+inf、-inf 替换后的结果。

docs/api/paddle/nanmean_cn.rst

@@ -3,19 +3,24 @@
 nanmean
 -------------------------------
 
-.. py:function:: paddle.nanmean(x, axis=None, keepdim=False, name=None)
+.. py:function:: paddle.nanmean(x, axis=None, keepdim=False, name=None, *, dtype=None, out=None)
 
 
 
 沿 ``axis`` 计算 ``x`` 的平均值，且忽略掉 ``NaNs`` 值。
 
 参数
 ::::::::::
-    - **x** (Tensor) - 输入的 Tensor，数据类型为：bfloat16、float16、float32、float64。
-    - **axis** (int|list|tuple，可选) - 指定对 ``x`` 进行计算的轴。``axis`` 可以是 int、list(int)、tuple(int)。如果 ``axis`` 包含多个维度，则沿着 ``axis`` 中的所有轴进行计算。``axis`` 或者其中的元素值应该在范围[-D, D)内，D 是 ``x`` 的维度。如果 ``axis`` 或者其中的元素值小于 0，则等价于 :math:`axis + D`。如果 ``axis`` 是 None，则对 ``x`` 的全部元素计算平均值。默认值为 None。
+    - **x** (Tensor) - 输入的 Tensor，数据类型为：bfloat16、float16、float32、float64。别名 ``input``。
+    - **axis** (int|list|tuple，可选) - 指定对 ``x`` 进行计算的轴。``axis`` 可以是 int、list(int)、tuple(int)。如果 ``axis`` 包含多个维度，则沿着 ``axis`` 中的所有轴进行计算。``axis`` 或者其中的元素值应该在范围[-D, D)内，D 是 ``x`` 的维度。如果 ``axis`` 或者其中的元素值小于 0，则等价于 :math:`axis + D`。如果 ``axis`` 是 None，则对 ``x`` 的全部元素计算平均值。默认值为 None。别名 ``dim``。
     - **keepdim** (bool，可选) - 是否在输出 Tensor 中保留减小的维度。如果 ``keepdim`` 为 True，则输出 Tensor 和 ``x`` 具有相同的维度(减少的维度除外，减少的维度的大小为 1)。否则，输出 Tensor 的形状会在 ``axis`` 上进行 squeeze 操作。默认值为 False。
     - **name** (str，可选) - 具体用法请参见 :ref:`api_guide_Name`，一般无需设置，默认值为 None。
 
+关键字参数
+::::::::::
+    - **dtype** (str|paddle.dtype|np.dtype，可选) - 输出 Tensor 的数据类型。默认值为 None。
+    - **out** (Tensor，可选) - 输出 Tensor，若不为 ``None``，计算结果将保存在该 Tensor 中，默认值为 ``None``。
+
 返回
 ::::::::::
     ``Tensor``，沿着 ``axis`` 进行平均值计算的结果且忽略掉 ``NaNs`` 值，数据类型和 ``x`` 相同。

docs/api/paddle/nansum_cn.rst

@@ -3,18 +3,27 @@
 nansum
 -------------------------------
 
-.. py:function:: paddle.nansum(x, axis=None, dtype=None, keepdim=False, name=None)
+.. py:function:: paddle.nansum(x, axis=None, dtype=None, keepdim=False, name=None, *, out=None)
 
 计算给定轴上的元素之和，并将非数字元素（NaNs）视为 0。
 
+.. note::
+    此 API 有两种调用方式：
+    1. ``paddle.nansum(x, axis=None, dtype=None, keepdim=False, name=None, *, out=None)`` (Paddle 风格)
+    2. ``paddle.nansum(input, dim=None, keepdim=False, *, dtype=None, out=None)`` (PyTorch 风格)
+
 参数
 :::::::::
-    - **x** (Tensor) - 输入的 Tensor，数据类型为：bfloat16、float16、float32、float64、int32 或 int64。
-    - **axis** (int|list|tuple，可选) - 求和运算的维度。如果为 None，则计算所有元素的和并返回包含单个元素的 Tensor 变量，否则必须在 :math:`[−rank(x),rank(x)]` 范围内。如果 :math:`axis [i] <0`，则维度将变为 :math:`rank+axis[i]`，默认值为 None。
+    - **x** (Tensor) - 输入的 Tensor，数据类型为：bfloat16、float16、float32、float64、int32 或 int64。别名 ``input``。
+    - **axis** (int|list|tuple，可选) - 求和运算的维度。如果为 None，则计算所有元素的和并返回包含单个元素的 Tensor 变量，否则必须在 :math:`[−rank(x),rank(x)]` 范围内。如果 :math:`axis [i] <0`，则维度将变为 :math:`rank+axis[i]`，默认值为 None。别名 ``dim``。
     - **dtype** (str|paddle.dtype|np.dtype，可选) - 输出变量的数据类型。若参数为空，则输出变量的数据类型和输入变量相同，默认值为 None。
     - **keepdim** (bool) - 是否在输出 Tensor 中保留减小的维度。如 keepdim 为 True，否则结果 Tensor 的维度将比输入 Tensor 小，默认值为 False。
     - **name** (str，可选) - 具体用法请参见 :ref:`api_guide_Name`，一般无需设置，默认值为 None。
 
+关键字参数
+:::::::::
+    - **out** (Tensor，可选) - 输出 Tensor，若不为 ``None``，计算结果将保存在该 Tensor 中，默认值为 ``None``。
+
 返回
 :::::::::
 ``Tensor``，在指定维度上进行求和运算的 Tensor，数据类型和输入数据类型一致。

docs/api/paddle/sgn_cn.rst

@@ -3,17 +3,21 @@
 sgn
 -------------------------------
 
-.. py:function:: paddle.sgn(x, name=None)
+.. py:function:: paddle.sgn(x, name=None, *, out=None)
 
 对于复数 Tensor，此函数返回一个新的 Tensor，其元素与 input 元素的角度相同且绝对值为 1。
 
 对于实数 Tensor，对输入参数 ``x`` 中每个元素进行正负判断，并且输出正负判断值：1 代表正，-1 代表负，0 代表零。
 
 参数
 ::::::::::::
-    - **x** (Tensor) – 输入 Tensor，数据类型为 float16、float32、float64、complex64 或 complex128。
+    - **x** (Tensor) – 输入 Tensor，数据类型为 float16、float32、float64、complex64 或 complex128。别名 ``input``。
     - **name** (str，可选) - 具体用法请参见 :ref:`api_guide_Name`，一般无需设置，默认值为 None。
 
+关键字参数
+::::::::::::
+    - **out** (Tensor，可选) - 输出 Tensor，若不为 ``None``，计算结果将保存在该 Tensor 中，默认值为 ``None``。
+
 返回
 ::::::::::::
 Tensor，输出正负号或复数的单位向量，数据的 shape 大小及数据类型和输入 ``x`` 一致。

docs/api/paddle/signbit_cn.rst

@@ -3,15 +3,19 @@
 signbit
 -------------------------------
 
-.. py:function:: paddle.signbit(x, name=None)
+.. py:function:: paddle.signbit(x, name=None, *, out=None)
 
 对输入参数 ``x`` 的每个元素判断是否设置了其符号位，并输出判断值。若存在符号位，则输出 True，否则输出 False。
 
 参数
 ::::::::::::
-    - **x** (Tensor) – 进行符号位判断的多维 Tensor，数据类型为 uint8，int8，int16，int32，int64，bfloat16，float16，float32 或 float64。
+    - **x** (Tensor) – 进行符号位判断的多维 Tensor，数据类型为 uint8，int8，int16，int32，int64，bfloat16，float16，float32 或 float64。别名 ``input``。
     - **name** (str，可选) - 具体用法请参见 :ref:`api_guide_Name`，一般无需设置，默认值为 None。
 
+关键字参数
+::::::::::::
+    - **out** (Tensor，可选) - 输出 Tensor，若不为 ``None``，计算结果将保存在该 Tensor 中，默认值为 ``None``。
+
 返回
 ::::::::::::
 Tensor，输出掩码，数据的 shape 大小及数据类型和输入 ``x`` 一致。

docs/api/paddle/slice_scatter_cn.rst

@@ -7,6 +7,11 @@ slice_scatter
 
 沿着 ``axes`` 将 ``value`` 矩阵的值嵌入到 ``x`` 矩阵。返回一个新的 Tensor 而不是视图。 ``axes`` 需要与 ``starts``, ``ends`` 和 ``strides`` 尺寸一致。
 
+.. note::
+    此 API 有两种调用方式：
+    1. ``paddle.slice_scatter(x, value, axes, starts, ends, strides, name=None)`` (Paddle 风格)
+    2. ``paddle.slice_scatter(input, src, dim=0, start=0, end=None, step=1)`` (PyTorch 风格)
+
 图示展示了示例二 ——一个形状为 [3, 9] 的张量 x，在 axis 1  上使用 slice scatter 操作，将 [3, 1] 的 value 张量嵌入到指定的范围内。图中显示了原始张量、value 张量以及操作后的结果。
 
 .. image:: ../../images/api_legend/slice_scatter.png
@@ -16,12 +21,12 @@ slice_scatter
 
 参数
 :::::::::
-    - **x**  (Tensor) - 输入的 Tensor 作为目标矩阵，数据类型为： ``bool``、 ``float16``、 ``float32``、 ``float64``、 ``uint8``、 ``int8``、 ``int16``、 ``int32``、 ``int64``、 ``bfloat16``、 ``complex64``、 ``complex128``。
-    - **value**  (Tensor) - 需要插入的值，数据类型为： ``bool``、 ``float16``、 ``float32``、 ``float64``、 ``uint8``、 ``int8``、 ``int16``、 ``int32``、 ``int64``、 ``bfloat16``、 ``complex64``、 ``complex128``。
-    - **axes**  (list|tuple) - 指定沿着哪几个维度嵌入对应的值。
-    - **starts**  (list|tuple) - 嵌入的起始索引。
-    - **ends**  (list|tuple) - 嵌入的截止索引。
-    - **strides**  (list|tuple) - 嵌入的步长。
+    - **x**  (Tensor) - 输入的 Tensor 作为目标矩阵，数据类型为： ``bool``、 ``float16``、 ``float32``、 ``float64``、 ``uint8``、 ``int8``、 ``int16``、 ``int32``、 ``int64``、 ``bfloat16``、 ``complex64``、 ``complex128``。别名 ``input``。
+    - **value**  (Tensor) - 需要插入的值，数据类型为： ``bool``、 ``float16``、 ``float32``、 ``float64``、 ``uint8``、 ``int8``、 ``int16``、 ``int32``、 ``int64``、 ``bfloat16``、 ``complex64``、 ``complex128``。别名 ``src``。
+    - **axes**  (list|tuple) - 指定沿着哪几个维度嵌入对应的值。别名 ``dim``。
+    - **starts**  (list|tuple) - 嵌入的起始索引。别名 ``start``。
+    - **ends**  (list|tuple) - 嵌入的截止索引。别名 ``end``。
+    - **strides**  (list|tuple) - 嵌入的步长。别名 ``step``。
     - **name**  (str，可选) - 具体用法请参见 :ref:`api_guide_Name`，一般无需设置，默认值为 ``None``。
 
 返回

docs/api/paddle/special/Overview_cn.rst

@@ -16,3 +16,4 @@ special 函数
 
     " :ref:`softmax <cn_api_paddle_special_softmax>` ", "softmax 函数"
     " :ref:`logsumexp <cn_api_paddle_special_logsumexp>` ", "logsumexp 函数"
+    " :ref:`round <cn_api_paddle_special_round>` ", "round 函数"