sync with cpython 56e9fb3e

c-api/arg.po

@@ -7,7 +7,7 @@ msgid ""
 msgstr ""
 "Project-Id-Version: Python 3.10\n"
 "Report-Msgid-Bugs-To: \n"
-"POT-Creation-Date: 2021-10-26 16:47+0000\n"
+"POT-Creation-Date: 2022-05-14 00:18+0000\n"
 "PO-Revision-Date: 2021-11-22 16:44+0800\n"
 "Last-Translator: Adrian Liaw <adrianliaw2000@gmail.com>\n"
 "Language-Team: Chinese - TAIWAN (https://github.com/python/python-docs-zh-"
@@ -540,7 +540,8 @@ msgid ""
 msgstr ""
 
 #: ../../c-api/arg.rst:290 ../../c-api/arg.rst:617
-msgid "``n`` (:class:`int`) [Py_ssize_t]"
+#, fuzzy
+msgid "``n`` (:class:`int`) [:c:type:`Py_ssize_t`]"
 msgstr "``n`` (:class:`int`) [Py_ssize_t]"
 
 #: ../../c-api/arg.rst:290

c-api/bytes.po

@@ -7,7 +7,7 @@ msgid ""
 msgstr ""
 "Project-Id-Version: Python 3.10\n"
 "Report-Msgid-Bugs-To: \n"
-"POT-Creation-Date: 2022-04-03 00:14+0000\n"
+"POT-Creation-Date: 2022-05-14 00:18+0000\n"
 "PO-Revision-Date: 2018-05-23 14:04+0000\n"
 "Last-Translator: Adrian Liaw <adrianliaw2000@gmail.com>\n"
 "Language-Team: Chinese - TAIWAN (https://github.com/python/python-docs-zh-"
@@ -160,7 +160,8 @@ msgid ":attr:`%zd`"
 msgstr ":attr:`%zd`"
 
 #: ../../c-api/bytes.rst:87
-msgid "Py_ssize_t"
+#, fuzzy
+msgid ":c:type:`\\ Py_ssize_t`"
 msgstr "Py_ssize_t"
 
 #: ../../c-api/bytes.rst:87

c-api/intro.po

@@ -7,7 +7,7 @@ msgid ""
 msgstr ""
 "Project-Id-Version: Python 3.10\n"
 "Report-Msgid-Bugs-To: \n"
-"POT-Creation-Date: 2021-10-26 16:47+0000\n"
+"POT-Creation-Date: 2022-05-14 00:18+0000\n"
 "PO-Revision-Date: 2018-05-23 14:06+0000\n"
 "Last-Translator: Adrian Liaw <adrianliaw2000@gmail.com>\n"
 "Language-Team: Chinese - TAIWAN (https://github.com/python/python-docs-zh-"
@@ -499,11 +499,19 @@ msgid ""
 "that use them."
 msgstr ""
 
-#: ../../c-api/intro.rst:509
+#: ../../c-api/intro.rst:507
+msgid ""
+"A signed integral type such that ``sizeof(Py_ssize_t) == sizeof(size_t)``. "
+"C99 doesn't define such a thing directly (size_t is an unsigned integral "
+"type). See :pep:`353` for details. ``PY_SSIZE_T_MAX`` is the largest "
+"positive value of type :c:type:`Py_ssize_t`."
+msgstr ""
+
+#: ../../c-api/intro.rst:516
 msgid "Exceptions"
 msgstr "例外"
 
-#: ../../c-api/intro.rst:511
+#: ../../c-api/intro.rst:518
 msgid ""
 "The Python programmer only needs to deal with exceptions if specific error "
 "handling is required; unhandled exceptions are automatically propagated to "
@@ -512,7 +520,7 @@ msgid ""
 "stack traceback."
 msgstr ""
 
-#: ../../c-api/intro.rst:519
+#: ../../c-api/intro.rst:526
 msgid ""
 "For C programmers, however, error checking always has to be explicit. All "
 "functions in the Python/C API can raise exceptions, unless an explicit claim "
@@ -527,7 +535,7 @@ msgid ""
 "explicitly documented."
 msgstr ""
 
-#: ../../c-api/intro.rst:534
+#: ../../c-api/intro.rst:541
 msgid ""
 "Exception state is maintained in per-thread storage (this is equivalent to "
 "using global storage in an unthreaded application). A thread can be in one "
@@ -540,7 +548,7 @@ msgid ""
 "clears the exception state."
 msgstr ""
 
-#: ../../c-api/intro.rst:544
+#: ../../c-api/intro.rst:551
 msgid ""
 "The full exception state consists of three objects (all of which can be "
 "``NULL``): the exception type, the corresponding exception value, and the "
