python
diff --git a/‎library/parser.po
Lines changed: 48 additions & 57 deletions b/‎library/parser.po
Lines changed: 48 additions & 57 deletions
@@ -11,7 +11,7 @@ msgid ""
 msgstr ""
 "Project-Id-Version: Python 3.7\n"
 "Report-Msgid-Bugs-To: \n"
-"POT-Creation-Date: 2019-01-01 10:14+0900\n"
+"POT-Creation-Date: 2019-09-21 03:33+0000\n"
 "PO-Revision-Date: 2019-09-01 03:30+0000\n"
 "Last-Translator: tomo, 2019\n"
 "Language-Team: Japanese (https://www.transifex.com/python-doc/teams/5390/ja/)\n"
@@ -75,20 +75,11 @@ msgid ""
 "trees to be created in the target version, with the only restriction being "
 "that migrating to an older version of the interpreter will not support more "
 "recent language constructs.  The parse trees are not typically compatible "
-"from one version to another, whereas source code has always been forward-"
-"compatible."
+"from one version to another, though source code has usually been forward-"
+"compatible within a major release series."
 msgstr ""
-"もっとも重要なことは、内部パーサが処理する Python "
-"の文法についてよく理解しておく必要があるということです。言語の文法に関する完全な情報については、 :ref:`reference-index` "
-"を参照してください。標準の Python ディストリビューションに含まれるファイル :file:`Grammar/Grammar` "
-"の中で定義されている文法仕様から、パーサ自身は作成されています。このモジュールが作成する ST オブジェクトの中に格納される解析木は、下で説明する "
-":func:`expr` または :func:`suite` 関数によって作られるときに内部パーサから実際に出力されるものです。 "
-":func:`sequence2st` が作る ST オブジェクトは忠実にこれらの構造をシミュレートしています。言語の形式文法が改訂されるために、 "
-"\"正しい\" と考えられるシーケンスの値が Python のあるバージョンから別のバージョンで変化することがあるということに注意してください。しかし、"
-" Python "
-"のあるバージョンから別のバージョンへテキストのソースのままコードを移せば、目的のバージョンで正しい解析木を常に作成できます。ただし、インタープリタの古いバージョンへ移行する際に、最近の言語コンストラクトをサポートしていないことがあるという制限だけがあります。ソースコードが常に前方互換性があるのに対して、一般的に解析木はあるバージョンから別のバージョンへの互換性がありません。"
-
-#: ../../library/parser.rst:56
+
+#: ../../library/parser.rst:57
 msgid ""
 "Each element of the sequences returned by :func:`st2list` or "
 ":func:`st2tuple` has a simple form.  Sequences representing non-terminal "
@@ -121,7 +112,7 @@ msgstr ""
 "トークンに対応する数値です。行番号情報が必要なときに返される別の形式では、同じトークンが ``(1, 'if', 12)`` "
 "のように表されます。ここでは、 ``12`` が終端記号の見つかった行番号を表しています。"
 
-#: ../../library/parser.rst:73
+#: ../../library/parser.rst:74
 msgid ""
 "Terminal elements are represented in much the same way, but without any "
 "child elements and the addition of the source text which was identified.  "
@@ -133,7 +124,7 @@ msgstr ""
 "キーワードの例が代表的なものです。終端記号のいろいろな型は、 C ヘッダファイル :file:`Include/token.h` と Python "
 "モジュール :mod:`token` で定義されています。"
 
-#: ../../library/parser.rst:79
+#: ../../library/parser.rst:80
 msgid ""
 "The ST objects are not required to support the functionality of this module,"
 " but are provided for three purposes: to allow an application to amortize "
@@ -148,7 +139,7 @@ msgstr ""
 "のリストやタプル表現に比べてメモリ空間を保全する解析木表現を提供するため、解析木を操作する追加モジュールを C で作ることを簡単にするため。ST "
 "オブジェクトを使っていることを隠すために、簡単な \"ラッパー\" クラスを Python で作ることができます。"
 
