From e5a75bf0edf5f28bf998863e1ba8e0237b40b68a Mon Sep 17 00:00:00 2001 From: "github-actions[bot]" Date: Wed, 7 May 2025 00:16:39 +0000 Subject: [PATCH 1/5] sync with cpython 3f93295b --- using/cmdline.po | 322 +++++++++++++++++++++++------------------------ whatsnew/3.13.po | 9 +- 2 files changed, 166 insertions(+), 165 deletions(-) diff --git a/using/cmdline.po b/using/cmdline.po index 670d24139c..e2e5b79b5f 100644 --- a/using/cmdline.po +++ b/using/cmdline.po @@ -6,7 +6,7 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.13\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2025-04-09 00:15+0000\n" +"POT-Creation-Date: 2025-05-07 00:15+0000\n" "PO-Revision-Date: 2018-05-23 16:19+0000\n" "Last-Translator: Adrian Liaw \n" "Language-Team: Chinese - TAIWAN (https://github.com/python/python-docs-zh-" @@ -29,8 +29,8 @@ msgstr "" #: ../../using/cmdline.rst:16 msgid "" -"Other implementations' command line schemes may differ. " -"See :ref:`implementations` for further resources." +"Other implementations' command line schemes may differ. See :ref:" +"`implementations` for further resources." msgstr "" #: ../../using/cmdline.rst:23 @@ -124,9 +124,9 @@ msgstr "" #: ../../using/cmdline.rst:69 msgid "" "If this option is given, the first element of :data:`sys.argv` will be ``\"-" -"c\"`` and the current directory will be added to the start " -"of :data:`sys.path` (allowing modules in that directory to be imported as " -"top level modules)." +"c\"`` and the current directory will be added to the start of :data:`sys." +"path` (allowing modules in that directory to be imported as top level " +"modules)." msgstr "" #: ../../using/cmdline.rst:74 @@ -134,8 +134,8 @@ msgid "" "Raises an :ref:`auditing event ` ``cpython.run_command`` with " "argument ``command``." msgstr "" -"引發一個附帶引數 ``command`` 的\\ :ref:`稽核事件 ` " -"``cpython.run_command``。" +"引發一個附帶引數 ``command`` 的\\ :ref:`稽核事件 ` ``cpython." +"run_command``。" #: ../../using/cmdline.rst:78 msgid "" @@ -178,10 +178,9 @@ msgstr "" #: ../../using/cmdline.rst:105 msgid "" -":option:`-I` option can be used to run the script in isolated mode " -"where :data:`sys.path` contains neither the current directory nor the user's " -"site-packages directory. All ``PYTHON*`` environment variables are ignored, " -"too." +":option:`-I` option can be used to run the script in isolated mode where :" +"data:`sys.path` contains neither the current directory nor the user's site-" +"packages directory. All ``PYTHON*`` environment variables are ignored, too." msgstr "" #: ../../using/cmdline.rst:110 @@ -201,8 +200,8 @@ msgid "" "Raises an :ref:`auditing event ` ``cpython.run_module`` with " "argument ``module-name``." msgstr "" -"引發一個附帶引數 ``module-name`` 的\\ :ref:`稽核事件 ` " -"``cpython.run_module``。" +"引發一個附帶引數 ``module-name`` 的\\ :ref:`稽核事件 ` ``cpython." +"run_module``。" #: ../../using/cmdline.rst:119 msgid ":func:`runpy.run_module`" @@ -233,8 +232,8 @@ msgstr "" #: ../../using/cmdline.rst:137 msgid "" "If this option is given, the first element of :data:`sys.argv` will be ``\"-" -"\"`` and the current directory will be added to the start " -"of :data:`sys.path`." +"\"`` and the current directory will be added to the start of :data:`sys." +"path`." msgstr "" #: ../../using/cmdline.rst:141 ../../using/cmdline.rst:796 @@ -274,10 +273,9 @@ msgstr "" #: ../../using/cmdline.rst:163 msgid "" -":option:`-I` option can be used to run the script in isolated mode " -"where :data:`sys.path` contains neither the script's directory nor the " -"user's site-packages directory. All ``PYTHON*`` environment variables are " -"ignored, too." +":option:`-I` option can be used to run the script in isolated mode where :" +"data:`sys.path` contains neither the script's directory nor the user's site-" +"packages directory. All ``PYTHON*`` environment variables are ignored, too." msgstr "" #: ../../using/cmdline.rst:168 @@ -285,8 +283,8 @@ msgid "" "Raises an :ref:`auditing event ` ``cpython.run_file`` with " "argument ``filename``." msgstr "" -"引發一個附帶引數 ``filename`` 的\\ :ref:`稽核事件 ` " -"``cpython.run_file``。" +"引發一個附帶引數 ``filename`` 的\\ :ref:`稽核事件 ` ``cpython." +"run_file``。" #: ../../using/cmdline.rst:171 msgid ":func:`runpy.run_path`" @@ -363,11 +361,10 @@ msgstr "" #: ../../using/cmdline.rst:246 msgid "" -"Issue a warning when converting :class:`bytes` or :class:`bytearray` " -"to :class:`str` without specifying encoding or comparing :class:`!bytes` " -"or :class:`!bytearray` with :class:`!str` or :class:`!bytes` " -"with :class:`int`. Issue an error when the option is given twice (:option:`!-" -"bb`)." +"Issue a warning when converting :class:`bytes` or :class:`bytearray` to :" +"class:`str` without specifying encoding or comparing :class:`!bytes` or :" +"class:`!bytearray` with :class:`!str` or :class:`!bytes` with :class:`int`. " +"Issue an error when the option is given twice (:option:`!-bb`)." msgstr "" #: ../../using/cmdline.rst:251 @@ -399,8 +396,8 @@ msgstr "" #: ../../using/cmdline.rst:276 msgid "" -"Turn on parser debugging output (for expert only). See also " -"the :envvar:`PYTHONDEBUG` environment variable." +"Turn on parser debugging output (for expert only). See also the :envvar:" +"`PYTHONDEBUG` environment variable." msgstr "" #: ../../using/cmdline.rst:279 @@ -411,8 +408,8 @@ msgstr "" #: ../../using/cmdline.rst:285 msgid "" -"Ignore all ``PYTHON*`` environment variables, e.g. :envvar:`PYTHONPATH` " -"and :envvar:`PYTHONHOME`, that might be set." +"Ignore all ``PYTHON*`` environment variables, e.g. :envvar:`PYTHONPATH` and :" +"envvar:`PYTHONHOME`, that might be set." msgstr "" #: ../../using/cmdline.rst:288 @@ -469,10 +466,10 @@ msgstr "" #: ../../using/cmdline.rst:323 msgid "" -"Remove assert statements and any code conditional on the value " -"of :const:`__debug__`. Augment the filename for compiled (:term:`bytecode`) " -"files by adding ``.opt-1`` before the ``.pyc`` extension (see :pep:`488`). " -"See also :envvar:`PYTHONOPTIMIZE`." +"Remove assert statements and any code conditional on the value of :const:" +"`__debug__`. Augment the filename for compiled (:term:`bytecode`) files by " +"adding ``.opt-1`` before the ``.pyc`` extension (see :pep:`488`). See also :" +"envvar:`PYTHONOPTIMIZE`." msgstr "" #: ../../using/cmdline.rst:328 ../../using/cmdline.rst:338 @@ -521,9 +518,9 @@ msgstr "" #: ../../using/cmdline.rst:368 msgid "" -"Turn on hash randomization. This option only has an effect if " -"the :envvar:`PYTHONHASHSEED` environment variable is set to ``0``, since " -"hash randomization is enabled by default." +"Turn on hash randomization. This option only has an effect if the :envvar:" +"`PYTHONHASHSEED` environment variable is set to ``0``, since hash " +"randomization is enabled by default." msgstr "" #: ../../using/cmdline.rst:372 @@ -555,8 +552,8 @@ msgstr "" #: ../../using/cmdline.rst:394 msgid "" -"Don't add the :data:`user site-packages directory ` " -"to :data:`sys.path`." +"Don't add the :data:`user site-packages directory ` to :data:" +"`sys.path`." msgstr "" #: ../../using/cmdline.rst:397 @@ -572,8 +569,8 @@ msgstr "" msgid "" "Disable the import of the module :mod:`site` and the site-dependent " "manipulations of :data:`sys.path` that it entails. Also disable these " -"manipulations if :mod:`site` is explicitly imported later " -"(call :func:`site.main` if you want them to be triggered)." +"manipulations if :mod:`site` is explicitly imported later (call :func:`site." +"main` if you want them to be triggered)." msgstr "" #: ../../using/cmdline.rst:414 @@ -593,8 +590,8 @@ msgstr "" #: ../../using/cmdline.rst:425 msgid "" "Print a message each time a module is initialized, showing the place " -"(filename or built-in module) from which it is loaded. When given twice " -"(:option:`!-vv`), print a message for each file that is checked for when " +"(filename or built-in module) from which it is loaded. When given twice (:" +"option:`!-vv`), print a message for each file that is checked for when " "searching for a module. Also provides information on module cleanup at exit." msgstr "" @@ -689,17 +686,17 @@ msgstr "" #: ../../using/cmdline.rst:484 msgid "" "Multiple :option:`-W` options can be given; when a warning matches more than " -"one option, the action for the last matching option is performed. " -"Invalid :option:`-W` options are ignored (though, a warning message is " -"printed about invalid options when the first warning is issued)." +"one option, the action for the last matching option is performed. Invalid :" +"option:`-W` options are ignored (though, a warning message is printed about " +"invalid options when the first warning is issued)." msgstr "" #: ../../using/cmdline.rst:489 msgid "" "Warnings can also be controlled using the :envvar:`PYTHONWARNINGS` " -"environment variable and from within a Python program using " -"the :mod:`warnings` module. For example, the :func:`warnings.filterwarnings` " -"function can be used to use a regular expression on the warning message." +"environment variable and from within a Python program using the :mod:" +"`warnings` module. For example, the :func:`warnings.filterwarnings` function " +"can be used to use a regular expression on the warning message." msgstr "" #: ../../using/cmdline.rst:494 ../../using/cmdline.rst:933 @@ -722,8 +719,8 @@ msgstr "" #: ../../using/cmdline.rst:509 msgid "" -"``-X faulthandler`` to enable :mod:`faulthandler`. See " -"also :envvar:`PYTHONFAULTHANDLER`." +"``-X faulthandler`` to enable :mod:`faulthandler`. See also :envvar:" +"`PYTHONFAULTHANDLER`." msgstr "" #: ../../using/cmdline.rst:514 @@ -736,19 +733,18 @@ msgstr "" #: ../../using/cmdline.rst:521 msgid "" -"``-X tracemalloc`` to start tracing Python memory allocations using " -"the :mod:`tracemalloc` module. By default, only the most recent frame is " -"stored in a traceback of a trace. Use ``-X tracemalloc=NFRAME`` to start " -"tracing with a traceback limit of *NFRAME* frames. " -"See :func:`tracemalloc.start` and :envvar:`PYTHONTRACEMALLOC` for more " -"information." +"``-X tracemalloc`` to start tracing Python memory allocations using the :mod:" +"`tracemalloc` module. By default, only the most recent frame is stored in a " +"traceback of a trace. Use ``-X tracemalloc=NFRAME`` to start tracing with a " +"traceback limit of *NFRAME* frames. See :func:`tracemalloc.start` and :" +"envvar:`PYTHONTRACEMALLOC` for more information." msgstr "" #: ../../using/cmdline.rst:530 msgid "" "``-X int_max_str_digits`` configures the :ref:`integer string conversion " -"length limitation `. See " -"also :envvar:`PYTHONINTMAXSTRDIGITS`." +"length limitation `. See also :envvar:" +"`PYTHONINTMAXSTRDIGITS`." msgstr "" #: ../../using/cmdline.rst:536 @@ -777,15 +773,15 @@ msgstr "" #: ../../using/cmdline.rst:557 msgid "" "``-X pycache_prefix=PATH`` enables writing ``.pyc`` files to a parallel tree " -"rooted at the given directory instead of to the code tree. See " -"also :envvar:`PYTHONPYCACHEPREFIX`." +"rooted at the given directory instead of to the code tree. See also :envvar:" +"`PYTHONPYCACHEPREFIX`." msgstr "" #: ../../using/cmdline.rst:563 msgid "" "``-X warn_default_encoding`` issues a :class:`EncodingWarning` when the " -"locale-specific default encoding is used for opening files. See " -"also :envvar:`PYTHONWARNDEFAULTENCODING`." +"locale-specific default encoding is used for opening files. See also :envvar:" +"`PYTHONWARNDEFAULTENCODING`." msgstr "" #: ../../using/cmdline.rst:569 @@ -794,8 +790,8 @@ msgid "" "location information (end line, start column offset and end column offset) " "to every instruction in code objects. This is useful when smaller code " "objects and pyc files are desired as well as suppressing the extra visual " -"location indicators when the interpreter displays tracebacks. See " -"also :envvar:`PYTHONNODEBUGRANGES`." +"location indicators when the interpreter displays tracebacks. See also :" +"envvar:`PYTHONNODEBUGRANGES`." msgstr "" #: ../../using/cmdline.rst:578 @@ -806,8 +802,8 @@ msgid "" "installed Python (the normal case). If it's under development (running from " "the source tree) then the default is ``off``. Note that the :mod:`!" "importlib_bootstrap` and :mod:`!importlib_bootstrap_external` frozen modules " -"are always used, even if this flag is set to ``off``. See " -"also :envvar:`PYTHON_FROZEN_MODULES`." +"are always used, even if this flag is set to ``off``. See also :envvar:" +"`PYTHON_FROZEN_MODULES`." msgstr "" #: ../../using/cmdline.rst:589 @@ -825,26 +821,25 @@ msgid "" "support. When this option is provided, the ``perf`` profiler will be able to " "report Python calls using DWARF information. This option is only available " "on some platforms and will do nothing if is not supported on the current " -"system. The default value is \"off\". See " -"also :envvar:`PYTHON_PERF_JIT_SUPPORT` and :ref:`perf_profiling`." +"system. The default value is \"off\". See also :envvar:" +"`PYTHON_PERF_JIT_SUPPORT` and :ref:`perf_profiling`." msgstr "" #: ../../using/cmdline.rst:606 msgid "" -":samp:`-X cpu_count={n}` " -"overrides :func:`os.cpu_count`, :func:`os.process_cpu_count`, " -"and :func:`multiprocessing.cpu_count`. *n* must be greater than or equal to " -"1. This option may be useful for users who need to limit CPU resources of a " -"container system. See also :envvar:`PYTHON_CPU_COUNT`. If *n* is " -"``default``, nothing is overridden." +":samp:`-X cpu_count={n}` overrides :func:`os.cpu_count`, :func:`os." +"process_cpu_count`, and :func:`multiprocessing.cpu_count`. *n* must be " +"greater than or equal to 1. This option may be useful for users who need to " +"limit CPU resources of a container system. See also :envvar:" +"`PYTHON_CPU_COUNT`. If *n* is ``default``, nothing is overridden." msgstr "" #: ../../using/cmdline.rst:615 msgid "" ":samp:`-X presite={package.module}` specifies a module that should be " -"imported before the :mod:`site` module is executed and before " -"the :mod:`__main__` module exists. Therefore, the imported module " -"isn't :mod:`__main__`. This can be used to execute code early during Python " +"imported before the :mod:`site` module is executed and before the :mod:" +"`__main__` module exists. Therefore, the imported module isn't :mod:" +"`__main__`. This can be used to execute code early during Python " "initialization. Python needs to be :ref:`built in debug mode ` " "for this option to exist. See also :envvar:`PYTHON_PRESITE`." msgstr "" @@ -859,8 +854,8 @@ msgstr "" #: ../../using/cmdline.rst:631 msgid "" -"It also allows passing arbitrary values and retrieving them through " -"the :data:`sys._xoptions` dictionary." +"It also allows passing arbitrary values and retrieving them through the :" +"data:`sys._xoptions` dictionary." msgstr "" #: ../../using/cmdline.rst:636 @@ -932,10 +927,10 @@ msgstr "" #: ../../using/cmdline.rst:696 msgid "" "Change the location of the standard Python libraries. By default, the " -"libraries are searched in :file:`{prefix}/lib/python{version}` " -"and :file:`{exec_prefix}/lib/python{version}`, where :file:`{prefix}` " -"and :file:`{exec_prefix}` are installation-dependent directories, both " -"defaulting to :file:`/usr/local`." +"libraries are searched in :file:`{prefix}/lib/python{version}` and :file:" +"`{exec_prefix}/lib/python{version}`, where :file:`{prefix}` and :file:" +"`{exec_prefix}` are installation-dependent directories, both defaulting to :" +"file:`/usr/local`." msgstr "" #: ../../using/cmdline.rst:702 @@ -948,8 +943,8 @@ msgstr "" #: ../../using/cmdline.rst:709 msgid "" "Augment the default search path for module files. The format is the same as " -"the shell's :envvar:`PATH`: one or more directory pathnames separated " -"by :data:`os.pathsep` (e.g. colons on Unix or semicolons on Windows). Non-" +"the shell's :envvar:`PATH`: one or more directory pathnames separated by :" +"data:`os.pathsep` (e.g. colons on Unix or semicolons on Windows). Non-" "existent directories are silently ignored." msgstr "" @@ -969,8 +964,8 @@ msgstr "" #: ../../using/cmdline.rst:722 msgid "" -"An additional directory will be inserted in the search path in front " -"of :envvar:`PYTHONPATH` as described above under :ref:`using-on-interface-" +"An additional directory will be inserted in the search path in front of :" +"envvar:`PYTHONPATH` as described above under :ref:`using-on-interface-" "options`. The search path can be manipulated from within a Python program as " "the variable :data:`sys.path`." msgstr "" @@ -983,8 +978,8 @@ msgstr "" #: ../../using/cmdline.rst:738 msgid "" -"If this is set to a non-empty string, it overrides " -"the :data:`sys.platlibdir` value." +"If this is set to a non-empty string, it overrides the :data:`sys." +"platlibdir` value." msgstr "" #: ../../using/cmdline.rst:746 @@ -1008,9 +1003,9 @@ msgstr "" #: ../../using/cmdline.rst:761 msgid "" -"If this is set to a non-empty string it is equivalent to specifying " -"the :option:`-O` option. If set to an integer, it is equivalent to " -"specifying :option:`-O` multiple times." +"If this is set to a non-empty string it is equivalent to specifying the :" +"option:`-O` option. If set to an integer, it is equivalent to specifying :" +"option:`-O` multiple times." msgstr "" #: ../../using/cmdline.rst:768 @@ -1020,15 +1015,15 @@ msgid "" "by the default implementation of :func:`sys.breakpointhook` which itself is " "called by built-in :func:`breakpoint`. If not set, or set to the empty " "string, it is equivalent to the value \"pdb.set_trace\". Setting this to " -"the string \"0\" causes the default implementation " -"of :func:`sys.breakpointhook` to do nothing but return immediately." +"the string \"0\" causes the default implementation of :func:`sys." +"breakpointhook` to do nothing but return immediately." msgstr "" #: ../../using/cmdline.rst:780 msgid "" -"If this is set to a non-empty string it is equivalent to specifying " -"the :option:`-d` option. If set to an integer, it is equivalent to " -"specifying :option:`-d` multiple times." +"If this is set to a non-empty string it is equivalent to specifying the :" +"option:`-d` option. If set to an integer, it is equivalent to specifying :" +"option:`-d` multiple times." msgstr "" #: ../../using/cmdline.rst:784 @@ -1039,8 +1034,8 @@ msgstr "" #: ../../using/cmdline.rst:790 msgid "" -"If this is set to a non-empty string it is equivalent to specifying " -"the :option:`-i` option." +"If this is set to a non-empty string it is equivalent to specifying the :" +"option:`-i` option." msgstr "" #: ../../using/cmdline.rst:793 @@ -1061,15 +1056,15 @@ msgstr "" #: ../../using/cmdline.rst:808 msgid "" -"If this is set to a non-empty string it is equivalent to specifying " -"the :option:`-u` option." +"If this is set to a non-empty string it is equivalent to specifying the :" +"option:`-u` option." msgstr "" #: ../../using/cmdline.rst:814 msgid "" -"If this is set to a non-empty string it is equivalent to specifying " -"the :option:`-v` option. If set to an integer, it is equivalent to " -"specifying :option:`-v` multiple times." +"If this is set to a non-empty string it is equivalent to specifying the :" +"option:`-v` option. If set to an integer, it is equivalent to specifying :" +"option:`-v` multiple times." msgstr "" #: ../../using/cmdline.rst:821 @@ -1161,8 +1156,8 @@ msgstr "" #: ../../using/cmdline.rst:898 msgid "" "Defines the :data:`user base directory `, which is used to " -"compute the path of the :data:`user site-packages directory " -"` and :ref:`installation paths ` for " +"compute the path of the :data:`user site-packages directory ` and :ref:`installation paths ` for " "``python -m pip install --user``." msgstr "" @@ -1192,11 +1187,11 @@ msgstr "" #: ../../using/cmdline.rst:939 msgid "" -"If this environment variable is set to a non-empty " -"string, :func:`faulthandler.enable` is called at startup: install a handler " -"for :const:`~signal.SIGSEGV`, :const:`~signal.SIGFPE`, :const:`~signal.SIGABRT`, :const:`~signal.SIGBUS` " -"and :const:`~signal.SIGILL` signals to dump the Python traceback. This is " -"equivalent to :option:`-X` ``faulthandler`` option." +"If this environment variable is set to a non-empty string, :func:" +"`faulthandler.enable` is called at startup: install a handler for :const:" +"`~signal.SIGSEGV`, :const:`~signal.SIGFPE`, :const:`~signal.SIGABRT`, :const:" +"`~signal.SIGBUS` and :const:`~signal.SIGILL` signals to dump the Python " +"traceback. This is equivalent to :option:`-X` ``faulthandler`` option." msgstr "" #: ../../using/cmdline.rst:951 @@ -1218,8 +1213,8 @@ msgstr "" #: ../../using/cmdline.rst:973 msgid "" -"If this environment variable is set to a non-empty string, enable " -"the :ref:`debug mode ` of the :mod:`asyncio` module." +"If this environment variable is set to a non-empty string, enable the :ref:" +"`debug mode ` of the :mod:`asyncio` module." msgstr "" #: ../../using/cmdline.rst:981 @@ -1239,22 +1234,22 @@ msgstr "" #: ../../using/cmdline.rst:987 msgid "" "``malloc``: use the :c:func:`malloc` function of the C library for all " -"domains " -"(:c:macro:`PYMEM_DOMAIN_RAW`, :c:macro:`PYMEM_DOMAIN_MEM`, :c:macro:`PYMEM_DOMAIN_OBJ`)." +"domains (:c:macro:`PYMEM_DOMAIN_RAW`, :c:macro:`PYMEM_DOMAIN_MEM`, :c:macro:" +"`PYMEM_DOMAIN_OBJ`)." msgstr "" #: ../../using/cmdline.rst:990 msgid "" -"``pymalloc``: use the :ref:`pymalloc allocator ` " -"for :c:macro:`PYMEM_DOMAIN_MEM` and :c:macro:`PYMEM_DOMAIN_OBJ` domains and " -"use the :c:func:`malloc` function for the :c:macro:`PYMEM_DOMAIN_RAW` domain." +"``pymalloc``: use the :ref:`pymalloc allocator ` for :c:macro:" +"`PYMEM_DOMAIN_MEM` and :c:macro:`PYMEM_DOMAIN_OBJ` domains and use the :c:" +"func:`malloc` function for the :c:macro:`PYMEM_DOMAIN_RAW` domain." msgstr "" #: ../../using/cmdline.rst:993 msgid "" -"``mimalloc``: use the :ref:`mimalloc allocator ` " -"for :c:macro:`PYMEM_DOMAIN_MEM` and :c:macro:`PYMEM_DOMAIN_OBJ` domains and " -"use the :c:func:`malloc` function for the :c:macro:`PYMEM_DOMAIN_RAW` domain." +"``mimalloc``: use the :ref:`mimalloc allocator ` for :c:macro:" +"`PYMEM_DOMAIN_MEM` and :c:macro:`PYMEM_DOMAIN_OBJ` domains and use the :c:" +"func:`malloc` function for the :c:macro:`PYMEM_DOMAIN_RAW` domain." msgstr "" #: ../../using/cmdline.rst:997 @@ -1285,9 +1280,9 @@ msgstr "" #: ../../using/cmdline.rst:1013 msgid "" -"If set to a non-empty string, Python will print statistics of " -"the :ref:`pymalloc memory allocator ` every time a new pymalloc " -"object arena is created, and on shutdown." +"If set to a non-empty string, Python will print statistics of the :ref:" +"`pymalloc memory allocator ` every time a new pymalloc object " +"arena is created, and on shutdown." msgstr "" #: ../../using/cmdline.rst:1017 @@ -1313,8 +1308,8 @@ msgstr "" #: ../../using/cmdline.rst:1033 msgid "" -"This may also be enabled at runtime " -"with :func:`sys._enablelegacywindowsfsencoding`." +"This may also be enabled at runtime with :func:`sys." +"_enablelegacywindowsfsencoding`." msgstr "" #: ../../using/cmdline.rst:1036 ../../using/cmdline.rst:1050 @@ -1385,12 +1380,11 @@ msgstr "" #: ../../using/cmdline.rst:1083 msgid "" "Configuring one of these locales (either explicitly or via the above " -"implicit locale coercion) automatically enables the " -"``surrogateescape`` :ref:`error handler ` " -"for :data:`sys.stdin` and :data:`sys.stdout` (:data:`sys.stderr` continues " -"to use ``backslashreplace`` as it does in any other locale). This stream " -"handling behavior can be overridden using :envvar:`PYTHONIOENCODING` as " -"usual." +"implicit locale coercion) automatically enables the ``surrogateescape`` :ref:" +"`error handler ` for :data:`sys.stdin` and :data:`sys." +"stdout` (:data:`sys.stderr` continues to use ``backslashreplace`` as it does " +"in any other locale). This stream handling behavior can be overridden using :" +"envvar:`PYTHONIOENCODING` as usual." msgstr "" #: ../../using/cmdline.rst:1090 @@ -1416,10 +1410,10 @@ msgstr "更多細節請見 :pep:`538`。" #: ../../using/cmdline.rst:1109 msgid "" -"If this environment variable is set to a non-empty string, " -"enable :ref:`Python Development Mode `, introducing additional " -"runtime checks that are too expensive to be enabled by default. This is " -"equivalent to setting the :option:`-X` ``dev`` option." +"If this environment variable is set to a non-empty string, enable :ref:" +"`Python Development Mode `, introducing additional runtime checks " +"that are too expensive to be enabled by default. This is equivalent to " +"setting the :option:`-X` ``dev`` option." msgstr "" #: ../../using/cmdline.rst:1118 @@ -1438,8 +1432,8 @@ msgstr "" #: ../../using/cmdline.rst:1129 msgid "" -"If this environment variable is set to a non-empty string, issue " -"a :class:`EncodingWarning` when the locale-specific default encoding is used." +"If this environment variable is set to a non-empty string, issue a :class:" +"`EncodingWarning` when the locale-specific default encoding is used." msgstr "" #: ../../using/cmdline.rst:1132 @@ -1467,8 +1461,8 @@ msgstr "" #: ../../using/cmdline.rst:1153 msgid "" -"See also the :option:`-X perf <-X>` command-line option " -"and :ref:`perf_profiling`." +"See also the :option:`-X perf <-X>` command-line option and :ref:" +"`perf_profiling`." msgstr "" #: ../../using/cmdline.rst:1160 @@ -1480,8 +1474,8 @@ msgstr "" #: ../../using/cmdline.rst:1166 msgid "" -"See also the :option:`-X perf_jit <-X>` command-line option " -"and :ref:`perf_profiling`." +"See also the :option:`-X perf_jit <-X>` command-line option and :ref:" +"`perf_profiling`." msgstr "" #: ../../using/cmdline.rst:1175 @@ -1512,23 +1506,22 @@ msgstr "另請參閱 :option:`-X frozen_modules <-X>` 命令列選項。" #: ../../using/cmdline.rst:1198 msgid "" "If this variable is set to ``1``, the interpreter will colorize various " -"kinds of output. Setting it to ``0`` deactivates this behavior. See " -"also :ref:`using-on-controlling-color`." +"kinds of output. Setting it to ``0`` deactivates this behavior. See also :" +"ref:`using-on-controlling-color`." msgstr "" #: ../../using/cmdline.rst:1206 msgid "" "If this variable is set to any value, the interpreter will not attempt to " -"load the Python-based :term:`REPL` that requires :mod:`curses` " -"and :mod:`readline`, and will instead use the traditional parser-" -"based :term:`REPL`." +"load the Python-based :term:`REPL` that requires :mod:`curses` and :mod:" +"`readline`, and will instead use the traditional parser-based :term:`REPL`." msgstr "" #: ../../using/cmdline.rst:1215 msgid "" -"This environment variable can be used to set the location of a " -"``.python_history`` file (by default, it is ``.python_history`` in the " -"user's home directory)." +"This environment variable can be used to set the location of a ``." +"python_history`` file (by default, it is ``.python_history`` in the user's " +"home directory)." msgstr "" #: ../../using/cmdline.rst:1223 @@ -1544,29 +1537,36 @@ msgid "" "precedence over this variable, and :ref:`whatsnew313-free-threaded-cpython`." msgstr "" -#: ../../using/cmdline.rst:1233 +#: ../../using/cmdline.rst:1234 +msgid "" +"On builds where experimental just-in-time compilation is available, this " +"variable can force the JIT to be disabled (``0``) or enabled (``1``) at " +"interpreter startup." +msgstr "" + +#: ../../using/cmdline.rst:1241 msgid "Debug-mode variables" msgstr "除錯模式變數" -#: ../../using/cmdline.rst:1237 +#: ../../using/cmdline.rst:1245 msgid "" "If set, Python will dump objects and reference counts still alive after " "shutting down the interpreter." msgstr "" -#: ../../using/cmdline.rst:1240 ../../using/cmdline.rst:1248 +#: ../../using/cmdline.rst:1248 ../../using/cmdline.rst:1256 msgid "" "Needs Python configured with the :option:`--with-trace-refs` build option." msgstr "" -#: ../../using/cmdline.rst:1244 +#: ../../using/cmdline.rst:1252 msgid "" "If set, Python will dump objects and reference counts still alive after " "shutting down the interpreter into a file under the path given as the value " "to this environment variable." msgstr "" -#: ../../using/cmdline.rst:1254 +#: ../../using/cmdline.rst:1262 msgid "" "If this variable is set to a module, that module will be imported early in " "the interpreter lifecycle, before the :mod:`site` module is executed, and " @@ -1574,22 +1574,22 @@ msgid "" "is not treated as :mod:`__main__`." msgstr "" -#: ../../using/cmdline.rst:1259 +#: ../../using/cmdline.rst:1267 msgid "This can be used to execute code early during Python initialization." msgstr "" -#: ../../using/cmdline.rst:1261 +#: ../../using/cmdline.rst:1269 msgid "" "To import a submodule, use ``package.module`` as the value, like in an " "import statement." msgstr "" -#: ../../using/cmdline.rst:1264 +#: ../../using/cmdline.rst:1272 msgid "" "See also the :option:`-X presite <-X>` command-line option, which takes " "precedence over this variable." msgstr "" -#: ../../using/cmdline.rst:1267 +#: ../../using/cmdline.rst:1275 msgid "Needs Python configured with the :option:`--with-pydebug` build option." msgstr "" diff --git a/whatsnew/3.13.po b/whatsnew/3.13.po index 008d810fdb..00b971f26a 100644 --- a/whatsnew/3.13.po +++ b/whatsnew/3.13.po @@ -6,7 +6,7 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.13\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2025-04-30 00:15+0000\n" +"POT-Creation-Date: 2025-05-07 00:15+0000\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language-Team: Chinese - TAIWAN (https://github.com/python/python-docs-zh-" @@ -620,19 +620,20 @@ msgstr "" #: ../../whatsnew/3.13.rst:392 msgid "" "``yes``: Enable the JIT. To disable the JIT at runtime, pass the environment " -"variable ``PYTHON_JIT=0``." +"variable :envvar:`PYTHON_JIT=0 `." msgstr "" #: ../../whatsnew/3.13.rst:394 msgid "" "``yes-off``: Build the JIT but disable it by default. To enable the JIT at " -"runtime, pass the environment variable ``PYTHON_JIT=1``." +"runtime, pass the environment variable :envvar:`PYTHON_JIT=1 `." msgstr "" #: ../../whatsnew/3.13.rst:396 msgid "" "``interpreter``: Enable the Tier 2 interpreter but disable the JIT. The " -"interpreter can be disabled by running with ``PYTHON_JIT=0``." +"interpreter can be disabled by running with :envvar:`PYTHON_JIT=0 " +"`." msgstr "" #: ../../whatsnew/3.13.rst:399 From 5fabd3239b7deedbf6dd41b1feb1e022834d3f04 Mon Sep 17 00:00:00 2001 From: "github-actions[bot]" Date: Thu, 8 May 2025 00:16:55 +0000 Subject: [PATCH 2/5] sync with cpython 6beec6c8 --- library/html.parser.po | 151 ++-- library/stdtypes.po | 1592 ++++++++++++++++++++-------------------- 2 files changed, 871 insertions(+), 872 deletions(-) diff --git a/library/html.parser.po b/library/html.parser.po index e557e6025b..6be3945398 100644 --- a/library/html.parser.po +++ b/library/html.parser.po @@ -7,7 +7,7 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.13\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2024-09-03 11:11+0800\n" +"POT-Creation-Date: 2025-05-08 00:15+0000\n" "PO-Revision-Date: 2023-05-04 22:54+0800\n" "Last-Translator: Matt Wang \n" "Language-Team: Chinese - TAIWAN (https://github.com/python/python-docs-zh-" @@ -82,10 +82,11 @@ msgid "Example HTML Parser Application" msgstr "HTML 剖析器應用程式範例" #: ../../library/html.parser.rst:44 +#, fuzzy msgid "" "As a basic example, below is a simple HTML parser that uses the :class:" "`HTMLParser` class to print out start tags, end tags, and data as they are " -"encountered::" +"encountered:" msgstr "" "以下的基礎範例是一個簡單的 HTML 剖析器，它使用 :class:`HTMLParser` 類別，當遇" "到開始標籤、結束標籤和資料時將它們印出： ::" @@ -124,11 +125,11 @@ msgstr "" "parser.feed('Test'\n" " '

Parse me!

')" -#: ../../library/html.parser.rst:64 +#: ../../library/html.parser.rst:66 msgid "The output will then be:" msgstr "輸出將是：" -#: ../../library/html.parser.rst:66 +#: ../../library/html.parser.rst:68 msgid "" "Encountered a start tag: html\n" "Encountered a start tag: head\n" @@ -156,15 +157,15 @@ msgstr "" "Encountered an end tag : body\n" "Encountered an end tag : html" -#: ../../library/html.parser.rst:83 +#: ../../library/html.parser.rst:85 msgid ":class:`.HTMLParser` Methods" msgstr ":class:`.HTMLParser` 方法" -#: ../../library/html.parser.rst:85 +#: ../../library/html.parser.rst:87 msgid ":class:`HTMLParser` instances have the following methods:" msgstr ":class:`HTMLParser` 實例具有以下方法：" -#: ../../library/html.parser.rst:90 +#: ../../library/html.parser.rst:92 msgid "" "Feed some text to the parser. It is processed insofar as it consists of " "complete elements; incomplete data is buffered until more data is fed or :" @@ -173,7 +174,7 @@ msgstr "" "向剖析器提供一些文本。只要它由完整的元素組成，它就會被處理；不完整的資料會被" "緩衝，直到輸入更多資料或呼叫 :meth:`close`。 *data* 必須是 :class:`str`。" -#: ../../library/html.parser.rst:97 +#: ../../library/html.parser.rst:99 msgid "" "Force processing of all buffered data as if it were followed by an end-of-" "file mark. This method may be redefined by a derived class to define " @@ -184,17 +185,17 @@ msgstr "" "重新定義，以在輸入末尾定義額外的處理，但重新定義的版本仍應要呼叫 :class:" "`HTMLParser` 基底類別方法 :meth:`close`。" -#: ../../library/html.parser.rst:105 +#: ../../library/html.parser.rst:107 msgid "" "Reset the instance. Loses all unprocessed data. This is called implicitly " "at instantiation time." msgstr "重置實例。丟棄所有未處理的資料。這在實例化時被會隱晦地呼叫。" -#: ../../library/html.parser.rst:111 +#: ../../library/html.parser.rst:113 msgid "Return current line number and offset." msgstr "回傳目前列號 (line number) 和偏移量 (offset)。" -#: ../../library/html.parser.rst:116 +#: ../../library/html.parser.rst:118 msgid "" "Return the text of the most recently opened start tag. This should not " "normally be needed for structured processing, but may be useful in dealing " @@ -205,7 +206,7 @@ msgstr "" "「已部署」的 HTML 或以最少的更改重新生成輸入（可以保留屬性之間的空白等）時可" "能很有用。" -#: ../../library/html.parser.rst:122 +#: ../../library/html.parser.rst:124 msgid "" "The following methods are called when data or markup elements are " "encountered and they are meant to be overridden in a subclass. The base " @@ -215,13 +216,13 @@ msgstr "" "當遇到資料或標記元素時將呼叫以下方法，並且它們應在子類別中被覆蓋。基底類別實" "作什麼都不做（除了 :meth:`~HTMLParser.handle_startendtag`）：" -#: ../../library/html.parser.rst:129 +#: ../../library/html.parser.rst:131 msgid "" "This method is called to handle the start tag of an element (e.g. ``
``)." msgstr "呼叫此方法來處理元素的開始標籤（例如 ``
``）。" -#: ../../library/html.parser.rst:131 +#: ../../library/html.parser.rst:133 msgid "" "The *tag* argument is the name of the tag converted to lower case. The " "*attrs* argument is a list of ``(name, value)`` pairs containing the " @@ -233,7 +234,7 @@ msgstr "" "列表，包含在標籤的 ``<>`` 括號內找到的屬性。 *name* 將被轉成小寫，*value* 中" "的引號會被刪除，字元和實體參照也會被替換。" -#: ../../library/html.parser.rst:137 +#: ../../library/html.parser.rst:139 msgid "" "For instance, for the tag ````, this method " "would be called as ``handle_starttag('a', [('href', 'https://www.cwi." @@ -242,22 +243,22 @@ msgstr "" "例如，對於標籤 ````，這個方法會以 " "``handle_starttag('a', [('href', 'https://www.cwi.nl/')])`` 的形式被呼叫。" -#: ../../library/html.parser.rst:140 +#: ../../library/html.parser.rst:142 msgid "" "All entity references from :mod:`html.entities` are replaced in the " "attribute values." msgstr "在屬性值中來自 :mod:`html.entities` 的所有實體參照都會被替換。" -#: ../../library/html.parser.rst:146 +#: ../../library/html.parser.rst:148 msgid "" "This method is called to handle the end tag of an element (e.g. ``
``)." msgstr "呼叫此方法來處理元素的結束標籤（例如 ``
``）。" -#: ../../library/html.parser.rst:148 +#: ../../library/html.parser.rst:150 msgid "The *tag* argument is the name of the tag converted to lower case." msgstr "*tag* 引數是轉換為小寫的標籤名稱。" -#: ../../library/html.parser.rst:153 +#: ../../library/html.parser.rst:155 msgid "" "Similar to :meth:`handle_starttag`, but called when the parser encounters an " "XHTML-style empty tag (````). This method may be overridden by " @@ -270,7 +271,7 @@ msgstr "" "information) 的子類別覆蓋；預設實作只是呼叫 :meth:`handle_starttag` 和 :meth:" "`handle_endtag`。" -#: ../../library/html.parser.rst:161 +#: ../../library/html.parser.rst:163 msgid "" "This method is called to process arbitrary data (e.g. text nodes and the " "content of ```` and ````)." @@ -278,7 +279,7 @@ msgstr "" "呼叫此方法來處理任意資料（例如文本節點與 ```` 和 " "```` 的內容）。" -#: ../../library/html.parser.rst:167 +#: ../../library/html.parser.rst:169 msgid "" "This method is called to process a named character reference of the form " "``&name;`` (e.g. ``>``), where *name* is a general entity reference (e.g. " @@ -288,7 +289,7 @@ msgstr "" "*name* 是一般實體參照（例如 ``'gt'``）。如果 *convert_charrefs* 為 ``True``，" "則永遠不會呼叫此方法。" -#: ../../library/html.parser.rst:175 +#: ../../library/html.parser.rst:177 msgid "" "This method is called to process decimal and hexadecimal numeric character " "references of the form :samp:`&#{NNN};` and :samp:`&#x{NNN};`. For example, " @@ -301,13 +302,13 @@ msgstr "" "``；在這種情況下，該方法將收到 ``'62'`` 或 ``'x3E'``。如果 " "*convert_charrefs* 為 ``True``，則永遠不會呼叫此方法。" -#: ../../library/html.parser.rst:184 +#: ../../library/html.parser.rst:186 msgid "" "This method is called when a comment is encountered (e.g. ````）。" -#: ../../library/html.parser.rst:186 +#: ../../library/html.parser.rst:188 msgid "" "For example, the comment ```` will cause this method to be " "called with the argument ``' comment '``." @@ -315,7 +316,7 @@ msgstr "" "舉例來說，註解 ```` 會使得此方法被以引數 ``' comment '`` 來呼" "叫。" -#: ../../library/html.parser.rst:189 +#: ../../library/html.parser.rst:191 msgid "" "The content of Internet Explorer conditional comments (condcoms) will also " "be sent to this method, so, for ```` 為例，" "這個方法將會收到 ``'[if IE 9]>IE9-specific content``)." @@ -334,7 +335,7 @@ msgstr "" "呼叫此方法來處理 HTML 文件類型聲明 (doctype declaration)（例如 ````）。" -#: ../../library/html.parser.rst:199 +#: ../../library/html.parser.rst:201 msgid "" "The *decl* parameter will be the entire contents of the declaration inside " "the ```` markup (e.g. ``'DOCTYPE html'``)." @@ -342,7 +343,7 @@ msgstr "" "*decl* 參數將是 ```` 標記內聲明部分的全部內容（例如 ``'DOCTYPE " "html'``）。" -#: ../../library/html.parser.rst:205 +#: ../../library/html.parser.rst:207 msgid "" "Method called when a processing instruction is encountered. The *data* " "parameter will contain the entire processing instruction. For example, for " @@ -355,7 +356,7 @@ msgstr "" "``handle_pi(\"proc color='red'\")`` 形式被呼叫。它旨在被衍生類別覆蓋；基底類" "別實作中什麼都不做。" -#: ../../library/html.parser.rst:213 +#: ../../library/html.parser.rst:215 msgid "" "The :class:`HTMLParser` class uses the SGML syntactic rules for processing " "instructions. An XHTML processing instruction using the trailing ``'?'`` " @@ -364,12 +365,12 @@ msgstr "" ":class:`HTMLParser` 類別使用 SGML 語法規則來處理指示。使用有 ``?`` 跟隨在後面" "的 XHTML 處理指示將導致 ``?`` 被包含在 *data* 中。" -#: ../../library/html.parser.rst:220 +#: ../../library/html.parser.rst:222 msgid "" "This method is called when an unrecognized declaration is read by the parser." msgstr "當剖析器讀取無法識別的聲明時會呼叫此方法。" -#: ../../library/html.parser.rst:222 +#: ../../library/html.parser.rst:224 msgid "" "The *data* parameter will be the entire contents of the declaration inside " "the ```` markup. It is sometimes useful to be overridden by a " @@ -378,17 +379,18 @@ msgstr "" "*data* 參數將是 ```` 標記內聲明的全部內容。有時被衍生類別被覆蓋會是好" "用的。在基底類別實作中什麼都不做。" -#: ../../library/html.parser.rst:230 +#: ../../library/html.parser.rst:232 msgid "Examples" msgstr "範例" -#: ../../library/html.parser.rst:232 +#: ../../library/html.parser.rst:234 +#, fuzzy msgid "" "The following class implements a parser that will be used to illustrate more " -"examples::" +"examples:" msgstr "以下類別實作了一個剖析器，將用於解說更多範例： ::" -#: ../../library/html.parser.rst:235 +#: ../../library/html.parser.rst:237 msgid "" "from html.parser import HTMLParser\n" "from html.entities import name2codepoint\n" @@ -458,11 +460,12 @@ msgstr "" "\n" "parser = MyHTMLParser()" -#: ../../library/html.parser.rst:269 -msgid "Parsing a doctype::" +#: ../../library/html.parser.rst:273 +#, fuzzy +msgid "Parsing a doctype:" msgstr "剖析文件類型： ::" -#: ../../library/html.parser.rst:271 +#: ../../library/html.parser.rst:275 msgid "" ">>> parser.feed('')\n" @@ -474,11 +477,12 @@ msgstr "" "Decl : DOCTYPE HTML PUBLIC \"-//W3C//DTD HTML 4.01//EN\" \"http://www.w3." "org/TR/html4/strict.dtd\"" -#: ../../library/html.parser.rst:275 -msgid "Parsing an element with a few attributes and a title::" +#: ../../library/html.parser.rst:281 +#, fuzzy +msgid "Parsing an element with a few attributes and a title:" msgstr "剖析一個具有一些屬性和標題的元素： ::" -#: ../../library/html.parser.rst:277 +#: ../../library/html.parser.rst:283 msgid "" ">>> parser.feed('\"The')\n" "Start tag: img\n" @@ -500,13 +504,14 @@ msgstr "" "Data : Python\n" "End tag : h1" -#: ../../library/html.parser.rst:287 +#: ../../library/html.parser.rst:295 +#, fuzzy msgid "" "The content of ``script`` and ``style`` elements is returned as is, without " -"further parsing::" +"further parsing:" msgstr "``script`` 和 ``style`` 元素的內容按原樣回傳，無需進一步剖析： ::" -#: ../../library/html.parser.rst:290 +#: ../../library/html.parser.rst:298 msgid "" ">>> parser.feed('