@@ -553,7 +561,7 @@ msgid ""
 "``sys.exc_info()`` and friends."
 msgstr ""
 
-#: ../../c-api/intro.rst:556
+#: ../../c-api/intro.rst:563
 msgid ""
 "Note that starting with Python 1.5, the preferred, thread-safe way to access "
 "the exception state from Python code is to call the function :func:`sys."
@@ -567,7 +575,7 @@ msgid ""
 "referenced by the stack frames in the traceback."
 msgstr ""
 
-#: ../../c-api/intro.rst:567
+#: ../../c-api/intro.rst:574
 msgid ""
 "As a general principle, a function that calls another function to perform "
 "some task should check whether the called function raised an exception, and "
@@ -578,7 +586,7 @@ msgid ""
 "of the error."
 msgstr ""
 
-#: ../../c-api/intro.rst:576
+#: ../../c-api/intro.rst:583
 msgid ""
 "A simple example of detecting exceptions and passing them on is shown in "
 "the :c:func:`sum_sequence` example above. It so happens that this example "
@@ -587,11 +595,11 @@ msgid ""
 "why you like Python, we show the equivalent Python code::"
 msgstr ""
 
-#: ../../c-api/intro.rst:591
+#: ../../c-api/intro.rst:598
 msgid "Here is the corresponding C code, in all its glory::"
 msgstr ""
 
-#: ../../c-api/intro.rst:643
+#: ../../c-api/intro.rst:650
 msgid ""
 "This example represents an endorsed use of the ``goto`` statement in C! It "
 "illustrates the use of :c:func:`PyErr_ExceptionMatches` and :c:func:"
@@ -604,35 +612,35 @@ msgid ""
 "success after the final call made is successful."
 msgstr ""
 
-#: ../../c-api/intro.rst:657
+#: ../../c-api/intro.rst:664
 msgid "Embedding Python"
 msgstr "嵌入式Python"
 
-#: ../../c-api/intro.rst:659
+#: ../../c-api/intro.rst:666
 msgid ""
 "The one important task that only embedders (as opposed to extension writers) "
 "of the Python interpreter have to worry about is the initialization, and "
 "possibly the finalization, of the Python interpreter. Most functionality of "
 "the interpreter can only be used after the interpreter has been initialized."
 msgstr ""
 
-#: ../../c-api/intro.rst:672
+#: ../../c-api/intro.rst:679
 msgid ""
 "The basic initialization function is :c:func:`Py_Initialize`. This "
 "initializes the table of loaded modules, and creates the fundamental "
 "modules :mod:`builtins`, :mod:`__main__`, and :mod:`sys`. It also "
 "initializes the module search path (``sys.path``)."
 msgstr ""
 
-#: ../../c-api/intro.rst:679
+#: ../../c-api/intro.rst:686
 msgid ""
 ":c:func:`Py_Initialize` does not set the \"script argument list\" (``sys."
 "argv``). If this variable is needed by Python code that will be executed "
 "later, it must be set explicitly with a call to ``PySys_SetArgvEx(argc, "
 "argv, updatepath)`` after the call to :c:func:`Py_Initialize`."
 msgstr ""
 
-#: ../../c-api/intro.rst:684
+#: ../../c-api/intro.rst:691
 msgid ""
 "On most systems (in particular, on Unix and Windows, although the details "
 "are slightly different), :c:func:`Py_Initialize` calculates the module "
@@ -644,7 +652,7 @@ msgid ""
 "on the shell command search path (the environment variable :envvar:`PATH`)."
 msgstr ""
 
-#: ../../c-api/intro.rst:693
+#: ../../c-api/intro.rst:700
 msgid ""
 "For instance, if the Python executable is found in :file:`/usr/local/bin/"
 "python`, it will assume that the libraries are in :file:`/usr/local/lib/"
@@ -655,7 +663,7 @@ msgid ""
 "in front of the standard path by setting :envvar:`PYTHONPATH`."
 msgstr ""
 
-#: ../../c-api/intro.rst:708
+#: ../../c-api/intro.rst:715
 msgid ""
 "The embedding application can steer the search by calling "
 "``Py_SetProgramName(file)`` *before* calling :c:func:`Py_Initialize`. Note "
@@ -666,7 +674,7 @@ msgid ""
 "func:`Py_GetProgramFullPath` (all defined in :file:`Modules/getpath.c`)."
 msgstr ""
 
-#: ../../c-api/intro.rst:718
+#: ../../c-api/intro.rst:725
 msgid ""
 "Sometimes, it is desirable to \"uninitialize\" Python. For instance, the "
 "application may want to start over (make another call to :c:func:"
