python
diff --git a/‎library/ftplib.po‎
Lines changed: 19 additions & 1 deletion b/‎library/ftplib.po‎
Lines changed: 19 additions & 1 deletion
diff --git a/‎library/gettext.po‎
Lines changed: 56 additions & 4 deletions b/‎library/gettext.po‎
Lines changed: 56 additions & 4 deletions
@@ -5,6 +5,7 @@
 # 
 # Translators:
 # tomo, 2020
+# Takanori Suzuki <takanori@takanory.net>, 2021
 # 
 #, fuzzy
 msgid ""
@@ -13,7 +14,7 @@ msgstr ""
 "Report-Msgid-Bugs-To: \n"
 "POT-Creation-Date: 2021-01-01 16:06+0000\n"
 "PO-Revision-Date: 2020-05-30 12:02+0000\n"
-"Last-Translator: tomo, 2020\n"
+"Last-Translator: Takanori Suzuki <takanori@takanory.net>, 2021\n"
 "Language-Team: Japanese (https://www.transifex.com/python-doc/teams/5390/ja/)\n"
 "MIME-Version: 1.0\n"
 "Content-Type: text/plain; charset=UTF-8\n"
@@ -38,6 +39,10 @@ msgid ""
 ":mod:`urllib.request` to handle URLs that use FTP.  For more information on "
 "FTP (File Transfer Protocol), see Internet :rfc:`959`."
 msgstr ""
+"このモジュールでは :class:`FTP` クラスと、それに関連するいくつかの項目を定義しています。 :class:`FTP` "
+"クラスは、FTPプロトコルのクライアント側の機能を備えています。このクラスを使うとFTPのいろいろな機能の自動化、例えば他のFTPサーバのミラーリングといったことを実行するPythonプログラムを書くことができます。また、"
+" :mod:`urllib.request` モジュールもFTPを使うURLを操作するのにこのクラスを使っています。 FTP (File "
+"Transfer Protocol)についての詳しい情報はInternet :rfc:`959` を参照して下さい。"
 
 #: ../../library/ftplib.rst:22
 msgid "Here's a sample session using the :mod:`ftplib` module::"
@@ -153,6 +158,8 @@ msgid ""
 "opposed to programming errors made by the caller).  This set includes the "
 "four exceptions listed above as well as :exc:`OSError` and :exc:`EOFError`."
 msgstr ""
+":class:`FTP` インスタンスのメソッド実行時、FTP接続で (プログラミングのエラーと考えられるメソッドの実行によって) 発生する全ての例外 "
+"(タプル形式)。この例外には以上の４つのエラーはもちろん、 :exc:`OSError` と :exc:`EOFError` も含まれます。"
 
 #: ../../library/ftplib.rst:155
 msgid "Module :mod:`netrc`"
@@ -216,6 +223,8 @@ msgid ""
 "Raises an :ref:`auditing event <auditing>` ``ftplib.connect`` with arguments"
 " ``self``, ``host``, ``port``."
 msgstr ""
+"引数 ``self``, ``host``, ``port`` を指定して :ref:`監査イベント <auditing>` "
+"``ftplib.connect`` を送出します。 "
 
 #: ../../library/ftplib.rst:202
 msgid ""
@@ -259,6 +268,8 @@ msgid ""
 "Raises an :ref:`auditing event <auditing>` ``ftplib.sendcmd`` with arguments"
 " ``self``, ``cmd``."
 msgstr ""
+"引数 ``self``, ``cmd`` を指定して :ref:`監査イベント <auditing>` ``ftplib.sendcmd`` "
+"を送出します。 "
 
 #: ../../library/ftplib.rst:234
 msgid ""
@@ -280,6 +291,12 @@ msgid ""
 "*callback*).  A reasonable default is chosen. *rest* means the same thing as"
 " in the :meth:`transfercmd` method."
 msgstr ""
+"バイナリ転送モードでファイルを受信します。 *cmd* は適切な ``RETR`` コマンド:  ``'RETR filename'`` "
+"でなければなりません。関数 *callback* は、受信したデータブロックのそれぞれに対して、データブロックを１つの bytes "
+"の引数として呼び出されます。省略可能な引数 *blocksize* "
+"は、実際の転送を行うのに作られた低レベルのソケットオブジェクトから読み込む最大のチャンクサイズを指定します（これは *callback* "
+"に与えられるデータブロックの最大サイズにもなります）。妥当なデフォルト値が設定されます。 *rest* は、 :meth:`transfercmd` "
+"メソッドと同じものです。"
 
 #: ../../library/ftplib.rst:255
 msgid ""
