python
diff --git a/‎howto/clinic.po
Lines changed: 115 additions & 6 deletions b/‎howto/clinic.po
Lines changed: 115 additions & 6 deletions
@@ -86,7 +86,7 @@ msgstr ""
 "一切の引数解析を行わなくなります。Argument Clinic が生成するコードがブラック"
 "ボックスになり、CPython がそのブラックボックスの先頭を呼び出し、最後にその関"
 "数のコードが呼ばれます。引数の ``PyObject *args`` (と ``PyObject *kwargs``) "
-"は暗黙的に、必要な型のC言語の変数に変換されます。"
+"は暗黙的に、必要な型の C の変数に変換されます。"
 
 #: ../../howto/clinic.rst:43
 msgid ""
@@ -368,6 +368,10 @@ msgid ""
 "should have just the text, based at the left margin, with no line wider than "
 "80 characters. (Argument Clinic will preserve indents inside the docstring.)"
 msgstr ""
+"docstring を切り取って ``[clinic]`` の行の間に貼り付け、適切にクォートされた "
+"C の文字列になるようにガラクタを全て削除します。そうすると、80文字以上の行が"
+"ない、左マージンに揃えられた、テキストだけになるはずです。 (Argument Clinic "
+"は docstring 内のインデントを保持します。)"
 
 #: ../../howto/clinic.rst:201
 msgid ""
@@ -376,6 +380,10 @@ msgid ""
 "``help()`` on your builtin in the future, the first line will be built "
 "automatically based on the function's signature.)"
 msgstr ""
+"古い docstring の最初の行に関数シグネチャのようなものがある場合は、その行を破"
+"棄します。 (docstring は最早必要ありません — 将来あなたのビルトインで "
+"``help()`` を使うときは、 最初の行は、 関数のシグネチャに基づいて自動的にビル"
+"ドされます。)"
 
 #: ../../howto/clinic.rst:207 ../../howto/clinic.rst:228
 #: ../../howto/clinic.rst:252 ../../howto/clinic.rst:310
@@ -391,12 +399,17 @@ msgid ""
 "paragraph consisting of a single 80-column line at the beginning of the "
 "docstring."
 msgstr ""
+"あなたの docstring に「要約」(summary)行がない場合、 Argument Clinic は文句を"
+"言います。 なので、それがあることを確認しましょう。 「要約」行は、 docstring "
+"の先頭にあり、 80 桁以内の単一の行で構成される段落である必要があります。"
 
 #: ../../howto/clinic.rst:218
 msgid ""
 "(Our example docstring consists solely of a summary line, so the sample code "
 "doesn't have to change for this step.)"
 msgstr ""
+"(例の docstring は要約行のみで構成されているため、このステップではサンプル・"
+"コードを変更する必要はありません。)"
 
 #: ../../howto/clinic.rst:221
 msgid ""
@@ -406,6 +419,10 @@ msgid ""
 "module, include any sub-modules, and if the function is a method on a class "
 "it should include the class name too."
 msgstr ""
+"docstring に関数の名前を入力し、その後に空白行を入力します。 これは関数の "
+"Python 名であり、 関数への完全なドット・パス(full dotted path)である必要があ"
+"ります。つまり、それはモジュール名で始まり、サブモジュールが含まれている必要"
+"があり、関数がクラスのメソッドである場合は、クラス名も含める必要があります。"
 
 #: ../../howto/clinic.rst:236
 msgid ""
@@ -416,46 +433,65 @@ msgid ""
 "statics go at the top.  (In our sample code we'll just show the two blocks "
 "next to each other.)"
 msgstr ""
