Skip to content

[API Compatibility] pow_/remainder_/bernoulli/combinations/trapezoid/frexp/lgamma/kron/kthvalue/poisson/mode/mv Edit By AI Agent #7853

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
sunzhongkai588 merged 2 commits into from
Mar 16, 2026
Merged

[API Compatibility] pow_/remainder_/bernoulli/combinations/trapezoid/frexp/lgamma/kron/kthvalue/poisson/mode/mv Edit By AI Agent #7853

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
2 commits
Select commit Hold shift + click to select a range
b8dad74
[API Compatibility] pow_/remainder_/bernoulli/combinations/trapezoid/…
zhwesky2010 Mar 10, 2026
aa48e94
Merge branch 'develop' of https://github.com/PaddlePaddle/docs into d…
zhwesky2010 Mar 13, 2026
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
10 changes: 7 additions & 3 deletions docs/api/paddle/atan2_cn.rst
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -3,7 +3,7 @@
atan2
-------------------------------

.. py:function:: paddle.atan2(x, y, name=None)
.. py:function:: paddle.atan2(x, y, name=None, *, out=None)



Expand All @@ -23,10 +23,14 @@ atan2
参数
:::::::::

- **x** (Tensor) - 输入的 Tensor，数据类型为：int32、int64、float16、float32、float64。
- **y** (Tensor) - 输入的 Tensor，数据类型为：int32、int64、float16、float32、float64。
- **x** (Tensor) - 输入的 Tensor，数据类型为：int32、int64、float16、float32、float64。别名 ``input`` 。
- **y** (Tensor) - 输入的 Tensor，数据类型为：int32、int64、float16、float32、float64。别名 ``other`` 。
- **name** (str，可选) - 操作的名称（可选，默认值为 None）。更多信息请参见 :ref:`api_guide_Name`。

关键字参数
:::::::::
- **out** (Tensor，可选) - 输出 Tensor，若不为 ``None``，计算结果将保存在该 Tensor 中，默认值为 ``None``。

返回
:::::::::

Expand Down
13 changes: 9 additions & 4 deletions docs/api/paddle/bernoulli_cn.rst
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -3,7 +3,7 @@
bernoulli
-------------------------------

.. py:function:: paddle.bernoulli(x, p=None, name=None)
.. py:function:: paddle.bernoulli(x, p=None, name=None, *, out=None)

对输入 ``x`` 的每一个元素 :math:`x_i`，从以 :math:`x_i` 为参数的伯努利分布（又名两点分布或者 0-1 分布）中抽取一个样本。以 :math:`x_i` 为参数的伯努利分布的概率密度函数是

Expand All @@ -16,9 +16,14 @@ bernoulli
参数
::::::::::::

- **x** (Tensor) - 输入的 Tensor，数据类型为 float32、float64、int32 或 int64。
- **p** (float，可选) - 若指定 ``p``，伯努利分布的参数将全部设为 ``p``。默认值为 None，此时伯努利分布的参数由 ``x`` 决定。
- **name** (str，可选) - 具体用法请参见 :ref:`api_guide_Name`，一般无需设置，默认值为 None。
- **x** (Tensor) - 输入的 Tensor，数据类型为 float32、float64。别名 ``input``。
- **p** (float|None，可选) - 若指定 ``p``，伯努利分布的参数将全部设为 ``p``。默认值为 None，此时伯努利分布的参数由 ``x`` 决定。
- **name** (str|None，可选) - 具体用法请参见 :ref:`api_guide_Name`，一般无需设置，默认值为 None。

关键字参数
::::::::::::

- **out** (Tensor，可选) - 输出 Tensor，若不为 ``None``，计算结果将保存在该 Tensor 中，默认值为 ``None``。

返回
::::::::::::
Expand Down
2 changes: 1 addition & 1 deletion docs/api/paddle/combinations_cn.rst
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -10,7 +10,7 @@ combinations