@@ -680,18 +688,18 @@ msgid ""
 "released."
 msgstr ""
 
-#: ../../c-api/intro.rst:732
+#: ../../c-api/intro.rst:739
 msgid "Debugging Builds"
 msgstr ""
 
-#: ../../c-api/intro.rst:734
+#: ../../c-api/intro.rst:741
 msgid ""
 "Python can be built with several macros to enable extra checks of the "
 "interpreter and extension modules. These checks tend to add a large amount "
 "of overhead to the runtime so they are not enabled by default."
 msgstr ""
 
-#: ../../c-api/intro.rst:738
+#: ../../c-api/intro.rst:745
 msgid ""
 "A full list of the various types of debugging builds is in the file :file:"
 "`Misc/SpecialBuilds.txt` in the Python source distribution. Builds are "
@@ -701,7 +709,7 @@ msgid ""
 "section."
 msgstr ""
 
-#: ../../c-api/intro.rst:744
+#: ../../c-api/intro.rst:751
 msgid ""
 "Compiling the interpreter with the :c:macro:`Py_DEBUG` macro defined "
 "produces what is generally meant by :ref:`a debug build of Python <debug-"
@@ -712,13 +720,13 @@ msgid ""
 "disabled."
 msgstr ""
 
-#: ../../c-api/intro.rst:752
+#: ../../c-api/intro.rst:759
 msgid ""
 "In addition to the reference count debugging described below, extra checks "
 "are performed, see :ref:`Python Debug Build <debug-build>`."
 msgstr ""
 
-#: ../../c-api/intro.rst:755
+#: ../../c-api/intro.rst:762
 msgid ""
 "Defining :c:macro:`Py_TRACE_REFS` enables reference tracing (see the :option:"
 "`configure --with-trace-refs option <--with-trace-refs>`). When defined, a "
@@ -728,7 +736,7 @@ msgid ""
 "this happens after every statement run by the interpreter.)"
 msgstr ""
 
-#: ../../c-api/intro.rst:762
+#: ../../c-api/intro.rst:769
 msgid ""
 "Please refer to :file:`Misc/SpecialBuilds.txt` in the Python source "
 "distribution for more detailed information."

c-api/number.po

@@ -7,7 +7,7 @@ msgid ""
 msgstr ""
 "Project-Id-Version: Python 3.10\n"
 "Report-Msgid-Bugs-To: \n"
-"POT-Creation-Date: 2022-04-03 00:14+0000\n"
+"POT-Creation-Date: 2022-05-14 00:18+0000\n"
 "PO-Revision-Date: 2018-05-23 14:07+0000\n"
 "Last-Translator: Adrian Liaw <adrianliaw2000@gmail.com>\n"
 "Language-Team: Chinese - TAIWAN (https://github.com/python/python-docs-zh-"
@@ -279,14 +279,15 @@ msgstr ""
 
 #: ../../c-api/number.rst:276
 msgid ""
-"Returns *o* converted to a Py_ssize_t value if *o* can be interpreted as an "
-"integer. If the call fails, an exception is raised and ``-1`` is returned."
+"Returns *o* converted to a :c:type:`Py_ssize_t` value if *o* can be "
+"interpreted as an integer. If the call fails, an exception is raised and "
+"``-1`` is returned."
 msgstr ""
 
 #: ../../c-api/number.rst:279
 msgid ""
-"If *o* can be converted to a Python int but the attempt to convert to a "
-"Py_ssize_t value would raise an :exc:`OverflowError`, then the *exc* "
+"If *o* can be converted to a Python int but the attempt to convert to a :c:"
+"type:`Py_ssize_t` value would raise an :exc:`OverflowError`, then the *exc* "
 "argument is the type of exception that will be raised (usually :exc:"
 "`IndexError` or :exc:`OverflowError`). If *exc* is ``NULL``, then the "
 "exception is cleared and the value is clipped to ``PY_SSIZE_T_MIN`` for a "

c-api/object.po

@@ -7,7 +7,7 @@ msgid ""
 msgstr ""
 "Project-Id-Version: Python 3.10\n"
 "Report-Msgid-Bugs-To: \n"
-"POT-Creation-Date: 2022-04-03 00:14+0000\n"
+"POT-Creation-Date: 2022-05-14 00:18+0000\n"
 "PO-Revision-Date: 2018-05-23 14:32+0000\n"
 "Last-Translator: Adrian Liaw <adrianliaw2000@gmail.com>\n"
 "Language-Team: Chinese - TAIWAN (https://github.com/python/python-docs-zh-"
