sync with cpython f12e7cb8

Author: github-actions[bot]

library/imaplib.po

@@ -6,7 +6,7 @@ msgid ""
 msgstr ""
 "Project-Id-Version: Python 3.13\n"
 "Report-Msgid-Bugs-To: \n"
-"POT-Creation-Date: 2024-10-11 00:13+0000\n"
+"POT-Creation-Date: 2025-08-24 00:17+0000\n"
 "PO-Revision-Date: 2018-05-23 16:04+0000\n"
 "Last-Translator: Adrian Liaw <[email protected]>\n"
 "Language-Team: Chinese - TAIWAN (https://github.com/python/python-docs-zh-"
@@ -395,34 +395,38 @@ msgid ""
 "includes the phrase ``AUTH=CRAM-MD5``."
 msgstr ""
 
-#: ../../library/imaplib.rst:331
+#: ../../library/imaplib.rst:328
+msgid "An :exc:`IMAP4.error` is raised if MD5 support is not available."
+msgstr ""
+
+#: ../../library/imaplib.rst:334
 msgid "Shutdown connection to server. Returns server ``BYE`` response."
 msgstr ""
 
-#: ../../library/imaplib.rst:333
+#: ../../library/imaplib.rst:336
 msgid "The method no longer ignores silently arbitrary exceptions."
 msgstr ""
 
-#: ../../library/imaplib.rst:339
+#: ../../library/imaplib.rst:342
 msgid ""
 "List subscribed mailbox names in directory matching pattern. *directory* "
 "defaults to the top level directory and *pattern* defaults to match any "
 "mailbox. Returned data are tuples of message part envelope and data."
 msgstr ""
 
-#: ../../library/imaplib.rst:346
+#: ../../library/imaplib.rst:349
 msgid "Show my ACLs for a mailbox (i.e. the rights that I have on mailbox)."
 msgstr ""
 
-#: ../../library/imaplib.rst:351
+#: ../../library/imaplib.rst:354
 msgid "Returns IMAP namespaces as defined in :rfc:`2342`."
 msgstr ""
 
-#: ../../library/imaplib.rst:356
+#: ../../library/imaplib.rst:359
 msgid "Send ``NOOP`` to server."
 msgstr ""
 
-#: ../../library/imaplib.rst:361
+#: ../../library/imaplib.rst:364
 msgid ""
 "Opens socket to *port* at *host*. The optional *timeout* parameter specifies "
 "a timeout in seconds for the connection attempt. If timeout is not given or "
@@ -435,56 +439,56 @@ msgid ""
 "You may override this method."
 msgstr ""
 
-#: ../../library/imaplib.rst:371
+#: ../../library/imaplib.rst:374
 msgid ""
 "Raises an :ref:`auditing event <auditing>` ``imaplib.open`` with arguments "
 "``self``, ``host``, ``port``."
 msgstr ""
 "引發一個附帶引數 ``self``、``host``、``port`` 的\\ :ref:`稽核事件 "
 "<auditing>` ``imaplib.open``。"
 
-#: ../../library/imaplib.rst:373
+#: ../../library/imaplib.rst:376
 msgid "The *timeout* parameter was added."
 msgstr "新增 *timeout* 參數。"
 
-#: ../../library/imaplib.rst:378
+#: ../../library/imaplib.rst:381
 msgid ""
 "Fetch truncated part of a message. Returned data is a tuple of message part "
 "envelope and data."
 msgstr ""
 
-#: ../../library/imaplib.rst:384
+#: ../../library/imaplib.rst:387
 msgid ""
 "Assume authentication as *user*. Allows an authorised administrator to proxy "
 "into any user's mailbox."
 msgstr ""
 
-#: ../../library/imaplib.rst:390
+#: ../../library/imaplib.rst:393
 msgid ""
 "Reads *size* bytes from the remote server. You may override this method."
 msgstr ""
 
-#: ../../library/imaplib.rst:395
+#: ../../library/imaplib.rst:398
 msgid "Reads one line from the remote server. You may override this method."
 msgstr ""
 
-#: ../../library/imaplib.rst:400
+#: ../../library/imaplib.rst:403
 msgid ""
 "Prompt server for an update. Returned data is ``None`` if no new messages, "
 "else value of ``RECENT`` response."
 msgstr ""
 
-#: ../../library/imaplib.rst:406
+#: ../../library/imaplib.rst:409
 msgid "Rename mailbox named *oldmailbox* to *newmailbox*."
 msgstr ""
 
-#: ../../library/imaplib.rst:411
+#: ../../library/imaplib.rst:414
 msgid ""
 "Return data for response *code* if received, or ``None``. Returns the given "
 "code, instead of the usual type."
 msgstr ""
 
-#: ../../library/imaplib.rst:417
+#: ../../library/imaplib.rst:420
 msgid ""
 "Search mailbox for matching messages.  *charset* may be ``None``, in which "
 "case no ``CHARSET`` will be specified in the request to the server.  The "