-#: ../../library/parser.rst:87
+#: ../../library/parser.rst:88
 msgid ""
 "The :mod:`parser` module defines functions for a few distinct purposes.  The"
 " most important purposes are to create ST objects and to convert ST objects "
@@ -160,29 +151,29 @@ msgstr ""
 "オブジェクトを解析木とコンパイルされたコードオブジェクトのような他の表現に変換することです。しかし、 ST "
 "オブジェクトで表現された解析木の型を調べるために役に立つ関数もあります。"
 
-#: ../../library/parser.rst:97
+#: ../../library/parser.rst:98
 msgid "Module :mod:`symbol`"
 msgstr ":mod:`symbol` モジュール"
 
-#: ../../library/parser.rst:97
+#: ../../library/parser.rst:98
 msgid "Useful constants representing internal nodes of the parse tree."
 msgstr "解析木の内部ノードを表す便利な定数。"
 
-#: ../../library/parser.rst:100
+#: ../../library/parser.rst:101
 msgid "Module :mod:`token`"
 msgstr ":mod:`token` モジュール"
 
-#: ../../library/parser.rst:100
+#: ../../library/parser.rst:101
 msgid ""
 "Useful constants representing leaf nodes of the parse tree and functions for"
 " testing node values."
 msgstr "便利な解析木の葉のノードを表す定数とノード値をテストするための関数。"
 
-#: ../../library/parser.rst:107
+#: ../../library/parser.rst:108
 msgid "Creating ST Objects"
 msgstr "ST オブジェクトを作成する"
 
-#: ../../library/parser.rst:109
+#: ../../library/parser.rst:110
 msgid ""
 "ST objects may be created from source code or from a parse tree. When "
 "creating an ST object from source, different functions are used to create "
@@ -191,7 +182,7 @@ msgstr ""
 "ST オブジェクトはソースコードあるいは解析木から作られます。ST オブジェクトをソースから作るときは、``'eval'`` と ``'exec'`` "
 "形式を作成するために別々の関数が使われます。"
 
-#: ../../library/parser.rst:116
+#: ../../library/parser.rst:117
 msgid ""
 "The :func:`expr` function parses the parameter *source* as if it were an "
 "input to ``compile(source, 'file.py', 'eval')``.  If the parse succeeds, an "
@@ -202,7 +193,7 @@ msgstr ""
 "関数はパラメータ *source* を構文解析します。解析が成功した場合は、 ST "
 "オブジェクトは内部解析木表現を保持するために作成されます。そうでなければ、適切な例外を発生させます。"
 
-#: ../../library/parser.rst:124
+#: ../../library/parser.rst:125
 msgid ""
 "The :func:`suite` function parses the parameter *source* as if it were an "
 "input to ``compile(source, 'file.py', 'exec')``.  If the parse succeeds, an "
@@ -213,7 +204,7 @@ msgstr ""
 "関数はパラメータ *source* を構文解析します。解析が成功した場合は、 ST "
 "オブジェクトは内部解析木表現を保持するために作成されます。そうでなければ、適切な例外を発生させます。"
 
-#: ../../library/parser.rst:132
+#: ../../library/parser.rst:133
 msgid ""
 "This function accepts a parse tree represented as a sequence and builds an "
 "internal representation if possible.  If it can validate that the tree "
@@ -239,7 +230,7 @@ msgstr ""
 "を解析した結果のようなコンストラクトが原因であるかもしれません。このようなコンストラクトは Python "
 "のパーサを逃れますが、バイトコードインタープリタによってチェックされます。"
 
-#: ../../library/parser.rst:145
+#: ../../library/parser.rst:146
 msgid ""
 "Sequences representing terminal tokens may be represented as either two-"
 "element lists of the form ``(1, 'name')`` or as three-element lists of the "