参数
::::::::::
- **x** (Tensor) - 输入 1-D Tensor ，它的数据类型可以是 float16，float32，float64，int32，int64。
- **x** (Tensor) - 输入 1-D Tensor ，它的数据类型可以是 float16，float32，float64，int32，int64。别名 ``input``。
- **r** (int，可选) - 组合的数长度，默认值为 2。
- **with_replacement** (bool，可选) - 是否允许组合数中出现重复值，默认不允许，默认值为 False。
- **name** (str，可选) - 具体用法请参见 :ref:`api_guide_Name` ，一般无需设置，默认值为 None。
Expand Down
1 change: 0 additions & 1 deletion docs/api/paddle/count_nonzero_cn.rst
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -14,7 +14,6 @@ count_nonzero
- **keepdim** (bool，可选) - 是否在输出 Tensor 中保留被统计的维度。如果 ``keepdim`` 为 True，则输出 Tensor 和 ``x`` 具有相同的维度（被统计的维度大小为 1）；否则，输出 Tensor 会在 ``axis`` 上进行 squeeze 操作。默认值为 False。
- **name** (str，可选) - 具体用法请参见 :ref:`api_guide_Name`，一般无需设置，默认值为 None。


返回
::::::::::
``Tensor``，沿着 ``axis`` 统计输入 Tensor 中非零元素的个数，数据类型 int64。
Expand Down
10 changes: 8 additions & 2 deletions docs/api/paddle/cumulative_trapezoid_cn.rst
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -3,7 +3,7 @@
cumulative_trapezoid
--------------------------------

.. py:function:: paddle.cumulative_trapezoid(y, x=None, dx=None, axis=-1, name=None)
.. py:function:: paddle.cumulative_trapezoid(y, x=None, dx=None, axis=-1, name=None, *, out=None)

在指定维度上对输入实现 `trapezoid rule <https://en.wikipedia.org/wiki/Trapezoidal_rule>`_ 算法。与 :ref:`cn_api_paddle_trapezoid` 的区别是，所用累积求和函数为 cumsum。

Expand All @@ -14,8 +14,14 @@ cumulative_trapezoid
- **y** (Tensor) - 输入多维 Tensor，可选的数据类型为 float16、float32、float64。
- **x** (Tensor，可选) - ``y`` 中数值对应的浮点数所组成的 Tensor，类型与 ``y`` 相同，形状与 ``y`` 的形状相匹配；若 ``x`` 有输入，已知 ``y`` 的尺寸为 `[d_1, d_2, ... , d_n]` 且 `axis=k`，则 ``x`` 的尺寸只能为 `[d_k]` 或 `[d_1, d_2, ... , d_n]`；如果 ``x`` 为 None，则假定采样点均匀分布 ``dx``。
- **dx** (float，可选) - 相邻采样点之间的常数间隔；当 ``x`` 和 ``dx`` 均未指定时，``dx`` 默认为 1.0。
- **axis** (int，可选) - 计算 trapezoid rule 时 ``y`` 的维度。默认值 -1。
- **axis** (int，可选) - 计算 trapezoid rule 时 ``y`` 的维度。默认值 -1。别名 ``dim``。
- **name** (str，可选) - 具体用法请参见 :ref:`api_guide_Name`，一般无需设置，默认值为 None。

关键字参数
:::::::::

- **out** (Tensor，可选) - 输出 Tensor，若不为 ``None``，计算结果将保存在该 Tensor 中，默认值为 ``None``。

返回
:::::::::
Tensor，按 trapezoidal rule 计算出 ``y`` 等于 N 维张量时的定积分，结果为 N 维张量。
Expand Down
6 changes: 5 additions & 1 deletion docs/api/paddle/floor_divide__cn.rst
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -4,8 +4,12 @@ floor_divide\_
-------------------------------

.. py:function:: paddle.floor_divide_(x, y, name=None)
Inplace 版本的 :ref:`cn_api_paddle_floor_divide` API，对输入 x 采用 Inplace 策略。

Inplace 版本的 :ref:`cn_api_paddle_floor_divide` 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``，参数名 ``other`` 可替代 ``y``，如 ``floor_divide_(input=tensor_x, other=tensor_y)`` 等价于 ``floor_divide_(x=tensor_x, y=tensor_y)``。
12 changes: 8 additions & 4 deletions docs/api/paddle/frexp_cn.rst
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -3,15 +3,19 @@
frexp
-------------------------------

.. py:function:: paddle.frexp(x, name)
.. py:function:: paddle.frexp(x, name=None, *, out=None)


用于把一个浮点数分解为尾数和指数的函数，返回一个尾数 Tensor 和一个指数 Tensor
用于把一个浮点数分解为尾数和指数的函数，返回一个尾数 Tensor 和一个指数 Tensor。

