fix chinese doc for API (#2409)

doc/fluid/api/tensor.rst

@@ -50,6 +50,7 @@ paddle.tensor
     tensor/has_nan.rst
     tensor/increment.rst
     tensor/is_empty.rst
+    tensor/index_select.rst
     tensor/isfinite.rst
     tensor/less_equal.rst
     tensor/less_than.rst

doc/fluid/api/tensor/concat.rst

-.. _api_tensor_cn_concat:
+..  THIS FILE IS GENERATED BY `gen_doc.{py|sh}`
+    !DO NOT EDIT THIS FILE MANUALLY!
+
+.. _api_tensor_concat:
 
 concat
--------------------------------
-:doc_source: paddle.fluid.layers.concat
+--------
 
+..  autofunction:: paddle.tensor.concat
+    :noindex:
 

doc/fluid/api/tensor/eye.rst

-.. _api_tensor_cn_eye:
+..  THIS FILE IS GENERATED BY `gen_doc.{py|sh}`
+    !DO NOT EDIT THIS FILE MANUALLY!
+
+.. _api_tensor_eye:
 
 eye
--------------------------------
-:doc_source: paddle.fluid.layers.eye
+--------
 
+..  autofunction:: paddle.tensor.full
+    :noindex:
 

doc/fluid/api/tensor/full.rst

-.. _api_tensor_cn_full:
+..  THIS FILE IS GENERATED BY `gen_doc.{py|sh}`
+    !DO NOT EDIT THIS FILE MANUALLY!
 
-full
--------------------------------
-:doc_source: paddle.fluid.layers.fill_constant
+.. _api_tensor_full:
 
+full
+--------
 
+..  autofunction:: paddle.tensor.full
+    :noindex:

doc/fluid/api/tensor/index_select.rst

+..  THIS FILE IS GENERATED BY `gen_doc.{py|sh}`
+    !DO NOT EDIT THIS FILE MANUALLY!
+
+.. _api_tensor_index_select:
+
+index_select
+-------------
+
+..  autofunction:: paddle.tensor.index_select
+    :noindex:
+

doc/fluid/api/tensor/linspace.rst

-.. _api_tensor_cn_linspace:
+..  THIS FILE IS GENERATED BY `gen_doc.{py|sh}`
+    !DO NOT EDIT THIS FILE MANUALLY!
+
+.. _api_tensor_linspace:
 
 linspace
--------------------------------
-:doc_source: paddle.fluid.layers.linspace
+--------
 
+..  autofunction:: paddle.tensor.linspace
+    :noindex:
 

doc/fluid/api/tensor/ones.rst

-.. _api_tensor_cn_ones:
+..  THIS FILE IS GENERATED BY `gen_doc.{py|sh}`
+    !DO NOT EDIT THIS FILE MANUALLY!
+
+.. _api_tensor_ones:
 
 ones
--------------------------------
-:doc_source: paddle.fluid.layers.ones
+--------
+
+..  autofunction:: paddle.tensor.ones
+    :noindex:
 
 

doc/fluid/api/tensor/split.rst

-.. _api_tensor_cn_split:
+..  THIS FILE IS GENERATED BY `gen_doc.{py|sh}`
+    !DO NOT EDIT THIS FILE MANUALLY!
+
+.. _api_tensor_split:
 
 split
--------------------------------
-:doc_source: paddle.fluid.layers.split
+--------
 
+..  autofunction:: paddle.tensor.split
+    :noindex:
 

doc/fluid/api/tensor/zeros.rst

-.. _api_tensor_cn_zeros:
+..  THIS FILE IS GENERATED BY `gen_doc.{py|sh}`
+    !DO NOT EDIT THIS FILE MANUALLY!
+
+.. _api_tensor_zeros:
 
 zeros
--------------------------------
-:doc_source: paddle.fluid.layers.zeros
+--------
+
+..  autofunction:: paddle.tensor.zeros
+    :noindex:
 
 

doc/fluid/api_cn/layers_cn/linspace_cn.rst

@@ -5,25 +5,23 @@ linspace
 
 .. py:function:: paddle.fluid.layers.linspace(start, stop, num, dtype=None, name=None)
 
-
-
-
 该OP返回一个Tensor，Tensor的值为在区间start和stop上均匀间隔的num个值，输出Tensor的长度为num。
 **注意：该OP不进行梯度计算**
  
 参数：
-    - **start** (float|Tensor) – ``start`` 是区间开始的变量，可以是一个浮点标量，或是一个shape为[1]的Tensor，该Tensor的数据类型可以是float32或者是float64。
-    - **stop** (float|Tensor) – ``end`` 是区间结束的变量，可以是一个浮点标量，或是一个shape为[1]的Tensor，该Tensor的数据类型可以是float32或者是float64。
+    - **start** (int|float|Tensor) – ``start`` 是区间开始的变量，可以是一个浮点标量，或是一个shape为[1]的Tensor，该Tensor的数据类型可以是float32，float64，int32 或者int64。
+    - **stop** (int|float|Tensor) – ``stop`` 是区间结束的变量，可以是一个浮点标量，或是一个shape为[1]的Tensor，该Tensor的数据类型可以是float32，float64，int32或者int64。
     - **num** (int|Tensor) – ``num`` 是给定区间内需要划分的区间数，可以是一个整型标量，或是一个shape为[1]的Tensor，该Tensor的数据类型需为int32。
-    - **dtype** (string, 可选) – 输出Tensor的数据类型，可以是float32或者是float64，如果dtype的数据类型为None，输出Tensor数据类型为float32。
+    - **dtype** (np.dtype|str, 可选) – 输出Tensor的数据类型，可以是float32，float64， int32或者int64。如果dtype的数据类型为None，输出Tensor数据类型为float32。
     - **name** （str， 可选）- 具体用法请参见 :ref:`api_guide_Name` ，一般无需设置，默认值为None。
 
 返回：表示等间隔划分结果的1-D Tensor，该Tensor的shape大小为 :math:`[num]` ，在mum为1的情况下，仅返回包含start元素值的Tensor。
 
 抛出异常：
-    - ``TypeError`` - 当start或者stop的数据类型不是float32或者float64。
-    - ``TypeError`` - 当num的数据类型不是float32或者float64。
-    - ``TypeError`` - 当dtype的类型不是float32或者float64。
+    - ``TypeError`` - 当 ``start`` 或者 ``stop`` 的数据类型不是float32，float64， int32或者int64。
+    - ``TypeError`` - 当 ``dtype`` 的类型不是float32，float64，int32或者int64。
+    - ``TypeError`` - ``num`` 的类型必须是int当 ``num`` 不是Tensor的时候。
+    - ``TypeError`` - ``num`` 的数据类型必须是int32当 ``num`` 是Tensor的时候。
 
 **代码示例**：
 

doc/fluid/api_cn/layers_cn/ones_cn.rst

@@ -9,7 +9,7 @@ ones
 
 参数：
     - **shape** (tuple|list|Tensor) - 输出Tensor的形状， ``shape`` 的数据类型为int32或者int64。
-    - **dtype** (np.dtype|core.VarDesc.VarType|str) - 输出Tensor的数据类型，数据类型必须为bool、 float16、float32、float64、int32或int64。
+    - **dtype** (np.dtype|str) - 输出Tensor的数据类型，数据类型必须为bool、 float16、float32、float64、int32或int64。
     - **force_cpu** (bool， 可选) – 是否强制将输出Tensor写入CPU内存。如果 ``force_cpu`` 为False，则将输出Tensor写入当前所在运算设备的内存，默认为False。
 
 返回：值全为1的Tensor，数据类型和 ``dtype`` 定义的类型一致。

doc/fluid/api_cn/layers_cn/zeros_cn.rst

@@ -9,7 +9,7 @@ zeros
 
 参数：
     - **shape** (tuple|list|Tensor) - 输出Tensor的形状， ``shape`` 的数据类型为int32或者int64。
-    - **dtype** (np.dtype|core.VarDesc.VarType|str) - 输出Tensor的数据类型，数据类型必须为bool、 float16、float32、float64、int32或int64。
+    - **dtype** (np.dtype|str) - 输出Tensor的数据类型，数据类型必须为bool、 float16、float32、float64、int32或int64。
     - **force_cpu** (bool， 可选) - 是否强制将输出Tensor写入CPU内存。如果 ``force_cpu`` 为False，则将输出Tensor写入当前所在运算设备的内存，默认为False。
 
 返回：值全为0的Tensor，数据类型和 ``dtype`` 定义的类型一致。

doc/fluid/api_cn/paddle_cn.rst

@@ -65,6 +65,7 @@ paddle
 	paddle_cn/flatten_cn.rst
 	paddle_cn/flip_cn.rst
 	paddle_cn/floor_cn.rst
+	paddle_cn/full_cn.rst
 	paddle_cn/full_like_cn.rst
 	paddle_cn/gather_cn.rst
 	paddle_cn/gather_nd_cn.rst

doc/fluid/api_cn/tensor_cn/concat_cn.rst

@@ -28,16 +28,16 @@ concat
   import paddle
   import numpy as np
   
-  paddle.enable_imperative()  # Now we are in imperative mode
+  paddle.disable_static()  # Now we are in imperative mode
   in1 = np.array([[1, 2, 3],
                   [4, 5, 6]])
   in2 = np.array([[11, 12, 13],
                   [14, 15, 16]])
   in3 = np.array([[21, 22],
                   [23, 24]])
-  x1 = paddle.imperative.to_variable(in1)
-  x2 = paddle.imperative.to_variable(in2)
-  x3 = paddle.imperative.to_variable(in3)
+  x1 = paddle.to_tensor(in1)
+  x2 = paddle.to_tensor(in2)
+  x3 = paddle.to_tensor(in3)
   zero = paddle.full(shape=[1], dtype='int32', fill_value=0)
   # When the axis is negative, the real axis is (axis + Rank(x))
   # As follow, axis is -1, Rank(x) is 2, the real axis is 1

doc/fluid/api_cn/tensor_cn/eye_cn.rst

@@ -8,9 +8,9 @@ eye
 该OP用来构建二维Tensor(主对角线元素为1，其他元素为0)。
 
 参数：
-    - **num_rows** (int) - 生成二维Tensor的行数，数据类型为非负int32。
-    - **num_columns** (int，可选) - 生成二维Tensor的列数，数据类型为非负int32。若为None，则默认等于num_rows。
-    - **dtype** (np.dtype|core.VarDesc.VarType|str， 可选) - 返回Tensor的数据类型，可为float16，float32，float64， int32， int64。若为None, 则默认等于float32。
+    - **num_rows** (int) - 生成2-D Tensor的行数，数据类型为非负int32。
+    - **num_columns** (int，可选) - 生成2-D Tensor的列数，数据类型为非负int32。若为None，则默认等于num_rows。
+    - **dtype** (np.dtype|str， 可选) - 返回Tensor的数据类型，可为float16，float32，float64， int32， int64。若为None, 则默认等于float32。
     - **name** （str， 可选）- 具体用法请参见 :ref:`api_guide_Name` ，一般无需设置，默认值为None。
 
 返回： ``shape`` 为 [num_rows, num_columns]的Tensor。
@@ -25,7 +25,7 @@ eye
 .. code-block:: python
 
     import paddle
-    paddle.enable_imperative()  # Now we are in imperative mode
+    paddle.disable_static()  # Now we are in imperative mode
     data = paddle.eye(3, dtype='int32')
     # [[1 0 0]
     #  [0 1 0]

doc/fluid/api_cn/tensor_cn/full_cn.rst

@@ -7,12 +7,12 @@ full
 
 
 
-该OP创建形状大小为shape并且数据类型为dtype的Tensor，其中元素值均为 ``fill_value``。
+该OP创建形状大小为 ``shape`` 并且数据类型为 ``dtype``  的Tensor，其中元素值均为 ``fill_value`` 。
 
 参数：
     - **shape** (list|tuple|Tensor) – 指定创建Tensor的形状(shape), 数据类型为int32 或者int64。
     - **fill_value** (bool|float|int|Tensor) - 用于初始化输出Tensor的常量数据的值。注意：该参数不可超过输出变量数据类型的表示范围。
-    - **dtype** （np.dtype|core.VarDesc.VarType|str， 可选）- 输出变量的数据类型。若为None，则输出变量的数据类型和输入变量相同，默认值为None。
+    - **dtype** （np.dtype|str， 可选）- 输出变量的数据类型。若为None，则输出变量的数据类型和输入变量相同，默认值为None。
     - **name** （str，可选）- 具体用法请参见 :ref:`api_guide_Name` ，一般无需设置，默认值为None。
     
 返回：返回一个存储结果的Tensor，数据类型和dtype相同。
@@ -28,13 +28,13 @@ full
 
     import paddle
 
-    paddle.enable_imperative()  # Now we are in imperative mode
+    paddle.disable_static()  # Now we are in imperative mode
     data1 = paddle.full(shape=[2,1], fill_value=0, dtype='int64') 
     #[[0]
     # [0]]
 
     # attr shape is a list which contains Tensor.
-    positive_3 = paddle.fill_constant([1], "int32", 2)
+    positive_2 = paddle.fill_constant([1], "int32", 2)
     data3 = paddle.full(shape=[1, positive_2], dtype='float32', fill_value=1.5)
     # [[1.5 1.5]]
 
@@ -46,6 +46,6 @@ full
     
     # attr fill_value is a Tensor.
     val = paddle.fill_constant([1], "float32", 2.0)
-    data5 = paddle.full(shape=[2,1], fill_value=val, dtype='float32') i
+    data5 = paddle.full(shape=[2,1], fill_value=val, dtype='float32')
     # [[2.0] 
     #  [2.0]]

doc/fluid/api_cn/tensor_cn/full_like_cn.rst

@@ -11,7 +11,7 @@ full_like
 参数：
     - **x** (Tensor) – 输入Tensor, 输出Tensor和x具有相同的形状，x的数据类型可以是bool，float16，float32，float64，int32，int64。
     - **fill_value** (bool|float|int) - 用于初始化输出张量的常量数据的值。注意：该参数不可超过输出变量数据类型的表示范围。
-    - **dtype** （np.dtype|core.VarDesc.VarType|str， 可选）- 输出变量的数据类型。若参数为None，则输出变量的数据类型和输入变量相同，默认值为None。
+    - **dtype** （np.dtype|str， 可选）- 输出变量的数据类型。若参数为None，则输出变量的数据类型和输入变量相同，默认值为None。
     - **name** （str，可选）- 具体用法请参见 :ref:`api_guide_Name` ，一般无需设置，默认值为None。
     
 返回：返回一个存储结果的Tensor，数据类型和dtype相同。
@@ -27,7 +27,7 @@ full_like
     import paddle
     import numpy as np
     
-    paddle.enable_imperative()  # Now we are in imperative mode 
+    paddle.disable_static()  # Now we are in imperative mode 
     input = paddle.full(shape=[2, 3], fill_value=0.0, dtype='float32', name='input')
     output = paddle.full_like(input, 2.0)
     # [[2. 2. 2.]

doc/fluid/api_cn/tensor_cn/index_select_cn.rst

@@ -11,7 +11,7 @@ index_select
         
 **参数**：
     - **x** （Tensor）– 输入Tensor。 ``x`` 的数据类型可以是float32，float64，int32，int64。
-    - **index** （Tensor）– 包含索引下标的一维Tensor。
+    - **index** （Tensor）– 包含索引下标的1-D Tensor。
     - **axis**    (int, 可选) – 索引轴，若未指定，则默认选取第0维。
     - **name** （str，可选）- 具体用法请参见 :ref:`api_guide_Name` ，一般无需设置，默认值为None。
 
@@ -36,8 +36,8 @@ index_select
                          [9.0, 10.0, 11.0, 12.0]])
         data_index = np.array([0, 1, 1]).astype('int32')
 
