[API compatibility] Update 13 API Docs for Parameter Aliases (PaddlePaddle#7389)

* [API compatibility] 13 api docs update of Decorator

* [API compatibility] paddle.unbind

* fix

* fix

* fix

* fix white

* fix codestyle

* fix

Author: DongBaiYue

docs/api/paddle/concat_cn.rst

@@ -14,11 +14,14 @@ concat
    :width: 500
    :alt: 图例
 
+.. note::
+    别名支持: 参数名 ``tensors`` 可替代 ``x``，参数名 ``dim`` 可替代 ``axis`` ，如 ``concat(tensors=tensor_x, dim=1, ...)`` 等价于 ``concat(x=tensor_x, axis=1, ...)`` 。
+
 参数
 ::::::::::::
 
-    - **x** (list|tuple) - 待联结的 Tensor list 或者 Tensor tuple，支持的数据类型为：bool、float16、bfloat16、float32、float64、int8、uint8、int16、uint16、int32、int64、complex64、complex128， ``x`` 中所有 Tensor 的数据类型应该一致。
-    - **axis** (int|Tensor，可选) - 指定对输入 ``x`` 进行运算的轴，可以是整数或者形状为[]的 0-D Tensor，数据类型为 int32 或者 int64。 ``axis`` 的有效范围是 [-R, R)，R 是输入 ``x`` 中 Tensor 的维度，``axis`` 为负值时与 :math:`axis + R` 等价。默认值为 0。
+    - **x** (list|tuple) - 待联结的 Tensor list 或者 Tensor tuple，支持的数据类型为：bool、float16、bfloat16、float32、float64、int8、uint8、int16、uint16、int32、int64、complex64、complex128， ``x`` 中所有 Tensor 的数据类型应该一致。别名： ``tensors``。
+    - **axis** (int|Tensor，可选) - 指定对输入 ``x`` 进行运算的轴，可以是整数或者形状为[]的 0-D Tensor，数据类型为 int32 或者 int64。 ``axis`` 的有效范围是 [-R, R)，R 是输入 ``x`` 中 Tensor 的维度，``axis`` 为负值时与 :math:`axis + R` 等价。默认值为 0。别名： ``dim``。
     - **name** (str，可选) - 具体用法请参见 :ref:`api_guide_Name`，一般无需设置，默认值为 None。
 
 返回

docs/api/paddle/empty_like_cn.rst

@@ -8,10 +8,13 @@ empty_like
 
 根据参数 ``x`` 的 shape 和数据类型 ``dtype`` 创建未初始化的 Tensor。如果 ``dtype`` 为 None，则 Tensor 的数据类型与 ``x`` 相同。
 
+.. note::
+    别名支持: 参数名 ``input`` 可替代 ``x``，如 ``empty_like(input=tensor_x)`` 等价于 ``empty_like(x=tensor_x)`` 。
+
 参数
 ::::::::::::
 
-    - **x** (Tensor) – 输入 Tensor，输出 Tensor 和 x 具有相同的形状，x 的数据类型可以是 bool、float16、float32、float64、int32、int64。
+    - **x** (Tensor) – 输入 Tensor，输出 Tensor 和 x 具有相同的形状，x 的数据类型可以是 bool、float16、float32、float64、int32、int64。别名： ``input``。
     - **dtype** （str|paddle.dtype|np.dtype，可选）- 输出变量的数据类型，可以是 bool、float16、float32、float64、int32、int64。若参数为 None，则输出变量的数据类型和输入变量相同，默认值为 None。
     - **name** (str，可选) - 具体用法请参见 :ref:`api_guide_Name`，一般无需设置，默认值为 None。
 

docs/api/paddle/full_cn.rst

@@ -9,6 +9,9 @@ full
 
 创建形状大小为 ``shape`` 并且数据类型为 ``dtype``  的 Tensor，其中元素值均为 ``fill_value`` 。
 
+.. note::
+    别名支持: 参数名 ``size`` 可替代 ``shape``，如 ``full(size=[2, 3], …)`` 等价于 ``full(shape=[2, 3], …)`` 。
+
 参数
 ::::::::::::
 

docs/api/paddle/nn/functional/softmax_cn.rst

@@ -80,13 +80,14 @@ softmax
                  [0.26762315, 0.26762315, 0.26762315, 0.26762315],
                  [0.72747516, 0.72747516, 0.72747516, 0.72747516]]]
 
+.. note::
+    别名支持: 参数名 ``input`` 可替代 ``x``，参数名 ``dim`` 可替代 ``axis`` ，如 ``softmax(input=tensor_x, dim=1, ...)`` 等价于 ``softmax(x=tensor_x, axis=1, ...)`` 。
 
 参数
 ::::::::::
 
