update

docs/guides/11_kernel_primitives_api/functor_api_cn.md

@@ -1,5 +1,5 @@
 # API 介绍 - Functor
-介绍 Kernel Primitive API 定义的计算 Functor，当前一共有 13 个 Functor 可以直接使用。
+介绍 Kernel Primitive API 定义的 Functor，当前一共有 13 个 Functor 可以直接使用。
 
 ## Unary Functor
 
@@ -14,12 +14,12 @@ struct kps::ExpFunctor<Tx, Ty>();
 对 Tx 类型的输入数做 Exp 操作，并将结果转成 Ty 类型返回。
 
 #### 模板参数
-> Tx : 输入数据的类型。
-> Ty : 返回类型。
+> Tx : 输入数据的类型。</br>
+> Ty : 返回类型。</br>
 
 #### 使用示例
 ```
-auto functor = kps::ExpFunctor<float>(1);
+auto functor = kps::ExpFunctor<float>();
 float input = 0;
 float out = functor(input);
 
@@ -39,8 +39,8 @@ struct kps::IdentityFunctor<Tx, Ty>();
 将 Tx 类型的输入数据转成 Ty 类型返回。
 
 #### 模板参数
-> Tx : 输入数据的类型。
-> Ty : 返回类型。
+> Tx : 输入数据的类型。</br>
+> Ty : 返回类型。</br>
 
 #### 使用示例
 ```
@@ -62,8 +62,8 @@ struct kps::DivideFunctor<Tx, Ty>(num);
 将 Tx 类型的输入数据除以 num，并将结果转成 Ty 类型返回。
 
 #### 模板参数
-> Tx : 输入数据的类型。
-> Ty : 返回类型。
+> Tx : 输入数据的类型。</br>
+> Ty : 返回类型。</br>
 
 #### 使用示例
 ```
@@ -86,8 +86,8 @@ struct kps::SquareFunctor<Tx, Ty>();
 对 Tx 类型的输入数做 Square 操作，并将结果转成 Ty 类型返回。
 
 #### 模板参数
-> Tx : 输入数据的类型。
-> Ty : 返回类型。
+> Tx : 输入数据的类型。</br>
+> Ty : 返回类型。</br>
 #### 使用示例
 ```
 auto functor = kps::SquareFunctor<float>();
@@ -254,6 +254,7 @@ struct kps::SubFunctor<T>();
 
 #### 模板参数
 > T : 数据类型。
+
 #### 使用示例
 ```
 auto functor = kps::SubFunctor<float>();
@@ -277,6 +278,7 @@ struct kps::DivFunctor<T>();
 
 #### 模板参数
 > T : 数据类型。
+
 #### 使用示例
 ```
 auto functor = kps::DivFunctor<float>();
@@ -313,10 +315,10 @@ float out = functor(input1, input2);
 // out = 0
 ```
 ## Functor 定义规则
-ElementwiseAny 支持指针数组的形式传递，对于其他计算函数仅仅支持普通参数传递。
+当前计算函数中仅 ElementwiseAny 支持 Functor 参数设置为指针，其他计算函数的 Functor 仅能设置为普通参数。
 
-### 指针数组传递
-目前指针数组传递仅仅在 ElementwiseAny 中支持，因此在进行 ElementwiseAny 的 Functor 定义时候需要保证重载的 operate() 函数的参数是指针数组。例如要实现功能： (a + b) * c + d， 则可以结合 ElementwiseAny 与 Functor 完成对应计算。
+### 指针传递
+在进行 ElementwiseAny 的 Functor 定义时候需要保证重载的 operate() 函数的参数是数组指针。例如要实现功能： (a + b) * c + d， 则可以结合 ElementwiseAny 与 Functor 完成对应计算。
 
 ExampleFunctor1 定义:
 ```

docs/guides/11_kernel_primitives_api/functor_api_en.md

@@ -14,12 +14,12 @@ struct kps::ExpFunctor<Tx, Ty>();
 Exp operation is performed on the input number of Tx type, and the result is converted into Ty type and returned.
 
 #### Template Parameters
-> Tx : Data type of input.
-> Ty : The type of return.
+> Tx : Data type of input.</br>
+> Ty : The type of return.</br>
 
 #### Example
 ```
-auto functor = kps::ExpFunctor<float>(1);
+auto functor = kps::ExpFunctor<float>();
 float input = 0;
 float out = functor(input);
 
@@ -62,8 +62,8 @@ struct kps::DivideFunctor<Tx, Ty>(num);
 Divide the input data of Tx type by num, and convert the result into Ty type to return.
 
 #### Template Parameters
-> Tx : Data type of input.
-> Ty : The type of return.
+> Tx : Data type of input.</br>
+> Ty : The type of return.</br>
 
 #### Example
 ```
@@ -86,8 +86,8 @@ struct kps::SquareFunctor<Tx, Ty>();
 Perform Square operation on the input number of Tx type, and convert the result into Ty type to return.
 
 #### Template Parameters
-> Tx : Data type of input.
-> Ty : The type of return.
+> Tx : Data type of input.</br>
+> Ty : The type of return.</br>
 
 #### Example
 ```
@@ -138,6 +138,7 @@ Returns the maximum value of the two inputs. MaxFunctor provides the initial() f
 
 #### Template Parameters
 > T : The type of data.
+
 #### Example
 ```
 auto functor = kps::MaxFunctor<float>();
