fix cn doc of API unsqueeze/concat/split after changing English doc. test=develop (#1562)

doc/fluid/api_cn/layers_cn/concat_cn.rst

@@ -5,11 +5,11 @@ concat
 
 .. py:function:: paddle.fluid.layers.concat(input,axis=0,name=None)
 
-该OP对输入沿 ``axis`` 轴进行联结
+该OP对输入沿 ``axis`` 轴进行联结。
 
 参数：
-    - **input** (list) - 输入待联结的多维 ``Tensor`` 组成的 ``list`` ，支持的数据类型为：float32、float64、int32、int64。
-    - **axis** (int，可选) - 指定对输入Tensor进行运算的轴， ``axis`` 的有效范围是[-R, R)，R是输入 ``input`` 中 ``Tensor`` 的Rank， ``axis`` 为负时与 ``axis`` +R 等价。默认值为0。
+    - **input** (list) - 输入是待联结的多维 ``Tensor`` 组成的 ``list`` ，支持的数据类型为：float32、float64、int32、int64。
+    - **axis** (int|Variable，可选) - 整数或者形状为[1]的 ``Tensor``，数据类型为 ``int32``。指定对输入Tensor进行运算的轴， ``axis`` 的有效范围是[-R, R)，R是输入 ``input`` 中 ``Tensor`` 的维度， ``axis`` 为负值时与 :math:`axis + R` 等价。默认值为0。
     - **name** (str，可选) – 具体用法请参见 :ref:`api_guide_Name` ，一般无需设置，默认值为None。
 
 返回：联结后的 ``Tensor`` ，数据类型和 ``input`` 相同。

doc/fluid/api_cn/layers_cn/split_cn.rst

@@ -5,40 +5,49 @@ split
 
 .. py:function:: paddle.fluid.layers.split(input,num_or_sections,dim=-1,name=None)
 
-将输入Tensor分割成多个子Tensor。
+该OP将输入Tensor分割成多个子Tensor。
 
 参数：
-    - **input** (Variable) - 输入变量，为数据类型为float32，float64，int32，int64的多维Tensor或者LoDTensor。
-    - **num_or_sections** (int|list) - 整数或元素为整数的列表。如果\ ``num_or_sections``\ 是一个整数，则表示Tensor平均划分为的相同大小子Tensor的数量。如果\ ``num_or_sections``\ 是一个整数列表，则列表的长度代表子Tensor的数量，列表中的整数依次代表子Tensor的需要分割成的维度的大小。列表长度不能超过输入Tensor待分割的维度的大小。
-    - **dim** (int) - 需要分割的维度。如果dim < 0,划分的维度为rank(input) + dim，数据类型为int32，int64。
+    - **input** (Variable) - 输入变量，数据类型为float32，float64，int32，int64的多维Tensor或者LoDTensor。
+    - **num_or_sections** (int|list|tuple) - 如果 ``num_or_sections`` 是一个整数，则表示Tensor平均划分为相同大小子Tensor的数量。如果 ``num_or_sections`` 是一个list或tuple，那么它的长度代表子Tensor的数量，它的元素可以是整数或者形状为[1]的Tensor，依次代表子Tensor需要分割成的维度的大小。list或tuple的长度不能超过输入Tensor待分割的维度的大小。至多有一个元素值为-1，-1表示该值是由 ``input`` 待分割的维度值和 ``num_or_sections`` 的剩余元素推断出来的。
+    - **dim** (int|Variable，可选) - 整数或者形状为[1]的Tensor，数据类型为int32或int64。表示需要分割的维度。如果dim < 0，则划分的维度为rank(input) + dim。默认值为-1。
     - **name** (str，可选) - 具体用法请参见 :ref:`api_guide_Name` ，一般无需设置，默认值为None。
 
 返回：分割后的Tensor列表。
 
 返回类型：列表(Variable(Tensor|LoDTensor))，数据类型为int32，int64，float32，float64。
 
+抛出异常：
+    - :code:`TypeError`：``num_or_sections`` 不是int、list 或 tuple。
+    - :code:`TypeError`：``dim`` 不是 int 或 Variable。
+
 **代码示例**：
 
 .. code-block:: python
 
     import paddle.fluid as fluid
 
-    # 输入是维度为[-1, 3, 9, 5]的Tensor：
-    input = fluid.layers.data(
+    # 输入是维度为[3, 9, 5]的Tensor：
+    input = fluid.data(
          name="input", shape=[3, 9, 5], dtype="float32")
 
     # 传入num_or_sections为一个整数
-    x0, x1, x2 = fluid.layers.split(input, num_or_sections=3, dim=2)
-    x0.shape  # [-1, 3, 3, 5]
-    x1.shape  # [-1, 3, 3, 5]
-    x2.shape  # [-1, 3, 3, 5]
+    x0, x1, x2 = fluid.layers.split(input, num_or_sections=3, dim=1)
+    x0.shape  # [3, 3, 5]
+    x1.shape  # [3, 3, 5]
+    x2.shape  # [3, 3, 5]
 
     # 传入num_or_sections为一个整数列表
-    x0, x1, x2 = fluid.layers.split(input, num_or_sections=[2, 3, 4], dim=2)
-    x0.shape  # [-1, 3, 2, 5]
-    x1.shape  # [-1, 3, 3, 5]
-    x2.shape  # [-1, 3, 4, 5]
-
+    x0, x1, x2 = fluid.layers.split(input, num_or_sections=[2, 3, 4], dim=1)
+    x0.shape  # [3, 2, 5]
+    x1.shape  # [3, 3, 5]
+    x2.shape  # [3, 4, 5]
+
+    # 传入num_or_sections为一个整数列表，其中有一个元素为-1
+    x0, x1, x2 = fluid.layers.split(input, num_or_sections=[2, 3, -1], dim=1)
+    x0.shape  # [3, 2, 5]
+    x1.shape  # [3, 3, 5]
+    x2.shape  # [3, 4, 5]
 
 
 

doc/fluid/api_cn/layers_cn/unsqueeze_cn.rst

@@ -5,7 +5,7 @@ unsqueeze
 
 .. py:function:: paddle.fluid.layers.unsqueeze(input, axes, name=None)
 
-该OP向输入（input）的shape中一个或多个位置（axes）插入维度
+该OP向输入（input）的shape中一个或多个位置（axes）插入维度。
 
 - 示例：
 
@@ -22,9 +22,9 @@ unsqueeze
                     [[4, 5, 6]]]]
       
 参数：
-    - **input** (Variable) - 维度为 :math:[N_1, N2, ..., N_D]的多维Tensor
-    - **axes** (list)- 整数数列，每个数代表要插入维度的位置
-    - **name** (str|None) - 该层名称
+    - **input** (Variable)- 多维 ``Tensor``，数据类型为 ``float32``， ``float64``， ``int8``， ``int32``，或 ``int64``。
+    - **axes** (int|list|tuple|Variable) - 表示要插入维度的位置。数据类型是 ``int32`` 。如果 ``axes`` 的类型是 list 或 tuple，它的元素可以是整数或者形状为[1]的 ``Tensor`` 。如果 ``axes`` 的类型是 ``Variable``，则是1-D ``Tensor``。
+    - **name** （str，可选）- 具体用法请参见 :ref:`api_guide_Name` ，一般无需设置。默认值： ``None``。
 
 返回：扩展维度后的多维Tensor
 
@@ -35,5 +35,6 @@ unsqueeze
 .. code-block:: python
 
     import paddle.fluid as fluid
-    x = fluid.layers.data(name='x', shape=[5, 10])
+    x = fluid.data(name='x', shape=[5, 10])
     y = fluid.layers.unsqueeze(input=x, axes=[1])
+    # y.shape is [5, 1, 10]