-    - **x** (Tensor) - 输入的 ``Tensor``，数据类型为 bfloat16 、 float16 、 float32 或 float64。
-      ``别名：input``
-    - **axis** (int，可选) - 指定对输入 :attr:`x` 进行运算的轴。:attr:`axis` 的有效范围是 :math:`[-D, D)`，:math:`D` 是输入 :attr:`x` 的维度，:attr:`axis` 为负值时与 :math:`axis + D` 等价。默认值为 -1。
+    - **x** (Tensor) - 输入的 ``Tensor``，数据类型为 bfloat16 、 float16 、 float32 或 float64。别名： ``input``。
+    - **axis** (int，可选) - 指定对输入 :attr:`x` 进行运算的轴。:attr:`axis` 的有效范围是 :math:`[-D, D)`，:math:`D` 是输入 :attr:`x` 的维度，:attr:`axis` 为负值时与 :math:`axis + D` 等价。默认值为 -1。别名： ``dim``。
     - **dtype** (str|paddle.dtype|np.dtype，可选) - 输出 `Tensor` 的数据类型，支持 bfloat16、 float16、 float32、float64。
     - **name** (str，可选) - 具体用法请参见 :ref:`api_guide_Name`，一般无需设置，默认值为 None。
     - **out** (Tensor，可选) - 指定输出结果的 `Tensor`，默认值为 None。

docs/api/paddle/nonzero_cn.rst

@@ -3,7 +3,7 @@
 nonzero
 -------------------------------
 
-.. py:function:: paddle.nonzero(x, as_tuple=False)
+.. py:function:: paddle.nonzero(x, as_tuple=False, *, out=None)
 
 
 
@@ -12,12 +12,20 @@ nonzero
 返回结果是一个 ``shape`` 等于 ``[z x n]`` 的 ``Tensor``，第 ``i`` 行代表输入中第 ``i`` 个非零元素的坐标；当 ``as_tuple = True`` 时，
 返回结果是由 ``n`` 个大小为 ``z`` 的 ``1-D Tensor`` 构成的元组，第 ``i`` 个 ``1-D Tensor`` 记录输入的非零元素在第 ``i`` 维的坐标。
 
+.. note::
+    别名支持: 参数名 ``input`` 可替代 ``x`` ，如 ``nonzero(input=tensor_x)`` 等价于 ``nonzero(x=tensor_x)`` 。
+
 参数
 :::::::::
 
-    - **x** （Tensor）– 输入的 Tensor。
+    - **x** （Tensor）– 输入的 Tensor。别名： ``input``。
     - **as_tuple** (bool，可选) - 返回格式。是否以 ``1-D Tensor`` 构成的元组格式返回。
 
+关键字参数
+:::::::::
+
+    - **out** (Tensor，可选) - 输出 Tensor。默认值为 None。
+
 
 
 返回

docs/api/paddle/outer_cn.rst

@@ -10,11 +10,14 @@ outer
 
 对于 1 维 Tensor 正常计算外积，对于大于 1 维的 Tensor 先展平为 1 维再计算外积。
 
+.. note::
+    别名支持: 参数名 ``input`` 可替代 ``x``，参数名 ``vec2`` 可替代 ``y`` ，如 ``outer(input=tensor_x, vec2=tensor_y, ...)`` 等价于 ``outer(x=tensor_x, y=tensor_y, ...)`` 。
+
 参数
 :::::::::
 
-    - **x** (Tensor) - 一个 N 维 Tensor 或者标量 Tensor。
-    - **y** (Tensor) - 一个 N 维 Tensor 或者标量 Tensor。
+    - **x** (Tensor) - 一个 N 维 Tensor 或者标量 Tensor。别名： ``input``。
+    - **y** (Tensor) - 一个 N 维 Tensor 或者标量 Tensor。别名： ``vec2``。
     - **name** (str，可选) - 具体用法请参见 :ref:`api_guide_Name`，一般无需设置，默认值为 None。
 
 返回

docs/api/paddle/pow_cn.rst

@@ -13,10 +13,13 @@ pow
 
     out = x^{y}
 
+.. note::
+    别名支持: 参数名 ``input`` 可替代 ``x``，参数名 ``exponent`` 可替代 ``y`` ，如 ``pow(input=2, exponent=1.1)`` 等价于 ``pow(x=2, y=1.1)`` 。
+
 参数
 :::::::::
-    - **x** （Tensor）- 多维 ``Tensor``，数据类型为 ``bfloat16`` 、 ``float16`` 、 ``float32`` 、 ``float64`` 、 ``int32`` 或  ``int64`` 。
-    - **y** （float|int|Tensor）- 如果类型是多维 ``Tensor``，其数据类型应该和 ``x`` 相同。
+    - **x** （Tensor）- 多维 ``Tensor``，数据类型为 ``bfloat16`` 、 ``float16`` 、 ``float32`` 、 ``float64`` 、 ``int32`` 或  ``int64`` 。别名： ``input``。
+    - **y** （float|int|Tensor）- 如果类型是多维 ``Tensor``，其数据类型应该和 ``x`` 相同。别名： ``exponent``。
     - **name** (str，可选) - 具体用法请参见 :ref:`api_guide_Name`，一般无需设置，默认值为 None。
 
 返回

docs/api/paddle/reshape_cn.rst

