[API Compatibility] select_scatter/sgn/signbit/slice_scatter/take/tensordot/tril_indices/triu_indices/vander/logaddexp/logspace/moveaxis/nan_to_num/nanmean/nansum/masked_fill/addmv/addr/fix/histc/trunc Edit By AI Agent (#7909)

Co-authored-by: zhouwei25 <zhouwei25@baidu.com>
Co-authored-by: Claude Opus 4.6 <noreply@anthropic.com>

Author: 3 people

docs/api/paddle/addmv_cn.rst

@@ -0,0 +1,32 @@
+.. _cn_api_paddle_addmv:
+
+addmv
+-------------------------------
+
+.. py:function:: paddle.addmv(input, mat, vec, beta=1, alpha=1, name=None, *, out=None)
+
+执行矩阵 ``mat`` 和向量 ``vec`` 的矩阵-向量乘法，并将其加到输入 Tensor 上。
+
+公式为：out = beta * input + alpha * (mat @ vec)
+
+参数
+:::::::::
+    - **input** (Tensor) - 待加的输入 Tensor。
+    - **mat** (Tensor) - 待乘的矩阵。
+    - **vec** (Tensor) - 待乘的向量。
+    - **beta** (float，可选) - input 的乘数，默认值为 1。
+    - **alpha** (float，可选) - mat @ vec 的乘数，默认值为 1。
+    - **name** (str，可选) - 操作名称，默认值为 None。
+
+关键字参数
+:::::::::
+    - **out** (Tensor，可选) - 输出 Tensor，若不为 ``None``，计算结果将保存在该 Tensor 中，默认值为 ``None``。
+
+返回
+:::::::::
+Tensor：计算结果 Tensor。
+
+代码示例
+:::::::::
+
+COPY-FROM: paddle.addmv

docs/api/paddle/addr_cn.rst

@@ -0,0 +1,32 @@
+.. _cn_api_paddle_addr:
+
+addr
+-------------------------------
+
+.. py:function:: paddle.addr(input, vec1, vec2, beta=1, alpha=1, name=None, *, out=None)
+
+执行向量 ``vec1`` 和向量 ``vec2`` 的外积，并将其加到输入矩阵上。
+
+公式为：out = beta * input + alpha * (vec1 outer vec2)
+
+参数
+:::::::::
+    - **input** (Tensor) - 待加的输入 Tensor。
+    - **vec1** (Tensor) - 第一个向量。
+    - **vec2** (Tensor) - 第二个向量。
+    - **beta** (float，可选) - input 的乘数，默认值为 1。
+    - **alpha** (float，可选) - 外积的乘数，默认值为 1。
+    - **name** (str，可选) - 操作名称，默认值为 None。
+
+关键字参数
+:::::::::
+    - **out** (Tensor，可选) - 输出 Tensor，若不为 ``None``，计算结果将保存在该 Tensor 中，默认值为 ``None``。
+
+返回
+:::::::::
+Tensor：计算结果 Tensor。
+
+代码示例
+:::::::::
+
+COPY-FROM: paddle.addr

docs/api/paddle/erf__cn.rst

@@ -10,3 +10,7 @@ Inplace 版本的 :ref:`cn_api_paddle_erf` API，对输入 x 采用 Inplace 策
 更多关于 inplace 操作的介绍请参考 `3.1.3 原位（Inplace）操作和非原位操作的区别`_ 了解详情。
 
 .. _3.1.3 原位（Inplace）操作和非原位操作的区别: https://www.paddlepaddle.org.cn/documentation/docs/zh/develop/guides/beginner/tensor_cn.html#id3
+
+.. note::
+
+    别名支持：参数名 ``input`` 可替代 ``x``，如 ``erf_(input=tensor_x)`` 等价于 ``erf_(x=tensor_x)``。

docs/api/paddle/expm1__cn.rst

@@ -10,3 +10,7 @@ Inplace 版本的 :ref:`cn_api_paddle_expm1` API，对输入 ``x`` 采用 Inplac
 更多关于 inplace 操作的介绍请参考 `3.1.3 原位（Inplace）操作和非原位操作的区别`_ 了解详情。
 
 .. _3.1.3 原位（Inplace）操作和非原位操作的区别: https://www.paddlepaddle.org.cn/documentation/docs/zh/develop/guides/beginner/tensor_cn.html#id3
+
+.. note::
+
+    别名支持：参数名 ``input`` 可替代 ``x``，如 ``expm1_(input=tensor_x)`` 等价于 ``expm1_(x=tensor_x)``。

docs/api/paddle/fix_cn.rst

@@ -0,0 +1,26 @@
+.. _cn_api_paddle_fix:
+
+fix
+-------------------------------
+
+.. py:function:: paddle.fix(input, name=None, *, out=None)
+
+返回输入 Tensor 的截断整数值。与 ``paddle.trunc`` 功能相同。
+
+参数
+:::::::::
+    - **input** (Tensor) - 输入 Tensor，数据类型为 int32、int64、float32、float64。别名 ``x``。
+    - **name** (str，可选) - 操作名称，默认值为 None。
+
+关键字参数
+:::::::::
+    - **out** (Tensor，可选) - 输出 Tensor，若不为 ``None``，计算结果将保存在该 Tensor 中，默认值为 ``None``。
+
+返回
+:::::::::
+Tensor：截断后的 Tensor。
+
+代码示例
+:::::::::
+
+COPY-FROM: paddle.fix

docs/api/paddle/histc_cn.rst

@@ -0,0 +1,31 @@
+.. _cn_api_paddle_histc:
+
+histc
+-------------------------------
+
+.. py:function:: paddle.histc(input, bins=100, min=0.0, max=0.0, name=None, *, out=None)
+
+计算 Tensor 的直方图。
+
+元素被分配到 min 和 max 之间的等宽区间中。如果 min 和 max 都为零，则使用数据的最小值和最大值。
+
+参数
+:::::::::
+    - **input** (Tensor) - 输入 Tensor。
+    - **bins** (int，可选) - 直方图区间数，默认值为 100。
+    - **min** (float，可选) - 范围的下端（包含），默认值为 0.0。
+    - **max** (float，可选) - 范围的上端（包含），默认值为 0.0。
+    - **name** (str，可选) - 操作名称，默认值为 None。
+
+关键字参数
+:::::::::
+    - **out** (Tensor，可选) - 输出 Tensor，若不为 ``None``，计算结果将保存在该 Tensor 中，默认值为 ``None``。
+
+返回
+:::::::::
+Tensor：直方图 Tensor，数据类型为 float32。
+
+代码示例
+:::::::::
+
+COPY-FROM: paddle.histc

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, device=None, requires_grad=False)
 
 返回一个 Tensor，Tensor 的值为在区间 :math:`[base^{start}, base^{stop}]` 上按对数均匀间隔的 :math:`num` 个值，输出 Tensor 的长度为 num。
 
@@ -14,12 +14,18 @@ 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** (PlaceLike，可选) - 输出 Tensor 的设备，默认值为 ``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 替换后的结果。