sync with cpython 04466286

github-actions[bot] · web-flow · commit 90a0a4e6dd6f · 2025-06-02T00:17:54.000Z
diff --git a/library/compileall.po b/library/compileall.po
@@ -7,7 +7,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-06-02 00:16+0000\n"
 "PO-Revision-Date: 2018-05-23 14:41+0000\n"
 "Last-Translator: Adrian Liaw <adrianliaw2000@gmail.com>\n"
 "Language-Team: Chinese - TAIWAN (https://github.com/python/python-docs-zh-"
@@ -89,48 +89,62 @@ msgid ""
 "executed."
 msgstr ""
 
-#: ../../library/compileall.rst:61
+#: ../../library/compileall.rst:60
 msgid ""
-"Remove (``-s``) or append (``-p``) the given prefix of paths recorded in the "
-"``.pyc`` files. Cannot be combined with ``-d``."
+"Remove the given prefix from paths recorded in the ``.pyc`` files. Paths are "
+"made relative to the prefix."
+msgstr ""
+
+#: ../../library/compileall.rst:63
+msgid "This option can be used with ``-p`` but not with ``-d``."
 msgstr ""
 
 #: ../../library/compileall.rst:67
 msgid ""
+"Prepend the given prefix to paths recorded in the ``.pyc`` files. Use ``-p /"
+"`` to make the paths absolute."
+msgstr ""
+
+#: ../../library/compileall.rst:70
+msgid "This option can be used with ``-s`` but not with ``-d``."
+msgstr ""
+
+#: ../../library/compileall.rst:74
+msgid ""
 "regex is used to search the full path to each file considered for "
 "compilation, and if the regex produces a match, the file is skipped."
 msgstr ""
 
-#: ../../library/compileall.rst:72
+#: ../../library/compileall.rst:79
 msgid ""
 "Read the file ``list`` and add each line that it contains to the list of "
 "files and directories to compile.  If ``list`` is ``-``, read lines from "
 "``stdin``."
 msgstr ""
 
-#: ../../library/compileall.rst:78
+#: ../../library/compileall.rst:85
 msgid ""
 "Write the byte-code files to their legacy locations and names, which may "
 "overwrite byte-code files created by another version of Python.  The default "
 "is to write files to their :pep:`3147` locations and names, which allows "
 "byte-code files from multiple versions of Python to coexist."
 msgstr ""
 
-#: ../../library/compileall.rst:85
+#: ../../library/compileall.rst:92
 msgid ""
 "Control the maximum recursion level for subdirectories. If this is given, "
 "then ``-l`` option will not be taken into account. :program:`python -m "
 "compileall <directory> -r 0` is equivalent to :program:`python -m compileall "
 "<directory> -l`."
 msgstr ""
 
-#: ../../library/compileall.rst:92
+#: ../../library/compileall.rst:99
 msgid ""
 "Use *N* workers to compile the files within the given directory. If ``0`` is "
 "used, then the result of :func:`os.process_cpu_count` will be used."
 msgstr ""
 
-#: ../../library/compileall.rst:98
+#: ../../library/compileall.rst:105
 msgid ""
 "Control how the generated byte-code files are invalidated at runtime. The "
 "``timestamp`` value, means that ``.pyc`` files with the source timestamp and "
@@ -143,78 +157,78 @@ msgid ""
 "the ``SOURCE_DATE_EPOCH`` environment variable is set."
 msgstr ""
 
-#: ../../library/compileall.rst:111
+#: ../../library/compileall.rst:118
 msgid ""
 "Compile with the given optimization level. May be used multiple times to "
 "compile for multiple levels at a time (for example, ``compileall -o 1 -o "
 "2``)."
 msgstr ""
 
-#: ../../library/compileall.rst:117
+#: ../../library/compileall.rst:124
 msgid "Ignore symlinks pointing outside the given directory."
 msgstr ""
 