@@ -28,11 +28,14 @@ reshape
 .. image:: ../../images/api_legend/reshape.png
    :alt: 图例
 
+.. note::
+    别名支持: 参数名 ``input`` 可替代 ``x``，如 ``reshape(input=tensor_x, ...)`` 等价于 ``reshape(x=tensor_x, ...)``。
+
 参数
 ::::::::::::
 
-  - **x** (Tensor) - N-D ``Tensor``，数据类型为 ``float16``, ``float32``, ``float64``, ``int16``, ``int32``, ``int64``, ``int8``, ``uint8``, ``complex64``, ``complex128``, ``bfloat16`` 或 ``bool``。
-  - **shape** (list|tuple|Tensor) - 数据类型是 ``int32``。定义目标形状。目标形状最多只能有一个维度为-1。如果 ``shape`` 的类型是 list 或 tuple，它的元素可以是整数或者形状为[]的 ``Tensor``。如果 ``shape`` 的类型是 ``Tensor``，则是 1-D 的 ``Tensor``。
+  - **x** (Tensor) - N-D ``Tensor``，数据类型为 ``float16``, ``float32``, ``float64``, ``int16``, ``int32``, ``int64``, ``int8``, ``uint8``, ``complex64``, ``complex128``, ``bfloat16`` 或 ``bool``。别名： ``input``。
+  - **shape** (list|tuple|Tensor|*shape) - 数据类型是 ``int32``。定义目标形状。目标形状最多只能有一个维度为-1。如果 ``shape`` 的类型是 list 或 tuple，它的元素可以是整数或者形状为[]的 ``Tensor``。如果 ``shape`` 的类型是 ``Tensor``，则是 1-D 的 ``Tensor``。 如果是 ``shape`` 是 \*shape，则直接以可变长参数形式传入整数（例如 ``reshape(tensor_x, 2, 3)``）。
   - **name** (str，可选) - 具体用法请参见 :ref:`api_guide_Name`，一般无需设置，默认值为 None。
 
 返回

docs/api/paddle/unbind_cn.rst

@@ -6,14 +6,16 @@ unbind
 .. py:function:: paddle.unbind(input, axis=0)
 
 
+.. note::
+    别名支持: 参数名 ``dim`` 可替代 ``axis``，如 ``paddle.unbind(input=tensor_x, dim=0)`` 等价于 ``paddle.unbind(input=tensor_x, axis=0)`` 。
 
 
 将输入 Tensor 按照指定的维度分割成多个子 Tensor。
 
 参数
 :::::::::
        - **input** (Tensor) - 输入变量，数据类型为 float16、loat32、float64、int32、int64、complex64、complex128 的多维 Tensor。
-       - **axis** (int32|int64，可选) - 数据类型为 int32 或 int64，表示需要分割的维度。如果 axis < 0，则划分的维度为 rank(input) + axis。默认值为 0。
+       - **axis** (int32|int64，可选) - 数据类型为 int32 或 int64，表示需要分割的维度。如果 axis < 0，则划分的维度为 rank(input) + axis。默认值为 0。别名： ``dim``。
 
 返回
 :::::::::

docs/api/paddle/where_cn.rst

@@ -20,12 +20,15 @@ where
 .. note::
     ``numpy.where(condition)`` 功能与 ``paddle.nonzero(condition, as_tuple=True)`` 相同，可以参考 :ref:`cn_api_paddle_nonzero`。
 
+.. note::
+    别名支持: 参数名 ``input`` 可替代 ``x``，参数名 ``other`` 可替代 ``y`` ，如 ``paddle.where(condition, input=x, other=y)`` 等价于 ``paddle.where(condition, x=x, y=y)`` 。
+
 参数
 ::::::::::::
 
     - **condition** (Tensor) - 选择 ``x`` 或 ``y`` 元素的条件。在为 True（非零值）时，选择 ``x``，否则选择 ``y``。
-    - **x** (Tensor|scalar，可选) - 条件为 True 时选择的 Tensor 或 scalar，数据类型为 bfloat16、 float16、float32、float64、int32 或 int64。``x`` 和 ``y`` 必须都给出或者都不给出。
-    - **y** (Tensor|scalar，可选) - 条件为 False 时选择的 Tensor 或 scalar，数据类型为 bfloat16、float16、float32、float64、int32 或 int64。``x`` 和 ``y`` 必须都给出或者都不给出。
+    - **x** (Tensor|scalar，可选) - 条件为 True 时选择的 Tensor 或 scalar，数据类型为 bfloat16、 float16、float32、float64、int32 或 int64。``x`` 和 ``y`` 必须都给出或者都不给出。别名： ``input``。
+    - **y** (Tensor|scalar，可选) - 条件为 False 时选择的 Tensor 或 scalar，数据类型为 bfloat16、float16、float32、float64、int32 或 int64。``x`` 和 ``y`` 必须都给出或者都不给出。别名： ``other``。
     - **name** (str，可选) - 具体用法请参见 :ref:`api_guide_Name`，一般无需设置，默认值为 None。
 
 返回