@@ -485,6 +502,7 @@ msgid ""
 "Set up a secure control connection by using TLS or SSL, depending on what is"
 " specified in the :attr:`ssl_version` attribute."
 msgstr ""
+":attr:`ssl_version` 属性で指定されたものに従って、 TLS または SSL を使い、セキュアコントロール接続をセットアップします。"
 
 #: ../../library/ftplib.rst:430
 msgid ""
 
@@ -5,6 +5,7 @@
 # 
 # Translators:
 # tomo, 2020
+# Takanori Suzuki <takanori@takanory.net>, 2021
 # 
 #, fuzzy
 msgid ""
@@ -13,7 +14,7 @@ msgstr ""
 "Report-Msgid-Bugs-To: \n"
 "POT-Creation-Date: 2021-01-01 16:06+0000\n"
 "PO-Revision-Date: 2020-05-30 12:03+0000\n"
-"Last-Translator: tomo, 2020\n"
+"Last-Translator: Takanori Suzuki <takanori@takanory.net>, 2021\n"
 "Language-Team: Japanese (https://www.transifex.com/python-doc/teams/5390/ja/)\n"
 "MIME-Version: 1.0\n"
 "Content-Type: text/plain; charset=UTF-8\n"
@@ -39,6 +40,9 @@ msgid ""
 "messages in one natural language, and provide a catalog of translated "
 "messages for running under different natural languages."
 msgstr ""
+":mod:`gettext` モジュールは、 Python のモジュールやアプリケーションの国際化 (I18N, I-nternationalizatio-N) および地域化  (L10N, L-ocalizatio-N) サービスを提供します。\n"
+"このモジュールは GNU :program:`gettext` メッセージカタログの API と、より高水準で Python ファイルに適しているクラス形式の API の両方をサポートしてます。\n"
+"以下で述べるインタフェースを使うことで、モジュールやアプリケーションのメッセージをある自然言語で記述しておき、後から提供する翻訳されたメッセージのカタログによって様���な自然言語環境で実行できます。"
 
 #: ../../library/gettext.rst:22
 msgid ""
@@ -74,6 +78,9 @@ msgid ""
 "searched for in the environment variables :envvar:`LANGUAGE`, "
 ":envvar:`LC_ALL`, :envvar:`LC_MESSAGES`, and :envvar:`LANG` respectively."
 msgstr ""
+"*domain* をロケールディレクトリ *localedir* に対応付けます。\n"
+"具体的には、 :mod:`gettext` は与えられたドメインに対するバイナリ形式の :file:`.mo` ファイルを探しに、(Unixでは) :file:`{localedir}/{language}/LC_MESSAGES/{domain}.mo` というパスを見に行きます。\n"
+"ここで *language* はそれぞれ環境変数 :envvar:`LANGUAGE` 、 :envvar:`LC_ALL` 、 :envvar:`LC_MESSAGES` 、 :envvar:`LANG` の中から検索されます。"
 
 #: ../../library/gettext.rst:45
 msgid ""
@@ -176,6 +183,9 @@ msgid ""
 "may get unexpected Unicode-related exceptions if there are encoding problems"
 " with the translated strings."
 msgstr ""
+"これらの関数はエンコードされたバイ��列を返すため Python 3 で使うのは避けるべきです。\n"
+"ほとんどの Python アプリケーションでは、人間が読むテキストをバイト列ではなく文字列として扱いたいので、 Unicode 文字列を返す代わりの関数を使う方が良いです。\n"
+"さらに言うと、翻訳文字列にエンコーディング上の問題があった場合、 Unicode 関連の予期しない例外を受け取るかもしれません。"
 
 #: ../../library/gettext.rst:134
 msgid ""
@@ -203,6 +213,10 @@ msgid ""
 "strings. Instances of this class can also install themselves in the built-in"
 " namespace as the function :func:`_`."
 msgstr ""
+":mod:`gettext` モジュールのクラス形式の API は、 GNU :program:`gettext` API よりも高い柔軟性と利便性を持っています。\n"
+"Python のアプリケーションやモジュールを地域化するにはこちらを使うことをお勧めします。\n"
+":mod:`!gettext` には、GNU :file:`.mo` 形式のファイルを構文解析する処理の実装と、文字列を返すメソッドを持つ :class:`GNUTranslations` クラスが定義されています。\n"
+"このクラスのインスタンスも、自分自身を組み込み名前空間に関数  :func:`_` として配置できます。"
 
 #: ../../library/gettext.rst:160
 msgid ""
