python
diff --git a/‎library/copyreg.po
Lines changed: 12 additions & 14 deletions b/‎library/copyreg.po
Lines changed: 12 additions & 14 deletions
diff --git a/‎library/os.po
Lines changed: 11 additions & 11 deletions b/‎library/os.po
Lines changed: 11 additions & 11 deletions
diff --git a/‎library/venv.po
Lines changed: 56 additions & 40 deletions b/‎library/venv.po
Lines changed: 56 additions & 40 deletions
@@ -7,7 +7,7 @@ msgid ""
 msgstr ""
 "Project-Id-Version: Python 3.10\n"
 "Report-Msgid-Bugs-To: \n"
-"POT-Creation-Date: 2022-01-19 00:09+0000\n"
+"POT-Creation-Date: 2022-10-11 00:23+0000\n"
 "PO-Revision-Date: 2016-11-19 00:29+0000\n"
 "Last-Translator: Liang-Bo Wang <me@liang2.tw>\n"
 "Language-Team: Chinese - TAIWAN (https://github.com/python/python-docs-zh-"
@@ -45,30 +45,28 @@ msgstr ""
 msgid ""
 "Declares that *function* should be used as a \"reduction\" function for "
 "objects of type *type*.  *function* should return either a string or a tuple "
-"containing two or three elements."
+"containing two or three elements. See the :attr:`~pickle.Pickler."
+"dispatch_table` for more details on the interface of *function*."
 msgstr ""
 
-#: ../../library/copyreg.rst:34
+#: ../../library/copyreg.rst:35
 msgid ""
-"The optional *constructor* parameter, if provided, is a callable object "
-"which can be used to reconstruct the object when called with the tuple of "
-"arguments returned by *function* at pickling time.  A :exc:`TypeError` is "
-"raised if the *constructor* is not callable."
+"The *constructor_ob* parameter is a legacy feature and is now ignored, but "
+"if passed it must be a callable."
 msgstr ""
 
-#: ../../library/copyreg.rst:39
+#: ../../library/copyreg.rst:38
 msgid ""
-"See the :mod:`pickle` module for more details on the interface expected of "
-"*function* and *constructor*.  Note that the :attr:`~pickle.Pickler."
-"dispatch_table` attribute of a pickler object or subclass of :class:`pickle."
-"Pickler` can also be used for declaring reduction functions."
+"Note that the :attr:`~pickle.Pickler.dispatch_table` attribute of a pickler "
+"object or subclass of :class:`pickle.Pickler` can also be used for declaring "
+"reduction functions."
 msgstr ""
 
-#: ../../library/copyreg.rst:46
+#: ../../library/copyreg.rst:43
 msgid "Example"
 msgstr "範例"
 
-#: ../../library/copyreg.rst:48
+#: ../../library/copyreg.rst:45
 msgid ""
 "The example below would like to show how to register a pickle function and "
 "how it will be used:"
 
@@ -7,7 +7,7 @@ msgid ""
 msgstr ""
 "Project-Id-Version: Python 3.10\n"
 "Report-Msgid-Bugs-To: \n"
-"POT-Creation-Date: 2022-10-09 00:22+0000\n"
+"POT-Creation-Date: 2022-10-11 00:23+0000\n"
 "PO-Revision-Date: 2018-05-23 16:07+0000\n"
 "Last-Translator: Adrian Liaw <adrianliaw2000@gmail.com>\n"
 "Language-Team: Chinese - TAIWAN (https://github.com/python/python-docs-zh-"
@@ -447,11 +447,11 @@ msgstr ""
 
 #: ../../library/os.rst:294
 msgid ""
-"Return the value of the environment variable *key* if it exists, or "
-"*default* if it doesn't. *key*, *default* and the result are str. Note that "
-"since :func:`getenv` uses :data:`os.environ`, the mapping of :func:`getenv` "
-"is similarly also captured on import, and the function may not reflect "
-"future environment changes."
+"Return the value of the environment variable *key* as a string if it exists, "
+"or *default* if it doesn't. *key* is a string. Note that since :func:"
+"`getenv` uses :data:`os.environ`, the mapping of :func:`getenv` is similarly "
+"also captured on import, and the function may not reflect future environment "
+"changes."
 msgstr ""
 
 #: ../../library/os.rst:300