-#: ../../library/compileall.rst:121
+#: ../../library/compileall.rst:128
 msgid ""
 "If two ``.pyc`` files with different optimization level have the same "
 "content, use hard links to consolidate duplicate files."
 msgstr ""
 
-#: ../../library/compileall.rst:124
+#: ../../library/compileall.rst:131
 msgid "Added the ``-i``, ``-b`` and ``-h`` options."
 msgstr "新增選項 ``-i``、``-b`` 與 ``-h``。"
 
-#: ../../library/compileall.rst:127
+#: ../../library/compileall.rst:134
 msgid ""
 "Added the  ``-j``, ``-r``, and ``-qq`` options.  ``-q`` option was changed "
 "to a multilevel value.  ``-b`` will always produce a byte-code file ending "
 "in ``.pyc``, never ``.pyo``."
 msgstr ""
 
-#: ../../library/compileall.rst:132
+#: ../../library/compileall.rst:139
 msgid "Added the ``--invalidation-mode`` option."
 msgstr "新增選項 ``--invalidation-mode``。"
 
-#: ../../library/compileall.rst:135
+#: ../../library/compileall.rst:142
 msgid ""
 "Added the ``-s``, ``-p``, ``-e`` and ``--hardlink-dupes`` options. Raised "
 "the default recursion limit from 10 to :py:func:`sys.getrecursionlimit()`. "
 "Added the possibility to specify the ``-o`` option multiple times."
 msgstr ""
 
-#: ../../library/compileall.rst:142
+#: ../../library/compileall.rst:149
 msgid ""
 "There is no command-line option to control the optimization level used by "
 "the :func:`compile` function, because the Python interpreter itself already "
 "provides the option: :program:`python -O -m compileall`."
 msgstr ""
 
-#: ../../library/compileall.rst:146
+#: ../../library/compileall.rst:153
 msgid ""
 "Similarly, the :func:`compile` function respects the :data:`sys."
 "pycache_prefix` setting. The generated bytecode cache will only be useful "
 "if :func:`compile` is run with the same :data:`sys.pycache_prefix` (if any) "
 "that will be used at runtime."
 msgstr ""
 
-#: ../../library/compileall.rst:152
+#: ../../library/compileall.rst:159
 msgid "Public functions"
 msgstr ""
 
-#: ../../library/compileall.rst:156
+#: ../../library/compileall.rst:163
 msgid ""
 "Recursively descend the directory tree named by *dir*, compiling all :file:`."
 "py` files along the way. Return a true value if all the files compiled "
 "successfully, and a false value otherwise."
 msgstr ""
 
-#: ../../library/compileall.rst:160
+#: ../../library/compileall.rst:167
 msgid ""
 "The *maxlevels* parameter is used to limit the depth of the recursion; it "
 "defaults to ``sys.getrecursionlimit()``."
 msgstr ""
 
-#: ../../library/compileall.rst:163
+#: ../../library/compileall.rst:170
 msgid ""
 "If *ddir* is given, it is prepended to the path to each file being compiled "
 "for use in compilation time tracebacks, and is also compiled in to the byte-"
@@ -223,28 +237,28 @@ msgid ""
 "executed."
 msgstr ""
 
-#: ../../library/compileall.rst:169
+#: ../../library/compileall.rst:176
 msgid ""
 "If *force* is true, modules are re-compiled even if the timestamps are up to "
 "date."
 msgstr ""
 
-#: ../../library/compileall.rst:172
+#: ../../library/compileall.rst:179
 msgid ""
 "If *rx* is given, its ``search`` method is called on the complete path to "
 "each file considered for compilation, and if it returns a true value, the "
 "file is skipped. This can be used to exclude files matching a regular "
 "expression, given as a :ref:`re.Pattern <re-objects>` object."
 msgstr ""
 
-#: ../../library/compileall.rst:177 ../../library/compileall.rst:254
+#: ../../library/compileall.rst:184 ../../library/compileall.rst:261
 msgid ""
 "If *quiet* is ``False`` or ``0`` (the default), the filenames and other "
 "information are printed to standard out. Set to ``1``, only errors are "
 "printed. Set to ``2``, all output is suppressed."
 msgstr ""
 
