Merge 3.11 into 3.10

Author: github-actions

installing/index.po

@@ -163,7 +163,7 @@ msgstr ""
 #: ../../installing/index.rst:65
 msgid ""
 "The use of ``venv`` is now recommended for creating virtual environments."
-msgstr "仮想環境の作成には、 ``venv`` の使用をお勧めします。"
+msgstr "仮想環境の作成には、 ``venv`` の使用が今は推奨されています。"
 
 #: ../../installing/index.rst:70
 msgid ""

library/typing.po

@@ -47,6 +47,10 @@ msgid ""
 "class:`TypeVar`, and :class:`Generic`. For a full specification, please see :"
 "pep:`484`. For a simplified introduction to type hints, see :pep:`483`."
 msgstr ""
+"このモジュールは型のランタイムへのサポートを提供します。最も基本的な型として:"
+"data:`Any`、:data:`Union`、:data:`Callable`:class:`TypeVar`、:class:"
+"`Generic` が存在します。詳細な仕様は:pep:`484`に記載があります。型ヒントの導"
+"入についての説明は:pep:`483`に記載があります。"
 
 #: ../../library/typing.rst:26
 msgid ""

library/venv.po

@@ -40,13 +40,20 @@ msgid ""
 "packages in the base environment, so only those explicitly installed in the "
 "virtual environment are available."
 msgstr ""
+":mod:`!venv` モジュールは、軽量な仮想環境の作成を行います。それぞれの仮想環境"
+"は、:mod:`site` ディレクトリに独立した Python パッケージの集合を持っていま"
+"す。仮想環境は、ベース Python とも呼ばれる、すでにインストールされている "
+"Python の上に作成され、明示的にインストールしたパッケージのみが利用可能となる"
+"よう、ベース Python から隔離することもできます。"
 
 #: ../../library/venv.rst:29
 msgid ""
 "When used from within a virtual environment, common installation tools such "
 "as `pip`_ will install Python packages into a virtual environment without "
 "needing to be told to do so explicitly."
 msgstr ""
+"仮想環境の中から使われると、`pip`_  のような一般的なインストールツールは明示"
+"的に指定しなくても仮想環境に Python パッケージをインストールします。"
 
 #: ../../library/venv.rst:33
 msgid "See :pep:`405` for more background on Python virtual environments."
@@ -104,11 +111,13 @@ msgid ""
 "``pyvenv`` was the recommended tool for creating virtual environments for "
 "Python 3.3 and 3.4, and is :ref:`deprecated in Python 3.6 <whatsnew36-venv>`."
 msgstr ""
+"Python 3.3 と 3.4 では仮想環境の作成に ``pyvenv`` が推奨されていましたが、:"
+"ref:`Python 3.6 で非推奨になりました<whatsnew36-venv>`。"
 
 #: ../../using/venv-create.inc:22
 msgid ""
 "The use of ``venv`` is now recommended for creating virtual environments."
-msgstr "仮想環境の作成には、 ``venv`` の使用をお勧めします。"
+msgstr "仮想環境の作成には、 ``venv`` の使用が今は推奨されています。"
 
 #: ../../using/venv-create.inc:27
 msgid "On Windows, invoke the ``venv`` command as follows::"
@@ -133,6 +142,8 @@ msgid ""
 "Add ``--upgrade-deps`` option to upgrade pip + setuptools to the latest on "
 "PyPI"
 msgstr ""
+"pip と setuptools を PyPI での最新版に更新するには、``--upgrade-deps`` オプ"
+"ションを追加してください。"
 
 #: ../../using/venv-create.inc:73
 msgid ""
@@ -216,7 +227,7 @@ msgstr ""
 
 #: ../../library/venv.rst:48
 msgid "How venvs work"
-msgstr ""
+msgstr "仮想環境のしくみ"
 
 #: ../../library/venv.rst:50
 msgid ""
@@ -227,6 +238,11 @@ msgid ""
 "environment. It is sufficient to check ``sys.prefix == sys.base_prefix`` to "
 "determine if the current interpreter is running from a virtual environment."
 msgstr ""
+"Python インタプリタが仮想環境で実行しているとき、:data:`sys.prefix` と :data:"
+"`sys.exec_prefix` は仮想環境のディレクトリを指し示し、 :data:`sys."
+"base_prefix` と :data:`sys.base_exec_prefix` は仮想環境の作成に使われたベー"
+"ス Python のディレクトリを指し示します。``sys.prefix == sys.base_prefix`` を"
+"調べれば、現在のインタプリタが仮想環境で実行しているかを判定できます。"
 
 #: ../../library/venv.rst:59
 msgid ""