+"モジュールまたはクラスがこの C ファイルの Argument Clinic で初めて使用される"
+"場合は、モジュール および/または クラスを宣言する必要があります。 Argument "
+"Clinic 界隈では、これらを C ファイルの先頭近くの別のブロックで宣言することが"
+"好ましいとされます。これは、インクルード・ファイル や statics が先頭に配置さ"
+"れるのと同一の手法です。 (なお、 このコード例では、説明の都合上 2 つのブロッ"
+"クを続けて表示しています。)"
 
 #: ../../howto/clinic.rst:244
 msgid ""
 "The name of the class and module should be the same as the one seen by "
 "Python.  Check the name defined in the :c:type:`PyModuleDef` or :c:type:"
 "`PyTypeObject` as appropriate."
 msgstr ""
+"クラス名とモジュール名は、 Python で表示されるものと同一にする必要がありま"
+"す。 :c:type:`PyModuleDef` または :c:type:`PyTypeObject` で定義されている名前"
+"を適宜確認してください。"
 
 #: ../../howto/clinic.rst:248
 msgid ""
 "When you declare a class, you must also specify two aspects of its type in "
 "C: the type declaration you'd use for a pointer to an instance of this "
 "class, and a pointer to the :c:type:`PyTypeObject` for this class."
 msgstr ""
+"クラスを宣言するときは、 C では、その型の 2 つの側面も指定する必要がありま"
+"す。 それは、このクラスのインスタンスへのポインタに使用する型宣言と、このクラ"
+"スの :c:type:`PyTypeObject` へのポインタに使用する型宣言です。"
 
 #: ../../howto/clinic.rst:268
 msgid ""
 "Declare each of the parameters to the function.  Each parameter should get "
 "its own line.  All the parameter lines should be indented from the function "
 "name and the docstring."
 msgstr ""
+"関数のための各引数(parameters)を宣言します。 各引数は、それぞれ独立した行であ"
+"る必要があります。すべての引数行は、関数名と docstring からインデントさせる必"
+"要があります。"
 
 #: ../../howto/clinic.rst:272
 msgid "The general form of these parameter lines is as follows:"
-msgstr ""
+msgstr "これらの引数行の一般的な形式は以下のとおりです:"
 
 #: ../../howto/clinic.rst:278
 msgid "If the parameter has a default value, add that after the converter:"
 msgstr ""
+"引数にデフォルト値がある場合は、コンバーター(converter)の後に追加します:"
 
 #: ../../howto/clinic.rst:285
 msgid ""
 "Argument Clinic's support for \"default values\" is quite sophisticated; "
 "please see :ref:`the section below on default values <default_values>` for "
 "more information."
 msgstr ""
+"「デフォルト値」に対する Argument Clinic のサポートは非常に洗練されています。"
+"詳細については、 :ref:`下記 引数のデフォルト値 セクション <default_values>` "
+"を参照してください。"
 
 #: ../../howto/clinic.rst:289
 msgid "Add a blank line below the parameters."
-msgstr ""
+msgstr "全ての引数の下に空白行を追加します。"
 
 #: ../../howto/clinic.rst:291
 msgid ""
@@ -465,6 +501,10 @@ msgid ""
 "convenience syntax intended to make porting old code into Argument Clinic "
 "easier."
 msgstr ""
+"「コンバーター」(converter)は、 C で使用される変数の型と、実行時に Python の"
+"値を C の値に変換する方法の、両方を確立します。 ここでは、 「レガシー・コン"
+"バーター」(legacy converter) と呼ばれるものを使用します。これは、古いコード"
+"を Argument Clinic に簡単に移植できるようにするための便利な構文です。"
 
 #: ../../howto/clinic.rst:298
 msgid ""
@@ -475,57 +515,84 @@ msgid ""
 "parsing function what the type of the variable is and how to convert it.  "
 "For more on format units please see :ref:`arg-parsing`.)"
 msgstr ""
