Merge branch 'develop' into new_op1

Author: zhanghonggeng

.github/CODEOWNERS

@@ -1,2 +1,2 @@
 # Paddle API Docs
-docs/api/paddle @jzhang533 @sunzhongkai588 @mattheliu
+docs/api/paddle @jzhang533 @sunzhongkai588 @mattheliu @Echo-Nie

.pre-commit-config.yaml

@@ -18,6 +18,11 @@ repos:
         types: [text]
       - id: remove-tabs
         types: [text]
+  - repo: https://github.com/PFCCLab/typos-pre-commit-mirror.git
+    rev: v1.38.1
+    hooks:
+      - id: typos
+        args: [--force-exclude]
   # Document hooks
   - repo: https://github.com/PFCCLab/dochooks
     rev: v0.6.0

_typos.toml

@@ -0,0 +1,282 @@
+[files]
+# The following files will be excluded from spell check during commits
+extend-exclude = []
+
+[default]
+# Ignore 1-3 letter words, refer to https://github.com/crate-ci/typos/issues/1079
+extend-ignore-words-re = ["^[a-zA-Z]{1,3}$"]
+# refer to https://github.com/crate-ci/typos/blob/master/docs/reference.md#example-configurations
+extend-ignore-re = [
+    # Ignore lines by `# typos: disable-line`
+    "(?Rm)^.*(#|//)\\s*typos:\\s*disable-line$",
+    # Ignore block by `# typos: off` and `# typos: on`
+    "(?s)(#|//)\\s*typos:\\s*off.*?\\n\\s*(#|//)\\s*typos:\\s*on"
+]
+
+[default.extend-words]
+# PaddlePaddle specific words
+CANN = "CANN"
+Clas = "Clas"
+arange = "arange"
+
+# These words need to be fixed
+Accuray = "Accuray"
+Adventages = "Adventages"
+Archetecture = "Archetecture"
+Asynchoronous = "Asynchoronous"
+Attrbute = "Attrbute"
+Attribtue = "Attribtue"
+Bounary = "Bounary"
+Classfication = "Classfication"
+Comparision = "Comparision"
+Contructing = "Contructing"
+Creenshot = "Creenshot"
+DELCARE = "DELCARE"
+Dateset = "Dateset"
+Discription = "Discription"
+Distrbuted = "Distrbuted"
+Driect = "Driect"
+Embeddding = "Embeddding"
+Embeding = "Embeding"
+Engish = "Engish"
+Fasle = "Fasle"
+Flase = "Flase"
+Generater = "Generater"
+Gloabal = "Gloabal"
+Imporvement = "Imporvement"
+Interfce = "Interfce"
+Kernal = "Kernal"
+Learing = "Learing"
+Moible = "Moible"
+Nervana = "Nervana"
+Numberic = "Numberic"
+Operaton = "Operaton"
+Optimizaing = "Optimizaing"
+Optimzier = "Optimzier"
+Paremeter = "Paremeter"
+Pipline = "Pipline"
+Porgram = "Porgram"
+Prallel = "Prallel"
+Propegation = "Propegation"
+Propogation = "Propogation"
+Protocal = "Protocal"
+Pyhton = "Pyhton"
+REGISTE = "REGISTE"
+Reivew = "Reivew"
+Reuqest = "Reuqest"
+Setment = "Setment"
+Similarily = "Similarily"
+Simle = "Simle"
+Sovler = "Sovler"
+Successed = "Successed"
+Tansformer = "Tansformer"
+Tenosr = "Tenosr"
+Traning = "Traning"
+Transfomed = "Transfomed"
+Tthe = "Tthe"
+Ture = "Ture"
+Useage = "Useage"
+Varialble = "Varialble"
+Varible = "Varible"
+Varient = "Varient"
+Wether = "Wether"
+accordding = "accordding"
+accoustic = "accoustic"
+accpetance = "accpetance"
+accracy = "accracy"
+acutal = "acutal"
+apporach = "apporach"
+apporaches = "apporaches"
+arguements = "arguements"
+arguemnts = "arguemnts"
+assgin = "assgin"
+assginment = "assginment"
+auxilary = "auxilary"
+avaiable = "avaiable"
+baisc = "baisc"
+basci = "basci"
+beacuse = "beacuse"
+bechmark = "bechmark"
+benckmark = "benckmark"
+boradcast = "boradcast"
+brodcast = "brodcast"
+caculate = "caculate"
+cantains = "cantains"
+choosen = "choosen"
+classfication = "classfication"
+classfy = "classfy"
+cliping = "cliping"
+colunms = "colunms"
+commmit = "commmit"
+complie = "complie"
+condtional = "condtional"
+conjuction = "conjuction"
+containg = "containg"
+contruct = "contruct"
+contructed = "contructed"
+contruction = "contruction"
+contxt = "contxt"
+convertion = "convertion"
+convinience = "convinience"
+correponding = "correponding"
+corresonding = "corresonding"
+correspoinding = "correspoinding"
+corss = "corss"
+creatation = "creatation"
+creats = "creats"
+dafault = "dafault"
+datas = "datas"
+decribe = "decribe"
+decribes = "decribes"
+deocder = "deocder"
+desgin = "desgin"
+desginated = "desginated"
+desigin = "desigin"
+determinated = "determinated"
+diffcult = "diffcult"
+dimention = "dimention"
+dimentions = "dimentions"
+dirrectories = "dirrectories"
+disucssion = "disucssion"
+egde = "egde"
+enviornment = "enviornment"
+erros = "erros"
+evalute = "evalute"
+exampels = "exampels"
+exection = "exection"
+exlusive = "exlusive"
+exmaple = "exmaple"
+exsits = "exsits"
+feeded = "feeded"
+flaot = "flaot"
+fliters = "fliters"
+follwing = "follwing"
+formated = "formated"
+formater = "formater"
+forword = "forword"
+foward = "foward"
+functinal = "functinal"
+fundemental = "fundemental"
+funtion = "funtion"
+gard = "gard"
+generaly = "generaly"
+gloabl = "gloabl"
+heigh = "heigh"
+ilter = "ilter"
+imge = "imge"
+implememted = "implememted"
+indeces = "indeces"
+indentical = "indentical"
+indicies = "indicies"
+indx = "indx"
+infered = "infered"
+inferface = "inferface"
+infor = "infor"
+ingore = "ingore"
+instert = "instert"
+instrinsics = "instrinsics"
+interchangable = "interchangable"
+intializers = "intializers"
+intput = "intput"
+lable = "lable"
+learing = "learing"
+legth = "legth"
+lengthes = "lengthes"
+lenth = "lenth"
+leran = "leran"
+libary = "libary"
+likey = "likey"
+mantained = "mantained"
+matrics = "matrics"
+mdule = "mdule"
+mechnism = "mechnism"
+memeory = "memeory"
+memroy = "memroy"
+messege = "messege"
+metaphore = "metaphore"
+metrices = "metrices"
+muliply = "muliply"
+mulitplying = "mulitplying"
+mutbale = "mutbale"
+neeeded = "neeeded"
+nessesary = "nessesary"
+numberic = "numberic"
+occurence = "occurence"
+opeartor = "opeartor"
+opeartors = "opeartors"
+operaters = "operaters"
+optmization = "optmization"
+outpu = "outpu"
+outpus = "outpus"
+overrided = "overrided"
+overwrited = "overwrited"
+palce = "palce"
+parammeters = "parammeters"
+poniter = "poniter"
+porcess = "porcess"
+processer = "processer"
+promot = "promot"
+propegation = "propegation"
+provicded = "provicded"
+recevied = "recevied"
+recomment = "recomment"
+registerd = "registerd"
+registring = "registring"
+reivew = "reivew"
+relase = "relase"
+requirments = "requirments"
+resut = "resut"
+resuts = "resuts"
+sacle = "sacle"
+samle = "samle"
+satifies = "satifies"
+schedual = "schedual"
+secenarios = "secenarios"
+sematic = "sematic"
+seperator = "seperator"
+setted = "setted"
+shoule = "shoule"
+similary = "similary"
+simplier = "simplier"
+skiped = "skiped"
+softwares = "softwares"
+sould = "sould"
+specail = "specail"
+sperated = "sperated"
+splited = "splited"
+splitted = "splitted"
+stirng = "stirng"
+stradegy = "stradegy"
+subract = "subract"
+sucess = "sucess"
+sucessor = "sucessor"
+sucessors = "sucessors"
+szie = "szie"
+tempory = "tempory"
+tenosr = "tenosr"
+thier = "thier"
+traget = "traget"
+traing = "traing"
+trainning = "trainning"
+traning = "traning"
+transfered = "transfered"
+trasformed = "trasformed"
+treshold = "treshold"
+trian = "trian"
+unqiue = "unqiue"
+unsupport = "unsupport"
+updte = "updte"
+utill = "utill"
+varialbes = "varialbes"
+varibale = "varibale"
+varibales = "varibales"
+varience = "varience"
+varient = "varient"
+visting = "visting"
+warpped = "warpped"
+wether = "wether"
+wiht = "wiht"
+wirte = "wirte"
+workign = "workign"
+wraper = "wraper"
+writter = "writter"