-#: ../../library/compileall.rst:181 ../../library/compileall.rst:258
+#: ../../library/compileall.rst:188 ../../library/compileall.rst:265
 msgid ""
 "If *legacy* is true, byte-code files are written to their legacy locations "
 "and names, which may overwrite byte-code files created by another version of "
@@ -253,15 +267,15 @@ msgid ""
 "coexist."
 msgstr ""
 
-#: ../../library/compileall.rst:187 ../../library/compileall.rst:264
+#: ../../library/compileall.rst:194 ../../library/compileall.rst:271
 msgid ""
 "*optimize* specifies the optimization level for the compiler.  It is passed "
 "to the built-in :func:`compile` function. Accepts also a sequence of "
 "optimization levels which lead to multiple compilations of one :file:`.py` "
 "file in one call."
 msgstr ""
 
-#: ../../library/compileall.rst:191
+#: ../../library/compileall.rst:198
 msgid ""
 "The argument *workers* specifies how many workers are used to compile files "
 "in parallel. The default is to not use multiple workers. If the platform "
@@ -271,80 +285,80 @@ msgid ""
 "`ValueError` will be raised."
 msgstr ""
 
-#: ../../library/compileall.rst:198 ../../library/compileall.rst:268
+#: ../../library/compileall.rst:205 ../../library/compileall.rst:275
 msgid ""
 "*invalidation_mode* should be a member of the :class:`py_compile."
 "PycInvalidationMode` enum and controls how the generated pycs are "
 "invalidated at runtime."
 msgstr ""
 
-#: ../../library/compileall.rst:202 ../../library/compileall.rst:272
+#: ../../library/compileall.rst:209 ../../library/compileall.rst:279
 msgid ""
 "The *stripdir*, *prependdir* and *limit_sl_dest* arguments correspond to the "
 "``-s``, ``-p`` and ``-e`` options described above. They may be specified as "
 "``str`` or :py:class:`os.PathLike`."
 msgstr ""
 
-#: ../../library/compileall.rst:206 ../../library/compileall.rst:276
+#: ../../library/compileall.rst:213 ../../library/compileall.rst:283
 msgid ""
 "If *hardlink_dupes* is true and two ``.pyc`` files with different "
 "optimization level have the same content, use hard links to consolidate "
 "duplicate files."
 msgstr ""
 
-#: ../../library/compileall.rst:209 ../../library/compileall.rst:307
+#: ../../library/compileall.rst:216 ../../library/compileall.rst:314
 msgid "Added the *legacy* and *optimize* parameter."
 msgstr "新增 *legacy* 與 *optimize* 參數。"
 
-#: ../../library/compileall.rst:212
+#: ../../library/compileall.rst:219
 msgid "Added the *workers* parameter."
 msgstr "新增 *workers* 參數。"
 
-#: ../../library/compileall.rst:215 ../../library/compileall.rst:281
-#: ../../library/compileall.rst:310
+#: ../../library/compileall.rst:222 ../../library/compileall.rst:288
+#: ../../library/compileall.rst:317
 msgid "*quiet* parameter was changed to a multilevel value."
 msgstr ""
 
-#: ../../library/compileall.rst:218 ../../library/compileall.rst:284
-#: ../../library/compileall.rst:313
+#: ../../library/compileall.rst:225 ../../library/compileall.rst:291
+#: ../../library/compileall.rst:320
 msgid ""
 "The *legacy* parameter only writes out ``.pyc`` files, not ``.pyo`` files no "
 "matter what the value of *optimize* is."
 msgstr ""
 
-#: ../../library/compileall.rst:222
+#: ../../library/compileall.rst:229
 msgid "Accepts a :term:`path-like object`."
 msgstr ""
 