-        x = paddle.to_variable(data)
-        index = paddle.to_variable(data_index)
+        x = paddle.to_tensor(data)
+        index = paddle.to_tensor(data_index)
         out_z1 = paddle.index_select(x=x, index=index)
         #[[1. 2. 3. 4.]
         # [5. 6. 7. 8.]

doc/fluid/api_cn/tensor_cn/linspace_cn.rst

@@ -5,36 +5,32 @@ linspace
 
 .. py:function:: paddle.linspace(start, stop, num, dtype=None, name=None)
 
-:alias_main: paddle.linspace
-:alias: paddle.tensor.linspace, paddle.tensor.creation.linspace
-
-
-
 该OP返回一个Tensor，Tensor的值为在区间start和stop上均匀间隔的num个值，输出Tensor的长度为num。
-
 **注意：该OP不进行梯度计算**
  
 参数：
-    - **start** (float|Tensor) – ``start`` 是区间开始的变量，可以是一个浮点标量，或是一个shape为[1]的Tensor，该Tensor的数据类型可以是float32或者是float64。
-    - **stop** (float|Tensor) – ``end`` 是区间结束的变量，可以是一个浮点标量，或是一个shape为[1]的Tensor，该Tensor的数据类型可以是float32或者是float64。
+    - **start** (int|float|Tensor) – ``start`` 是区间开始的变量，可以是一个浮点标量，或是一个shape为[1]的Tensor，该Tensor的数据类型可以是float32，float64，int32 或者int64。
+    - **stop** (int|float|Tensor) – ``stop`` 是区间结束的变量，可以是一个浮点标量，或是一个shape为[1]的Tensor，该Tensor的数据类型可以是float32，float64，int32或者int64。
     - **num** (int|Tensor) – ``num`` 是给定区间内需要划分的区间数，可以是一个整型标量，或是一个shape为[1]的Tensor，该Tensor的数据类型需为int32。