@@ -211,6 +225,9 @@ msgid ""
 "*localedir* is as in :func:`bindtextdomain`. Optional *languages* is a list "
 "of strings, where each string is a language code."
 msgstr ""
+"この関数は標準的な :file:`.mo` ファイル検索アルゴリズムを実装しています。 :func:`textdomain` と同じく、 "
+"*domain* を引数にとります。オプションの *localedir* は :func:`bindtextdomain` と同じです。またオプションの"
+" *languages* は文字列を列挙したリストで、各文字列は言語コードを表します。"
 
 #: ../../library/gettext.rst:165
 msgid ""
@@ -261,6 +278,12 @@ msgid ""
 ":meth:`~NullTranslations.lgettext` and :meth:`~NullTranslations.lngettext` "
 "methods."
 msgstr ""
+"*domain* 、 *localedir* 、 *languages* に基づいて :class:`*Translations` インスタンスを返します。\n"
+"*domain* 、 *localedir* 、 *languages* はまず :func:`find` に渡され、関連付けられている :file:`.mo` ファイルパスのリストを取得します。\n"
+"同一の :file:`.mo` ファイル名を持つインスタンスはキャッシュされます。\n"
+"実際にインスタンス化されるクラスは、 *class_* が与えられていた場合はそのクラスで、そうでない場合には :class:`GNUTranslations` です。\n"
+"クラスのコンストラクタは単一の引数として :term:`file object` を取らなければなりません。\n"
+"*codeset* が与えられた場合、 :meth:`~NullTranslations.lgettext` メソッドおよび :meth:`~NullTranslations.lngettext` メソッドで翻訳文字列のエンコードに使う文字集合を変更します。"
 
 #: ../../library/gettext.rst:196
 msgid ""
@@ -287,7 +310,7 @@ msgstr "以前は :exc:`OSError` ではなく :exc:`IOError` が送出されて
 
 #: ../../library/gettext.rst:209 ../../library/gettext.rst:232
 msgid "The *codeset* parameter."
-msgstr ""
+msgstr "*codeset* 引数。"
 
 #: ../../library/gettext.rst:214
 msgid ""
@@ -359,6 +382,8 @@ msgid ""
 "unsupported message catalog file format, you should override this method to "
 "parse your format."
 msgstr ""
+"基底クラスでは何もしない (no-op) ようになっています。このメソッドの役割はファイルオブジェクト *fp* "
+"を引数に取り、ファイルからデータを読み出し、メッセージカタログを初期化することです。サポートされていないメッセージカタログ形式を使っている場合、その形式を解釈するためにはこのメソッドを上書きしなくてはなりません。"
 
 #: ../../library/gettext.rst:263
 msgid ""
@@ -393,12 +418,16 @@ msgid ""
 "If a fallback has been set, forward :meth:`pgettext` to the fallback. "
 "Otherwise, return the translated message.  Overridden in derived classes."
 msgstr ""
+"代替オブジェクトが設定されている場合、 :meth:`pgettext` "
+"を代替オブジェクトに転送します。そうでない場合、翻訳されたメッセージを返します。派生クラスで上書きするメソッドです。"
 
 #: ../../library/gettext.rst:291
 msgid ""
 "If a fallback has been set, forward :meth:`npgettext` to the fallback. "
 "Otherwise, return the translated message.  Overridden in derived classes."
 msgstr ""
+"代替オブジェクトが設定されている場合、 :meth:`npgettext` "
+"を代替オブジェクトに転送します。そうでない場合、翻訳されたメッセージを返します。派生クラスで上書きするメソッドです。"
 
 #: ../../library/gettext.rst:300
 msgid ""
@@ -452,6 +481,8 @@ msgid ""
 " to :func:`_`.  Supported names are ``'gettext'``, ``'ngettext'``, "
 "``'pgettext'``, ``'npgettext'``, ``'lgettext'``, and ``'lngettext'``."
 msgstr ""
+"*names* パラメータを与える場合には、 :func:`_` 以外では組み込み名前空間に配置したい関数名を列挙したシーケンスでなければなりません。\n"
+"サポートされている名前は ``'gettext'``, ``'ngettext'``, ``'pgettext'``, ``'npgettext'``, ``'lgettext'``, ``'lngettext'`` です。"
 
 #: ../../library/gettext.rst:349
 msgid ""
