From 8bc86d363aaf1104e4b84fe4160e3e0cff141cda Mon Sep 17 00:00:00 2001
From: Zhen Wang <wangzhen31@baidu.com>
Date: Wed, 25 Sep 2019 14:02:15 +0800
Subject: [PATCH] Rewrite the content of the chain in Reader_cn.rst. (#1281)

* Rewrite the content of the chain in Reader_cn.rst.
---
 .../api_cn/data/data_reader_cn/Reader_cn.rst  | 11 +-----
 doc/fluid/api_cn/io_cn/chain_cn.rst           | 38 ++++++++++++++-----
 2 files changed, 31 insertions(+), 18 deletions(-)

diff --git a/doc/fluid/api_cn/data/data_reader_cn/Reader_cn.rst b/doc/fluid/api_cn/data/data_reader_cn/Reader_cn.rst
index 0006a80f4..48a900bee 100644
--- a/doc/fluid/api_cn/data/data_reader_cn/Reader_cn.rst
+++ b/doc/fluid/api_cn/data/data_reader_cn/Reader_cn.rst
@@ -91,16 +91,9 @@ Data Reader Interface
 
 .. py:function:: paddle.reader.chain(*readers)
 
-创建一个数据reader，其输出是链接在一起的输入数据reader的输出。
+**注意：paddle.reader.chain是paddle.fluid.io.chain的别名，推荐使用paddle.fluid.io.chain。**
 
-如果输入reader输出以下数据条目：[0，0，0][1，1，1][2，2，2]，链接reader将输出：[0，0，0，1，1，1，2，2，2] 。
-
-参数：
-    - **readers** – 输入的数据。
-
-返回： 新的数据读取器
-
-返回类型： callable
+详见 :ref:`cn_api_fluid_io_chain` 接口的使用文档。
 
 
 .. py:function:: paddle.reader.shuffle(reader, buf_size)
diff --git a/doc/fluid/api_cn/io_cn/chain_cn.rst b/doc/fluid/api_cn/io_cn/chain_cn.rst
index 9dc9537a8..58f3b2e6a 100644
--- a/doc/fluid/api_cn/io_cn/chain_cn.rst
+++ b/doc/fluid/api_cn/io_cn/chain_cn.rst
@@ -5,19 +5,39 @@ chain
 
 .. py:function:: paddle.fluid.io.chain(*readers)
 
-创建一个数据读取器，输出为输入数据读取器链接到一起的结果，如果输入如下：
+创建一个数据读取器，其功能是将输入的多个数据读取器的输出链接在一起作为它的输出。
 
-[0, 0, 0]
+举例来说，如果输入数据读取器的输出分别为[0，0，0]、[10，10，10]和[20，20，20]，那么调用该接口产生的新数据读取器的输出为：[0，0，0][10，10，10][20，20，20] 。
 
-[1, 1, 1]
+参数：
+    - **readers** – 输入的数据读取器。
 
-[2, 2, 2]
+返回： 新的数据读取器。
 
-输出将会为[0, 0, 0, 1, 1, 1, 2, 2, 2].
+返回类型：callable
 
-参数:
-    - **readers** – 输入reader
+**代码示例**
 
-返回：新的数据reader。
+..  code-block:: python
+
+    import paddle
+    def reader_creator_3(start):
+        def reader():
+            for i in range(start, start + 3):
+                yield [i, i, i]
+        return reader
+
+    c = paddle.reader.chain(reader_creator_3(0), reader_creator_3(10), reader_creator_3(20))
+    for e in c():
+        print(e)
+    # 输出结果如下：
+    # [0, 0, 0]
+    # [1, 1, 1]
+    # [2, 2, 2]
+    # [10, 10, 10]
+    # [11, 11, 11]
+    # [12, 12, 12]
+    # [20, 20, 20]
+    # [21, 21, 21]
+    # [22, 22, 22]
 
-返回类型：callable
\ No newline at end of file
-- 
GitLab