+"各引数について、その引数の「フォーマット単位」を ``PyArg_Parse()`` のフォー"
+"マット引数からコピーし、 引用符に囲まれた文字列にして、 *that* にコンバーター"
+"として指定します。 (「フォーマット単位」(format unit)とは、引数解析関数に変数"
+"の型とその変換方法を伝える ``format`` パラメータの 1 ～ 3 文字の部分文字列の"
+"正式な名前です。フォーマット単位の詳細については、 :ref:`arg-parsing` を参照"
+"してください。)"
 
 #: ../../howto/clinic.rst:307
 msgid ""
 "For multicharacter format units like ``z#``, use the entire two-or-three "
 "character string."
 msgstr ""
+"``z#`` のような複数文字のフォーマット単位の場合、2または3文字の文字列全体を使"
+"用します。"
 
 #: ../../howto/clinic.rst:325
 msgid ""
 "If your function has ``|`` in the format string, meaning some parameters "
 "have default values, you can ignore it.  Argument Clinic infers which "
 "parameters are optional based on whether or not they have default values."
 msgstr ""
+"関数のフォーマット文字列に ``|`` が含まれている場合、つまり一部の引数にデフォ"
+"ルト値がある場合は、無視してかまいません。 Argument Clinic は、デフォルト値が"
+"あるかどうかに基づいて、どの引数がオプションなのかを推測します。"
 
 #: ../../howto/clinic.rst:330
 msgid ""
 "If your function has ``$`` in the format string, meaning it takes keyword-"
 "only arguments, specify ``*`` on a line by itself before the first keyword-"
 "only argument, indented the same as the parameter lines."
 msgstr ""
+"関数のフォーマット文字列に ``$`` が含まれている場合、つまりキーワードのみの引"
+"数を取る場合は、最初のキーワードのみの引数の、前の行に ``*`` を単独で指定し、"
+"引数行と同一のインデントを行います。"
 
 #: ../../howto/clinic.rst:335
 msgid "(``_pickle.Pickler.dump`` has neither, so our sample is unchanged.)"
 msgstr ""
+"(なお、 ``_pickle.Pickler.dump`` にはどちらも含まれていないため、サンプルは変"
+"更されていません。)"
 
 #: ../../howto/clinic.rst:338
 msgid ""
 "If the existing C function calls :c:func:`PyArg_ParseTuple` (as opposed to :"
 "c:func:`PyArg_ParseTupleAndKeywords`), then all its arguments are positional-"
 "only."
 msgstr ""
+"既存の C 関数が、(:c:func:`PyArg_ParseTupleAndKeywords` ではなく、) :c:func:"
+"`PyArg_ParseTuple` を呼び出す場合、そのすべての引数は位置のみです(positional-"
+"only)。"
 
 #: ../../howto/clinic.rst:342
 msgid ""
 "To mark all parameters as positional-only in Argument Clinic, add a ``/`` on "
 "a line by itself after the last parameter, indented the same as the "
 "parameter lines."
 msgstr ""
+"Argument Clinic ですべての引数を位置のみ(positional-only)としてマークするに"
+"は、引数行と同一のインデントにして、最後の引数の次の行に ``/`` を追加します。"
 
 #: ../../howto/clinic.rst:346
 msgid ""
 "Currently this is all-or-nothing; either all parameters are positional-only, "
 "or none of them are.  (In the future Argument Clinic may relax this "
 "restriction.)"
 msgstr ""
+"現在のところ、これは、すべての引数が位置のみ(positional-only)であるか、全てが"
+"そうでないかのどちらかです(all-or-nothing)。 (Argument Clinic は将来はこの制"
+"限を緩和する可能性もあります。)"
 
 #: ../../howto/clinic.rst:366
 msgid ""
 "It's helpful to write a per-parameter docstring for each parameter. But per-"
 "parameter docstrings are optional; you can skip this step if you prefer."
 msgstr ""
+"各引数に引数ごとの docstring (per-parameter docstring)を記述すると助けになり"
+"ます。 ただし、引数ごとの docstring はオプションですので、必要に応じて、この"
+"手順はスキップできます。"
 
 #: ../../howto/clinic.rst:370
 msgid ""
