python
diff --git a/‎library/devmode.po‎
Lines changed: 62 additions & 31 deletions b/‎library/devmode.po‎
Lines changed: 62 additions & 31 deletions
@@ -4,9 +4,10 @@
 # FIRST AUTHOR <EMAIL@ADDRESS>, YEAR.
 # 
 # Translators:
-# Freesand Leo <[email protected]>, 2021
 # ppcfish <[email protected]>, 2021
 # Alpha Du <[email protected]>, 2021
+# Dai Xu <[email protected]>, 2021
+# Freesand Leo <[email protected]>, 2021
 # 
 #, fuzzy
 msgid ""
@@ -15,7 +16,7 @@ msgstr ""
 "Report-Msgid-Bugs-To: \n"
 "POT-Creation-Date: 2021-06-29 12:56+0000\n"
 "PO-Revision-Date: 2021-06-28 01:04+0000\n"
-"Last-Translator: Alpha Du <alphanow@gmail.com>, 2021\n"
+"Last-Translator: Freesand Leo <yuqinju@163.com>, 2021\n"
 "Language-Team: Chinese (China) (https://www.transifex.com/python-doc/teams/5390/zh_CN/)\n"
 "MIME-Version: 1.0\n"
 "Content-Type: text/plain; charset=UTF-8\n"
@@ -34,40 +35,42 @@ msgid ""
 "the default if the code is correct; new warnings are only emitted when an "
 "issue is detected."
 msgstr ""
-"Python "
-"开发模式引入了额外的运行时检查，由于成本太高，所以默认情况下是不启用的。如果代码是正确的，它不应该比默认情况的更加详细；只有在检测到问题的时候才会发出新的警告。"
+"开发模式下的 Python "
+"加入了额外的运行时检查，由于开销太大，并非默认启用的。如果代码能够正确执行，默认的调试级别足矣，不应再提高了；仅当觉察到问题时再提升警告触发的级别。"
 
 #: ../../library/devmode.rst:13
 msgid ""
 "It can be enabled using the :option:`-X dev <-X>` command line option or by "
 "setting the :envvar:`PYTHONDEVMODE` environment variable to ``1``."
 msgstr ""
-"它可以通过 :option:`-X dev <-X>` 命令行选项或通过设置 :envvar:`PYTHONDEVMODE` 环境变量为 ``1`` "
-"来启用。"
+"使用 :option:`-X dev <-X>` 命令行参数或将环境变量 :envvar:`PYTHONDEVMODE` 置为 ``1`` "
+"，可以启用开发模式。"
 
 #: ../../library/devmode.rst:16
 msgid "See also :ref:`Python debug build <debug-build>`."
 msgstr "另请参考 :ref:`Python debug build <debug-build>` 。"
 
 #: ../../library/devmode.rst:19
 msgid "Effects of the Python Development Mode"
-msgstr ""
+msgstr "Python 开发模式的效果"
 
 #: ../../library/devmode.rst:21
 msgid ""
 "Enabling the Python Development Mode is similar to the following command, "
 "but with additional effects described below::"
-msgstr ""
+msgstr "启用 Python 开发模式后的效果，与以下命令类似，不过还有下面的额外效果："
 
 #: ../../library/devmode.rst:26
 msgid "Effects of the Python Development Mode:"
-msgstr ""
+msgstr "Python 开发模式的效果："
 
 #: ../../library/devmode.rst:28
 msgid ""
 "Add ``default`` :ref:`warning filter <describing-warning-filters>`. The "
 "following warnings are shown:"
 msgstr ""
+"加入 ``default`` :ref:`warning filter <describing-warning-filters>` "
+"。下述警告信息将会显示出来："
 
 #: ../../library/devmode.rst:31
 msgid ":exc:`DeprecationWarning`"
@@ -90,99 +93,114 @@ msgid ""
 "Normally, the above warnings are filtered by the default :ref:`warning "
 "filters <describing-warning-filters>`."
 msgstr ""