@@ -250,17 +241,17 @@ msgstr ""
 "終端トークンを表すシーケンスは、``(1, 'name')`` 形式の二つの要素のリストか、または ``(1, 'name', 56)`` "
 "形式の三つの要素のリストです。三番目の要素が存在する場合は、有効な行番号だとみなされます。行番号が指定されるのは、入力木の終端記号の一部に対してです。"
 
-#: ../../library/parser.rst:154
+#: ../../library/parser.rst:155
 msgid ""
 "This is the same function as :func:`sequence2st`.  This entry point is "
 "maintained for backward compatibility."
 msgstr "これは :func:`sequence2st` と同じ関数です。このエントリポイントは後方互換性のために維持されています。"
 
-#: ../../library/parser.rst:161
+#: ../../library/parser.rst:162
 msgid "Converting ST Objects"
 msgstr "ST オブジェクトを変換する"
 
-#: ../../library/parser.rst:163
+#: ../../library/parser.rst:164
 msgid ""
 "ST objects, regardless of the input used to create them, may be converted to"
 " parse trees represented as list- or tuple- trees, or may be compiled into "
@@ -270,7 +261,7 @@ msgstr ""
 "作成するために使われた入力に関係なく、ST "
 "オブジェクトはリスト木またはタプル木として表される解析木へ変換されるか、または実行可能なオブジェクトへコンパイルされます。解析木は行番号情報を持って、あるいは持たずに抽出されます。"
 
-#: ../../library/parser.rst:171
+#: ../../library/parser.rst:172
 msgid ""
 "This function accepts an ST object from the caller in *st* and returns a "
 "Python list representing the equivalent parse tree.  The resulting list "
@@ -287,7 +278,7 @@ msgstr ""
 " :func:`st2tuple` "
 "を代わりに使うべきです。リスト表現が必要とされるとき、この関数はタプル表現を取り出して入れ子のリストに変換するよりかなり高速です。"
 
-#: ../../library/parser.rst:181
+#: ../../library/parser.rst:182
 msgid ""
 "If *line_info* is true, line number information will be included for all "
 "terminal tokens as a third element of the list representing the token.  Note"
@@ -297,7 +288,7 @@ msgstr ""
 "*line_info* が真ならば、トークンを表すリストの三番目の要素として行番号情報がすべての終端トークンに含まれます。与えられた行番号はトークン "
 "*が終わる* 行を指定していることに注意してください。フラグが偽または省略された場合は、この情報は省かれます。"
 
-#: ../../library/parser.rst:189
+#: ../../library/parser.rst:190
 msgid ""
 "This function accepts an ST object from the caller in *st* and returns a "
 "Python tuple representing the equivalent parse tree.  Other than returning a"
@@ -306,7 +297,7 @@ msgstr ""
 "この関数は呼び出し側から *st* に ST オブジェクトを受け取り、解析木と等価な Python "
 "のタプルを返します。リストの代わりにタプルを返す以外は、この関数は :func:`st2list` と同じです。"
 
-#: ../../library/parser.rst:193
+#: ../../library/parser.rst:194
 msgid ""
 "If *line_info* is true, line number information will be included for all "
 "terminal tokens as a third element of the list representing the token.  This"
@@ -315,7 +306,7 @@ msgstr ""
 "*line_info* "
 "が真ならば、トークンを表すリストの三番目の要素として行番号情報がすべての終端トークンに含まれます。フラグが偽または省略された場合は、この情報は省かれます。"
 
-#: ../../library/parser.rst:204
+#: ../../library/parser.rst:205
 msgid ""
 "The Python byte compiler can be invoked on an ST object to produce code "
 "objects which can be used as part of a call to the built-in :func:`exec` or "
@@ -329,7 +320,7 @@ msgstr ""
 "パラメータで指定されるソースファイル名を使って、 *st* からパーサへ内部解析木を渡します。 *filename* "
 "に与えられるデフォルト値は、ソースが ST オブジェクトだったことを示唆しています。"
 