参数
::::::::::
- **x** (Tensor) – 输入是一个多维的 Tensor，它的数据类型可以是 float32，float64。
- **x** (Tensor) – 输入是一个多维的 Tensor，它的数据类型可以是 float32，float64。别名 ``input``。
- **name** (str，可选) - 具体用法请参见 :ref:`api_guide_Name` ，一般无需设置，默认值为 None。

关键字参数
::::::::::
- **out** (tuple[Tensor, Tensor]，可选) - 输出 Tensor，若不为 ``None``，计算结果将保存在该 Tensor 元组中，默认值为 ``None``。

返回
::::::::::
mantissa（Tensor）：分解后的尾数，类型为 Tensor，形状和原输入的形状一致。
Expand Down
8 changes: 6 additions & 2 deletions docs/api/paddle/isneginf_cn.rst
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -3,15 +3,19 @@
isneginf
-----------------------------

.. py:function:: paddle.isneginf(x, name=None)
.. py:function:: paddle.isneginf(x, name=None, *, out=None)

返回输入 tensor 的每一个值是否为 ``-INF`` 。

参数
:::::::::
- **x** (Tensor)：输入的 `Tensor`，数据类型为：float16、float32、float64、int8、int16、int32、int64、uint8。
- **x** (Tensor)：输入的 `Tensor`，数据类型为：float16、float32、float64、int8、int16、int32、int64、uint8。别名: ``input``。
- **name** (str，可选) - 具体用法请参见 :ref:`api_guide_Name`，一般无需设置，默认值为 None。

关键字参数
:::::::::
- **out** (Tensor，可选) - 输出 Tensor，若不为 ``None``，计算结果将保存在该 Tensor 中，默认值为 ``None``。

返回
:::::::::
``Tensor``，每个元素是一个 bool 值，表示输入 ``x`` 的每个元素是否为 ``-INF`` 。
Expand Down
8 changes: 6 additions & 2 deletions docs/api/paddle/isposinf_cn.rst
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -3,15 +3,19 @@
isposinf
-----------------------------

.. py:function:: paddle.isposinf(x, name=None)
.. py:function:: paddle.isposinf(x, name=None, *, out=None)

返回输入 tensor 的每一个值是否为 ``+INF`` 。

参数
:::::::::
- **x** (Tensor)：输入的 `Tensor`，数据类型为：float16、float32、float64、int8、int16、int32、int64、uint8。
- **x** (Tensor)：输入的 `Tensor`，数据类型为：bfloat16、float16、float32、float64、int8、int16、int32、int64、uint8。别名: ``input``。
- **name** (str，可选) - 具体用法请参见 :ref:`api_guide_Name`，一般无需设置，默认值为 None。

关键字参数
:::::::::
- **out** (Tensor，可选) - 输出 Tensor，若不为 ``None``，计算结果将保存在该 Tensor 中，默认值为 ``None``。

返回
:::::::::
``Tensor``，每个元素是一个 bool 值，表示输入 ``x`` 的每个元素是否为 ``+INF`` 。
Expand Down
2 changes: 1 addition & 1 deletion docs/api/paddle/isreal_cn.rst
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -10,7 +10,7 @@ isreal

参数
:::::::::
- **x** (Tensor) - 输入 Tensor。
- **x** (Tensor) - 输入 Tensor。别名: ``input``。
- **name** (str，可选) - 具体用法请参见 :ref:`api_guide_Name`，一般无需设置，默认值为 None。

返回
Expand Down
16 changes: 8 additions & 8 deletions docs/api/paddle/kron_cn.rst
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -3,11 +3,7 @@
kron
-------------------------------

.. py:function:: paddle.kron(x, y, out=None, name=None)




.. py:function:: paddle.kron(x, y, name=None, *, out=None)

Kronecker Product 算子。

Expand Down Expand Up @@ -35,11 +31,15 @@ Kronecker Product 算子。
参数
::::::::::::

