Merge branch 'develop' of https://github.com/PaddlePaddle/docs into my_docs_change

Author: ZJhorseloudly

docs/api/paddle/Overview_cn.rst

@@ -197,13 +197,18 @@ tensor 数学操作原位（inplace）版本
     " :ref:`paddle.ceil_ <cn_api_paddle_ceil_>` ", "Inplace 版本的 ceil API，对输入 x 采用 Inplace 策略"
     " :ref:`paddle.clip_ <cn_api_paddle_clip_>` ", "Inplace 版本的 clip API，对输入 x 采用 Inplace 策略"
     " :ref:`paddle.copysign_ <cn_api_paddle_copysign_>` ", "Inplace 版本的 copysign API，对输入 x 采用 Inplace 策略"
+    " :ref:`paddle.divide_ <cn_api_paddle_divide_>` ", "Inplace 版本的 divide API，对输入 x 采用 Inplace 策略"
+    " :ref:`paddle.equal_ <cn_api_paddle_equal_>` ", "Inplace 版本的 equal API，对输入 x 采用 Inplace 策略"
     " :ref:`paddle.exp_ <cn_api_paddle_exp_>` ", "Inplace 版本的 exp API，对输入 x 采用 Inplace 策略"
     " :ref:`paddle.expm1_ <cn_api_paddle_expm1_>` ", "Inplace 版本的 expm1 API，对输入 x 采用 Inplace 策略"
     " :ref:`paddle.flatten_ <cn_api_paddle_flatten_>` ", "Inplace 版本的 flatten API，对输入 x 采用 Inplace 策略"
     " :ref:`paddle.floor_ <cn_api_paddle_floor_>` ", "Inplace 版本的 floor API，对输入 x 采用 Inplace 策略"
+    " :ref:`paddle.floor_divide_ <cn_api_paddle_floor_divide_>` ", "Inplace 版本的 floor_divide API，对输入 x 采用 Inplace 策略"
+    " :ref:`paddle.frac_ <cn_api_paddle_frac_>` ", "Inplace 版本的 frac API，对输入 x 采用 Inplace 策略"
     " :ref:`paddle.gammaincc_ <cn_api_paddle_gammaincc_>` ", "Inplace 版本的 gammaincc API，对输入 x 采用 Inplace 策略"
     " :ref:`paddle.gammainc_ <cn_api_paddle_gammainc_>` ", "Inplace 版本的 gammainc API，对输入 x 采用 Inplace 策略"
     " :ref:`paddle.gammaln_ <cn_api_paddle_gammaln_>` ", "Inplace 版本的 gammaln API，对输入 x 采用 Inplace 策略"
+    " :ref:`paddle.gcd_ <cn_api_paddle_gcd_>` ", "Inplace 版本的 gcd API，对输入 x 采用 Inplace 策略"
     " :ref:`paddle.reciprocal_ <cn_api_paddle_reciprocal_>` ", "Inplace 版本的 reciprocal API，对输入 x 采用 Inplace 策略"
     " :ref:`paddle.round_ <cn_api_paddle_round_>` ", "Inplace 版本的 round API，对输入 x 采用 Inplace 策略"
     " :ref:`paddle.rsqrt_ <cn_api_paddle_rsqrt_>` ", "Inplace 版本的 rsqrt API，对输入 x 采用 Inplace 策略"

docs/api/paddle/addmm__cn.rst

@@ -4,7 +4,6 @@ addmm\_
 -------------------------------
 
 .. py:function:: paddle.addmm_(input, x, y, alpha=1.0, beta=1.0, name=None)
-
 Inplace 版本的 :ref:`cn_api_paddle_addmm` API，对输入 `input` 采用 Inplace 策略。
 
 更多关于 inplace 操作的介绍请参考 `3.1.3 原位（Inplace）操作和非原位操作的区别`_ 了解详情。

docs/api/paddle/broadcast_tensors_cn.rst

@@ -13,7 +13,15 @@ broadcast_tensors
 
     .. _Tensor 介绍: ../../guides/beginner/tensor_cn.html#id7
 