docs/api/gen_doc.py

@@ -696,23 +696,23 @@ def check_cn_en_match(path="./paddle", diff_file="en_cn_files_diff"):
     """
     osp_join = os.path.join
     osp_exists = os.path.exists
-    with open(diff_file, "w") as fo:
+    with open(diff_file, "w") as f:
         tmpl = "{}\t{}\n"
-        fo.write(tmpl.format("exist", "not_exits"))
+        f.write(tmpl.format("exist", "not_exits"))
         for root, dirs, files in os.walk(path):
             for file in files:
                 if file.endswith(en_suffix):
                     cf = file.replace(en_suffix, cn_suffix)
                     if not osp_exists(osp_join(root, cf)):
-                        fo.write(
+                        f.write(
                             tmpl.format(
                                 osp_join(root, file), osp_join(root, cf)
                             )
                         )
                 elif file.endswith(cn_suffix):
                     ef = file.replace(cn_suffix, en_suffix)
                     if not osp_exists(osp_join(root, ef)):
-                        fo.write(
+                        f.write(
                             tmpl.format(
                                 osp_join(root, file), osp_join(root, ef)
                             )

docs/api/paddle/DataParallel_cn.rst

@@ -14,7 +14,7 @@ DataParallel
 
 1. 使用 ``paddle.distributed.spawn`` 方法启动，例如：
 
- ``python demo.py`` (spawn need to be called in ``__main__`` method)
+``python demo.py`` (spawn need to be called in ``__main__`` method)
 
 2. 使用 ``paddle.distributed.launch`` 方法启动，例如：
 

docs/api/paddle/audio/features/LogMelSpectrogram_cn.rst

@@ -14,19 +14,19 @@ LogMelSpectrogram
     - **n_fft** (int，可选) - 离散傅里叶变换中频率窗大小，默认 512。
     - **hop_length**  (int，可选) - 帧移，默认 512。
     - **win_length**  (int，可选) - 短时 FFT 的窗长，默认为 None。
-    - **window**  (str，可选) - 窗函数名，支持的窗函数类型'hamming'，'hann'，'gaussian'，'general_gaussian'，'exponential'，'triang'，'bohman'，'blackman'，'cosine'，'tukey'，'taylor'，'bartlett'，'kaiser'，'nuttall'，默认``hann``。
+    - **window**  (str，可选) - 窗函数名，支持的窗函数类型'hamming'，'hann'，'gaussian'，'general_gaussian'，'exponential'，'triang'，'bohman'，'blackman'，'cosine'，'tukey'，'taylor'，'bartlett'，'kaiser'，'nuttall'，默认 ``hann`` 。
     - **power**  (float，可选) - 幅度谱的指数，默认是 2.0。
     - **center**  (bool，可选) - 对输入信号填充，如果 True，那么 t 以 t*hop_length 为中心，如果为 False，则 t 以 t*hop_length 开始，默认是 True。
     - **pad_mode**  (str，可选) - 如果 center 是 True，选择填充的方式，默认值是'reflect'。
     - **n_mels** (int，可选) - mel bins 的数目，默认是 64。
     - **f_min** (float，可选) - 最小频率(hz)，默认 50.0。
     - **f_max** (float，可选) - 最大频率(hz)，默认为 None。
     - **htk** (bool，可选) - 在计算 fbank 矩阵时是否用在 HTK 公式缩放，默认是 False。
-    - **norm** (Union[str，float]，可选) - 计算 fbank 矩阵时正则化的种类，默认是``slaney``，你也可以 norm=0.5，使用 p-norm 正则化。
+    - **norm** (Union[str，float]，可选) - 计算 fbank 矩阵时正则化的种类，默认是 ``slaney`` ，你也可以 norm=0.5，使用 p-norm 正则化。
     - **ref_value** (float，可选) - 参照值，如果小于 1.0，信号的 db 会被提升，相反 db 会下降，默认值为 1.0。
     - **amin** (float，可选) - 输入的幅值的最小值，默认是 1e-10。
     - **top_db** (float，可选) - log-mel 谱的最大值(db)，默认是 None。
-    - **dtype** (str|paddle.dtype|np.dtype，可选) - 输入和窗的数据类型，默认是``float32``。
+    - **dtype** (str|paddle.dtype|np.dtype，可选) - 输入和窗的数据类型，默认是 ``float32`` 。
 
 
 返回

docs/api/paddle/audio/functional/compute_fbank_matrix_cn.rst

@@ -16,13 +16,13 @@ compute_fbank_matrix
     - **f_min** (float，可选) - 最小频率(hz)，默认是 0.0。
     - **f_max** (Optional[float]，可选) - 最大频率(hz)，默认是 None。
     - **htk** (bool，可选) - 是否使用 htk 缩放，默认是 False。
-    - **norm** (Union[str, float]，可选) - norm 的类型，默认是``slaney``。
-    - **dtype** (str|paddle.dtype|np.dtype，可选) - 返回矩阵的数据类型，默认``float32``。
+    - **norm** (Union[str, float]，可选) - norm 的类型，默认是 ``slaney``。
+    - **dtype** (str|paddle.dtype|np.dtype，可选) - 返回矩阵的数据类型，默认 ``float32`` 。
 
 返回
 :::::::::
 
-``paddle.Tensor``，Tensor shape (n_mels, n_fft//2 + 1)。
+ ``paddle.Tensor`` ，Tensor shape (n_mels, n_fft//2 + 1)。
 
 代码示例
 :::::::::

docs/api/paddle/bucketize_cn.rst

@@ -11,7 +11,7 @@ bucketize
     - **x** (Tensor) - 输入的 N 维 Tensor，支持的数据类型：int32、int64、float32、float64。
     - **sorted_sequence** (Tensor) - 输入的一维 Tensor，支持的数据类型：int32、int64、float32、float64。该 Tensor 的数值在其最后一个维度递增。
     - **out_int32** (bool，可选) - 输出的数据类型支持 int32、int64。默认值为 False，表示默认的输出数据类型为 int64。
-    - **right** (bool，可选) - 根据给定 ``x`` 在 ``sorted_sequence`` 查找对应的上边界或下边界。如果 ``sorted_sequence``的值为 nan 或 inf，则返回最内层维度的大小。默认值为 False，表示在 ``sorted_sequence`` 的查找给定 ``x`` 的下边界。
+    - **right** (bool，可选) - 根据给定 ``x`` 在 ``sorted_sequence`` 查找对应的上边界或下边界。如果 ``sorted_sequence`` 的值为 nan 或 inf，则返回最内层维度的大小。默认值为 False，表示在 ``sorted_sequence`` 的查找给定 ``x`` 的下边界。
     - **name** (str，可选) - 具体用法请参见 :ref:`api_guide_Name`，一般无需设置，默认值为 None。
 
 返回

docs/api/paddle/gather_cn.rst

@@ -42,7 +42,7 @@ gather
 ::::::::::::
         - **x** (Tensor) - 输入 Tensor，秩 ``rank >= 1``，支持的数据类型包括 int32、int64、float32、float64、complex64、complex128 和 uint8 (CPU)、float16（GPU） 。
         - **index** (Tensor) - 索引 Tensor，秩 ``rank = 0`` 或者 ``rank = 1``，数据类型为 int32 或 int64。
-        - **axis** (Tensor) - 指定 index 获取输入的维度，``axis`` 的类型可以是 int 或者 Tensor，当 ``axis`` 为 Tensor 的时候其数据类型为 int32 或者 int64。默认值为 None，当``axis``为 None 的时候其值为 0。
+        - **axis** (Tensor) - 指定 index 获取输入的维度，``axis`` 的类型可以是 int 或者 Tensor，当 ``axis`` 为 Tensor 的时候其数据类型为 int32 或者 int64。默认值为 None，当 ``axis`` 为 None 的时候其值为 0。
         - **name** (str，可选) - 具体用法请参见 :ref:`api_guide_Name`，一般无需设置，默认值为 None。
 
 返回