Translate new/fuzzy entries from upstream sync (cpython 6e6984a)

Rebased onto upstream/cron/sync/3.14 (5 new sync commits) and translated
the resulting new-or-fuzzy backlog: 70 entries across 27 files (9 new, 61
fuzzy resolved). Nearly all fuzzy entries stem from upstream introducing
a new :deco: reST role for decorator references, replacing prior
:func:/:class:/:meth: roles -- updated the corresponding role in each
existing Chinese translation to match, verifying prose accuracy rather
than blind-replacing.

Files touched: c-api/frame.po, deprecations/index.po,
deprecations/pending-removal-in-3.15.po, faq/programming.po,
glossary.po, howto/{annotations,descriptor,sorting}.po, library/{abc,
asyncio-stream,bisect,collections,contextlib,csv,enum,functions,
functools,platform,tarfile}.po, reference/simple_stmts.po, sphinx.po,
whatsnew/{3.3,3.10,3.11,3.12,3.13,3.14}.po.

Also fixed along the way:
- whatsnew/3.11.po: wrong contributor name on the :deco:`typing.final`
  entry (was "Serhiy Storchaka", msgid credits "Jelle Zijlstra").
- whatsnew/3.3.po: typo "請改" -> "請改用" (missing 用) on the
  abc.abstractproperty deprecation entry.
- Several instances of the known RST-escaping bug (role/literal closing
  backtick directly touching full-width punctuation with no \ separator)
  in entries touched by this sync, across abc.po, functools.po,
  descriptor.po, and whatsnew/3.12.po.

Excludes the large pre-existing untranslated backlog unrelated to this
sync (e.g. whatsnew/2.4-2.7.po, os.po, ctypes.po, typing.po, and other
files where "new" msgids were just role-syntax churn on long-untranslated
entries, not genuinely new content).

Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01DSmHq7nqqTrRwTigk6kNeh

Author: claude

c-api/frame.po

@@ -309,7 +309,7 @@ msgstr "此 frame 對應到一個類別實例上的方法。"
 msgid ""
 "Note that reading the executable kind from a frame is currently only "
 "possible with undocumented internal APIs."
-msgstr ""
+msgstr "請注意，目前只能透過未寫入文件的內部 API 從 frame 中讀取可執行種類。"
 
 #: ../../c-api/frame.rst:280
 msgid "The number of entries in :c:data:`PyUnstable_ExecutableKinds`."

deprecations/index.po

@@ -193,13 +193,12 @@ msgstr ""
 "pass`` 或 ``TD = TypedDict(\"TD\", {})`` 來建立具有零個欄位的 TypedDict。"
 
 #: ../../deprecations/pending-removal-in-3.15.rst:85
-#, fuzzy
 msgid ""
 "The :deco:`typing.no_type_check_decorator` decorator function has been "
 "deprecated since Python 3.13. After eight years in the :mod:`typing` module, "
 "it has yet to be supported by any major type checker."
 msgstr ""
-"自 Python 3.13 起，:func:`typing.no_type_check_decorator` 裝飾器函式已被棄"
+"自 Python 3.13 起，:deco:`typing.no_type_check_decorator` 裝飾器函式已被棄"
 "用。在 :mod:`typing` 模組中使用了八年之後，它尚未得到任何主要型別檢查器的支"
 "援。"
 

deprecations/pending-removal-in-3.15.po

@@ -183,13 +183,12 @@ msgstr ""
 "pass`` 或 ``TD = TypedDict(\"TD\", {})`` 來建立具有零個欄位的 TypedDict。"
 
 #: ../../deprecations/pending-removal-in-3.15.rst:85
-#, fuzzy
 msgid ""
 "The :deco:`typing.no_type_check_decorator` decorator function has been "
 "deprecated since Python 3.13. After eight years in the :mod:`typing` module, "
 "it has yet to be supported by any major type checker."
 msgstr ""
-"自 Python 3.13 起，:func:`typing.no_type_check_decorator` 裝飾器函式已被棄"
+"自 Python 3.13 起，:deco:`typing.no_type_check_decorator` 裝飾器函式已被棄"
 "用。在 :mod:`typing` 模組中使用了八年之後，它尚未得到任何主要型別檢查器的支"
 "援。"
 