-下图展示将三个 Tensor 广播到同一维度的过程。三个 Tensor 的尺寸分别为 [4, 1, 3]、[2, 3]、[4, 2, 1]，在广播时，会从最后一个维度开始对齐，对于每一个维度，任意两个 Tensor 的在该维度大小相等；或者其中一个 Tensor 的维度等于 1；或者其中一个 Tensor 的维度不存在。在下图中，最后一个维度中，Tenser3 取值为 1，Tensor1 和 Tensor2 取值为 3，所有 Tensor 的该维度被扩张为 3；倒数第二个维度中，Tenser1 取值为 2，Tensor2 和 Tensor3 取值为 2，所有 Tensor 的该维度被扩张为 2；倒数第三个维度中，Tenser2 为空，Tensor1 和 Tensor3 取值为 4，所有 Tensor 的该维度被扩张为 4。最终，所有 Tensor 都被扩张到 [4, 2, 3]。
+下图展示将三个 Tensor 广播到同一维度的过程。三个 Tensor 的尺寸分别为 [4, 1, 3]、[2, 3]、[4, 2, 1]，在广播时，会从最后一个维度开始对齐，对于每一个维度，任意两个 Tensor 的在该维度大小相等；或者其中一个 Tensor 的维度等于 1；或者其中一个 Tensor 的维度不存在。
+
+在下图中，
+
+- 最后一个维度中，Tenser3 取值为 1，Tensor1 和 Tensor2 取值为 3，所有 Tensor 的该维度被扩张为 3；
+- 倒数第二个维度中，Tenser1 取值为 1，Tensor2 和 Tensor3 取值为 2，所有 Tensor 的该维度被扩张为 2；
+- 倒数第三个维度中，Tenser2 为空，Tensor1 和 Tensor3 取值为 4，所有 Tensor 的该维度被扩张为 4。
+
+最终，所有 Tensor 都被扩张到 [4, 2, 3]。
 
 .. figure:: ../../images/api_legend/broadcast.png
    :width: 800

docs/api/paddle/divide__cn.rst

@@ -0,0 +1,11 @@
+.. _cn_api_paddle_divide_:
+
+divide\_
+-------------------------------
+
+.. py:function:: paddle.divide_(x, y, name=None)
+Inplace 版本的 :ref:`cn_api_paddle_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

docs/api/paddle/equal__cn.rst

@@ -0,0 +1,11 @@
+.. _cn_api_paddle_equal_:
+
+equal\_
+-------------------------------
+
+.. py:function:: paddle.equal_(x, y, name=None)
+Inplace 版本的 :ref:`cn_api_paddle_equal` 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

docs/api/paddle/floor_divide__cn.rst

@@ -0,0 +1,11 @@
+.. _cn_api_paddle_floor_divide_:
+
+floor_divide\_
+-------------------------------
+
+.. py:function:: paddle.floor_divide_(x, y, name=None)
+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

docs/api/paddle/frac__cn.rst

@@ -0,0 +1,11 @@
+.. _cn_api_paddle_frac_:
+
+frac\_
+-------------------------------
+
+.. py:function:: paddle.frac_(x, name=None)
+Inplace 版本的 :ref:`cn_api_paddle_frac` 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

docs/api/paddle/gcd__cn.rst

@@ -0,0 +1,11 @@
+.. _cn_api_paddle_gcd_:
+
+gcd\_
+-------------------------------
+
+.. py:function:: paddle.gcd_(x, y, name=None)
+Inplace 版本的 :ref:`cn_api_paddle_gcd` 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

docs/guides/model_convert/convert_from_pytorch/api_difference/nn/torch.nn.modules.module.register_module_forward_hook.md

@@ -1,8 +1,8 @@
-## [ torch 参数更多 ]torch.nn.modules.module.register_module_forward_hook
+## [ 组合替代实现 ]torch.nn.modules.module.register_module_forward_hook
 ### [torch.nn.modules.module.register_module_forward_hook](https://pytorch.org/docs/stable/generated/torch.nn.modules.module.register_module_forward_hook.html)
 
 ```python
-torch.nn.modules.module.register_module_forward_hook(hook, *, prepend=False, with_kwargs=False, always_call=False)
+torch.nn.modules.module.register_module_forward_hook(hook, *, always_call=False)
 ```
 
 ### [paddle.nn.Layer.register_forward_post_hook](https://www.paddlepaddle.org.cn/documentation/docs/zh/develop/api/paddle/nn/Layer_cn.html#register-forward-post-hook-hook)
@@ -11,12 +11,28 @@ torch.nn.modules.module.register_module_forward_hook(hook, *, prepend=False, wit
 paddle.nn.Layer.register_forward_post_hook(hook)
 ```
 
-PyTorch 相比 Paddle 支持更多其他参数，具体如下：
+其中，PyTorch 为给全局所有 module 注册 hook,而 Paddle 为给单个 Layer 注册 hook。PyTorch 相比 Paddle 支持更多其他参数，具体如下：
 ### 参数映射
 
 | PyTorch       | PaddlePaddle | 备注                                                   |
 | ------------- | ------------ | ------------------------------------------------------ |