+"通常上述警告是由默认的 :ref:`warning filters <describing-warning-filters>` 负责处理的。"
 
 #: ../../library/devmode.rst:39
 msgid ""
 "It behaves as if the :option:`-W default <-W>` command line option is used."
-msgstr ""
+msgstr "效果类似于采用了 :option:`-W default <-W>` 命令行参数。"
 
 #: ../../library/devmode.rst:41
 msgid ""
 "Use the :option:`-W error <-W>` command line option or set the "
 ":envvar:`PYTHONWARNINGS` environment variable to ``error`` to treat warnings"
 " as errors."
 msgstr ""
+"使用命令行参数 :option:`-W error <-W>` 或将环境变量 :envvar:`PYTHONWARNINGS` 设为 "
+"``error``，可将警告视为错误。"
 
 #: ../../library/devmode.rst:45
 msgid "Install debug hooks on memory allocators to check for:"
-msgstr ""
+msgstr "在内存分配程序中安装调试钩子，用以查看："
 
 #: ../../library/devmode.rst:47
 msgid "Buffer underflow"
-msgstr ""
+msgstr "缓冲区下溢"
 
 #: ../../library/devmode.rst:48
 msgid "Buffer overflow"
-msgstr ""
+msgstr "缓冲区上溢"
 
 #: ../../library/devmode.rst:49
 msgid "Memory allocator API violation"
-msgstr ""
+msgstr "内存分配 API 冲突"
 
 #: ../../library/devmode.rst:50
 msgid "Unsafe usage of the GIL"
-msgstr ""
+msgstr "不安全的 GIL 调用"
 
 #: ../../library/devmode.rst:52
 msgid "See the :c:func:`PyMem_SetupDebugHooks` C function."
-msgstr ""
+msgstr "参见 C 函数 :c:func:`PyMem_SetupDebugHooks` 。"
 
 #: ../../library/devmode.rst:54
 msgid ""
 "It behaves as if the :envvar:`PYTHONMALLOC` environment variable is set to "
 "``debug``."
-msgstr ""
+msgstr "效果如同将环境变量 :envvar:`PYTHONMALLOC` 设为 ``debug``。"
 
 #: ../../library/devmode.rst:57
 msgid ""
 "To enable the Python Development Mode without installing debug hooks on "
 "memory allocators, set the :envvar:`PYTHONMALLOC` environment variable to "
 "``default``."
 msgstr ""
+"若要启用 Python 开发模式，却又不要在内存分配程序中安装调试钩子，请将 环境变量 :envvar:`PYTHONMALLOC` 设为 "
+"``default``。"
 
 #: ../../library/devmode.rst:61
 msgid ""
 "Call :func:`faulthandler.enable` at Python startup to install handlers for "
 "the :const:`SIGSEGV`, :const:`SIGFPE`, :const:`SIGABRT`, :const:`SIGBUS` and"
 " :const:`SIGILL` signals to dump the Python traceback on a crash."
 msgstr ""
+"在启动 Python 时调用 :func:`faulthandler.enable` ，会安装 :const:`SIGSEGV` 、 "
+":const:`SIGFPE` 、 :const:`SIGABRT` 、 :const:`SIGBUS` 和 :const:`SIGILL` "
+"信号的处理程序，以便在程序崩溃时将 Python 跟踪信息转储下来。"
 
 #: ../../library/devmode.rst:65
 msgid ""
 "It behaves as if the :option:`-X faulthandler <-X>` command line option is "
 "used or if the :envvar:`PYTHONFAULTHANDLER` environment variable is set to "
 "``1``."
 msgstr ""