faq/programming.po

@@ -3866,14 +3866,13 @@ msgid "How do I cache method calls?"
 msgstr "如何快取方法呼叫？"
 
 #: ../../faq/programming.rst:2005
-#, fuzzy
 msgid ""
 "The two principal tools for caching methods are :deco:`functools."
 "cached_property` and :deco:`functools.lru_cache`.  The former stores results "
 "at the instance level and the latter at the class level."
 msgstr ""
-"快取方法的兩個主要工具是 :func:`functools.cached_property` 和 :func:"
-"`functools.lru_cache`。前者在實例層級儲存結果，後者在類別層級儲存結果。"
+"快取方法的兩個主要工具是 :deco:`functools.cached_property` 和 :deco:"
+"`functools.lru_cache`\\ 。前者在實例層級儲存結果，後者在類別層級儲存結果。"
 
 #: ../../faq/programming.rst:2010
 msgid ""

glossary.po

@@ -903,15 +903,14 @@ msgid "decorator"
 msgstr "decorator（裝飾器）"
 
 #: ../../glossary.rst:417
-#, fuzzy
 msgid ""
 "A function returning another function, usually applied as a function "
 "transformation using the ``@wrapper`` syntax.  Common examples for "
 "decorators are :deco:`classmethod` and :deco:`staticmethod`."
 msgstr ""
 "一個函式，它會回傳另一個函式，通常它會使用 ``@wrapper`` 語法，被應用為一種函"
-"式的變換 (function transformation)。裝飾器的常見範例是 :func:`classmethod` "
-"和 :func:`staticmethod`。"
+"式的變換 (function transformation)。裝飾器的常見範例是 :deco:`classmethod` "
+"和 :deco:`staticmethod`\\ 。"
 
 #: ../../glossary.rst:421
 msgid ""
@@ -1534,13 +1533,12 @@ msgstr ""
 "用哪種實作，是由調度演算法 (dispatch algorithm) 來決定。"
 
 #: ../../glossary.rst:691
-#, fuzzy
 msgid ""
 "See also the :term:`single dispatch` glossary entry, the :deco:`functools."
 "singledispatch` decorator, and :pep:`443`."
 msgstr ""
-"另請參閱 :term:`single dispatch`\\ （單一調度）術語表條目、:func:`functools."
-"singledispatch` 裝飾器和 :pep:`443`。"
+"另請參閱 :term:`single dispatch`\\ （單一調度）術語表條目、:deco:`functools."
+"singledispatch` 裝飾器和 :pep:`443`\\ 。"
 
 #: ../../glossary.rst:693
 msgid "generic type"

howto/annotations.po

@@ -299,16 +299,15 @@ msgstr ""
 "區域變數``。"
 
 #: ../../howto/annotations.rst:156
-#, fuzzy
 msgid ""
 "If ``o`` is a wrapped callable using :func:`functools.update_wrapper`, :deco:"
 "`functools.wraps`, or :func:`functools.partial`, iteratively unwrap it by "
 "accessing either ``o.__wrapped__`` or ``o.func`` as appropriate, until you "
 "have found the root unwrapped function."
 msgstr ""
-"如果 ``o`` 是使用 :func:`functools.update_wrapper`、:func:`functools.wraps` "
-"或 :func:`functools.partial` 包裝的 callable ，請依據需求，透過存取 ``o."
-"__wrapped__`` 或 ``o.func`` 來疊代解開它，直到找到根解包函式。"
+"如果 ``o`` 是使用 :func:`functools.update_wrapper`\\ 、:deco:`functools."
+"wraps` 或 :func:`functools.partial` 包裝的 callable ，請依據需求，透過存取 "
+"``o.__wrapped__`` 或 ``o.func`` 來疊代解開它，直到找到根解包函式。"
 
 #: ../../howto/annotations.rst:160
 msgid ""

howto/descriptor.po

@@ -78,17 +78,16 @@ msgstr ""
 "這種程度的細節。"
 
 #: ../../howto/descriptor.rst:28