@@ -536,33 +603,50 @@ msgid ""
 "amount.  You can write as much text as you like, across multiple lines if "
 "you wish."
 msgstr ""
+"引数ごとの docstring を追加する方法: 引数ごとの docstring の最初の行は、引数"
+"行定義よりもさらにインデントする必要があります。 この最初の行の左マージンは、"
+"引数ごとの docstring 全体の左マージンを確定します。 あなたが書くすべてのテキ"
+"ストは、この左マージン量だけアウトデントされます。 必要に応じて、複数行にまた"
+"がって、好きなだけテキストを書くことができます。"
 
 #: ../../howto/clinic.rst:394
 msgid ""
 "Save and close the file, then run ``Tools/clinic/clinic.py`` on it.  With "
 "luck everything worked---your block now has output, and a ``.c.h`` file has "
 "been generated! Reopen the file in your text editor to see::"
 msgstr ""
+"ファイルを保存して閉じ、 そのファイルに対して ``Tools/clinic/clinic.py`` を実"
+"行します。 運が良ければすべてうまくいきます --- つまり、 Argument Clinic ブ"
+"ロックに出力があり、かつ、 ``.c.h`` ファイルが生成されまます！ テキスト・エ"
+"ディタでそのファイルを再度開いて確認します::"
 
 #: ../../howto/clinic.rst:413
 msgid ""
 "Obviously, if Argument Clinic didn't produce any output, it's because it "
 "found an error in your input.  Keep fixing your errors and retrying until "
 "Argument Clinic processes your file without complaint."
 msgstr ""
+"Argument Clinic が明らかに出力を生成しなかった場合、それは入力にエラーが見つ"
+"かったためです。 Argument Clinic が問題なくファイルを処理するまで、エラーの修"
+"正と再試行を続けて下さい。。"
 
 #: ../../howto/clinic.rst:417
 msgid ""
 "For readability, most of the glue code has been generated to a ``.c.h`` "
 "file.  You'll need to include that in your original ``.c`` file, typically "
 "right after the clinic module block::"
 msgstr ""
+"読みやすさのために、ほとんどのグルー・コードは ``.c.h`` ファイルに生成されて"
+"います。 これを元の ``.c`` ファイルにインクルードする必要があり、通常は "
+"clinic モジュール・ブロックの直後に置きます::"
 
 #: ../../howto/clinic.rst:423
 msgid ""
 "Double-check that the argument-parsing code Argument Clinic generated looks "
 "basically the same as the existing code."
 msgstr ""
+"Argument Clinic が生成した引数解析コードが既存のコードと基本的に同じであるこ"
+"とをダブル・チェックします。"
 
 #: ../../howto/clinic.rst:426
 msgid ""
@@ -571,20 +655,32 @@ msgid ""
 "`PyArg_ParseTupleAndKeywords`; ensure that the code generated by Argument "
 "Clinic calls the *exact* same function."
 msgstr ""
+"1番目に、両方の場所で同じ引数解析関数が使用されていることを確認します。 既存"
+"のコードは :c:func:`PyArg_ParseTuple` または :c:func:"
+"`PyArg_ParseTupleAndKeywords` のいずれかを呼び出す必要があります。 Argument "
+"Clinic によって生成されたコードが *まったく同じ* 関数を呼び出すことを確認して"
+"ください。"
 
 #: ../../howto/clinic.rst:432
 msgid ""
 "Second, the format string passed in to :c:func:`PyArg_ParseTuple` or :c:func:"
 "`PyArg_ParseTupleAndKeywords` should be *exactly* the same as the hand-"
 "written one in the existing function, up to the colon or semi-colon."
 msgstr ""