@@ -318,10 +319,10 @@ float out = functor(input1, input2);
 // out = 0
 ```
 ## Functor Definition Rules
-ElementwiseAny supports the transfer of pointer arrays, and only supports ordinary parameter transfer for other calculation functions.
+In the current calculation function, only ElementwiseAny supports setting the functor parameter as a pointer, and the functor of other calculation functions can only be set as a normal parameter.
 
 ### Pointer Array
-Pointer array transfer is only supported in ElementwiseAny, so when defining ElementwiseAny's Functor, you need to ensure that the parameter of the overloaded operate() function is an array of pointers. For example, to realize the function: (a + b) * c + d, you can combine ElementwiseAny and Functor to complete the corresponding calculation.
+When defining ElementwiseAny's Functor, you need to ensure that the parameter of the overloaded operate() function is a pointer. For example, to realize the function: (a + b) * c + d, you can combine ElementwiseAny and Functor to complete the calculation.
 
 ExampleFunctor1:
 ```

docs/guides/11_kernel_primitives_api/index_cn.rst

@@ -55,9 +55,8 @@ API 列表
 |                                      | 根据当前 Block 的数据偏移和原始输入指针计算输入坐标， |
 |                                      | 并将输入数据读取到寄存器中。                          |
 +--------------------------------------+-------------------------------------------------------+
-| ReadDataReduce                       | IO，                                                  |
-|                                      | 根据当前 Block 的数据偏移和原始输入指针计算输入坐标， |
-|                                      | 并将输入数据读取到寄存器中。                          |
+| ReadDataReduce                       | IO，Reduce 形式的读取数据，                           |
+|                                      | 将需要进行规约的数据从全局内存读取到寄存器中。        |
 +--------------------------------------+-------------------------------------------------------+
 | WriteData                            | IO，将数据从寄存器写入全局内存中。                    |
 +--------------------------------------+-------------------------------------------------------+
@@ -82,7 +81,7 @@ API 列表
 API 介绍
 ##############
 
-- `Functor <./functor_api_cn.html>`_ : 介绍Kernel Primitive API 提供的 Functor。
+- `Functor <./functor_api_cn.html>`_ : 介绍 Kernel Primitive API 提供的 Functor。
 - `IO API <./io_api_cn.html>`_ : 介绍 IO 类 API 的定义和功能。
 - `Compute API <./compute_api_cn.html>`_ : 介绍 Compute 类 API 的定义和功能。
 

docs/guides/11_kernel_primitives_api/index_en.rst

@@ -18,7 +18,7 @@ Functor List
 +--------------------------------------+-------------------------------------------------------+
 | Functor name                         | Descriptions                                          |
 +======================================+=======================================================+
-| ExpFunctor                           | Unary Functor, perform Exp operation.                 |
+| ExpFunctor                           | Unary Functor, performs Exp operation.                |
 +--------------------------------------+-------------------------------------------------------+
 | IdentityFunctor                      | Unary Functor, which performs type conversion on input|
 |                                      | data.                                                 |
@@ -41,13 +41,13 @@ Functor List
 | LogicalOrFunctor                     | Binary Functor, which returns the logical or result of|
 |                                      | the inputs.                                           |
 +--------------------------------------+-------------------------------------------------------+
-| LogicalAndFunctor                    | Binary Functor, which returns the logical AND result  |
+| LogicalAndFunctor                    | Binary Functor, which returns the logical and result  |
 |                                      | of the inputs.                                        |
 +--------------------------------------+-------------------------------------------------------+
-| DivFunctor                           | Binary Functor, returns the result of division of two |
+| DivFunctor                           | Binary Functor, returns the result of division of the |
 |                                      | inputs.                                               |
 +--------------------------------------+-------------------------------------------------------+
-| FloorDivFunctor                      | Binary Functor, returns the result of division of two |
+| FloorDivFunctor                      | Binary Functor, returns the result of division of the |
 |                                      | inputs.                                               |
 +--------------------------------------+-------------------------------------------------------+
 
@@ -65,9 +65,8 @@ API List
 |                                      | block and the original input pointer, and read the input    |
 |                                      | data into the register.                                     |
 +--------------------------------------+-------------------------------------------------------------+
-| ReadDataReduce                       | IO, calculate the input coordinates according to the data   |
-|                                      | offset of the current block and the original input pointer, |
-|                                      | and read the input data into the register.                  |
+| ReadDataReduce                       | IO, read data in Reduce form, read the input data from      |
+|                                      | global memory into register for Reduce.                     |
 +--------------------------------------+-------------------------------------------------------------+
 | WriteData                            | IO, write data from registers to global memory.             |
 +--------------------------------------+-------------------------------------------------------------+

docs/guides/11_kernel_primitives_api/io_api_cn.md

@@ -1,5 +1,5 @@
 # API 介绍 - IO
-介绍目前 Kernel Primitive API 提供的用于全局内存和寄存器进行数据交换的 API。当前实现的 IO 类 API 均是 Block 级别的多线程 API。函数内部以 blockDim.x 或 blockDim.y 进行线程索引，因此请详细阅读 API 使用规则。
+介绍目前 Kernel Primitive API 提供的用于全局内存和寄存器进行数据交换的 API。当前实现的 IO 类 API 均是 Block 级别的多线程 API。函数内部以 blockDim.x 或 blockDim.y 进行线程索引，请详细阅读 API 使用规则。
 ## [ReadData](https://github.com/PaddlePaddle/Paddle/blob/develop/paddle/fluid/operators/kernel_primitives/datamover_primitives.h#L121)
 ### 函数定义