-#: ../../library/parser.rst:211
+#: ../../library/parser.rst:212
 msgid ""
 "Compiling an ST object may result in exceptions related to compilation; an "
 "example would be a :exc:`SyntaxError` caused by the parse tree for ``del "
@@ -346,11 +337,11 @@ msgstr ""
 "は、実際には Python バイトコンパイラによって通常作り出されます。これが :mod:`parser` "
 "モジュールがこの時点で例外を発生できる理由です。解析木のインスペクションを行うことで、コンパイルが失敗するほとんどの原因をプログラムによって診断することができます。"
 
-#: ../../library/parser.rst:224
+#: ../../library/parser.rst:225
 msgid "Queries on ST Objects"
 msgstr "ST オブジェクトに対する問い合わせ"
 
-#: ../../library/parser.rst:226
+#: ../../library/parser.rst:227
 msgid ""
 "Two functions are provided which allow an application to determine if an ST "
 "was created as an expression or a suite.  Neither of these functions can be "
@@ -361,7 +352,7 @@ msgstr ""
 "ST が :func:`expr` または :func:`suite` を通してソースコードから作られたかどうか、あるいは、 "
 ":func:`sequence2st` を通して解析木から作られたかどうかを決定できません。"
 
-#: ../../library/parser.rst:236
+#: ../../library/parser.rst:237
 msgid ""
 "When *st* represents an ``'eval'`` form, this function returns true, "
 "otherwise it returns false.  This is useful, since code objects normally "
@@ -375,7 +366,7 @@ msgstr ""
 " :func:`compilest` によって作成されたコードオブジェクトに問い合わせることはできませんし、そのコードオブジェクトは組み込み "
 ":func:`compile` 関数によって作成されたコードオブジェクトと同じであることに注意してください。"
 
-#: ../../library/parser.rst:245
+#: ../../library/parser.rst:246
 msgid ""
 "This function mirrors :func:`isexpr` in that it reports whether an ST object"
 " represents an ``'exec'`` form, commonly known as a \"suite.\"  It is not "
@@ -386,11 +377,11 @@ msgstr ""
 ":func:`isexpr` に酷似しています。追加の構文が将来サポートされるかもしれないので、この関数が ``not isexpr(st)`` "
 "と等価であるとみなすのは安全ではありません。"
 
-#: ../../library/parser.rst:254
+#: ../../library/parser.rst:255
 msgid "Exceptions and Error Handling"
 msgstr "例外とエラー処理"
 
-#: ../../library/parser.rst:256
+#: ../../library/parser.rst:257
 msgid ""
 "The parser module defines a single exception, but may also pass other built-"
 "in exceptions from other portions of the Python runtime environment.  See "
@@ -399,7 +390,7 @@ msgstr ""
 "parser モジュールは例外を一つ定義していますが、Python "
 "ランタイム環境の他の部分が提供する別の組み込み例外を発生させることもあります。各関数が発生させる例外の情報については、それぞれ関数を参照してください。"
 
-#: ../../library/parser.rst:263
+#: ../../library/parser.rst:264
 msgid ""
 "Exception raised when a failure occurs within the parser module.  This is "
 "generally produced for validation failures rather than the built-in "
@@ -417,7 +408,7 @@ msgstr ""
 "へ渡される解析木の中の障害を引き起こすシーケンスを含むタプルと説明用の文字列である場合があります。モジュール内の他の関数の呼び出しは単純な文字列値を検出すればよいだけですが、"
 " :func:`sequence2st` の呼び出しはどちらの例外の型も処理できる必要があります。"
 
-#: ../../library/parser.rst:272
+#: ../../library/parser.rst:273
 msgid ""
 "Note that the functions :func:`compilest`, :func:`expr`, and :func:`suite` "
 "may raise exceptions which are normally raised by the parsing and "