@@ -269,8 +269,8 @@ msgstr ""
 
 #: ../../c-api/object.rst:259
 msgid ""
-"The return type is now Py_hash_t. This is a signed integer the same size as "
-"Py_ssize_t."
+"The return type is now Py_hash_t. This is a signed integer the same size "
+"as :c:type:`Py_ssize_t`."
 msgstr ""
 
 #: ../../c-api/object.rst:266

c-api/sys.po

@@ -10,7 +10,7 @@ msgid ""
 msgstr ""
 "Project-Id-Version: Python 3.10\n"
 "Report-Msgid-Bugs-To: \n"
-"POT-Creation-Date: 2022-04-03 00:14+0000\n"
+"POT-Creation-Date: 2022-05-14 00:18+0000\n"
 "PO-Revision-Date: 2018-05-23 14:07+0000\n"
 "Last-Translator: Adrian Liaw <adrianliaw2000@gmail.com>\n"
 "Language-Team: Chinese - TAIWAN (https://github.com/python/python-docs-zh-"
@@ -380,8 +380,8 @@ msgstr ""
 
 #: ../../c-api/sys.rst:325
 msgid ""
-"Note that ``#`` format characters should always be treated as "
-"``Py_ssize_t``, regardless of whether ``PY_SSIZE_T_CLEAN`` was defined."
+"Note that ``#`` format characters should always be treated as :c:type:"
+"`Py_ssize_t`, regardless of whether ``PY_SSIZE_T_CLEAN`` was defined."
 msgstr ""
 
 #: ../../c-api/sys.rst:328
@@ -390,7 +390,7 @@ msgstr ""
 
 #: ../../c-api/sys.rst:334
 msgid ""
-"Require ``Py_ssize_t`` for ``#`` format characters. Previously, an "
+"Require :c:type:`Py_ssize_t` for ``#`` format characters. Previously, an "
 "unavoidable deprecation warning was raised."
 msgstr ""
 

c-api/typeobj.po

@@ -7,7 +7,7 @@ msgid ""
 msgstr ""
 "Project-Id-Version: Python 3.10\n"
 "Report-Msgid-Bugs-To: \n"
-"POT-Creation-Date: 2022-03-02 00:17+0000\n"
+"POT-Creation-Date: 2022-05-14 00:18+0000\n"
 "PO-Revision-Date: 2018-05-23 14:33+0000\n"
 "Last-Translator: Adrian Liaw <adrianliaw2000@gmail.com>\n"
 "Language-Team: Chinese - TAIWAN (https://github.com/python/python-docs-zh-"
@@ -130,8 +130,9 @@ msgstr ":c:member:`~PyTypeObject.tp_basicsize`"
 #: ../../c-api/typeobj.rst:52 ../../c-api/typeobj.rst:99
 #: ../../c-api/typeobj.rst:120 ../../c-api/typeobj.rst:0
 #: ../../c-api/typeobj.rst:408
-msgid "Py_ssize_t"
-msgstr "Py_ssize_t"
+#, fuzzy
+msgid ":c:type:`Py_ssize_t`"
+msgstr ":c:type:`ssizeargfunc`"
 
 #: ../../c-api/typeobj.rst:48
 msgid ":c:member:`~PyTypeObject.tp_itemsize`"
@@ -3428,3 +3429,6 @@ msgid ""
 "The simplest :ref:`static type <static-types>` with variable-length "
 "instances::"
 msgstr ""
+
+#~ msgid "Py_ssize_t"
+#~ msgstr "Py_ssize_t"

c-api/unicode.po

@@ -9,7 +9,7 @@ msgid ""
 msgstr ""
 "Project-Id-Version: Python 3.10\n"
 "Report-Msgid-Bugs-To: \n"
-"POT-Creation-Date: 2022-05-07 00:14+0000\n"
+"POT-Creation-Date: 2022-05-14 00:18+0000\n"
 "PO-Revision-Date: 2018-05-23 14:08+0000\n"
 "Last-Translator: Adrian Liaw <adrianliaw2000@gmail.com>\n"
 "Language-Team: Chinese - TAIWAN (https://github.com/python/python-docs-zh-"
@@ -591,7 +591,8 @@ msgid ":attr:`%zd`"
 msgstr ":attr:`%zd`"
 
 #: ../../c-api/unicode.rst:493 ../../c-api/unicode.rst:496
-msgid "Py_ssize_t"
+#, fuzzy
+msgid ":c:type:`\\ Py_ssize_t`"
 msgstr "Py_ssize_t"
 
 #: ../../c-api/unicode.rst:493