-    - **dtype** (np.dtype|core.VarDesc.VarType|str，可选) – 输出Tensor的数据类型，可以是float32或者是float64。如果dtype为None，默认类型为float32。
-    - **name** （str，可选）- 具体用法请参见 :ref:`api_guide_Name` ，一般无需设置，默认值为None。
+    - **dtype** (np.dtype|str, 可选) – 输出Tensor的数据类型。数据类型可以是float32，float64，int32，int64。如果dtype的数据类型为None，输出Tensor数据类型为float32。
+    - **name** （str， 可选）- 具体用法请参见 :ref:`api_guide_Name` ，一般无需设置，默认值为None。
 
-返回：输出结果的数据类型是float32或float64，表示等间隔划分结果的1-D Tensor，该Tensor的shape大小为 :math:`[num]` ，在mum为1的情况下，仅返回包含start元素值的Tensor。
-
-返回类型：Variable
+返回：表示等间隔划分结果的1-D Tensor，该Tensor的shape大小为 :math:`[num]` ，在mum为1的情况下，仅返回包含start元素值的Tensor。
 
 抛出异常：
-    - ``TypeError`` - 当start或者stop的数据类型不是float32或者float64。
-    - ``TypeError`` - 当num的数据类型不是float32或者float64。
-    - ``TypeError`` - 当dtype的类型不是float32或者float64。
+    - ``TypeError`` - 当 ``start`` 或者 ``stop`` 的数据类型不是float32，float64，int32或者int64。
+    - ``TypeError`` - 当 ``dtype`` 的类型不是float32，float64，int32或者int64。
+    - ``TypeError`` - ``num`` 的类型必须是int当 ``num`` 不是Tensor的时候。
+    - ``TypeError`` - ``num`` 的数据类型必须是int32当 ``num`` 是Tensor的时候。
+
 
 **代码示例**：
 
 .. code-block:: python
 
       import paddle
