[po] auto sync

github-actions[bot] · github-actions[bot] · commit a7a146c39e98 · 2022-05-02T07:49:47.000Z
diff --git a/howto/clinic.po b/howto/clinic.po
@@ -1733,17 +1733,23 @@ msgid ""
 "value), then the generated code will propagate the error.  Otherwise it will"
 " encode the value you return like normal."
 msgstr ""
+"返回值转换器还存在一个复杂的问题：出错信息如何表示？通常函数在执行成功时会返回一个有效（非 ``NULL``）指针，失败则返回 "
+"``NULL``。但如果使用了整数的返回值转换器，所有整数都是有效值。Argument Clinic "
+"怎么检测错误呢？解决方案是：返回值转换器会隐含寻找一个代表错误的特殊值。如果返回该特殊值，且设置了出错标记（ ``PyErr_Occurred()`` "
+"返回 True），那么生成的代码会传递该错误。否则，会对返回值进行正常编码。"
 
 #: ../../howto/clinic.rst:1057
 msgid "Currently Argument Clinic supports only a few return converters:"
-msgstr ""
+msgstr "目前 Argument Clinic 只支持少数几种返回值转换器。"
 
 #: ../../howto/clinic.rst:1072
 msgid ""
 "None of these take parameters.  For the first three, return -1 to indicate "
 "error.  For ``DecodeFSDefault``, the return type is ``const char *``; return"
 " a ``NULL`` pointer to indicate an error."
 msgstr ""
+"这些转换器都不需要参数。前3个转换器如果返回 -1 则表示出错。``DecodeFSDefault`` 的返回值类型是 ``const char "
+"*``；若返回 ``NULL`` 指针则表示出错。"
 
 #: ../../howto/clinic.rst:1076
 msgid ""
@@ -1752,53 +1758,57 @@ msgid ""
 "the reference count on ``Py_None``.  I'm not sure it adds enough clarity to "
 "be worth using.)"
 msgstr ""
+"（还有一个 ``NoneType`` 转换器是实验性质的，成功时返回 ``Py_None`` ，失败则返回 ``NULL``，且不会增加 "
+"``Py_None`` 的引用计数。此转换器是否值得适用，尚不明确）。"
 
 #: ../../howto/clinic.rst:1081
 msgid ""
 "To see all the return converters Argument Clinic supports, along with their "
 "parameters (if any), just run ``Tools/clinic/clinic.py --converters`` for "
 "the full list."
 msgstr ""
+"只要运行 ``Tools/clinic/clinic.py --converters`` ，即可查看 Argument Clinic "
+"支持的所有返回值转换器，包括其参数。"
 
 #: ../../howto/clinic.rst:1087
 msgid "Cloning existing functions"
-msgstr ""
+msgstr "复制已有的函数"
 
 #: ../../howto/clinic.rst:1089
 msgid ""
 "If you have a number of functions that look similar, you may be able to use "
 "Clinic's \"clone\" feature.  When you clone an existing function, you reuse:"
-msgstr ""
+msgstr "如果已有一些函数比较相似，或许可以采用 Clinic 的“克隆”功能。 克隆之后能够复用以下内容："
 
 #: ../../howto/clinic.rst:1093
 msgid "its parameters, including"
-msgstr ""
+msgstr "参数，包括："
 
 #: ../../howto/clinic.rst:1095
 msgid "their names,"
-msgstr ""
+msgstr "名称"
 
 #: ../../howto/clinic.rst:1097
 msgid "their converters, with all parameters,"
-msgstr ""
+msgstr "转换器（带有全部参数）"
 
 #: ../../howto/clinic.rst:1099
 msgid "their default values,"
-msgstr ""
+msgstr "默认值"
 
 #: ../../howto/clinic.rst:1101
 msgid "their per-parameter docstrings,"
-msgstr ""
+msgstr "参数前的文档字符串"
 
 #: ../../howto/clinic.rst:1103
 msgid ""
 "their *kind* (whether they're positional only, positional or keyword, or "
 "keyword only), and"
-msgstr ""
+msgstr "*类别* （只认位置、位置或关键字、只认关键字）"
 
 #: ../../howto/clinic.rst:1106
 msgid "its return converter."
-msgstr ""
+msgstr "返回值转换器"
 
 #: ../../howto/clinic.rst:1108
 msgid ""