@@ -494,11 +498,11 @@ msgid ""
 "`enable` command."
 msgstr ""
 
-#: ../../library/imaplib.rst:424
+#: ../../library/imaplib.rst:427
 msgid "Example::"
 msgstr "範例： ::"
 
-#: ../../library/imaplib.rst:426
+#: ../../library/imaplib.rst:429
 msgid ""
 "# M is a connected IMAP4 instance...\n"
 "typ, msgnums = M.search(None, 'FROM', '\"LDJ\"')\n"
@@ -507,61 +511,61 @@ msgid ""
 "typ, msgnums = M.search(None, '(FROM \"LDJ\")')"
 msgstr ""
 
-#: ../../library/imaplib.rst:435
+#: ../../library/imaplib.rst:438
 msgid ""
 "Select a mailbox. Returned data is the count of messages in *mailbox* "
 "(``EXISTS`` response).  The default *mailbox* is ``'INBOX'``.  If the "
 "*readonly* flag is set, modifications to the mailbox are not allowed."
 msgstr ""
 
-#: ../../library/imaplib.rst:442
+#: ../../library/imaplib.rst:445
 msgid "Sends ``data`` to the remote server. You may override this method."
 msgstr ""
 
-#: ../../library/imaplib.rst:444
+#: ../../library/imaplib.rst:447
 msgid ""
 "Raises an :ref:`auditing event <auditing>` ``imaplib.send`` with arguments "
 "``self``, ``data``."
 msgstr ""
 "引發一個附帶引數 ``self``、``data`` 的\\ :ref:`稽核事件 <auditing>` "
 "``imaplib.send``。"
 
-#: ../../library/imaplib.rst:449
+#: ../../library/imaplib.rst:452
 msgid ""
 "Set an ``ACL`` for *mailbox*. The method is non-standard, but is supported "
 "by the ``Cyrus`` server."
 msgstr ""
 
-#: ../../library/imaplib.rst:455
+#: ../../library/imaplib.rst:458
 msgid ""
 "Set ``ANNOTATION``\\ s for *mailbox*. The method is non-standard, but is "
 "supported by the ``Cyrus`` server."
 msgstr ""
 
-#: ../../library/imaplib.rst:461
+#: ../../library/imaplib.rst:464
 msgid ""
 "Set the ``quota`` *root*'s resource *limits*. This method is part of the "
 "IMAP4 QUOTA extension defined in rfc2087."
 msgstr ""
 
-#: ../../library/imaplib.rst:467
+#: ../../library/imaplib.rst:470
 msgid ""
 "Close connection established in ``open``.  This method is implicitly called "
 "by :meth:`IMAP4.logout`.  You may override this method."
 msgstr ""
 
-#: ../../library/imaplib.rst:473
+#: ../../library/imaplib.rst:476
 msgid "Returns socket instance used to connect to server."
 msgstr ""
 
-#: ../../library/imaplib.rst:478
+#: ../../library/imaplib.rst:481
 msgid ""
 "The ``sort`` command is a variant of ``search`` with sorting semantics for "
 "the results.  Returned data contains a space separated list of matching "
 "message numbers."
 msgstr ""
 
-#: ../../library/imaplib.rst:482
+#: ../../library/imaplib.rst:485
 msgid ""
 "Sort has two arguments before the *search_criterion* argument(s); a "
 "parenthesized list of *sort_criteria*, and the searching *charset*.  Note "
@@ -573,39 +577,39 @@ msgid ""
 "searching criteria.  It then returns the numbers of matching messages."
 msgstr ""
 
-#: ../../library/imaplib.rst:491 ../../library/imaplib.rst:562
+#: ../../library/imaplib.rst:494 ../../library/imaplib.rst:565
 msgid "This is an ``IMAP4rev1`` extension command."
 msgstr ""
 
-#: ../../library/imaplib.rst:496
+#: ../../library/imaplib.rst:499
 msgid ""
 "Send a ``STARTTLS`` command.  The *ssl_context* argument is optional and "
 "should be a :class:`ssl.SSLContext` object.  This will enable encryption on "
 "the IMAP connection.  Please read :ref:`ssl-security` for best practices."
 msgstr ""
 
-#: ../../library/imaplib.rst:503
+#: ../../library/imaplib.rst:506
 msgid ""
 "The method now supports hostname check with :attr:`ssl.SSLContext."
 "check_hostname` and *Server Name Indication* (see :const:`ssl.HAS_SNI`)."
 msgstr ""
 
-#: ../../library/imaplib.rst:511
+#: ../../library/imaplib.rst:514
 msgid "Request named status conditions for *mailbox*."
 msgstr ""
 
