sync with cpython c8e4c321

Author: github-actions[bot]

library/csv.po

@@ -7,7 +7,7 @@ msgid ""
 msgstr ""
 "Project-Id-Version: Python 3.12\n"
 "Report-Msgid-Bugs-To: \n"
-"POT-Creation-Date: 2023-12-17 00:04+0000\n"
+"POT-Creation-Date: 2024-02-01 00:03+0000\n"
 "PO-Revision-Date: 2023-11-08 15:06+0800\n"
 "Last-Translator: RockLeon <[email protected]>\n"
 "Language-Team: Chinese - TAIWAN (https://github.com/python/python-docs-zh-"
@@ -129,23 +129,24 @@ msgid "A short usage example::"
 msgstr "一個簡短的用法範例： ::"
 
 #: ../../library/csv.rst:89
+#, fuzzy
 msgid ""
 "Return a writer object responsible for converting the user's data into "
 "delimited strings on the given file-like object.  *csvfile* can be any "
-"object with a :func:`write` method.  If *csvfile* is a file object, it "
-"should be opened with ``newline=''`` [1]_.  An optional *dialect* parameter "
-"can be given which is used to define a set of parameters specific to a "
-"particular CSV dialect.  It may be an instance of a subclass of the :class:"
-"`Dialect` class or one of the strings returned by the :func:`list_dialects` "
-"function.  The other optional *fmtparams* keyword arguments can be given to "
-"override individual formatting parameters in the current dialect.  For full "
-"details about dialects and formatting parameters, see the :ref:`csv-fmt-"
-"params` section. To make it as easy as possible to interface with modules "
-"which implement the DB API, the value :const:`None` is written as the empty "
-"string.  While this isn't a reversible transformation, it makes it easier to "
-"dump SQL NULL data values to CSV files without preprocessing the data "
-"returned from a ``cursor.fetch*`` call. All other non-string data are "
-"stringified with :func:`str` before being written."
+"object with a :meth:`~io.TextIOBase.write` method.  If *csvfile* is a file "
+"object, it should be opened with ``newline=''`` [1]_.  An optional *dialect* "
+"parameter can be given which is used to define a set of parameters specific "
+"to a particular CSV dialect.  It may be an instance of a subclass of the :"
+"class:`Dialect` class or one of the strings returned by the :func:"
+"`list_dialects` function.  The other optional *fmtparams* keyword arguments "
+"can be given to override individual formatting parameters in the current "
+"dialect.  For full details about dialects and formatting parameters, see "
+"the :ref:`csv-fmt-params` section. To make it as easy as possible to "
+"interface with modules which implement the DB API, the value :const:`None` "
+"is written as the empty string.  While this isn't a reversible "
+"transformation, it makes it easier to dump SQL NULL data values to CSV files "
+"without preprocessing the data returned from a ``cursor.fetch*`` call. All "
+"other non-string data are stringified with :func:`str` before being written."
 msgstr ""
 "回傳一個寫入器物件 (writer object)，其負責在給定的類檔案物件 (file-like "
 "object) 上將使用者的資料轉換為分隔字串 (delimited string)。*csvfile* 可以為具"
@@ -261,19 +262,20 @@ msgid "Returned rows are now of type :class:`dict`."
 msgstr "回傳的列已成為型別 :class:`dict`。"
 
 #: ../../library/csv.rst:197
+#, fuzzy
 msgid ""
 "Create an object which operates like a regular writer but maps dictionaries "
 "onto output rows.  The *fieldnames* parameter is a :mod:`sequence "
 "<collections.abc>` of keys that identify the order in which values in the "
-"dictionary passed to the :meth:`writerow` method are written to file *f*.  "
-"The optional *restval* parameter specifies the value to be written if the "
-"dictionary is missing a key in *fieldnames*.  If the dictionary passed to "
-"the :meth:`writerow` method contains a key not found in *fieldnames*, the "
-"optional *extrasaction* parameter indicates what action to take. If it is "
-"set to ``'raise'``, the default value, a :exc:`ValueError` is raised. If it "
-"is set to ``'ignore'``, extra values in the dictionary are ignored. Any "
-"other optional or keyword arguments are passed to the underlying :class:"
-"`writer` instance."
+"dictionary passed to the :meth:`~csvwriter.writerow` method are written to "
+"file *f*.  The optional *restval* parameter specifies the value to be "
+"written if the dictionary is missing a key in *fieldnames*.  If the "
+"dictionary passed to the :meth:`~csvwriter.writerow` method contains a key "
+"not found in *fieldnames*, the optional *extrasaction* parameter indicates "
+"what action to take. If it is set to ``'raise'``, the default value, a :exc:"
+"`ValueError` is raised. If it is set to ``'ignore'``, extra values in the "
+"dictionary are ignored. Any other optional or keyword arguments are passed "
+"to the underlying :class:`writer` instance."
 msgstr ""
 "建立一個物件，其運作上就像一般的寫入器，但可以將 dictionary map 到輸出的列"
 "上。參數 *fieldnames* 是一個鍵值的 :mod:`sequence <collections.abc>` 且可以辨"
@@ -495,13 +497,14 @@ msgid "Dialects and Formatting Parameters"
 msgstr "Dialect 與格式參數"
 
 #: ../../library/csv.rst:375
+#, fuzzy
 msgid ""
 "To make it easier to specify the format of input and output records, "
 "specific formatting parameters are grouped together into dialects.  A "
-"dialect is a subclass of the :class:`Dialect` class having a set of specific "
-"methods and a single :meth:`validate` method.  When creating :class:`reader` "
-"or :class:`writer` objects, the programmer can specify a string or a "
-"subclass of the :class:`Dialect` class as the dialect parameter.  In "
+"dialect is a subclass of the :class:`Dialect` class containing various "
+"attributes describing the format of the CSV file.  When creating :class:"
+"`reader` or :class:`writer` objects, the programmer can specify a string or "
+"a subclass of the :class:`Dialect` class as the dialect parameter.  In "
 "addition to, or instead of, the *dialect* parameter, the programmer can also "
 "specify individual formatting parameters, which have the same names as the "
 "attributes defined below for the :class:`Dialect` class."
@@ -664,10 +667,11 @@ msgid "Writer Objects"
 msgstr "寫入器物件"
 
 #: ../../library/csv.rst:495
+#, fuzzy
 msgid ""
-":class:`Writer` objects (:class:`DictWriter` instances and objects returned "
+":class:`writer` objects (:class:`DictWriter` instances and objects returned "
 "by the :func:`writer` function) have the following public methods.  A *row* "
-"must be an iterable of strings or numbers for :class:`Writer` objects and a "
+"must be an iterable of strings or numbers for :class:`writer` objects and a "
 "dictionary mapping fieldnames to strings or numbers (by passing them "
 "through :func:`str` first) for :class:`DictWriter` objects.  Note that "
 "complex numbers are written out surrounded by parens. This may cause some "