+"其行为如同使用了 :option:`-X faulthandler <-X>` 命令行选项或将 :envvar:`PYTHONFAULTHANDLER`"
+" 环境变量设为 ``1``。"
 
 #: ../../library/devmode.rst:69
 msgid ""
 "Enable :ref:`asyncio debug mode <asyncio-debug-mode>`. For example, "
 ":mod:`asyncio` checks for coroutines that were not awaited and logs them."
 msgstr ""
+"启用 :ref:`asyncio debug mode <asyncio-debug-mode>`。比如 :mod:`asyncio` "
+"会检查没有等待的协程并记录下来。"
 
 #: ../../library/devmode.rst:72
 msgid ""
 "It behaves as if the :envvar:`PYTHONASYNCIODEBUG` environment variable is "
 "set to ``1``."
-msgstr ""
+msgstr "效果如同将环境变量 :envvar:`PYTHONASYNCIODEBUG` 设为 ``1``。"
 
 #: ../../library/devmode.rst:75
 msgid ""
 "Check the *encoding* and *errors* arguments for string encoding and decoding"
 " operations. Examples: :func:`open`, :meth:`str.encode` and "
 ":meth:`bytes.decode`."
 msgstr ""
+"检查字符串编码和解码函数的 *encoding* 和 *errors* 参数。例如： :func:`open` 、 :meth:`str.encode`"
+" 和 :meth:`bytes.decode`。"
 
 #: ../../library/devmode.rst:79
 msgid ""
 "By default, for best performance, the *errors* argument is only checked at "
 "the first encoding/decoding error and the *encoding* argument is sometimes "
 "ignored for empty strings."
 msgstr ""
+"为了获得最佳性能，默认只会在第一次编码/解码错误时才会检查  *errors* 参数，有时 *encoding* 参数为空字符串时还会被忽略。"
 
 #: ../../library/devmode.rst:83
 msgid "The :class:`io.IOBase` destructor logs ``close()`` exceptions."
-msgstr ""
+msgstr ":class:`io.IOBase` 的析构函数会记录 ``close()`` 触发的异常。"
 
 #: ../../library/devmode.rst:84
 msgid ""
@@ -200,62 +218,69 @@ msgid ""
 "and a buffer overflow error logs the traceback where the memory block was "
 "allocated."
 msgstr ""
+"Python 开发模式下，默认不会启用 :mod:`tracemalloc` 模块，因为其性能和内存开销太大。启用 :mod:`tracemalloc`"
+" 模块后，能够提供有关错误来源的一些额外信息。例如，:exc:`ResourceWarning` "
+"记录了资源分配的跟踪信息，而缓冲区溢出错误记录了内存块分配的跟踪信息。"
 
 #: ../../library/devmode.rst:94
 msgid ""
 "The Python Development Mode does not prevent the :option:`-O` command line "
 "option from removing :keyword:`assert` statements nor from setting "
 ":const:`__debug__` to ``False``."
 msgstr ""
+"Python 开发模式不会阻止命令行参数 :option:`-O` 删除 :keyword:`assert` 语句，也不会阻止将 "
+":const:`__debug__` 设为 ``False``。"
 
 #: ../../library/devmode.rst:98
 msgid ""
 "The Python Development Mode can only be enabled at the Python startup. Its "
 "value can be read from :data:`sys.flags.dev_mode <sys.flags>`."
 msgstr ""
+"Python 开发模式只能在 Python 启动时启用。其参数值可从  :data:`sys.flags.dev_mode <sys.flags>` "
+"读取。"
 
 #: ../../library/devmode.rst:101
 msgid "The :class:`io.IOBase` destructor now logs ``close()`` exceptions."
-msgstr ""
+msgstr "现在， :class:`io.IOBase` 的析构函数会记录 ``close()`` 触发的异常。"
 
 #: ../../library/devmode.rst:104
 msgid ""
 "The *encoding* and *errors* arguments are now checked for string encoding "
 "and decoding operations."
-msgstr ""
+msgstr "现在，字符串编码和解码操作时会检查 *encoding* 和 *errors* 参数。"
 
 #: ../../library/devmode.rst:110
 msgid "ResourceWarning Example"