-#, fuzzy
 msgid ""
 "The last section has pure Python equivalents for built-in descriptors that "
 "are written in C.  Read this if you're curious about how functions turn into "
 "bound methods or about the implementation of common tools like :deco:"
 "`classmethod`, :deco:`staticmethod`, :deco:`property`, and :term:`__slots__`."
 msgstr ""
 "最後一個章節提供以 C 語言撰寫的內建描述器的純 Python 等價實作。如果你好奇函式"
-"如何轉變為綁定方法，或者想了解常見工具如 :func:`classmethod`、:func:"
-"`staticmethod`、:func:`property` 和 :term:`__slots__` 的實作方式，請閱讀此章"
-"節。"
+"如何轉變為綁定方法，或者想了解常見工具如 :deco:`classmethod`\\ 、:deco:"
+"`staticmethod`\\ 、:deco:`property` 和 :term:`__slots__` 的實作方式，請閱讀此"
+"章節。"
 
 #: ../../howto/descriptor.rst:36
 msgid "Primer"
@@ -623,16 +622,15 @@ msgstr ""
 "料在這件事上有發言權。"
 
 #: ../../howto/descriptor.rst:319
-#, fuzzy
 msgid ""
 "Descriptors are used throughout the language.  It is how functions turn into "
 "bound methods.  Common tools like :deco:`classmethod`, :deco:"
 "`staticmethod`, :deco:`property`, and :deco:`functools.cached_property` are "
 "all implemented as descriptors."
 msgstr ""
 "描述器在整個語言中被廣泛使用。函式就是透過這種方式轉變為綁定方法。常見工具"
-"如 :func:`classmethod`、:func:`staticmethod`、:func:`property` 和 :func:"
-"`functools.cached_property` 都是以描述器實作的。"
+"如 :deco:`classmethod`\\ 、:deco:`staticmethod`\\ 、:deco:`property` 和 :"
+"deco:`functools.cached_property` 都是以描述器實作的。"
 
 #: ../../howto/descriptor.rst:326
 msgid "Complete Practical Example"

howto/sorting.po

@@ -748,7 +748,6 @@ msgstr ""
 "[('dave', 'B', 10), ('jane', 'B', 12), ('john', 'A', 15)]"
 
 #: ../../howto/sorting.rst:374
-#, fuzzy
 msgid ""
 "However, note that ``<`` can fall back to using :meth:`~object.__gt__` if :"
 "meth:`~object.__lt__` is not implemented (see :func:`object.__lt__` for "
@@ -759,7 +758,7 @@ msgstr ""
 "然而，請注意，當 :meth:`~object.__lt__` 沒有被實作時，``<`` 可以回退 (fall "
 "back) 使用 :meth:`~object.__gt__`\\ （有關技術上的細節資訊請看 :func:`object."
 "__lt__` ）。為了避免意外發生，:pep:`8` 建議所有六種的比較函式都需要被實作。裝"
-"飾器 :func:`~functools.total_ordering` 被提供用來讓任務更為簡單。"
+"飾器 :deco:`~functools.total_ordering` 被提供用來讓任務更為簡單。"
 
 #: ../../howto/sorting.rst:381
 msgid ""

library/abc.po

@@ -314,7 +314,6 @@ msgid "A decorator indicating abstract methods."
 msgstr "用於表示抽象方法的裝飾器。"
 
 #: ../../library/abc.rst:169
-#, fuzzy
 msgid ""
 "Using this decorator requires that the class's metaclass is :class:`ABCMeta` "
 "or is derived from it.  A class that has a metaclass derived from :class:`!"
@@ -325,11 +324,10 @@ msgid ""
 msgstr ""
 "類別的元類別是 :class:`ABCMeta` 或是從該類別衍生才能使用此裝飾器。一個具有衍"
 "生自 :class:`!ABCMeta` 之元類別的類別不可以被實例化，除非它全部的抽象方法和特"
-"性均已被覆寫。抽象方法可透過任何一般的 'super' 呼叫機制來呼叫。:func:`!"
+"性均已被覆寫。抽象方法可透過任何一般的 'super' 呼叫機制來呼叫。:deco:`!"
 "abstractmethod` 可被用於為特性和描述器宣告的抽象方法。"
 
 #: ../../library/abc.rst:176
-#, fuzzy
 msgid ""
 "Dynamically adding abstract methods to a class, or attempting to modify the "
 "abstraction status of a method or class once it is created, are only "