-#: ../../library/compileall.rst:225 ../../library/compileall.rst:288
-#: ../../library/compileall.rst:317
+#: ../../library/compileall.rst:232 ../../library/compileall.rst:295
+#: ../../library/compileall.rst:324
 msgid "The *invalidation_mode* parameter was added."
 msgstr "新增 *invalidation_mode* 參數。"
 
-#: ../../library/compileall.rst:228 ../../library/compileall.rst:291
-#: ../../library/compileall.rst:320
+#: ../../library/compileall.rst:235 ../../library/compileall.rst:298
+#: ../../library/compileall.rst:327
 msgid ""
 "The *invalidation_mode* parameter's default value is updated to ``None``."
 msgstr "新增 *invalidation_mode* 參數的預設值被更新為 ``None``。"
 
-#: ../../library/compileall.rst:231
+#: ../../library/compileall.rst:238
 msgid "Setting *workers* to 0 now chooses the optimal number of cores."
 msgstr ""
 
-#: ../../library/compileall.rst:234
+#: ../../library/compileall.rst:241
 msgid ""
 "Added *stripdir*, *prependdir*, *limit_sl_dest* and *hardlink_dupes* "
 "arguments. Default value of *maxlevels* was changed from ``10`` to ``sys."
 "getrecursionlimit()``"
 msgstr ""
 
-#: ../../library/compileall.rst:240
+#: ../../library/compileall.rst:247
 msgid ""
 "Compile the file with path *fullname*. Return a true value if the file "
 "compiled successfully, and a false value otherwise."
 msgstr ""
 
-#: ../../library/compileall.rst:243
+#: ../../library/compileall.rst:250
 msgid ""
 "If *ddir* is given, it is prepended to the path to the file being compiled "
 "for use in compilation time tracebacks, and is also compiled in to the byte-"
@@ -353,7 +367,7 @@ msgid ""
 "executed."
 msgstr ""
 
-#: ../../library/compileall.rst:249
+#: ../../library/compileall.rst:256
 msgid ""
 "If *rx* is given, its ``search`` method is passed the full path name to the "
 "file being compiled, and if it returns a true value, the file is not "
@@ -362,34 +376,34 @@ msgid ""
 "object."
 msgstr ""
 
-#: ../../library/compileall.rst:294
+#: ../../library/compileall.rst:301
 msgid ""
 "Added *stripdir*, *prependdir*, *limit_sl_dest* and *hardlink_dupes* "
 "arguments."
 msgstr ""
 
-#: ../../library/compileall.rst:299
+#: ../../library/compileall.rst:306
 msgid ""
 "Byte-compile all the :file:`.py` files found along ``sys.path``. Return a "
 "true value if all the files compiled successfully, and a false value "
 "otherwise."
 msgstr ""
 
-#: ../../library/compileall.rst:302
+#: ../../library/compileall.rst:309
 msgid ""
 "If *skip_curdir* is true (the default), the current directory is not "
 "included in the search.  All other parameters are passed to the :func:"
 "`compile_dir` function.  Note that unlike the other compile functions, "
 "``maxlevels`` defaults to ``0``."
 msgstr ""
 
-#: ../../library/compileall.rst:323
+#: ../../library/compileall.rst:330
 msgid ""
 "To force a recompile of all the :file:`.py` files in the :file:`Lib/` "
 "subdirectory and all its subdirectories::"
 msgstr ""
 
-#: ../../library/compileall.rst:326
+#: ../../library/compileall.rst:333
 msgid ""
 "import compileall\n"
 "\n"
@@ -404,10 +418,10 @@ msgid ""
 "compileall.compile_dir(pathlib.Path('Lib/'), force=True)"
 msgstr ""
 
-#: ../../library/compileall.rst:340
+#: ../../library/compileall.rst:347
 msgid "Module :mod:`py_compile`"
 msgstr ":mod:`py_compile` 模組"
 
-#: ../../library/compileall.rst:341
+#: ../../library/compileall.rst:348
 msgid "Byte-compile a single source file."
 msgstr ""