- **x** (Tensor) – Kron OP 的第一个输入。多维 Tensor，数据类型为 bfloat16、float16、float32、float64、int32 或 int64。
- **y** (Tensor) – Kron OP 的第二个输入。多维 Tensor，数据类型为 bfloat16、float16、float32、float64、int32 或 int64，与 x 相同。
- **out** (Tensor，可选) - 指定算子输出结果的 Tensor，可以是程序中已经创建的任何 Tensor。默认值为 None，此时将创建新的 Tensor 来保存输出结果。
- **x** (Tensor) – Kron OP 的第一个输入。多维 Tensor，数据类型为 bfloat16、float16、float32、float64、int32 或 int64。别名 ``input``。
- **y** (Tensor) – Kron OP 的第二个输入。多维 Tensor，数据类型为 bfloat16、float16、float32、float64、int32 或 int64，与 x 相同。别名 ``other``。
- **name** (str，可选) - 具体用法请参见 :ref:`api_guide_Name`，一般无需设置，默认值为 None。

关键字参数
::::::::::::

- **out** (Tensor，可选) - 输出 Tensor，若不为 ``None``，计算结果将保存在该 Tensor 中，默认值为 ``None``。

返回
::::::::::::

Expand Down
10 changes: 7 additions & 3 deletions docs/api/paddle/kthvalue_cn.rst
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -3,18 +3,22 @@
kthvalue
-------------------------------

.. py:function:: paddle.kthvalue(x, k, axis=None, keepdim=False, name=None)
.. py:function:: paddle.kthvalue(x, k, axis=None, keepdim=False, name=None, *, out=None)

在指定的轴上查找第 k 小的元素和其对应所在的索引信息。