@@ -339,18 +337,17 @@ msgid ""
 "method are not affected."
 msgstr ""
 "僅在使用 :func:`update_abstractmethods` 函式時，才能夠動態地為一個類別新增抽"
-"象方法，或者嘗試在方法或類別被建立後修改其抽象狀態。:func:`!abstractmethod` "
+"象方法，或者嘗試在方法或類別被建立後修改其抽象狀態。:deco:`!abstractmethod` "
 "只會影響使用常規繼承所衍生出的子類別；透過 ABC 的 :meth:`~ABCMeta.register` "
 "方法註冊的「虛擬子類別」不會受到影響。"
 
 #: ../../library/abc.rst:183
-#, fuzzy
 msgid ""
 "When :deco:`!abstractmethod` is applied in combination with other method "
 "descriptors, it should be applied as the innermost decorator, as shown in "
 "the following usage examples::"
 msgstr ""
-"當 :func:`!abstractmethod` 與其他方法描述器 (method descriptor) 配合應用時，"
+"當 :deco:`!abstractmethod` 與其他方法描述器 (method descriptor) 配合應用時，"
 "它應被當最內層的裝飾器，如以下用法範例所示： ::"
 
 #: ../../library/abc.rst:187
@@ -416,7 +413,6 @@ msgstr ""
 "    x = property(_get_x, _set_x)"
 
 #: ../../library/abc.rst:217
-#, fuzzy
 msgid ""
 "In order to correctly interoperate with the abstract base class machinery, "
 "the descriptor must identify itself as abstract using :attr:`!"
@@ -426,7 +422,7 @@ msgid ""
 msgstr ""
 "為了能正確地與 ABC 機制實作相互操作，描述器必須使用 :attr:`!"
 "__isabstractmethod__` 將自身標識為抽象的。一般來說，如果被用於組成描述器的任"
-"一方法是抽象的，則此屬性應當為 ``True``。 例如，Python 的內建 :class:"
+"一方法是抽象的，則此屬性應當為 ``True``\\ 。 例如，Python 的內建 :deco:"
 "`property` 所做的就等價於： ::"
 
 #: ../../library/abc.rst:223
@@ -462,30 +458,27 @@ msgid "The :mod:`!abc` module also supports the following legacy decorators:"
 msgstr ":mod:`!abc` 模組還支援下列舊式裝飾器："
 
 #: ../../library/abc.rst:244
-#, fuzzy
 msgid ""
 "It is now possible to use :deco:`classmethod` with :deco:`abstractmethod`, "
 "making this decorator redundant."
 msgstr ""
-"現在可以讓 :class:`classmethod` 配合 :func:`abstractmethod` 使用，使得此裝飾"
-"器變得冗餘。"
+"現在可以讓 :deco:`classmethod` 配合 :deco:`abstractmethod` 使用，使得此裝飾器"
+"變得冗餘。"
 
 #: ../../library/abc.rst:248
-#, fuzzy
 msgid ""
 "A subclass of the built-in :class:`classmethod`, indicating an abstract "
 "classmethod. Otherwise it is similar to :deco:`abstractmethod`."
 msgstr ""
-"內建 :func:`classmethod` 的子類別，表示為一個抽象類別方法。在其他方面它都類似"
-"於 :func:`abstractmethod`。"
+"內建 :class:`classmethod` 的子類別，表示為一個抽象類別方法。在其他方面它都類"
+"似於 :deco:`abstractmethod`\\ 。"
 
 #: ../../library/abc.rst:251
-#, fuzzy
 msgid ""
 "This special case is deprecated, as the :deco:`classmethod` decorator is now "
 "correctly identified as abstract when applied to an abstract method::"
 msgstr ""
-"這個特例已被棄用，因為現在當 :func:`classmethod` 裝飾器應用於抽象方法時已會被"
+"這個特例已被棄用，因為現在當 :deco:`classmethod` 裝飾器應用於抽象方法時已會被"
 "正確地標識為是抽象的： ::"
 
 #: ../../library/abc.rst:255
@@ -503,30 +496,27 @@ msgstr ""
 "        ..."
 
 #: ../../library/abc.rst:265