@@ -238,6 +254,14 @@ msgid ""
 "activation script is platform-specific (:samp:`{<venv>}` must be replaced by "
 "the path to the directory containing the virtual environment):"
 msgstr ""
+"仮想環境は、そのバイナリディレクトリ  (POSIX では ``bin``、Windows では "
+"``Scripts``) の中にあるスクリプトを使って「アクティベート (activate)」するこ"
+"とができます。この操作はそのディレクトリを :envvar:`!PATH` の先頭に追加するの"
+"で、:program:`!python` を実行すると仮想環境の Python インタプリタが実行され、"
+"フルパスを使わなくても仮想環境にインストールされたスクリプトを実行できます。"
+"アクティベートするスクリプトの呼び出し方はプラットフォームによって異なります "
+"(:samp:`{<venv>}` は仮想環境の入ったディレクトリへのパスで置き換えてくださ"
+"い)。"
 
 #: ../../library/venv.rst:69
 msgid "Platform"
@@ -261,31 +285,31 @@ msgstr "bash/zsh"
 
 #: ../../library/venv.rst:71
 msgid ":samp:`$ source {<venv>}/bin/activate`"
-msgstr ""
+msgstr ":samp:`$ source {<venv>}/bin/activate`"
 
 #: ../../library/venv.rst:73
 msgid "fish"
 msgstr "fish"
 
 #: ../../library/venv.rst:73
 msgid ":samp:`$ source {<venv>}/bin/activate.fish`"
-msgstr ""
+msgstr ":samp:`$ source {<venv>}/bin/activate.fish`"
 
 #: ../../library/venv.rst:75
 msgid "csh/tcsh"
 msgstr "csh/tcsh"
 
 #: ../../library/venv.rst:75
 msgid ":samp:`$ source {<venv>}/bin/activate.csh`"
-msgstr ""
+msgstr ":samp:`$ source {<venv>}/bin/activate.csh`"
 
 #: ../../library/venv.rst:77 ../../library/venv.rst:81
 msgid "PowerShell"
 msgstr "PowerShell"
 
 #: ../../library/venv.rst:77
 msgid ":samp:`$ {<venv>}/bin/Activate.ps1`"
-msgstr ""
+msgstr ":samp:`$ {<venv>}/bin/Activate.ps1`"
 
 #: ../../library/venv.rst:79
 msgid "Windows"
@@ -297,11 +321,11 @@ msgstr "cmd.exe"
 
 #: ../../library/venv.rst:79
 msgid ":samp:`C:\\\\> {<venv>}\\\\Scripts\\\\activate.bat`"
-msgstr ""
+msgstr ":samp:`C:\\\\> {<venv>}\\\\Scripts\\\\activate.bat`"
 
 #: ../../library/venv.rst:81
 msgid ":samp:`PS C:\\\\> {<venv>}\\\\Scripts\\\\Activate.ps1`"
-msgstr ""
+msgstr ":samp:`PS C:\\\\> {<venv>}\\\\Scripts\\\\Activate.ps1`"
 
 #: ../../library/venv.rst:84
 msgid ":program:`!fish` and :program:`!csh` activation scripts."
@@ -322,6 +346,10 @@ msgid ""
 "invoking Python. Furthermore, all scripts installed in the environment "
 "should be runnable without activating it."
 msgstr ""
+"Python を呼び出すときに仮想環境の Python インタプリタへのフルパスを指定すれば"
+"良いだけなので、仮想環境をアクティベートする*必要*はありません。さらに、仮想"
+"環境にインストールされたすべてのスクリプトはアクティベートせずとも実行可能な"
+"はずです。"
 
 #: ../../library/venv.rst:97
 msgid ""
@@ -334,6 +362,14 @@ msgid ""
 "Explorer window should run it with the correct interpreter without the "
 "environment needing to be activated or on the :envvar:`!PATH`."
 msgstr ""
+"これを達成するため、仮想環境にインストールされたスクリプトは、仮想環境の "
+"Python インタプリタを指し示す \"shebang\" の行を含みます i.e. :samp:`#!/"
+"{<path-to-venv>}/bin/python` 。つまり、:envvar:`!PATH` の値に関係なくそのスク"
+"リプトはそのインタプリタを使って実行されます。Windows では、\"shebang\" の行"
+"の処理は :ref:`launcher` がインストールされていれば可能です。したがって、"
+"Windows のエクスプローラのウィンドウで、インストールされたスクリプトをダブル"
+"クリックすると、仮想環境をアクティベートしたり :envvar:`!PATH` を編集したりし"
+"なくても、正しいインタプリタでスクリプトが実行されるはずです。"
 
 #: ../../library/venv.rst:106
 msgid ""