@@ -474,7 +505,7 @@ msgstr ""
 
 #: ../../library/gettext.rst:362
 msgid "Added ``'pgettext'`` and ``'npgettext'``."
-msgstr ""
+msgstr "``'pgettext'`` と ``'npgettext'`` が追加されました。"
 
 #: ../../library/gettext.rst:367
 msgid "The :class:`GNUTranslations` class"
@@ -503,6 +534,13 @@ msgid ""
 "then all message ids and message strings read from the catalog are converted"
 " to Unicode using this encoding, else ASCII is assumed."
 msgstr ""
+":class:`GNUTranslations` はまた、翻訳カタログ以外に、オプションのメタデータを読み込んで解釈します。GNU "
+":program:`gettext` では、空の文字列に対する変換先としてメタデータを取り込むことが慣習になっています。このメタデータは "
+":rfc:`822` 形式の ``key: value`` のペアになって��り、 ``Project-Id-Version`` "
+"キーを含んでいなければなりません。キー ``Content-Type`` があった場合、 ``charset`` の特性値 (property) は "
+"\"保護された\" :attr:`_charset` インスタンス変数を初期化するために用いられます。値がない場合には、デフォルトとして "
+"``None`` が使われます。エンコードに用いられる文字セットが指定されている場合、カタログから読み出された全てのメッセージ id "
+"とメッセージ文字列は、指定されたエンコードを用いて Unicode に変換され、そうでなければ ASCII とみなされます。"
 
 #: ../../library/gettext.rst:384
 msgid ""
@@ -576,13 +614,19 @@ msgid ""
 " the look up is forwarded to the fallback's :meth:`pgettext` method.  "
 "Otherwise, the *message* id is returned."
 msgstr ""
+"カタログから *context* と *message* id を検索して、対応するメッセージ文字列を、 Unicode でエンコードして返します。 "
+"*message* id と *context* "
+"に対するエントリがカタログに存在せず、フォールバックが設定されている場合、フォールバック検索はオブジェクトの :meth:`pgettext` "
+"メソッドに転送されます。そうでない場合、 *message* id 自体が返されます。"
 
 #: ../../library/gettext.rst:441
 msgid ""
 "Do a plural-forms lookup of a message id.  *singular* is used as the message"
 " id for purposes of lookup in the catalog, while *n* is used to determine "
 "which plural form to use."
 msgstr ""
+"メッセージ id に対する複数形を検索します。カタログに対する検索では *singular* がメッセージ id として用いられ、 *n* "
+"にはどの複数形を用いるかを指定します。"
 
 #: ../../library/gettext.rst:445
 msgid ""
@@ -674,7 +718,7 @@ msgstr "マークづけをしたファイルに一連のツールを走らせ、
 
 #: ../../library/gettext.rst:511
 msgid "create language-specific translations of the message catalogs"
-msgstr ""
+msgstr "特定の言語へのメッセージカタログの翻訳を作成します"
 
 #: ../../library/gettext.rst:513
 msgid ""
@@ -782,6 +826,8 @@ msgid ""
 "changes, e.g. to the built-in namespace. You should not use the GNU "
 ":program:`gettext` API but instead the class-based API."
 msgstr ""
+"モジュールを地域化する場合、グローバルな変更、例えば組み込み名前空間への変更を行わないように注意しなければなりません。GNU "
+":program:`gettext` API ではなく、クラス形式の API を使うべきです。"
 
 #: ../../library/gettext.rst:576
 msgid ""
@@ -958,6 +1004,12 @@ msgid ""
 "this reason, it is always best to call :func:`bindtextdomain` with an "
 "explicit absolute path at the start of your application."
 msgstr ""
+"標準でロケールが収められているディレクトリはシステム依存です; 例えば、RedHat Linux では "
+":file:`/usr/share/locale` ですが、 Solaris では :file:`/usr/lib/locale` です。 "
+":mod:`gettext` モジュールはこうしたシステム依存の標準設定をサポートしません; その代わりに "
+":file:`{sys.base_prefix}/share/locale` (:data:`sys.base_prefix` "
+"を参照してください)を標準の設定とします。この理由から、常にアプリケーションの開始時に絶対パスで明示的に指定して "
+":func:`bindtextdomain` を呼び出すのが最良のやり方ということになります。"
 
 #: ../../library/gettext.rst:732
 msgid "See the footnote for :func:`bindtextdomain` above."