-#, fuzzy
 msgid ""
 "It is now possible to use :deco:`staticmethod` with :deco:`abstractmethod`, "
 "making this decorator redundant."
 msgstr ""
-"現在可以讓 :class:`staticmethod` 配合 :func:`abstractmethod` 使用，使得此裝飾"
+"現在可以讓 :deco:`staticmethod` 配合 :deco:`abstractmethod` 使用，使得此裝飾"
 "器變得冗餘。"
 
 #: ../../library/abc.rst:269
-#, fuzzy
 msgid ""
 "A subclass of the built-in :class:`staticmethod`, indicating an abstract "
 "staticmethod. Otherwise it is similar to :deco:`abstractmethod`."
 msgstr ""
-"內建 :func:`staticmethod` 的子類別，表示為一個抽象靜態方法。在其他方面它都類"
-"似於 :func:`abstractmethod`。"
+"內建 :class:`staticmethod` 的子類別，表示為一個抽象靜態方法。在其他方面它都類"
+"似於 :deco:`abstractmethod`\\ 。"
 
 #: ../../library/abc.rst:272
-#, fuzzy
 msgid ""
 "This special case is deprecated, as the :deco:`staticmethod` decorator is "
 "now correctly identified as abstract when applied to an abstract method::"
 msgstr ""
-"這個特例已被棄用，因為現在當 :func:`staticmethod` 裝飾器應用於抽象方法時已會"
+"這個特例已被棄用，因為現在當 :deco:`staticmethod` 裝飾器應用於抽象方法時已會"
 "被正確地標識為是抽象的： ::"
 
 #: ../../library/abc.rst:276
@@ -544,30 +534,27 @@ msgstr ""
 "        ..."
 
 #: ../../library/abc.rst:285
-#, fuzzy
 msgid ""
 "It is now possible to use :deco:`property`, :deco:`property.getter`, :deco:"
 "`property.setter` and :deco:`property.deleter` with :deco:`abstractmethod`, "
 "making this decorator redundant."
 msgstr ""
-"現在可以讓 :class:`property`、:meth:`property.getter`、:meth:`property."
-"setter` 和 :meth:`property.deleter` 配合 :func:`abstractmethod` 使用，使得此"
+"現在可以讓 :deco:`property`\\ 、:deco:`property.getter`\\ 、:deco:`property."
+"setter` 和 :deco:`property.deleter` 配合 :deco:`abstractmethod` 使用，使得此"
 "裝飾器變得冗餘。"
 
 #: ../../library/abc.rst:290
-#, fuzzy
 msgid ""
 "A subclass of the built-in :class:`property`, indicating an abstract "
 "property."
-msgstr "內建 :func:`property` 的子類別，表示為一個抽象特性。"
+msgstr "內建 :class:`property` 的子類別，表示為一個抽象特性。"
 
 #: ../../library/abc.rst:293
-#, fuzzy
 msgid ""
 "This special case is deprecated, as the :deco:`property` decorator is now "
 "correctly identified as abstract when applied to an abstract method::"
 msgstr ""
-"這個特例已被棄用，因為現在當 :func:`property` 裝飾器應用於抽象方法時已會被正"
+"這個特例已被棄用，因為現在當 :deco:`property` 裝飾器應用於抽象方法時已會被正"
 "確地標識為是抽象的： ::"
 
 #: ../../library/abc.rst:297

library/asyncio-stream.po

@@ -517,6 +517,11 @@ msgid ""
 "tasks from running.  To prevent blocking behavior, yield to the event loop "
 "explicitly with ``await asyncio.sleep(0)`` (see :func:`asyncio.sleep`)."
 msgstr ""
+"當寫入緩衝區低於最高標記位 (high watermark) 時，:meth:`drain` 會立即回傳，而"
+"不會讓出控制權給事件迴圈。因此，重複呼叫 ``write()`` 後接著呼叫 ``await "
+"drain()`` 的程式碼可能會阻止其他 Task 執行。為了避免阻塞行為，請明確使用 "
+"``await asyncio.sleep(0)``\\ （請見 :func:`asyncio.sleep`\\ ）讓出控制權給事"
+"件迴圈。"
 
 #: ../../library/asyncio-stream.rst:399
 msgid "Upgrade an existing stream-based connection to TLS."