update power doc;test=develop (#2447)

doc/fluid/api_cn/tensor_cn/pow_cn.rst

@@ -3,45 +3,40 @@
 pow
 -------------------------------
 
-.. py:function:: paddle.pow(input, exponent, out=None, name=None):
-
-:alias_main: paddle.pow
-:alias: paddle.pow,paddle.tensor.pow,paddle.tensor.math.pow
-:update_api: paddle.fluid.layers.pow
-
+.. py:function:: paddle.pow(x, y, name=None):
 
 
 该OP是指数激活算子：
 
 .. math::
-        out = x^{exponent}
+        out = x^{y}
 
 参数：
-    - **x** （Variable）- 多维 ``Tensor`` 或 ``LoDTensor`` ，数据类型为 ``float32`` 或 ``float64`` 。
-    - **exponent** （float32|Variable，可选）- ``float32`` 或形状为[1]的 ``Tensor`` 或 ``LoDTensor``，数据类型为 ``float32``。Pow OP的指数因子。默认值：1.0。
-    - **out** (Variable, 可选) - 默认值None，如果out不为空，则该运算结果存储在out变量中。 
-    - **name** (str，可选) - 默认值None，输出的名称。该参数供开发人员打印调试信息时使用，具体用法参见 :ref:`api_guide_name`。当out和name同时不为空时，结果输出变量名与out保持一致。
-
-返回：维度与输入 `x` 相同的 ``Tensor`` 或 ``LoDTensor``，数据类型与 ``x`` 相同。
-
-返回类型：Variable。
+    - **x** （Tensor）- 多维 ``Tensor``，数据类型为 ``float32`` 或 ``float64`` 或 ``int32`` 或 ``int64``。
+    - **y** （Tensor）- 多维 ``Tensor``，数据类型为 ``float32`` 或 ``float64`` 或 ``int32`` 或 ``int64``。Pow OP的指数因子。默认值：1.0。
+    - **name** (str) - 默认值None，输出的名称。该参数供开发人员打印调试信息时使用，具体用法参见 :ref:`api_guide_name`。
 
+返回： Tensor，数据类型和input ``x`` 一致。
 
 **代码示例：**
 
 .. code-block:: python
 
     import paddle
-    import paddle.fluid as fluid
-    x = fluid.data(name="x", shape=[32,32], dtype="float32")
-    
-    # 示例1: 参数exponent是个浮点数
-    res = fluid.data(name="output", shape=[32,32], dtype="float32")
-    y_1 = paddle.pow(x, 2.0, out=res)
-    # y_1 is x^{2.0}
+    import numpy as np
+
+    paddle.disable_static()
     
-    # 示例2: 参数exponent是个变量
-    exponent_tensor = fluid.layers.fill_constant([1], "float32", 3.0)
-    res = fluid.data(name="output", shape=[32,32], dtype="float32")
-    y_2 = paddle.pow(x, exponent_tensor, out=res)
-    # y_2 is x^{3.0}
\ No newline at end of file
+    # 示例1: 参数y是个浮点数
+    x_data = np.array([1, 2, 3])
+    y = 2
+    x = paddle.to_tensor(x_data)
+    res = paddle.pow(x, y)
+    # print(res.numpy()) # [1 4 9]
+
+    # 示例2: 参数y是个Tensor
+    y = paddle.fill_constant(shape=[1], value=2, dtype='float32')
+    res = paddle.pow(x, y)
+    print(res.numpy()) # [1 4 9]
+
+    
\ No newline at end of file