@@ -467,11 +467,11 @@ msgstr ":ref:`適用 <availability>`：大部分的 Unix、Windows。"
 
 #: ../../library/os.rst:309
 msgid ""
-"Return the value of the environment variable *key* if it exists, or "
-"*default* if it doesn't. *key*, *default* and the result are bytes. Note "
-"that since :func:`getenvb` uses :data:`os.environb`, the mapping of :func:"
-"`getenvb` is similarly also captured on import, and the function may not "
-"reflect future environment changes."
+"Return the value of the environment variable *key* as bytes if it exists, or "
+"*default* if it doesn't. *key* must be bytes. Note that since :func:"
+"`getenvb` uses :data:`os.environb`, the mapping of :func:`getenvb` is "
+"similarly also captured on import, and the function may not reflect future "
+"environment changes."
 msgstr ""
 
 #: ../../library/os.rst:316
 
@@ -7,7 +7,7 @@ msgid ""
 msgstr ""
 "Project-Id-Version: Python 3.10\n"
 "Report-Msgid-Bugs-To: \n"
-"POT-Creation-Date: 2022-06-22 00:18+0000\n"
+"POT-Creation-Date: 2022-10-11 00:23+0000\n"
 "PO-Revision-Date: 2018-05-23 16:15+0000\n"
 "Last-Translator: Adrian Liaw <adrianliaw2000@gmail.com>\n"
 "Language-Team: Chinese - TAIWAN (https://github.com/python/python-docs-zh-"
@@ -333,113 +333,129 @@ msgid ""
 "environment in ``PATH``."
 msgstr ""
 
-#: ../../library/venv.rst:91
+#: ../../library/venv.rst:87
+msgid ""
+"Because scripts installed in environments should not expect the environment "
+"to be activated, their shebang lines contain the absolute paths to their "
+"environment's interpreters. Because of this, environments are inherently non-"
+"portable, in the general case. You should always have a simple means of "
+"recreating an environment (for example, if you have a requirements file "
+"``requirements.txt``, you can invoke ``pip install -r requirements.txt`` "
+"using the environment's ``pip`` to install all of the packages needed by the "
+"environment). If for any reason you need to move the environment to a new "
+"location, you should recreate it at the desired location and delete the one "
+"at the old location. If you move an environment because you moved a parent "
+"directory of it, you should recreate the environment in its new location. "
+"Otherwise, software installed into the environment may not work as expected."
+msgstr ""
+
+#: ../../library/venv.rst:104
 msgid "API"
 msgstr "API"
 
-#: ../../library/venv.rst:95
+#: ../../library/venv.rst:108
 msgid ""
 "The high-level method described above makes use of a simple API which "
 "provides mechanisms for third-party virtual environment creators to "
 "customize environment creation according to their needs, the :class:"
 "`EnvBuilder` class."
 msgstr ""
 
-#: ../../library/venv.rst:103
+#: ../../library/venv.rst:116
 msgid ""
 "The :class:`EnvBuilder` class accepts the following keyword arguments on "
 "instantiation:"
 msgstr ""
 
-#: ../../library/venv.rst:106
+#: ../../library/venv.rst:119
 msgid ""
 "``system_site_packages`` -- a Boolean value indicating that the system "
 "Python site-packages should be available to the environment (defaults to "
 "``False``)."
 msgstr ""
 
-#: ../../library/venv.rst:109
+#: ../../library/venv.rst:122
 msgid ""
 "``clear`` -- a Boolean value which, if true, will delete the contents of any "
 "existing target directory, before creating the environment."
 msgstr ""
 
-#: ../../library/venv.rst:112
+#: ../../library/venv.rst:125
 msgid ""
 "``symlinks`` -- a Boolean value indicating whether to attempt to symlink the "
 "Python binary rather than copying."
 msgstr ""
 
-#: ../../library/venv.rst:115
+#: ../../library/venv.rst:128
 msgid ""
 "``upgrade`` -- a Boolean value which, if true, will upgrade an existing "
 "environment with the running Python - for use when that Python has been "
 "upgraded in-place (defaults to ``False``)."
 msgstr ""
 
