[API Compatibility] add many api (PaddlePaddle#7411)

* update

* update

* update

* update

Author: aquagull

docs/api/paddle/Tensor_cn.rst

@@ -1777,7 +1777,7 @@ index_put(indices, value, accumulate=False, name=None)
 
 请参考 :ref:`cn_api_paddle_index_put`
 
-repeat_interleave(repeats, axis=None, name=None)
+repeat_interleave(repeats, axis=None, name=None, \*, output_size=None)
 :::::::::
 
 返回：计算后的 Tensor
@@ -2061,7 +2061,7 @@ max(axis=None, keepdim=False, name=None)
 
 请参考 :ref:`cn_api_paddle_max`
 
-amax(axis=None, keepdim=False, name=None)
+amax(axis=None, keepdim=False, name=None, \*, out=None)
 :::::::::
 
 返回：计算后的 Tensor
@@ -2070,7 +2070,7 @@ amax(axis=None, keepdim=False, name=None)
 
 请参考 :ref:`cn_api_paddle_amax`
 
-maximum(y, axis=-1, name=None)
+maximum(y, axis=-1, name=None, \*, out=None)
 :::::::::
 
 返回：计算后的 Tensor
@@ -2115,7 +2115,7 @@ min(axis=None, keepdim=False, name=None)
 
 请参考 :ref:`cn_api_paddle_min`
 
-amin(axis=None, keepdim=False, name=None)
+amin(axis=None, keepdim=False, name=None, \*, out=None)
 :::::::::
 
 返回：计算后的 Tensor
@@ -2124,7 +2124,7 @@ amin(axis=None, keepdim=False, name=None)
 
 请参考 :ref:`cn_api_paddle_amin`
 
-minimum(y, axis=-1, name=None)
+minimum(y, axis=-1, name=None, \*, out=None)
 :::::::::
 
 返回：计算后的 Tensor
@@ -2680,7 +2680,7 @@ vsplit(num_or_indices, name=None)
 
 请参考 :ref:`cn_api_paddle_vsplit`
 
-sqrt(name=None)
+sqrt(name=None, \*, out=None)
 :::::::::
 
 返回：计算后的 Tensor
@@ -2808,6 +2808,22 @@ tile(repeat_times, name=None)
 
 请参考 :ref:`cn_api_paddle_tile`
 
+repeat(\*repeats, name=None)
+:::::::::
+
+沿着指定维度重复当前 Tensor。返回一个新的 Tensor，其形状为当前 Tensor 的形状与 sizes 的乘积。
+
+参数：
+    - **repeats** (tuple|list|int) - 指定每个维度重复的次数。可以是单个整数，也可以是元组或列表。
+    - **name** (str，可选) - 具体用法请参见 :ref:`api_guide_Name`，一般无需设置，默认值为 None。
+
+返回：重复后的 Tensor
+
+返回类型：Tensor
+
+**代码示例**
+COPY-FROM: paddle.Tensor.repeat
+
 to(*args, **kwargs)
 :::::::::
 
@@ -2838,7 +2854,7 @@ tolist()
 
 请参考 :ref:`cn_api_paddle_tolist`
 
-topk(k, axis=None, largest=True, sorted=True, name=None)
+topk(k, axis=None, largest=True, sorted=True, name=None, \*, out=None)
 :::::::::
 
 返回：计算后的 Tensor
@@ -2865,6 +2881,15 @@ transpose(perm, name=None)
 
 请参考 :ref:`cn_api_paddle_transpose`
 
+permute(dims, name=None)
+:::::::::
+
+返回：计算后的 Tensor
+
+返回类型：Tensor
+
+请参考 :ref:`cn_api_paddle_permute`
+
 triangular_solve(b, upper=True, transpose=False, unitriangular=False, name=None)
 :::::::::
 

docs/api/paddle/compat/Overview_cn.rst

@@ -19,6 +19,8 @@ PyTorch 兼容函数
     " :ref:`softmax <cn_api_paddle_compat_softmax>` ", "softmax 函数"
     " :ref:`sort <cn_api_paddle_compat_sort>` ", "同时返回 values 及 indices 的排序"
     " :ref:`split <cn_api_paddle_compat_split>` ", "允许非整除块大小输入的 Tensor 轴向切分"
+    " :ref:`median <cn_api_paddle_compat_median>` ", "兼容版中位数，支持 dim/keepdim/out 签名"
+    " :ref:`nanmedian <cn_api_paddle_compat_nanmedian>` ", "忽略 NaN 的兼容版中位数，支持 dim/keepdim/out 签名"
 
 
 .. _about_compat_class:

docs/api/paddle/compat/median_cn.rst

@@ -0,0 +1,30 @@
+.. _cn_api_paddle_compat_median:
+
+median
+-------------------------------
+
+.. py:function:: paddle.compat.median(input, dim=None, keepdim=False, *, out=None)
+
+PyTorch 兼容的 :ref:`cn_api_paddle_median` 版本，提供完全一致的函数签名与行为：
+- 当 ``dim`` 为 ``None`` 时，返回所有元素的中位数。
+- 当 ``dim`` 指定维度时，返回该维度的中位数与对应索引。
+
+.. note::
+   此 API 遵循 ``torch.median`` 的函数签名和行为以实现 PyTorch 兼容。如需使用 Paddle 原生实现，请参考 :ref:`cn_api_paddle_median`。
+
+参数
+::::::::::
+- **input** (Tensor) - 输入 N 维 Tensor，支持 bool、bfloat16、float16、float32、float64、int32、int64 数据类型。
+- **dim** (int，可选) - 指定计算中位数的维度。为 ``None`` 时计算全局中位数。默认 ``None``。
+- **keepdim** (bool，可选) - 是否保留被约简的维度。默认 ``False``。
+- **out** (tuple(Tensor, Tensor)|Tensor，可选) - 关键字参数。当指定 ``dim`` 时，可传入二元组 ``(values, indices)`` 用于原位写回中位数与索引；当未指定 ``dim`` 时，可传入单个 ``Tensor`` 用于写回标量结果。默认 ``None``。
+
+返回
+::::::::::
+- 当 ``dim`` 为 ``None``：返回一个标量 ``Tensor``，为 ``input`` 的中位数。
+- 当 ``dim`` 指定：返回具名元组 ``(values, indices)``，分别是中位数与其索引。
+
+代码示例
+::::::::::
+
+COPY-FROM: paddle.compat.median

docs/api/paddle/compat/nanmedian_cn.rst

@@ -0,0 +1,31 @@
+.. _cn_api_paddle_compat_nanmedian:
+
+nanmedian
+-------------------------------
+
+.. py:function:: paddle.compat.nanmedian(input, *, dim=None, keepdim=False, *, out=None)
+
+PyTorch 兼容的 :ref:`cn_api_paddle_nanmedian` 版本，提供完全一致的函数签名与行为：
+- 忽略 NaN 元素计算中位数。
+- 当 ``dim`` 为 ``None`` 时，返回所有非 NaN 元素的中位数；
+- 当 ``dim`` 指定维度时，返回该维度上非 NaN 元素的中位数与对应索引；若某个切片全为 NaN，则返回 NaN 和索引 0。
+
+.. note::
+   此 API 遵循 ``torch.nanmedian`` 的函数签名和行为以实现 PyTorch 兼容。如需使用 Paddle 原生实现，请参考 :ref:`cn_api_paddle_nanmedian`。
+
+参数
+::::::::::
+- **input** (Tensor) - 输入 N 维 Tensor，支持 bfloat16、float16、float32、float64 数据类型。
+- **dim** (int，可选) - 指定计算中位数的维度。为 ``None`` 时计算全局中位数。默认 ``None``。
+- **keepdim** (bool，可选) - 是否保留被约简的维度。默认 ``False``。
+- **out** (tuple(Tensor, Tensor)|Tensor，可选) - 关键字参数。当指定 ``dim`` 时，可传入二元组 ``(values, indices)`` 用于原位写回中位数与索引；当未指定 ``dim`` 时，可传入单个 ``Tensor`` 用于写回标量结果。默认 ``None``。
+
+返回
+::::::::::
+- 当 ``dim`` 为 ``None``：返回一个标量 ``Tensor``，为忽略 NaN 后的中位数。
+- 当 ``dim`` 指定：返回具名元组 ``(values, indices)``，分别是中位数与其索引。
+
+代码示例
+::::::::::
+
+COPY-FROM: paddle.compat.nanmedian

docs/api/paddle/maximum_cn.rst

@@ -3,7 +3,7 @@
 maximum
 -------------------------------
 
-.. py:function:: paddle.maximum(x, y, name=None)
+.. py:function:: paddle.maximum(x, y, name=None, *, out=None)
 
 
 逐元素对比输入的两个 Tensor，并且把各个位置更大的元素保存到返回结果中。
@@ -18,11 +18,16 @@ maximum
 
    .. _Tensor 介绍: ../../guides/beginner/tensor_cn.html#id7
 
+
 参数
 :::::::::
-   - **x** （Tensor）- 输入的 Tensor。数据类型为 ``bfloat16`` 、 ``float16`` 、 ``float32`` 、 ``float64`` 、 ``int32`` 或  ``int64`` 。
-   - **y** （Tensor）- 输入的 Tensor。数据类型为 ``bfloat16`` 、 ``float16`` 、 ``float32`` 、 ``float64`` 、 ``int32`` 或  ``int64`` 。
+   - **x** (Tensor)- 输入的 Tensor。数据类型为 ``bfloat16`` 、 ``float16`` 、 ``float32`` 、 ``float64`` 、 ``int32`` 或  ``int64`` 。
+     ``别名: input``
+   - **y** (Tensor) - 输入的 Tensor。数据类型为 ``bfloat16`` 、 ``float16`` 、 ``float32`` 、 ``float64`` 、 ``int32`` 或  ``int64`` 。
+     ``别名: other``
    - **name** (str，可选) - 具体用法请参见 :ref:`api_guide_Name`，一般无需设置，默认值为 None。
+   - **out** (Tensor，可选) - 关键字参数。输出 Tensor，用于存储计算结果。如果指定，则结果将写入此 Tensor 中。
+
 
 返回
 :::::::::

docs/api/paddle/minimum_cn.rst

@@ -3,7 +3,7 @@
 minimum
 -------------------------------
 
-.. py:function:: paddle.minimum(x, y, name=None)
+.. py:function:: paddle.minimum(x, y, name=None, *, out=None)
 
 
 逐元素对比输入的两个 Tensor，并且把各个位置更小的元素保存到返回结果中。
@@ -18,11 +18,15 @@ minimum
 
    .. _Tensor 介绍: ../../guides/beginner/tensor_cn.html#id7
 
+
 参数
 :::::::::
    - **x** (Tensor) - 输入的 Tensor。数据类型为 ``bfloat16`` 、 ``float16`` 、 ``float32`` 、 ``float64`` 、 ``int32`` 或  ``int64`` 。
+     ``别名: input``
    - **y** (Tensor) - 输入的 Tensor。数据类型为 ``bfloat16`` 、 ``float16`` 、 ``float32`` 、 ``float64`` 、 ``int32`` 或  ``int64`` 。
+     ``别名: other``
    - **name** (str，可选) - 具体用法请参见 :ref:`api_guide_Name`，一般无需设置，默认值为 None。
+   - **out** (Tensor，可选) - 关键字参数。输出 Tensor，用于存储计算结果。如果指定，则结果将写入此 Tensor 中。
 
 返回
 :::::::::

docs/api/paddle/permute_cn.rst

@@ -0,0 +1,25 @@
+.. _cn_api_paddle_permute:
+
+permute
+-------------------------------
+
+.. py:function:: paddle.permute(input, dims, name=None)
+
+根据 dims 对输入的多维 Tensor 进行数据重排。返回多维 Tensor 的第 i 维对应输入 Tensor 的 dims[i] 维。
+
+参数
+::::::::::::
+
+    - **input** (Tensor) - 输入：input:[N_1, N_2, ..., N_k, D]多维 Tensor，可选的数据类型为 bool, float16, bfloat16, float32, float64, int8, int16, int32, int64, uint8, uint16, complex64, complex128。
+    - **dims** (list|tuple) - dims 长度必须和 input 的维度相同，并依照 dims 中的数据进行重排。
+    - **name** (str，可选) - 具体用法请参见 :ref:`api_guide_Name`，一般无需设置，默认值为 None。
+
+返回
+::::::::::::
+    ``Tensor``，经过 dims 指定顺序重排后的多维 Tensor，数据类型与输入一致，shape 为根据 dims 重新排列后的 shape。
+
+
+代码示例
+::::::::::::
+
+COPY-FROM: paddle.permute

docs/api/paddle/repeat_interleave_cn.rst

@@ -3,7 +3,7 @@
 repeat_interleave
 -------------------------------
 
-.. py:function:: paddle.repeat_interleave(x, repeats, axis=None, name=None)
+.. py:function:: paddle.repeat_interleave(x, repeats, axis=None, name=None, *, output_size=None)
 沿着指定轴 ``axis`` 对输入 ``x`` 进行复制，创建并返回到一个新的 Tensor。当 ``repeats`` 为 ``1-D`` Tensor 时，``repeats``  长度必须和指定轴 ``axis`` 维度一致，``repeats`` 对应位置的值表示 ``x`` 对应位置元素需要复制的次数。当 ``repeats`` 为 int 时，``x`` 沿指定轴 ``axis`` 上所有元素复制 ``repeats`` 次。
 
 
@@ -12,6 +12,9 @@ repeat_interleave
 
 最终输出为二维张量 ``[[1, 1, 1, 2, 2, 3], [4, 4, 4, 5, 5, 6]]``。
 
+.. note::
+    别名支持: 参数名 ``input`` 可替代 ``x``， ``dim`` 可替代 ``axis``；
+
     .. figure:: ../../images/api_legend/repeat_interleave.png
        :width: 500
        :alt: 示例一图示
@@ -28,6 +31,8 @@ repeat_interleave
     - **axis**    (int，可选) – 指定对输入 ``x`` 进行运算的轴，若未指定，默认值为 None，使用输入 Tensor 的 flatten 形式。
     - **dim** - ``axis`` 的别名，行为完全一致。
     - **name** (str，可选) - 具体用法请参见 :ref:`api_guide_Name`，一般无需设置，默认值为 None。
+    - **output_size** (int64，可选) – 关键字参数。输出 Tensor 的总大小，用于优化内存分配。若未指定，默认值为 None。
+
 
 
 返回

docs/api/paddle/sqrt_cn.rst

@@ -3,7 +3,7 @@
 sqrt
 -------------------------------
 
-.. py:function:: paddle.sqrt(x, name=None)
+.. py:function:: paddle.sqrt(x, name=None, *, out=None)
 
 
 
@@ -12,6 +12,9 @@ sqrt
 
 .. math:: out=\sqrt x=x^{1/2}
 
+.. note::
+    别名支持: 参数名 ``input`` 可替代 ``x``；
+
 .. note::
     请确保输入中的数值是非负数。
 
@@ -20,7 +23,9 @@ sqrt
 
 
     - **x** (Tensor) - 支持任意维度的 Tensor。数据类型为 float16，float32，float64，complex64 或 complex128。
+      ``别名: input``
     - **name** (str，可选) - 具体用法请参见 :ref:`api_guide_Name`，一般无需设置，默认值为 None。
+    - **out** (Tensor，可选) - 关键字参数。输出 Tensor，用于存储计算结果。如果指定，则结果将写入此 Tensor 中。
 
 返回
 ::::::::::::

docs/api/paddle/topk_cn.rst

@@ -3,19 +3,22 @@
 topk
 -------------------------------
 
-.. py:function:: paddle.topk(x, k, axis=None, largest=True, sorted=True, name=None)
+.. py:function:: paddle.topk(x, k, axis=None, largest=True, sorted=True, name=None, *, out=None)
 
 沿着可选的 ``axis`` 查找 topk 最大或者最小的结果和结果所在的索引信息。
 如果是一维 Tensor，则直接返回 topk 查询的结果。如果是多维 Tensor，则在指定的轴上查询 topk 的结果。
 
 参数
 :::::::::
     - **x** (Tensor) - 输入的多维 ``Tensor`` ，支持的数据类型：float32、float64、int32、int64。
+      ``别名: input``
     - **k** (int，Tensor) - 在指定的轴上进行 top 寻找的数量。
     - **axis** (int，可选) - 指定对输入 Tensor 进行运算的轴， ``axis`` 的有效范围是[-R, R），R 是输入 ``x`` 的 Rank， ``axis`` 为负时与 ``axis`` + R 等价。默认值为-1。
+      ``别名: dim``
     - **largest** (bool，可选) - 指定算法排序的方向。如果设置为 True，排序算法按照降序的算法排序，否则按照升序排序。默认值为 True。
     - **sorted** (bool，可选) - 控制返回的结果是否按照有序返回，默认为 True。
     - **name** (str，可选) - 具体用法请参见 :ref:`api_guide_Name`，一般无需设置，默认值为 None。
+    - **out** (tuple，可选) - 关键字参数。输出元组，用于存储计算结果和索引。如果指定，则结果将写入此元组中。
 
 返回
 :::::::::