[po] auto sync

github-actions[bot] · github-actions[bot] · commit c1dfbb665eaa · 2022-03-21T13:55:45.000Z
diff --git a/howto/clinic.po b/howto/clinic.po
@@ -283,12 +283,14 @@ msgid ""
 "with Argument Clinic yet. For my example I'm using "
 "``_pickle.Pickler.dump()``."
 msgstr ""
+"找到一个调用 :c:func:`PyArg_ParseTuple` 或 :c:func:`PyArg_ParseTupleAndKeywords` "
+"，且未被转换为采用 Argument Clinic 的 Python 内置程序。这里用了 ``_pickle.Pickler.dump()``。"
 
 #: ../../howto/clinic.rst:164
 msgid ""
 "If the call to the ``PyArg_Parse`` function uses any of the following format"
 " units:"
-msgstr ""
+msgstr "如果对 ``PyArg_Parse`` 函数的调用采用了以下格式："
 
 #: ../../howto/clinic.rst:176
 msgid ""
@@ -297,6 +299,8 @@ msgid ""
 "scenarios.  But these are advanced topics—let's do something simpler for "
 "your first function."
 msgstr ""
+"或者多次调用 :c:func:`PyArg_ParseTuple`，则应再选一个函数。Argument Clinic *确实* 支持上述这些状况。 "
+"但这些都是高阶内容——第一次使用就简单一些吧。"
 
 #: ../../howto/clinic.rst:181
 msgid ""
@@ -307,10 +311,13 @@ msgid ""
 "to Argument Clinic.  Argument Clinic doesn't support generic functions or "
 "polymorphic parameters."
 msgstr ""
+"此外，如果多次调用 :c:func:`PyArg_ParseTuple` 或 :c:func:`PyArg_ParseTupleAndKeywords`"
+" 且同一参数需支持不同的类型，或者用到 PyArg_Parse 以外的函数来解析参数，则可能不适合转换为 Argument Clinic。 "
+"Argument Clinic 不支持通用函数或多态参数。"
 
 #: ../../howto/clinic.rst:188
 msgid "Add the following boilerplate above the function, creating our block::"
-msgstr ""
+msgstr "在函数上方添加以下模板，创建块："
 
 #: ../../howto/clinic.rst:193
 msgid ""
@@ -320,6 +327,8 @@ msgid ""
 " 80 characters. (Argument Clinic will preserve indents inside the "
 "docstring.)"
 msgstr ""
+"剪下文档字符串并粘贴到 ``[clinic]`` 行之间，去除所有的无用字符，使其成为一个正确引用的 C "
+"字符串。最有应该只留下带有左侧缩进的文本，且行宽不大于 80 个字符。（参数 Clinic 将保留文档字符串中的缩进。）"
 
 #: ../../howto/clinic.rst:199
 msgid ""
@@ -328,13 +337,15 @@ msgid ""
 "``help()`` on your builtin in the future, the first line will be built "
 "automatically based on the function's signature.)"
 msgstr ""
+"如果文档字符串的第一行看起来像是函数的签名，就把这一行去掉吧。（(文档串不再需要用到它——将来对内置函数调用 ``help()`` "
+"时，第一行将根据函数的签名自动建立。）"
 
 #: ../../howto/clinic.rst:205 ../../howto/clinic.rst:226
 #: ../../howto/clinic.rst:250 ../../howto/clinic.rst:308
 #: ../../howto/clinic.rst:348 ../../howto/clinic.rst:375
 #: ../../howto/clinic.rst:481 ../../howto/clinic.rst:533
 msgid "Sample::"
-msgstr ""
+msgstr "示例："
 
 #: ../../howto/clinic.rst:211
 msgid ""
@@ -343,12 +354,14 @@ msgid ""
 "paragraph consisting of a single 80-column line at the beginning of the "
 "docstring."
 msgstr ""
+"如果文档字符串中没有“摘要”行，Argument Clinic 会报错。所以应确保带有摘要行。 "
+"“摘要”行应为在文档字符串开头的一个段落，由一个80列的单行构成。"
 
 #: ../../howto/clinic.rst:216
 msgid ""
 "(Our example docstring consists solely of a summary line, so the sample code"
 " doesn't have to change for this step.)"
-msgstr ""
+msgstr "（示例的文档字符串只包括一个摘要行，所以示例代码这一步不需改动）。"
 
 #: ../../howto/clinic.rst:219
 msgid ""
@@ -358,6 +371,8 @@ msgid ""
 "module, include any sub-modules, and if the function is a method on a class "
 "it should include the class name too."
 msgstr ""
+"在文档字符串上方，输入函数的名称，后面是空行。这应是函数的 Python "
+"名称，而且应是句点分隔的完整路径——以模块的名称开始，包含所有子模块名，若函数为类方法则还应包含类名。"
 
 #: ../../howto/clinic.rst:234
 msgid ""