@@ -343,6 +379,10 @@ msgid ""
 "VIRTUAL_ENV` cannot be relied upon to determine whether a virtual "
 "environment is being used."
 msgstr ""
+"仮想環境がアクティベートされると、:envvar:`!VIRTUAL_ENV` 環境変数の値が仮想環"
+"境へのパスに設定されます。アクティベートしなくても仮想環境を使うことは可能な"
+"ため、仮想環境が使われているか否かの判断を :envvar:`!VIRTUAL_ENV` に頼ること"
+"はできません。"
 
 #: ../../library/venv.rst:112
 msgid ""
@@ -359,6 +399,18 @@ msgid ""
 "directory of it, you should recreate the environment in its new location. "
 "Otherwise, software installed into the environment may not work as expected."
 msgstr ""
+"仮想環境にインストールされたスクリプトは仮想環境がアクティベートされているこ"
+"とを前提とすべきではないため、shebang の行は仮想環境のインタプリタへの絶対パ"
+"スを含みます。このため、本質的に、仮想環境は一般の場合ポータブルではありませ"
+"ん。いつでも仮想環境を再作成できる簡単な方法を持っておくべきです（例えば、"
+"``requirements.txt`` という requirements ファイルがあれば、仮想環境の "
+"``pip`` を用いて、``pip install -r requirements.txt`` を呼び出すことで、仮想"
+"環境が必要とするすべてのパッケージをインストールできます）。何らかの理由で仮"
+"想環境を別の場所に移動する必要がある場合は、新しい場所で仮想環境を再作成し、"
+"古い場所にある仮想環境を削除してください。仮想環境の親ディレクトリを移動した"
+"ため仮想環境も移動された場合は、新しい場所で仮想環境を再作成する必要がありま"
+"す。さもなくば、仮想環境にインストールされたソフトウェアが想定通りに動作しな"
+"い可能性があります。"
 
 #: ../../library/venv.rst:126
 msgid ""
@@ -444,10 +496,16 @@ msgid ""
 "used). If the special string ``\".\"`` is provided, the basename of the "
 "current directory is used as the prompt."
 msgstr ""
+"``prompt`` -- 仮想環境がアクティベートされたときに使う文字列（デフォルトは "
+"``None`` のため、仮想環境のディレクトリ名が使われます）。もし特殊な文字列 "
+"``\".\"`` が渡された場合、カレントディレクトリのベース名がプロンプトとして用"
+"いられます。"
 
 #: ../../library/venv.rst:171
 msgid "``upgrade_deps`` -- Update the base venv modules to the latest on PyPI"
 msgstr ""
+"``upgrade_deps`` -- venv のベースのモジュールを PyPI での最新版にアップデート"
+"します。"
 
 #: ../../library/venv.rst:173 ../../library/venv.rst:348
 msgid "Added the ``with_pip`` parameter"
@@ -513,82 +571,111 @@ msgid ""
 "of the environment directory will be cleared and then all necessary "
 "subdirectories will be recreated."
 msgstr ""
+"仮想環境のディレクトリとすべての必要なサブディレクトリのうちまだ存在しないも"
+"のを作成し、コンテキストオブジェクトを返します。このコンテキストオブジェクト"
+"は他のメソッドで使うために（パスなどの）属性を保持しているだけです。もし :"
+"class:`EnvBuilder` が ``clear=True`` の引数で作成された場合、仮想環境のディレ"
+"クトリの中身は消去され、すべての必要なサブディレクトリが再作成されます。"
 
 #: ../../library/venv.rst:223
 msgid ""
 "The returned context object is a :class:`types.SimpleNamespace` with the "
 "following attributes:"
 msgstr ""
+"返されるコンテキストオブジェクトは以下の属性を持った :class:`types."
+"SimpleNamespace` です:"
 
 #: ../../library/venv.rst:226
 msgid ""
 "``env_dir`` - The location of the virtual environment. Used for "
 "``__VENV_DIR__`` in activation scripts (see :meth:`install_scripts`)."
 msgstr ""
+"``env_dir`` - 仮想環境の場所。アクティベートスクリプトの中の "
+"``__VENV_DIR__`` で使われます（:meth:`install_scripts` を参照してください）。"
 
 #: ../../library/venv.rst:229
 msgid ""
 "``env_name`` - The name of the virtual environment. Used for "
 "``__VENV_NAME__`` in activation scripts (see :meth:`install_scripts`)."
 msgstr ""