-| hook  | hook       | 被注册为 forward pre-hook 的函数。 |
-| prepend  | -            | 钩子执行顺序控制，Paddle 无此参数，暂无转写方式。 |
-| with_kwargs        | -       | 是否传递关键字参数，Paddle 无此参数，暂无转写方式。  |
-| always_call        | -       | 是否强制调用钩子，Paddle 无此参数，暂无转写方式。  |
+| hook  | hook       | 被注册为 forward post-hook 的函数。 |
+| always_call        | -       | 是否强制调用钩子，Paddle 无此参数，一般对训练结果影响不大，可直接删除。  |
+
+### 转写示例
+
+```python
+# PyTorch 写法
+Linear = torch.nn.Linear(2, 4)
+Conv2d = torch.nn.Conv2d(3, 16, 3)
+Batch2d = torch.nn.BatchNorm2d(10)
+torch.nn.modules.module.register_module_forward_hook(hook)
+
+# Paddle 写法
+Linear = paddle.nn.Linear(2, 4)
+Conv2d = paddle.nn.Conv2d(3, 16, 3)
+Batch2d = paddle.nn.BatchNorm2D(10)
+Linear.register_forward_post_hook(hook)
+Conv2d.register_forward_post_hook(hook)
+Batch2d.register_forward_post_hook(hook)
+```

docs/guides/model_convert/convert_from_pytorch/api_difference/nn/torch.nn.modules.module.register_module_forward_pre_hook.md

@@ -1,4 +1,4 @@
-## [ 参数完全一致 ]torch.nn.modules.module.register_module_forward_pre_hook
+## [ 组合替代实现 ]torch.nn.modules.module.register_module_forward_pre_hook
 
 ### [torch.nn.modules.module.register_module_forward_pre_hook](https://pytorch.org/docs/stable/generated/torch.nn.modules.module.register_module_forward_pre_hook.html)
 
