Add Chinese documents of get_flags and set_flags and modify documents… (#1985)

As the title

doc/fluid/api_cn/executor_cn/Executor_cn.rst

@@ -5,12 +5,12 @@ Executor
 
 **注意：该API仅支持【静态图】模式**
 
-.. py:class:: paddle.fluid.executor.Executor (place)
+.. py:class:: paddle.fluid.executor.Executor (place=None)
 
-Executor支持单GPU、多GPU以及CPU运行。在Executor构造时，需要传入设备。
+Executor支持单GPU、多GPU以及CPU运行。
 
 参数：
-    - **place** (fluid.CPUPlace()|fluid.CUDAPlace(N)) – 该参数表示Executor执行所在的设备，这里的N为GPU对应的ID。
+    - **place** (fluid.CPUPlace()|fluid.CUDAPlace(N)|None) – 该参数表示Executor执行所在的设备，这里的N为GPU对应的ID。当该参数为 `None` 时，PaddlePaddle会根据其安装版本来设置默认设备。当PaddlePaddle是CPU版时，默认运行设备将会设置为 `fluid.CPUPlace()` ；当PaddlePaddle是GPU版本时，默认执行设备将会设置为 `fluid.CUDAPlace(0)` 。默认值为None。
   
 返回：初始化后的 ``Executor`` 对象
 
@@ -25,9 +25,13 @@ Executor支持单GPU、多GPU以及CPU运行。在Executor构造时，需要传
     import numpy
     import os
 
-    use_cuda = True
-    place = fluid.CUDAPlace(0) if use_cuda else fluid.CPUPlace()
-    exe = fluid.Executor(place)
+    # 显式设置运行设备
+    # use_cuda = True
+    # place = fluid.CUDAPlace(0) if use_cuda else fluid.CPUPlace()
+    # exe = fluid.Executor(place)
+
+    # 如果不显示设置运行设备，PaddlePaddle会设置默认运行设备
+    exe = fluid.Executor()
 
     train_program = fluid.Program()
     startup_program = fluid.Program()
@@ -54,8 +58,13 @@ Executor支持单GPU、多GPU以及CPU运行。在Executor构造时，需要传
     # 否则fluid会把逻辑核的所有数目设为CPU_NUM，
     # 在这种情况下，输入的batch size应大于CPU_NUM，
     # 否则程序会异常中断。
-    if not use_cuda:
-        os.environ['CPU_NUM'] = str(2)
+
+    # 显式设置运行设备
+    # if not use_cuda:
+    #    os.environ['CPU_NUM'] = str(2)
+
+    # 未显示设置运行设备且安装的Paddle为CPU版本
+    os.environ['CPU_NUM'] = str(2)
 
     compiled_prog = compiler.CompiledProgram(
         train_program).with_data_parallel(

doc/fluid/api_cn/fluid_cn.rst

@@ -31,6 +31,7 @@ fluid
     fluid_cn/enable_dygraph_cn.rst
     fluid_cn/ExecutionStrategy_cn.rst
     fluid_cn/Executor_cn.rst
+    fluid_cn/get_flags_cn.rst
     fluid_cn/global_scope_cn.rst
     fluid_cn/gradients_cn.rst
     fluid_cn/in_dygraph_mode_cn.rst
@@ -50,6 +51,7 @@ fluid
     fluid_cn/require_version_cn.rst
     fluid_cn/save_cn.rst
     fluid_cn/scope_guard_cn.rst
+    fluid_cn/set_flags_cn.rst
     fluid_cn/Tensor_cn.rst
     fluid_cn/Variable_cn.rst
     fluid_cn/WeightNormParamAttr_cn.rst

doc/fluid/api_cn/fluid_cn/Executor_cn.rst

@@ -6,12 +6,12 @@ Executor
 
 **注意：该API仅支持【静态图】模式**
 
-.. py:class:: paddle.fluid.Executor (place)
+.. py:class:: paddle.fluid.Executor (place=None)
 
-Executor支持单GPU、多GPU以及CPU运行。在Executor构造时，需要传入设备。
+Executor支持单GPU、多GPU以及CPU运行。
 
 参数：
-    - **place** (fluid.CPUPlace()|fluid.CUDAPlace(N)) – 该参数表示Executor执行所在的设备，这里的N为GPU对应的ID。
+    - **place** (fluid.CPUPlace()|fluid.CUDAPlace(N)|None) – 该参数表示Executor执行所在的设备，这里的N为GPU对应的ID。当该参数为 `None` 时，PaddlePaddle会根据其安装版本设置默认的运行设备。当安装的Paddle为CPU版时，默认运行设置会设置成 `CPUPlace()` ，而当Paddle为GPU版时，默认运行设备会设置成 `CUDAPlace(0)` 。默认值为None。
   
 返回：初始化后的 ``Executor`` 对象
 
@@ -26,9 +26,13 @@ Executor支持单GPU、多GPU以及CPU运行。在Executor构造时，需要传
     import numpy
     import os
 
-    use_cuda = True
-    place = fluid.CUDAPlace(0) if use_cuda else fluid.CPUPlace()
-    exe = fluid.Executor(place)
+    # 显式设置运行设备
+    # use_cuda = True
+    # place = fluid.CUDAPlace(0) if use_cuda else fluid.CPUPlace()
+    # exe = fluid.Executor(place)
+
+    # 如果不显示设置运行设备，PaddlePaddle会设置默认运行设备
+    exe = fluid.Executor()
 
     train_program = fluid.Program()
     startup_program = fluid.Program()
@@ -55,8 +59,13 @@ Executor支持单GPU、多GPU以及CPU运行。在Executor构造时，需要传
     # 否则fluid会把逻辑核的所有数目设为CPU_NUM，
     # 在这种情况下，输入的batch size应大于CPU_NUM，
     # 否则程序会异常中断。
-    if not use_cuda:
-        os.environ['CPU_NUM'] = str(2)
+
+    # 显式设置运行设备
+    # if not use_cuda:
+    #    os.environ['CPU_NUM'] = str(2)
+
+    # 未显示设置运行设备且安装的Paddle为CPU版本
+    os.environ['CPU_NUM'] = str(2)
 
     compiled_prog = compiler.CompiledProgram(
         train_program).with_data_parallel(

doc/fluid/api_cn/fluid_cn/get_flags_cn.rst

+.. _cn_api_fluid_get_flags:
+
+get_flags
+-------------------------------
+
+.. py:function:: paddle.fluid.get_flags(flags)
+用于获取Paddle框架中环境变量FLAGS的当前值。
+
+参数：
+    - **flags** (list|tuple|str) - 需要获取的环境变量FLAGS的名称。
+
+**代码示例**
+
+.. code-block:: python
+
+    import paddle.fluid as fluid
+
+    flags = ['FLAGS_eager_delete_tensor_gb', 'FLAGS_check_nan_inf']
+    res = fluid.get_flags(flags)
+    print(res)
+    # {'FLAGS_eager_delete_tensor_gb': 0.0, 'FLAGS_check_nan_inf': False}

doc/fluid/api_cn/fluid_cn/set_flags_cn.rst

+.. _cn_api_fluid_set_flags:
+
+set_flags
+-------------------------------
+
+.. py:function:: paddle.fluid.set_flags(flags)
+用于设置Paddle框架中环境变量FLAGS的值。
+
+参数：
+    - **flags** (dict) - 包含想要设置的环境变量FLAGS的名称和值的字典。
+
+**示例代码**
+
+.. code-block:: python
+
+    import paddle.fluid as fluid
+
+    fluid.set_flags({'FLAGS_eager_delete_tensor_gb': 1.0})