-#: ../../library/imaplib.rst:516
+#: ../../library/imaplib.rst:519
 msgid ""
 "Alters flag dispositions for messages in mailbox.  *command* is specified by "
 "section 6.4.6 of :rfc:`2060` as being one of \"FLAGS\", \"+FLAGS\", or \"-"
 "FLAGS\", optionally with a suffix of \".SILENT\"."
 msgstr ""
 
-#: ../../library/imaplib.rst:520
+#: ../../library/imaplib.rst:523
 msgid "For example, to set the delete flag on all messages::"
 msgstr ""
 
-#: ../../library/imaplib.rst:522
+#: ../../library/imaplib.rst:525
 msgid ""
 "typ, data = M.search(None, 'ALL')\n"
 "for num in data[0].split():\n"
@@ -617,7 +621,7 @@ msgstr ""
 "   M.store(num, '+FLAGS', '\\\\Deleted')\n"
 "M.expunge()"
 
-#: ../../library/imaplib.rst:529
+#: ../../library/imaplib.rst:532
 msgid ""
 "Creating flags containing ']' (for example: \"[test]\") violates :rfc:`3501` "
 "(the IMAP protocol).  However, imaplib has historically allowed creation of "
@@ -629,24 +633,24 @@ msgid ""
 "are sent from the server, since this improves real-world compatibility."
 msgstr ""
 
-#: ../../library/imaplib.rst:541
+#: ../../library/imaplib.rst:544
 msgid "Subscribe to new mailbox."
 msgstr ""
 
-#: ../../library/imaplib.rst:546
+#: ../../library/imaplib.rst:549
 msgid ""
 "The ``thread`` command is a variant of ``search`` with threading semantics "
 "for the results.  Returned data contains a space separated list of thread "
 "members."
 msgstr ""
 
-#: ../../library/imaplib.rst:549
+#: ../../library/imaplib.rst:552
 msgid ""
 "Thread members consist of zero or more messages numbers, delimited by "
 "spaces, indicating successive parent and child."
 msgstr ""
 
-#: ../../library/imaplib.rst:552
+#: ../../library/imaplib.rst:555
 msgid ""
 "Thread has two arguments before the *search_criterion* argument(s); a "
 "*threading_algorithm*, and the searching *charset*.  Note that unlike "
@@ -659,66 +663,66 @@ msgid ""
 "specified threading algorithm."
 msgstr ""
 
-#: ../../library/imaplib.rst:567
+#: ../../library/imaplib.rst:570
 msgid ""
 "Execute command args with messages identified by UID, rather than message "
 "number.  Returns response appropriate to command.  At least one argument "
 "must be supplied; if none are provided, the server will return an error and "
 "an exception will be raised."
 msgstr ""
 
-#: ../../library/imaplib.rst:575
+#: ../../library/imaplib.rst:578
 msgid "Unsubscribe from old mailbox."
 msgstr ""
 
-#: ../../library/imaplib.rst:579
+#: ../../library/imaplib.rst:582
 msgid ""
 ":meth:`imaplib.IMAP4.unselect` frees server's resources associated with the "
 "selected mailbox and returns the server to the authenticated state. This "
 "command performs the same actions as :meth:`imaplib.IMAP4.close`, except "
 "that no messages are permanently removed from the currently selected mailbox."
 msgstr ""
 
-#: ../../library/imaplib.rst:589
+#: ../../library/imaplib.rst:592
 msgid ""
 "Allow simple extension commands notified by server in ``CAPABILITY`` "
 "response."
 msgstr ""
 
-#: ../../library/imaplib.rst:592
+#: ../../library/imaplib.rst:595
 msgid "The following attributes are defined on instances of :class:`IMAP4`:"
 msgstr ""
 
-#: ../../library/imaplib.rst:596
+#: ../../library/imaplib.rst:599
 msgid ""
 "The most recent supported protocol in the ``CAPABILITY`` response from the "
 "server."
 msgstr ""
 
-#: ../../library/imaplib.rst:602
+#: ../../library/imaplib.rst:605
 msgid ""
 "Integer value to control debugging output.  The initialize value is taken "
 "from the module variable ``Debug``.  Values greater than three trace each "
 "command."
 msgstr ""
 
-#: ../../library/imaplib.rst:608
+#: ../../library/imaplib.rst:611
 msgid ""
 "Boolean value that is normally ``False``, but is set to ``True`` if an :meth:"
 "`enable` command is successfully issued for the ``UTF8=ACCEPT`` capability."
 msgstr ""
 
-#: ../../library/imaplib.rst:618
+#: ../../library/imaplib.rst:621
 msgid "IMAP4 Example"
 msgstr "IMAP4 範例"
 
-#: ../../library/imaplib.rst:620
+#: ../../library/imaplib.rst:623
 msgid ""
 "Here is a minimal example (without error checking) that opens a mailbox and "
 "retrieves and prints all messages::"
 msgstr ""
 
-#: ../../library/imaplib.rst:623
+#: ../../library/imaplib.rst:626
 msgid ""
 "import getpass, imaplib\n"
 "\n"