-msgstr ""
+msgstr "ResourceWarning 示例"
 
 #: ../../library/devmode.rst:112
 msgid ""
 "Example of a script counting the number of lines of the text file specified "
 "in the command line::"
-msgstr ""
+msgstr "以下示例将统计由命令行指定的文本文件的行数："
 
 #: ../../library/devmode.rst:126
 msgid ""
 "The script does not close the file explicitly. By default, Python does not "
 "emit any warning. Example using README.txt, which has 269 lines:"
-msgstr ""
+msgstr "上述代码没有显式关闭文件。默认情况下，Python 不会触发任何警告。下面用 README.txt 文件测试下，有 269 行："
 
 #: ../../library/devmode.rst:134
 msgid ""
 "Enabling the Python Development Mode displays a :exc:`ResourceWarning` "
 "warning:"
-msgstr ""
+msgstr "启用 Python 开发模式后，则会显示一条 :exc:`ResourceWarning` 警告："
 
 #: ../../library/devmode.rst:144
 msgid ""
 "In addition, enabling :mod:`tracemalloc` shows the line where the file was "
 "opened:"
-msgstr ""
+msgstr "启用 :mod:`tracemalloc` 后，则还会显示打开文件的那行代码："
 
 #: ../../library/devmode.rst:159
 msgid ""
 "The fix is to close explicitly the file. Example using a context manager::"
-msgstr ""
+msgstr "修正方案就是显式关闭文件。下面用上下文管理器作为示例："
 
 #: ../../library/devmode.rst:167
 msgid ""
@@ -264,24 +289,28 @@ msgid ""
 "CPython, but it is even worse in PyPy. Closing resources explicitly makes an"
 " application more deterministic and more reliable."
 msgstr ""
+"未能显式关闭资源，会让资源打开时长远超预期；在退出 Python 时可能会导致严重问题。这在 CPython 中比较糟糕，但在 PyPy "
+"中会更糟。显式关闭资源能让应用程序更加稳定可靠。"
 
 #: ../../library/devmode.rst:174
 msgid "Bad file descriptor error example"
-msgstr ""
+msgstr "文件描述符错误示例"
 
 #: ../../library/devmode.rst:176
 msgid "Script displaying the first line of itself::"
-msgstr ""
+msgstr "显示自身的第一行代码："
 
 #: ../../library/devmode.rst:189
 msgid "By default, Python does not emit any warning:"
-msgstr ""
+msgstr "默认情况下，Python 不会触发任何警告："
 
 #: ../../library/devmode.rst:196
 msgid ""
 "The Python Development Mode shows a :exc:`ResourceWarning` and logs a \"Bad "
 "file descriptor\" error when finalizing the file object:"
 msgstr ""
+"在 Python 开发模式下，会在析构文件对象时显示 :exc:`ResourceWarning` 并记录 “Bad file descriptor” "
+"错误。"
 
 #: ../../library/devmode.rst:212
 msgid ""
@@ -291,9 +320,11 @@ msgid ""
 "worst case scenario, closing it twice can lead to a crash (see "
 ":issue:`18748` for an example)."
 msgstr ""
+"``os.close(fp.fileno())`` 会关闭文件描述符。当文件对象析构函数试图再次关闭文件描述符时会失败，并触发 ``Bad file "
+"descriptor`` 错误。每个文件描述符只允许关闭一次。在最坏的情况下，关闭两次会导致程序崩溃（示例可参见 :issue:`18748` ）。"
 
 #: ../../library/devmode.rst:218
 msgid ""
 "The fix is to remove the ``os.close(fp.fileno())`` line, or open the file "
 "with ``closefd=False``."
-msgstr ""
+msgstr "修正方案是删除 ``os.close(fp.fileno())`` 这一行，或者打开文件时带上 ``closefd=False`` 参数。"