[API Compatibility] add paddle.nn.init.* (PaddlePaddle#7382)

* add paddle.nn.init.*

* fix

* fix

* fix

* add init.* to overview

Author: zhiminzhang0830

docs/api/paddle/nn/Overview_cn.rst

@@ -572,17 +572,30 @@ Embedding 相关函数
     " :ref:`paddle.nn.initializer.Assign <cn_api_paddle_nn_initializer_Assign>` ", "使用 Numpy 数组、Python 列表、Tensor 来初始化参数"
     " :ref:`paddle.nn.initializer.Bilinear <cn_api_paddle_nn_Bilinear>` ", "该接口为参数初始化函数，用于转置卷积函数中"
     " :ref:`paddle.nn.initializer.Constant <cn_api_paddle_nn_initializer_Constant>` ", "用于权重初始化，通过输入的 value 值初始化输入变量"
+    " :ref:`paddle.nn.init.constant_ <cn_api_paddle_nn_init_constant_>` ", "函数式版本的 :ref:`paddle.nn.initializer.Constant <cn_api_paddle_nn_initializer_Constant>` API"
     " :ref:`paddle.nn.initializer.KaimingNormal <cn_api_paddle_nn_initializer_KaimingNormal>` ", "实现 Kaiming 正态分布方式的权重初始化"
+    " :ref:`paddle.nn.init.kaiming_normal_ <cn_api_paddle_nn_init_kaiming_normal_>` ", "函数式版本的 :ref:`paddle.nn.initializer.KaimingNormal <cn_api_paddle_nn_initializer_KaimingNormal>` API"
     " :ref:`paddle.nn.initializer.KaimingUniform <cn_api_paddle_nn_initializer_KaimingUniform>` ", "实现 Kaiming 均匀分布方式的权重初始化"
+    " :ref:`paddle.nn.init.kaiming_uniform_ <cn_api_paddle_nn_init_kaiming_uniform_>` ", "函数式版本的 :ref:`paddle.nn.initializer.KaimingUniform <cn_api_paddle_nn_initializer_KaimingUniform>` API"
     " :ref:`paddle.nn.initializer.Normal <cn_api_paddle_nn_initializer_Normal>` ", "随机正态（高斯）分布初始化函数"
+    " :ref:`paddle.nn.init.normal_ <cn_api_paddle_nn_init_normal_>` ", "函数式版本的 :ref:`paddle.nn.initializer.Normal <cn_api_paddle_nn_initializer_Normal>` API"
     " :ref:`paddle.nn.initializer.set_global_initializer <cn_api_paddle_nn_initializer_set_global_initializer>` ", "用于设置 Paddle 框架中全局的参数初始化方法"
     " :ref:`paddle.nn.initializer.calculate_gain <cn_api_paddle_nn_initializer_calculate_gain>` ", "获取某些激活函数的推荐增益值（增益值可用于对某些初始化 API 进行设置，以调整初始化值）"
     " :ref:`paddle.nn.initializer.Dirac <cn_api_paddle_nn_initializer_Dirac>` ", "通过狄拉克 delta 函数来初始化 3D/4D/5D Tensor，一般用于卷积层，能最大程度保留卷积层输入的特性"
+    " :ref:`paddle.nn.init.dirac_ <cn_api_paddle_nn_init_dirac_>` ", "函数式版本的 :ref:`paddle.nn.initializer.Dirac <cn_api_paddle_nn_initializer_Dirac>` API"
     " :ref:`paddle.nn.initializer.Orthogonal <cn_api_paddle_nn_initializer_Orthogonal>` ", "正交矩阵初始化方式，被初始化的参数为（半）正交的"
+    " :ref:`paddle.nn.init.orthogonal_ <cn_api_paddle_nn_init_orthogonal_>` ", "函数式版本的 :ref:`paddle.nn.initializer.Orthogonal <cn_api_paddle_nn_initializer_Orthogonal>` API"
     " :ref:`paddle.nn.initializer.TruncatedNormal <cn_api_paddle_nn_initializer_TruncatedNormal>` ", "随机截断正态（高斯）分布初始化函数"
+    " :ref:`paddle.nn.init.trunc_normal_ <cn_api_paddle_nn_init_trunc_normal_>` ", "函数式版本的 :ref:`paddle.nn.initializer.TruncatedNormal <cn_api_paddle_nn_initializer_TruncatedNormal>` API"
     " :ref:`paddle.nn.initializer.Uniform <cn_api_paddle_nn_initializer_Uniform>` ", "随机均匀分布初始化函数"
+    " :ref:`paddle.nn.init.uniform_ <cn_api_paddle_nn_init_uniform_>` ", "函数式版本的 :ref:`paddle.nn.initializer.Uniform <cn_api_paddle_nn_initializer_Uniform>` API"
     " :ref:`paddle.nn.initializer.XavierNormal <cn_api_paddle_nn_initializer_XavierNormal>` ", "实现 Xavier 权重初始化方法（ Xavier weight initializer）"
+    " :ref:`paddle.nn.init.xavier_normal_ <cn_api_paddle_nn_init_xavier_normal_>` ", "函数式版本的 :ref:`paddle.nn.initializer.XavierNormal <cn_api_paddle_nn_initializer_XavierNormal>` API"
     " :ref:`paddle.nn.initializer.XavierUniform <cn_api_paddle_nn_initializer_XavierUniform>` ", "实现 Xavier 权重初始化方法（ Xavier weight initializer）"
+    " :ref:`paddle.nn.init.xavier_uniform_ <cn_api_paddle_nn_init_xavier_uniform_>` ", "函数式版本的 :ref:`paddle.nn.initializer.XavierUniform <cn_api_paddle_nn_initializer_XavierUniform>` API"
+    " :ref:`paddle.nn.init.eye_ <cn_api_paddle_nn_init_eye_>` ", "将二维输入张量的值设置为单位矩阵"
+    " :ref:`paddle.nn.init.ones_ <cn_api_paddle_nn_init_ones_>` ", "将输入张量的值设置为 1"
+    " :ref:`paddle.nn.init.zeros_ <cn_api_paddle_nn_init_zeros_>` ", "将输入张量的值设置为 0"
 
 .. _about_quantization:
 

docs/api/paddle/nn/init/calculate_gain_cn.rst

@@ -0,0 +1,19 @@
+.. _cn_api_paddle_nn_init_calculate_gain:
+
+calculate_gain
+-------------------------------
+
+.. py:class:: paddle.nn.init.calculate_gain(nonlinearity, param=None)
+
+返回给定非线性函数的推荐增益值。
+
+参数
+::::::::::::
+
+    - **nonlinearity** (str) - 非线形函数的名称。
+    - **param** (float，可选) - 某些非线性函数的可选参数。目前，该参数仅适用于'leaky_relu'。默认值：无（在公式中会自动计算为 0.01）。
+
+返回
+::::::::::::
+
+    float 类型增益值。

docs/api/paddle/nn/init/constant__cn.rst

@@ -0,0 +1,14 @@
+.. _cn_api_paddle_nn_init_constant_:
+
+constant\_
+-------------------------------
+
+.. py:class:: paddle.nn.init.constant_(tensor, val)
+
+将输入张量的值设置为指定的常量，该操作会直接修改输入张量。
+
+参数
+::::::::::::
+
+    - **tensor** (Tensor) - 输入张量。
+    - **val** (float) - 指定的填充输入张量的常量。

docs/api/paddle/nn/init/dirac__cn.rst

@@ -0,0 +1,14 @@
+.. _cn_api_paddle_nn_init_dirac_:
+
+dirac\_
+-------------------------------
+
+.. py:class:: paddle.nn.init.dirac_(tensor, groups=1)
+
+将输入张量的值设置为 Dirac delta 函数，该操作会直接修改输入张量。支持 3D、4D 和 5D 输入张量。
+
+参数
+::::::::::::
+
+    - **tensor** (Tensor) - 输入张量。
+    - **groups** (int，可选) - 输入张量的组数，默认值为 1。

docs/api/paddle/nn/init/eye__cn.rst

@@ -0,0 +1,13 @@
+.. _cn_api_paddle_nn_init_eye_:
+
+eye\_
+-------------------------------
+
+.. py:class:: paddle.nn.init.eye_(tensor)
+
+将二维输入张量的值设置为单位矩阵，该操作会直接修改输入张量。
+
+参数
+::::::::::::
+
+    - **tensor** (Tensor) - 输入张量。

docs/api/paddle/nn/init/kaiming_normal__cn.rst

@@ -0,0 +1,16 @@
+.. _cn_api_paddle_nn_init_kaiming_normal_:
+
+kaiming_normal\_
+-------------------------------
+
+.. py:class:: paddle.nn.init.kaiming_normal_(tensor, a=0, mode='fan_in', nonlinearity='leaky_relu')
+
+将输入张量的值设置为 Kaiming 正态分布的随机数，该操作会直接修改输入张量。
+
+参数
+::::::::::::
+
+    - **tensor** (Tensor) - 输入张量。
+    - **a** (float，可选) - 该层之后使用的修正函数的负斜率（仅在使用'leaky_relu'时使用），默认值为 0。
+    - **mode** (str，可选) - 计算增益的方法，可选值为'fan_in'、'fan_out'，默认值为'fan_in'。
+    - **nonlinearity** (str，可选) - 非线性函数的名称，默认值为'leaky_relu'。

docs/api/paddle/nn/init/kaiming_uniform__cn.rst

@@ -0,0 +1,16 @@
+.. _cn_api_paddle_nn_init_kaiming_uniform_:
+
+kaiming_uniform\_
+-------------------------------
+
+.. py:class:: paddle.nn.init.kaiming_uniform_(tensor, a=0, mode='fan_in', nonlinearity='leaky_relu')
+
+将输入张量的值设置为 Kaiming 均匀分布的随机数，该操作会直接修改输入张量。
+
+参数
+::::::::::::
+
+    - **tensor** (Tensor) - 输入张量。
+    - **a** (float，可选) - 该层之后使用的修正函数的负斜率（仅在使用'leaky_relu'时使用），默认值为 0。
+    - **mode** (str，可选) - 计算增益的方法，可选值为'fan_in'、'fan_out'，默认值为'fan_in'。
+    - **nonlinearity** (str，可选) - 非线性函数的名称，默认值为'leaky_relu'。

docs/api/paddle/nn/init/normal__cn.rst

@@ -0,0 +1,15 @@
+.. _cn_api_paddle_nn_init_normal_:
+
+normal\_
+-------------------------------
+
+.. py:class:: paddle.nn.init.normal_(tensor, mean=0.0, std=1.0)
+
+将输入张量的值设置为正态分布的随机数，该操作会直接修改输入张量。
+
+参数
+::::::::::::
+
+    - **tensor** (Tensor) - 输入张量。
+    - **mean** (float) - 正态分布的均值，默认值为 0.0。
+    - **std** (float) - 正态分布的标准差，默认值为 1.0。

docs/api/paddle/nn/init/ones__cn.rst

@@ -0,0 +1,8 @@
+.. _cn_api_paddle_nn_init_ones_:
+
+ones\_
+-------------------------------
+
+.. py:class:: paddle.nn.init.ones_(tensor)
+
+将输入张量的值设置为 1，该操作会直接修改输入张量。

docs/api/paddle/nn/init/orthogonal__cn.rst

@@ -0,0 +1,14 @@
+.. _cn_api_paddle_nn_init_orthogonal_:
+
+orthogonal\_
+-------------------------------
+
+.. py:class:: paddle.nn.init.orthogonal_(tensor, gain=1)
+
+将输入张量的值设置为截断的正态分布的随机数，该操作会直接修改输入张量。
+
+参数
+::::::::::::
+
+    - **tensor** (Tensor) - 输入张量。
+    - **gain** (float，可选) - 比例因子，默认值为 1.0。