@@ -432,53 +423,53 @@ msgstr ""
 ":exc:`OverflowError` 、 :exc:`SyntaxError` および :exc:`SystemError` "
 "が含まれます。こうした場合には、これらの例外が通常その例外に関係する全ての意味を伝えます。詳細については、各関数の説明を参照してください。"
 
-#: ../../library/parser.rst:283
+#: ../../library/parser.rst:284
 msgid "ST Objects"
 msgstr "ST オブジェクト"
 
-#: ../../library/parser.rst:285
+#: ../../library/parser.rst:286
 msgid ""
 "Ordered and equality comparisons are supported between ST objects. Pickling "
 "of ST objects (using the :mod:`pickle` module) is also supported."
 msgstr ""
 "ST オブジェクト間の順序と等値性の比較がサポートされています。 (:mod:`pickle` モジュールを使った) ST "
 "オブジェクトのピクルス化もサポートされています。"
 
-#: ../../library/parser.rst:291
+#: ../../library/parser.rst:292
 msgid ""
 "The type of the objects returned by :func:`expr`, :func:`suite` and "
 ":func:`sequence2st`."
 msgstr ":func:`expr` 、 :func:`suite` と :func:`sequence2st` が返すオブジェクトの型。"
 
-#: ../../library/parser.rst:294
+#: ../../library/parser.rst:295
 msgid "ST objects have the following methods:"
 msgstr "ST オブジェクトは次のメソッドを持っています:"
 
-#: ../../library/parser.rst:299
+#: ../../library/parser.rst:300
 msgid "Same as ``compilest(st, filename)``."
 msgstr "``compilest(st, filename)`` と同じ。"
 
-#: ../../library/parser.rst:304
+#: ../../library/parser.rst:305
 msgid "Same as ``isexpr(st)``."
 msgstr "``isexpr(st)`` と同じ。"
 
-#: ../../library/parser.rst:309
+#: ../../library/parser.rst:310
 msgid "Same as ``issuite(st)``."
 msgstr "``issuite(st)`` と同じ。"
 
-#: ../../library/parser.rst:314
+#: ../../library/parser.rst:315
 msgid "Same as ``st2list(st, line_info, col_info)``."
 msgstr "``st2list(st, line_info, col_info)`` と同じ。"
 
-#: ../../library/parser.rst:319
+#: ../../library/parser.rst:320
 msgid "Same as ``st2tuple(st, line_info, col_info)``."
 msgstr "``st2tuple(st, line_info, col_info)`` と同じ。"
 
-#: ../../library/parser.rst:323
+#: ../../library/parser.rst:324
 msgid "Example: Emulation of :func:`compile`"
 msgstr "例: :func:`compile` のエミュレーション"
 
-#: ../../library/parser.rst:325
+#: ../../library/parser.rst:326
 msgid ""
 "While many useful operations may take place between parsing and bytecode "
 "generation, the simplest operation is to do nothing.  For this purpose, "
@@ -488,15 +479,15 @@ msgstr ""
 "たくさんの有用な演算を構文解析とバイトコード生成の間に行うことができますが、もっとも単純な演算は何もしないことです。このため、 "
 ":mod:`parser` モジュールを使って中間データ構造を作ることは次のコードと等価です ::"
 
-#: ../../library/parser.rst:335
+#: ../../library/parser.rst:336
 msgid ""
 "The equivalent operation using the :mod:`parser` module is somewhat longer, "
 "and allows the intermediate internal parse tree to be retained as an ST "
 "object::"
 msgstr ""
 ":mod:`parser` モジュールを使った等価な演算はやや長くなりますが、 ST オブジェクトとして中間内部解析木が維持されるようにします::"
 
-#: ../../library/parser.rst:345
+#: ../../library/parser.rst:346
 msgid ""
 "An application which needs both ST and code objects can package this code "
 "into readily available functions::"