参数
:::::::::
- **x** （Tensor） - 一个输入的 N-D ``Tensor``，支持的数据类型：float32、float64、int32、int64。
- **x** （Tensor） - 一个输入的 N-D ``Tensor``，支持的数据类型：float16、float32、float64、int32、int64。别名 ``input``。
- **k** （int，Tensor） - 需要沿轴查找的第 ``k`` 小，所对应的 ``k`` 值。
- **axis** （int，可选） - 指定对输入 Tensor 进行运算的轴，``axis`` 的有效范围是[-R, R），R 是输入 ``x`` 的 Rank， ``axis`` 为负时与 ``axis`` + R 等价。默认值为-1。
- **axis** （int，可选） - 指定对输入 Tensor 进行运算的轴，``axis`` 的有效范围是[-R, R），R 是输入 ``x`` 的 Rank， ``axis`` 为负时与 ``axis`` + R 等价。默认值为-1。别名 ``dim``。
- **keepdim** (bool，可选）- 是否保留指定的轴。如果是 True，维度会与输入 x 一致，对应所指定的轴的 size 为 1。否则，由于对应轴被展开，输出的维度会比输入小 1。默认值为 False。
- **name** (str，可选) - 具体用法请参见 :ref:`api_guide_Name`，一般无需设置，默认值为 None。

关键字参数
:::::::::
- **out** (Tensor，可选) - 输出 Tensor，若不为 ``None``，计算结果将保存在该 Tensor 中，默认值为 ``None``。

返回
:::::::::
tuple（Tensor），返回第 k 小的元素和对应的索引信息。结果的数据类型和输入 ``x`` 一致。索引的数据类型是 int64。
Expand Down
5 changes: 0 additions & 5 deletions docs/api/paddle/lgamma_cn.rst
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -5,13 +5,8 @@ lgamma

.. py:function:: paddle.lgamma(x, name=None)




计算输入 x 的 gamma 函数的自然对数并返回。

.. math::
out = log\Gamma(x)

参数
:::::::::
Expand Down
12 changes: 8 additions & 4 deletions docs/api/paddle/logcumsumexp_cn.rst
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -3,7 +3,7 @@
logcumsumexp
-------------------------------

.. py:function:: paddle.logcumsumexp(x, axis=None, dtype=None, name=None)
.. py:function:: paddle.logcumsumexp(x, axis=None, dtype=None, name=None, *, out=None)

计算 x 的指数的前缀和的对数。

Expand All @@ -18,14 +18,18 @@ logcumsumexp

参数
:::::::::
- **x** (Tensor) - 需要进行操作的 Tensor。
- **axis** (int，可选) - 指明需要计算的维度。-1 代表最后一维。默认：None，将输入展开为一维变量再进行计算。
- **x** (Tensor) - 需要进行操作的 Tensor，数据类型为 float32、float64、float16、bfloat16、uint8、int8、int16、int32、int64。别名 ``input``。
- **axis** (int，可选) - 指明需要计算的维度。-1 代表最后一维。默认：None，将输入展开为一维变量再进行计算。别名 ``dim``。
- **dtype** (str|paddle.dtype|np.dtype，可选) - 输出 Tensor 的数据类型，支持 float16、float32、float64。如果指定了，那么在执行操作之前，输入 Tensor 将被转换为 dtype。这对于防止数据类型溢出非常有用。默认为：None。
- **name** (str，可选) - 具体用法请参见 :ref:`api_guide_Name`，一般无需设置，默认值为 None。

关键字参数
:::::::::
- **out** (Tensor，可选) - 输出 Tensor，若不为 ``None``，计算结果将保存在该 Tensor 中，默认值为 ``None``。

返回
:::::::::
- Tensor (Tensor)，x 的指数的前缀和的对数。
- Tensor (Tensor)，x 的指数的前缀和的对数（整数输入类型会自动转换为 float32）。


代码示例
Expand Down
10 changes: 7 additions & 3 deletions docs/api/paddle/mode_cn.rst
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -3,17 +3,21 @@
mode
-------------------------------

.. py:function:: paddle.mode(x, axis=-1, keepdim=False, name=None)
.. py:function:: paddle.mode(x, axis=-1, keepdim=False, name=None, *, out=None)

沿着可选的 ``axis`` 查找对应轴上的众数和结果所在的索引信息。

参数
:::::::::
- **x** （Tensor） - 输入的多维 ``Tensor``，支持的数据类型：float32、float64、int32、int64。
- **axis** （int，可选） - 指定对输入 Tensor 进行运算的轴，``axis`` 的有效范围是[-R, R），R 是输入 ``x`` 的 Rank， ``axis`` 为负时与 ``axis`` + R 等价。默认值为-1。
- **x** （Tensor） - 输入的多维 ``Tensor``，支持的数据类型：float32、float64、int32、int64。别名 ``input``。
- **axis** （int，可选） - 指定对输入 Tensor 进行运算的轴，``axis`` 的有效范围是[-R, R），R 是输入 ``x`` 的 Rank， ``axis`` 为负时与 ``axis`` + R 等价。默认值为-1。别名 ``dim``。
- **keepdim** （bool，可选）- 是否保留指定的轴。如果是 True，维度会与输入 x 一致，对应所指定的轴的 size 为 1。否则，由于对应轴被展开，输出的维度会比输入小 1。默认值为 1。
- **name** （str，可选） - 具体用法请参见 :ref:`api_guide_Name`，一般无需设置，默认值为 None。

关键字参数
:::::::::
- **out** (tuple[Tensor, Tensor]，可选) - 输出 Tensor，若不为 ``None``，计算结果将保存在该 Tensor 中，默认值为 ``None``。

返回
:::::::::
tuple（Tensor），返回检索到的众数结果和对应索引信息。结果的数据类型和输入 ``x`` 一致。索引的数据类型是 int64。
Comment on lines 14 to 23
Copy link

Copilot AI Mar 10, 2026

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

mode 文档中 keepdim 参数说明写“默认值为 1”，但函数签名为 keepdim=False；另外 out 类型是 tuple[Tensor, Tensor]，描述里仍用“该 Tensor”指代单个 Tensor。建议将 keepdim 默认值与签名一致，并明确 out 为 (values, indices) 两个 Tensor 的元组。

Suggested change
- **keepdim** （bool，可选）- 是否保留指定的轴。如果是 True，维度会与输入 x 一致，对应所指定的轴的 size 为 1。否则，由于对应轴被展开，输出的维度会比输入小 1。默认值为 1。
- **name** （str，可选） - 具体用法请参见 :ref:`api_guide_Name`，一般无需设置，默认值为 None。
关键字参数
:::::::::
- **out** (tuple[Tensor, Tensor]，可选) - 输出 Tensor，若不为 ``None``，计算结果将保存在该 Tensor 中，默认值为 ``None``。
返回
:::::::::
tuple（Tensor），返回检索到的众数结果和对应索引信息。结果的数据类型和输入 ``x`` 一致。索引的数据类型是 int64。
- **keepdim** （bool，可选）- 是否保留指定的轴。如果是 True，维度会与输入 x 一致，对应所指定的轴的 size 为 1。否则，由于对应轴被展开，输出的维度会比输入小 1。默认值为 False。
- **name** （str，可选） - 具体用法请参见 :ref:`api_guide_Name`，一般无需设置，默认值为 None。
关键字参数
:::::::::
- **out** (tuple[Tensor, Tensor]，可选) - 输出结果元组 ``(values, indices)``，若不为 ``None``，计算得到的众数结果及其对应索引信息将分别保存在该元组中的两个 Tensor 中，默认值为 ``None``。
返回
:::::::::
tuple(Tensor, Tensor)，即 ``(values, indices)``。第一个 Tensor 为检索到的众数结果，数据类型和输入 ``x`` 一致；第二个 Tensor 为对应的索引信息，数据类型为 int64。

Copilot uses AI. Check for mistakes.
Expand Down
8 changes: 6 additions & 2 deletions docs/api/paddle/mv_cn.rst
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -3,16 +3,20 @@
mv
-------------------------------

.. py:function:: paddle.mv(x, vec, name=None)
.. py:function:: paddle.mv(x, vec, name=None, *, out=None)

计算矩阵 ``x`` 和向量 ``vec`` 的乘积。

参数
:::::::::
- **x** (Tensor) - 输入变量，类型为 Tensor，形状为 :math:`[M, N]`，数据类型为 float32、float64。
- **x** (Tensor) - 输入变量，类型为 Tensor，形状为 :math:`[M, N]`，数据类型为 float32、float64。别名 ``input``。
- **vec** (Tensor) - 输入变量，类型为 Tensor，形状为 :math:`[N]`，数据类型为 float32、float64。
- **name** (str，可选) - 具体用法请参见 :ref:`api_guide_Name`，一般无需设置，默认值为 None。

关键字参数
:::::::::
- **out** (Tensor，可选) - 输出 Tensor，若不为 ``None``，计算结果将保存在该 Tensor 中，默认值为 ``None``。

返回
:::::::::

Expand Down
2 changes: 1 addition & 1 deletion docs/api/paddle/poisson_cn.rst
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -12,7 +12,7 @@ poisson

参数
:::::::::
- **x** (Tensor) - Tensor 的每个元素，对应泊松分布的 ``lambda`` 参数。数据类型为：bfloat16, float16, float32、float64。
- **x** (Tensor) - Tensor 的每个元素，对应泊松分布的 ``lambda`` 参数。数据类型为：bfloat16, float16, float32、float64。别名 ``input``。
Copy link

Copilot AI Mar 10, 2026

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

此处数据类型列表同时混用了英文逗号和中文顿号（bfloat16, float16, float32、float64），标点不一致。建议统一为中文文档常用格式（例如全部用 、 分隔），提升可读性与一致性。

Suggested change
- **x** (Tensor) - Tensor 的每个元素，对应泊松分布的 ``lambda`` 参数。数据类型为：bfloat16, float16, float32、float64。别名 ``input``。
- **x** (Tensor) - Tensor 的每个元素，对应泊松分布的 ``lambda`` 参数。数据类型为：bfloat16、float16、float32、float64。别名 ``input``。

Copilot uses AI. Check for mistakes.
- **name** (str，可选) - 具体用法请参见 :ref:`api_guide_Name`，一般无需设置，默认值为 None。

返回
Expand Down
5 changes: 4 additions & 1 deletion docs/api/paddle/pow__cn.rst
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -3,9 +3,12 @@
pow\_
-------------------------------

.. py:function:: paddle.pow_(x,y,name=None)
.. py:function:: paddle.pow_(x, y, name=None)
Inplace 版本的 :ref:`cn_api_paddle_pow` 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``，参数名 ``exponent`` 可替代 ``y``，如 ``pow_(input=tensor_x, exponent=2)`` 等价于 ``pow_(x=tensor_x, y=2)``。
3 changes: 3 additions & 0 deletions docs/api/paddle/squeeze__cn.rst
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -10,3 +10,6 @@ Inplace 版本的 :ref:`cn_api_paddle_squeeze` API，对输入 ``x`` 采用 Inpl
更多关于 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``，参数名 ``dim`` 可替代 ``axis``，如 ``squeeze_(input=tensor_x, dim=1)`` 等价于 ``squeeze_(x=tensor_x, axis=1)``。
Loading
Loading