-#: ../../library/venv.rst:119
+#: ../../library/venv.rst:132
 msgid ""
 "``with_pip`` -- a Boolean value which, if true, ensures pip is installed in "
 "the virtual environment. This uses :mod:`ensurepip` with the ``--default-"
 "pip`` option."
 msgstr ""
 
-#: ../../library/venv.rst:123
+#: ../../library/venv.rst:136
 msgid ""
 "``prompt`` -- a String to be used after virtual environment is activated "
 "(defaults to ``None`` which means directory name of the environment would be "
 "used). If the special string ``\".\"`` is provided, the basename of the "
 "current directory is used as the prompt."
 msgstr ""
 
-#: ../../library/venv.rst:128
+#: ../../library/venv.rst:141
 msgid "``upgrade_deps`` -- Update the base venv modules to the latest on PyPI"
 msgstr ""
 
-#: ../../library/venv.rst:130 ../../library/venv.rst:260
+#: ../../library/venv.rst:143 ../../library/venv.rst:273
 msgid "Added the ``with_pip`` parameter"
 msgstr "新增 ``with_pip`` 參數"
 
-#: ../../library/venv.rst:133 ../../library/venv.rst:263
+#: ../../library/venv.rst:146 ../../library/venv.rst:276
 msgid "Added the ``prompt`` parameter"
 msgstr "新增 ``prompt`` 參數"
 
-#: ../../library/venv.rst:136 ../../library/venv.rst:266
+#: ../../library/venv.rst:149 ../../library/venv.rst:279
 msgid "Added the ``upgrade_deps`` parameter"
 msgstr "新增 ``upgrade_deps`` 參數"
 
-#: ../../library/venv.rst:139
+#: ../../library/venv.rst:152
 msgid ""
 "Creators of third-party virtual environment tools will be free to use the "
 "provided :class:`EnvBuilder` class as a base class."
 msgstr ""
 
-#: ../../library/venv.rst:142
+#: ../../library/venv.rst:155
 msgid "The returned env-builder is an object which has a method, ``create``:"
 msgstr ""
 
-#: ../../library/venv.rst:146
+#: ../../library/venv.rst:159
 msgid ""
 "Create a virtual environment by specifying the target directory (absolute or "
 "relative to the current directory) which is to contain the virtual "
 "environment.  The ``create`` method will either create the environment in "
 "the specified directory, or raise an appropriate exception."
 msgstr ""
 
-#: ../../library/venv.rst:152
+#: ../../library/venv.rst:165
 msgid ""
 "The ``create`` method of the :class:`EnvBuilder` class illustrates the hooks "
 "available for subclass customization::"
 msgstr ""
 
-#: ../../library/venv.rst:167
+#: ../../library/venv.rst:180
 msgid ""
 "Each of the methods :meth:`ensure_directories`, :meth:"
 "`create_configuration`, :meth:`setup_python`, :meth:`setup_scripts` and :"
 "meth:`post_setup` can be overridden."
 msgstr ""
 
-#: ../../library/venv.rst:173
+#: ../../library/venv.rst:186
 msgid ""
 "Creates the environment directory and all necessary directories, and returns "
 "a context object.  This is just a holder for attributes (such as paths), for "
@@ -448,60 +464,60 @@ msgid ""
 "an existing environment directory."
 msgstr ""
 
-#: ../../library/venv.rst:181
+#: ../../library/venv.rst:194
 msgid "Creates the ``pyvenv.cfg`` configuration file in the environment."
 msgstr ""
 
-#: ../../library/venv.rst:185
+#: ../../library/venv.rst:198
 msgid ""
 "Creates a copy or symlink to the Python executable in the environment. On "
 "POSIX systems, if a specific executable ``python3.x`` was used, symlinks to "
 "``python`` and ``python3`` will be created pointing to that executable, "
 "unless files with those names already exist."
 msgstr ""
 
-#: ../../library/venv.rst:192
+#: ../../library/venv.rst:205
 msgid ""
 "Installs activation scripts appropriate to the platform into the virtual "
 "environment."
 msgstr ""
 