+"``env_name`` - 仮想環境の名前。アクティベートスクリプトの中の "
+"``__VENV_NAME__`` で使われます（:meth:`install_scripts` を参照してくださ"
+"い）。"
 
 #: ../../library/venv.rst:232
 msgid ""
 "``prompt`` - The prompt to be used by the activation scripts. Used for "
 "``__VENV_PROMPT__`` in activation scripts (see :meth:`install_scripts`)."
 msgstr ""
+"``prompt`` - アクティベートスクリプトで使われるプロンプト。アクティベートスク"
+"リプトの中の ``__VENV_PROMPT__`` で使われます（:meth:`install_scripts` を参照"
+"してください）。"
 
 #: ../../library/venv.rst:235
 msgid ""
 "``executable`` - The underlying Python executable used by the virtual "
 "environment. This takes into account the case where a virtual environment is "
 "created from another virtual environment."
 msgstr ""
+"``executable`` - 仮想環境の元になっている Python 実行可能ファイル。これは仮想"
+"環境が別の仮想環境から作られた場合も考慮に入れます。"
 
 #: ../../library/venv.rst:239
 msgid "``inc_path`` - The include path for the virtual environment."
-msgstr ""
+msgstr "``inc_path`` - 仮想環境の include パス。"
 
 #: ../../library/venv.rst:241
 msgid "``lib_path`` - The purelib path for the virtual environment."
-msgstr ""
+msgstr "``lib_path`` - 仮想環境の purelib パス。"
 
 #: ../../library/venv.rst:243
 msgid "``bin_path`` - The script path for the virtual environment."
-msgstr ""
+msgstr "``bin_path`` - 仮想環境のスクリプトのパス。"
 
 #: ../../library/venv.rst:245
 msgid ""
 "``bin_name`` - The name of the script path relative to the virtual "
 "environment location. Used for ``__VENV_BIN_NAME__`` in activation scripts "
 "(see :meth:`install_scripts`)."
 msgstr ""
+"``bin_name`` - 仮想環境の場所に相対的な、スクリプトのパス。アクティベートスク"
+"リプトの中の ``__VENV_BIN_NAME__`` で使われます（:meth:`install_scripts` を参"
+"照してください）。"
 
 #: ../../library/venv.rst:249
 msgid ""
 "``env_exe`` - The name of the Python interpreter in the virtual environment. "
 "Used for ``__VENV_PYTHON__`` in activation scripts (see :meth:"
 "`install_scripts`)."
 msgstr ""
+"``env_exe`` - 仮想環境の中の Python インタプリタの名前。アクティベートスクリ"
+"プトの中の ``__VENV_PYTHON__`` で使われます（:meth:`install_scripts` を参照し"
+"てください）。"
 
 #: ../../library/venv.rst:253
 msgid ""
 "``env_exec_cmd`` - The name of the Python interpreter, taking into account "
 "filesystem redirections. This can be used to run Python in the virtual "
 "environment."
 msgstr ""
+"``env_exec_cmd`` - ファイルシステムのリダイレクトを考慮に入れた、Python イン"
+"タプリタの名前。これは仮想環境の中で Python を実行するのに使えます。"
 
 #: ../../library/venv.rst:258
 msgid ""
 "The attribute ``lib_path`` was added to the context, and the context object "
 "was documented."
 msgstr ""
+"コンテキストに ``lib_path`` 属性が追加され、コンテキストオブジェクトがドキュ"
+"メントに追加されました。"
 
 #: ../../library/venv.rst:262
 msgid ""
 "The *venv* :ref:`sysconfig installation scheme <installation_paths>` is used "
 "to construct the paths of the created directories."
 msgstr ""
+"*venv* :ref:`システム構成インストールスキーム <installation_paths>` は作成さ"
+"れたディレクトリのパスを構築するために使われます。"
 
 #: ../../library/venv.rst:269
 msgid "Creates the ``pyvenv.cfg`` configuration file in the environment."
@@ -619,6 +706,9 @@ msgid ""
 "``setuptools``) in the environment. This is done by shelling out to the "
 "``pip`` executable in the environment."
 msgstr ""
+"仮想環境の中の venv のコア依存関係パッケージ（現在は ``pip`` と "
+"``setuptools``）をアップグレードします。これは仮想環境の中の ``pip`` 実行可能"
+"ファイルによって行われます。"
 
 #: ../../library/venv.rst:293
 msgid ""

library/xml.dom.po

@@ -168,6 +168,8 @@ msgid ""
 "`Python Language Mapping Specification <https://www.omg.org/spec/PYTH/1.2/"
 "PDF>`_"
 msgstr ""
+"`Python Language Mapping Specification <https://www.omg.org/spec/PYTH/1.2/"
+"PDF>`_"
 
 #: ../../library/xml.dom.rst:77
 msgid "This specifies the mapping from OMG IDL to Python."