+"2番目、 :c:func:`PyArg_ParseTuple` または :c:func:"
+"`PyArg_ParseTupleAndKeywords` に渡されるフォーマット文字列は、コロンまたはセ"
+"ミコロン含めて、既存の関数で手書きされたものと *まったく同じ* でなければなり"
+"ません。"
 
 #: ../../howto/clinic.rst:437
 msgid ""
 "(Argument Clinic always generates its format strings with a ``:`` followed "
 "by the name of the function.  If the existing code's format string ends with "
 "``;``, to provide usage help, this change is harmless—don't worry about it.)"
 msgstr ""
+"(Argument Clinic は常に ``:`` の後に関数名が続くフォーマット文字列を生成しま"
+"す。既存のコードのフォーマット文字列が ``;`` で終わっていた場合のこの変更は使"
+"用法のヘルプを提供するためで、この変更は無害です。 心配してないでください。）"
 
 #: ../../howto/clinic.rst:442
 msgid ""
@@ -593,13 +689,19 @@ msgid ""
 "function), ensure that the second argument is *exactly* the same between the "
 "two invocations."
 msgstr ""
+"3 番目に、フォーマット単位が 2 つの引数(arguments)を必要とする引数"
+"(parameters)(length 変数や、エンコード文字列や、変換関数へのポインタなど)につ"
+"いては、2 番目の引数(argument)が 2 つの呼び出し間で *正確に同じである* ことを"
+"確認してください。"
 
 #: ../../howto/clinic.rst:447
 msgid ""
 "Fourth, inside the output portion of the block you'll find a preprocessor "
 "macro defining the appropriate static :c:type:`PyMethodDef` structure for "
 "this builtin::"
 msgstr ""
+"4 番目に、ブロックの出力部分内に、このビルトインの適切な静的 :c:type:"
+"`PyMethodDef` 構造を定義するプリプロセッサ・マクロがあります::"
 
 #: ../../howto/clinic.rst:454
 msgid ""
@@ -696,21 +798,21 @@ msgstr ""
 
 #: ../../howto/clinic.rst:566
 msgid "Numeric constants (integer and float)"
-msgstr "数値定数 (整数と浮動小数)"
+msgstr "数値定数 (整数(integer)と浮動小数点数(float))"
 
 #: ../../howto/clinic.rst:567
 msgid "String constants"
 msgstr "文字列定数"
 
 #: ../../howto/clinic.rst:568
 msgid "``True``, ``False``, and ``None``"
-msgstr "``True``、``False``、``None``"
+msgstr "``True`` と ``False`` と ``None``"
 
 #: ../../howto/clinic.rst:569
 msgid ""
 "Simple symbolic constants like ``sys.maxsize``, which must start with the "
 "name of the module"
-msgstr ""
+msgstr "必ずモジュール名で始まる、 ``sys.maxsize`` のような単純な記号定数"
 
 #: ../../howto/clinic.rst:572
 msgid ""
@@ -723,6 +825,8 @@ msgid ""
 "(In the future, this may need to get even more elaborate, to allow full "
 "expressions like ``CONSTANT - 1``.)"
 msgstr ""
+"(将来的には、`CONSTANT - 1`` のような式を表現可能にするために、さらに精巧にす"
+"る必要があるかもしれません。)"
 
 #: ../../howto/clinic.rst:580
 msgid "Renaming the C functions and variables generated by Argument Clinic"
@@ -1071,6 +1175,9 @@ msgid ""
 "Clinic converters.  On the left is the legacy converter, on the right is the "
 "text you'd replace it with."
 msgstr ""
+"以下の表は、 legacy converter から実際の Argument Clinic converter へのマッピ"
+"ングを示す表です。左側は legacy converter で、右側がそれを置き換えたテキスト"
+"です。"
 
 #: ../../howto/clinic.rst:827
 msgid "``'B'``"
@@ -1409,6 +1516,8 @@ msgid ""
 "As an example, here's our sample ``pickle.Pickler.dump`` using the proper "
 "converter::"
 msgstr ""
+"例題の ``pickle.Pickler.dump`` 適切な converter を使用したものを以下示しま"
+"す::"
 
 #: ../../howto/clinic.rst:883
 msgid ""