-#: ../../library/venv.rst:197
+#: ../../library/venv.rst:210
 msgid ""
 "Upgrades the core venv dependency packages (currently ``pip`` and "
 "``setuptools``) in the environment. This is done by shelling out to the "
 "``pip`` executable in the environment."
 msgstr ""
 
-#: ../../library/venv.rst:205
+#: ../../library/venv.rst:218
 msgid ""
 "A placeholder method which can be overridden in third party implementations "
 "to pre-install packages in the virtual environment or perform other post-"
 "creation steps."
 msgstr ""
 
-#: ../../library/venv.rst:209
+#: ../../library/venv.rst:222
 msgid ""
 "Windows now uses redirector scripts for ``python[w].exe`` instead of copying "
 "the actual binaries. In 3.7.2 only :meth:`setup_python` does nothing unless "
 "running from a build in the source tree."
 msgstr ""
 
-#: ../../library/venv.rst:214
+#: ../../library/venv.rst:227
 msgid ""
 "Windows copies the redirector scripts as part of :meth:`setup_python` "
 "instead of :meth:`setup_scripts`. This was not the case in 3.7.2. When using "
 "symlinks, the original executables will be linked."
 msgstr ""
 
-#: ../../library/venv.rst:219
+#: ../../library/venv.rst:232
 msgid ""
 "In addition, :class:`EnvBuilder` provides this utility method that can be "
 "called from :meth:`setup_scripts` or :meth:`post_setup` in subclasses to "
 "assist in installing custom scripts into the virtual environment."
 msgstr ""
 
-#: ../../library/venv.rst:225
+#: ../../library/venv.rst:238
 msgid ""
 "*path* is the path to a directory that should contain subdirectories \"common"
 "\", \"posix\", \"nt\", each containing scripts destined for the bin "
@@ -510,64 +526,64 @@ msgid ""
 "placeholders:"
 msgstr ""
 
-#: ../../library/venv.rst:231
+#: ../../library/venv.rst:244
 msgid ""
 "``__VENV_DIR__`` is replaced with the absolute path of the environment "
 "directory."
 msgstr ""
 
-#: ../../library/venv.rst:234
+#: ../../library/venv.rst:247
 msgid ""
 "``__VENV_NAME__`` is replaced with the environment name (final path segment "
 "of environment directory)."
 msgstr ""
 
-#: ../../library/venv.rst:237
+#: ../../library/venv.rst:250
 msgid ""
 "``__VENV_PROMPT__`` is replaced with the prompt (the environment name "
 "surrounded by parentheses and with a following space)"
 msgstr ""
 
-#: ../../library/venv.rst:240
+#: ../../library/venv.rst:253
 msgid ""
 "``__VENV_BIN_NAME__`` is replaced with the name of the bin directory (either "
 "``bin`` or ``Scripts``)."
 msgstr ""
 
-#: ../../library/venv.rst:243
+#: ../../library/venv.rst:256
 msgid ""
 "``__VENV_PYTHON__`` is replaced with the absolute path of the environment's "
 "executable."
 msgstr ""
 
-#: ../../library/venv.rst:246
+#: ../../library/venv.rst:259
 msgid ""
 "The directories are allowed to exist (for when an existing environment is "
 "being upgraded)."
 msgstr ""
 
-#: ../../library/venv.rst:249
+#: ../../library/venv.rst:262
 msgid "There is also a module-level convenience function:"
 msgstr ""
 
-#: ../../library/venv.rst:255
+#: ../../library/venv.rst:268
 msgid ""
 "Create an :class:`EnvBuilder` with the given keyword arguments, and call "
 "its :meth:`~EnvBuilder.create` method with the *env_dir* argument."
 msgstr ""
 
-#: ../../library/venv.rst:270
+#: ../../library/venv.rst:283
 msgid "An example of extending ``EnvBuilder``"
 msgstr ""
 
-#: ../../library/venv.rst:272
+#: ../../library/venv.rst:285
 msgid ""
 "The following script shows how to extend :class:`EnvBuilder` by implementing "
 "a subclass which installs setuptools and pip into a created virtual "
 "environment::"
 msgstr ""
 
-#: ../../library/venv.rst:491
+#: ../../library/venv.rst:504
 msgid ""
 "This script is also available for download `online <https://gist.github.com/"
 "vsajip/4673395>`_."