+      
+      paddle.disable_static()
       data = paddle.linspace(0, 10, 5, dtype='float32') # [0.0,  2.5,  5.0,  7.5, 10.0]
       data = paddle.linspace(0, 10, 1, dtype='float32') # [0.0]
 

doc/fluid/api_cn/tensor_cn/ones_cn.rst

@@ -11,7 +11,7 @@ ones
 
 参数：
     - **shape** (tuple|list|Tensor) - 输出Tensor的形状， ``shape`` 的数据类型为int32或者int64。
-    - **dtype** (np.dtype|core.VarDesc.VarType|str， 可选) - 输出Tensor的数据类型，数据类型必须为bool、 float16、float32、float64、int32或int64。如果 ``dtype`` 为None，默认数据类型为float32。
+    - **dtype** (np.dtype|str， 可选) - 输出Tensor的数据类型，数据类型必须为bool、 float16、float32、float64、int32或int64。如果 ``dtype`` 为None，默认数据类型为float32。
     - **name** （str，可选）- 具体用法请参见 :ref:`api_guide_Name` ，一般无需设置，默认值为None。
 
 返回：值全为1的Tensor，数据类型和 ``dtype`` 定义的类型一致。
@@ -27,7 +27,7 @@ ones
 
     import paddle
     
-    paddle.enable_imperative()
+    paddle.disable_static()
     
     #default dtype for ones OP
     data1 = paddle.ones(shape=[3, 2]) 