@@ -12,10 +12,28 @@ torch.nn.modules.module.register_module_forward_pre_hook(hook)
 paddle.nn.Layer.register_forward_pre_hook(hook)
 ```
 
-功能一致，参数完全一致，具体如下：
+其中，PyTorch 为给全局所有 module 注册 hook,而 Paddle 为给单个 Layer 注册 hook, 具体如下：
 
 ### 参数映射
 
 | PyTorch | PaddlePaddle | 备注                                                                                            |
 |---------|--------------|-----------------------------------------------------------------------------------------------|
 | hook  | hook       | 被注册为 forward pre-hook 的函数。 |
+
+### 转写示例
+
+```python
+# PyTorch 写法
+Linear = torch.nn.Linear(2, 4)
+Conv2d = torch.nn.Conv2d(3, 16, 3)
+Batch2d = torch.nn.BatchNorm2d(10)
+torch.nn.modules.module.register_module_forward_pre_hook(hook)
+
+# Paddle 写法
+Linear = paddle.nn.Linear(2, 4)
+Conv2d = paddle.nn.Conv2d(3, 16, 3)
+Batch2d = paddle.nn.BatchNorm2D(10)
+Linear.register_forward_pre_hook(hook)
+Conv2d.register_forward_pre_hook(hook)
+Batch2d.register_forward_pre_hook(hook)
+```

docs/guides/model_convert/convert_from_pytorch/api_difference/torch/torch._foreach_abs.md

@@ -0,0 +1,19 @@
+## [组合替代实现]torch.\_foreach_abs
+
+### [torch.\_foreach_abs](https://pytorch.org/docs/stable/generated/torch._foreach_abs.html#torch-foreach-abs)
+
+```python
+torch._foreach_abs(self)
+```
+
+Paddle 无此 API，需要组合实现。
+
+### 转写示例
+
+```python
+# PyTorch 写法
+torch._foreach_abs(tensors)
+
+# Paddle 写法
+[paddle.abs(x) for x in tensors]
+```

docs/guides/model_convert/convert_from_pytorch/api_difference/torch/torch._foreach_abs_.md

@@ -0,0 +1,19 @@
+## [组合替代实现]torch.\_foreach_abs_
+
+### [torch.\_foreach_abs_](https://pytorch.org/docs/stable/generated/torch._foreach_abs_.html#torch-foreach-abs)
+
+```python
+torch._foreach_abs_(self)
+```
+
+Paddle 无此 API，需要组合实现。
+
+### 转写示例
+
+```python
+# PyTorch 写法
+torch._foreach_abs_(tensors)
+
+# Paddle 写法
+[paddle.abs_(x) for x in tensors]
+```

docs/guides/model_convert/convert_from_pytorch/api_difference/torch/torch._foreach_acos.md

@@ -0,0 +1,19 @@
+## [组合替代实现]torch.\_foreach_acos
+
+### [torch.\_foreach_acos](https://pytorch.org/docs/stable/generated/torch._foreach_acos.html#torch-foreach-acos)
+
+```python
+torch._foreach_acos(self)
+```
+
+Paddle 无此 API，需要组合实现。
+
+### 转写示例
+
+```python
+# PyTorch 写法
+torch._foreach_acos(tensors)
+
+# Paddle 写法
+[paddle.acos(x) for x in tensors]
+```

docs/guides/model_convert/convert_from_pytorch/api_difference/torch/torch._foreach_acos_.md

@@ -0,0 +1,19 @@
+## [组合替代实现]torch.\_foreach_acos_
+
+### [torch.\_foreach_acos_](https://pytorch.org/docs/stable/generated/torch._foreach_acos_.html#torch-foreach-acos)
+
+```python
+torch._foreach_acos_(self)
+```
+
+Paddle 无此 API，需要组合实现。
+
+### 转写示例
+
+```python
+# PyTorch 写法
+torch._foreach_acos_(tensors)
+
+# Paddle 写法
+[paddle.acos_(x) for x in tensors]
+```

docs/guides/model_convert/convert_from_pytorch/api_difference/torch/torch._foreach_asin.md

@@ -0,0 +1,19 @@
+## [组合替代实现]torch.\_foreach_asin
+
+### [torch.\_foreach_asin](https://pytorch.org/docs/stable/generated/torch._foreach_asin.html#torch-foreach-asin)
+
+```python
+torch._foreach_asin(self)
+```
+
+Paddle 无此 API，需要组合实现。
+
+### 转写示例
+
+```python
+# PyTorch 写法
+torch._foreach_asin(tensors)
+
+# Paddle 写法
+[paddle.asin(x) for x in tensors]
+```

docs/guides/model_convert/convert_from_pytorch/api_difference/torch/torch._foreach_asin_.md

@@ -0,0 +1,19 @@
+## [组合替代实现]torch.\_foreach_asin_
+
+### [torch.\_foreach_asin_](https://pytorch.org/docs/stable/generated/torch._foreach_asin_.html#torch-foreach-asin)
+
+```python
+torch._foreach_asin_(self)
+```
+
+Paddle 无此 API，需要组合实现。
+
+### 转写示例
+
+```python
+# PyTorch 写法
+torch._foreach_asin_(tensors)
+
+# Paddle 写法
+[paddle.asin_(x) for x in tensors]
+```

docs/guides/model_convert/convert_from_pytorch/api_difference/torch/torch._foreach_atan.md

@@ -0,0 +1,19 @@
+## [组合替代实现]torch.\_foreach_atan
+
+### [torch.\_foreach_atan](https://pytorch.org/docs/stable/generated/torch._foreach_atan.html#torch-foreach-atan)
+
+```python
+torch._foreach_atan(self)
+```
+
+Paddle 无此 API，需要组合实现。
+
+### 转写示例
+
+```python
+# PyTorch 写法
+torch._foreach_atan(tensors)
+
+# Paddle 写法
+[paddle.atan(x) for x in tensors]
+```

docs/guides/model_convert/convert_from_pytorch/api_difference/torch/torch._foreach_atan_.md

@@ -0,0 +1,19 @@
+## [组合替代实现]torch.\_foreach_atan_
+
+### [torch.\_foreach_atan_](https://pytorch.org/docs/stable/generated/torch._foreach_atan_.html#torch-foreach-atan)
+
+```python
+torch._foreach_atan_(self)
+```
+
+Paddle 无此 API，需要组合实现。
+
+### 转写示例
+
+```python
+# PyTorch 写法
+torch._foreach_atan_(tensors)
+
+# Paddle 写法
+[paddle.atan_(x) for x in tensors]
+```

docs/guides/model_convert/convert_from_pytorch/api_difference/torch/torch._foreach_ceil.md

@@ -0,0 +1,19 @@
+## [组合替代实现]torch.\_foreach_ceil
+
+### [torch.\_foreach_ceil](https://pytorch.org/docs/stable/generated/torch._foreach_ceil.html#torch-foreach-ceil)
+
+```python
+torch._foreach_ceil(self)
+```
+
+Paddle 无此 API，需要组合实现。
+
+### 转写示例
+
+```python
+# PyTorch 写法
+torch._foreach_ceil(tensors)
+
+# Paddle 写法
+[paddle.ceil(x) for x in tensors]
+```

docs/guides/model_convert/convert_from_pytorch/api_difference/torch/torch._foreach_cos.md

@@ -0,0 +1,19 @@
+## [组合替代实现]torch.\_foreach_cos
+
+### [torch.\_foreach_cos](https://pytorch.org/docs/stable/generated/torch._foreach_cos.html#torch-foreach-cos)
+
+```python
+torch._foreach_cos(self)
+```
+
+Paddle 无此 API，需要组合实现。
+
+### 转写示例
+
+```python
+# PyTorch 写法
+torch._foreach_cos(tensors)
+
+# Paddle 写法
+[paddle.cos(x) for x in tensors]
+```