doc/fluid/api_cn/tensor_cn/split_cn.rst

@@ -17,7 +17,7 @@ split
 返回：分割后的Tensor列表。
 
 抛出异常：
-    - :code:`TypeError`：``x`` 的数据类型不是float16、float32、float64、int32或int64时 。
+    - :code:`TypeError`：``x`` 的数据类型不是bool、float16、float32、float64、int32或int64时 。
     - :code:`TypeError`：``num_or_sections`` 不是int、list 或 tuple时。
     - :code:`TypeError`：``axis`` 不是 int 或 Tensor时。当 ``axis`` 为Tensor，其数据类型不是int32或int64时。
 
@@ -28,10 +28,10 @@ split
     import numpy as np
     import paddle
     
-    paddle.enable_imperative()
+    paddle.disable_static()
     # x is a Tensor which shape is [3, 9, 5]
     x_np = np.random.random([3, 9, 5]).astype("int32")
-    x = paddle.imperative.to_variable(x_np)
+    x = paddle.to_tensor(x_np)
 
     out0, out1, out22 = paddle.split(x, num_or_sections=3, axis=1)
     # out0.shape [3, 3, 5]

doc/fluid/api_cn/tensor_cn/zeros_cn.rst

@@ -25,7 +25,7 @@ zeros
 .. code-block:: python
 
     import paddle
-    paddle.enable_imperative()  # Now we are in imperative mode
+    paddle.disable_static()  # Now we are in imperative mode
     data = paddle.zeros(shape=[3, 2], dtype='float32') 
     # [[0. 0.]
     #  [0. 0.]