pytho****@googl*****
pytho****@googl*****
2011年 2月 27日 (日) 01:46:52 JST
4 new revisions: Revision: 2a2b732903 Author: Nozomu Kaneko <nozom****@gmail*****> Date: Sat Feb 26 08:43:53 2011 Log: 翻訳のため原文をコメントで追加 http://code.google.com/p/python-doc-ja/source/detail?r=2a2b732903 Revision: 12d0e11115 Author: Nozomu Kaneko <nozom****@gmail*****> Date: Sat Feb 26 08:43:56 2011 Log: Update to 2.6.6: library/__future__.rst http://code.google.com/p/python-doc-ja/source/detail?r=12d0e11115 Revision: 037349cf8d Author: Nozomu Kaneko <nozom****@gmail*****> Date: Sat Feb 26 08:43:56 2011 Log: 翻訳の改善 (library/__future__.rst) http://code.google.com/p/python-doc-ja/source/detail?r=037349cf8d Revision: bc0b26a44a Author: Nozomu Kaneko <nozom****@gmail*****> Date: Sat Feb 26 08:44:19 2011 Log: 誤字を修正 http://code.google.com/p/python-doc-ja/source/detail?r=bc0b26a44a ============================================================================== Revision: 2a2b732903 Author: Nozomu Kaneko <nozom****@gmail*****> Date: Sat Feb 26 08:43:53 2011 Log: 翻訳のため原文をコメントで追加 http://code.google.com/p/python-doc-ja/source/detail?r=2a2b732903 Modified: /library/__future__.rst ======================================= --- /library/__future__.rst Sat Nov 27 10:59:46 2010 +++ /library/__future__.rst Sat Feb 26 08:43:53 2011 @@ -5,8 +5,24 @@ :synopsis: Future ステートメントの定義 +.. :mod:`__future__` is a real module, and serves three purposes: + :mod:`__future__` は実際にモジュールであり、3つの役割があります。 + +.. * To avoid confusing existing tools that analyze import statements and expect to +.. find the modules they're importing. + +.. * To ensure that future_statements run under releases prior to 2.1 at least +.. yield runtime exceptions (the import of :mod:`__future__` will fail, because +.. there was no module of that name prior to 2.1). + +.. * To document when incompatible changes were introduced, and when they will be +.. --- or were --- made mandatory. This is a form of executable documentation, and +.. can be inspected programmatically via importing :mod:`__future__` and examining +.. its contents. + + * import ステートメントを解析する既存のツールを混乱させるのを避け、 そのステートメントがインポートしようとしているモジュールを見つけられるよ うにするため。 @@ -17,15 +33,23 @@ これは実行できる形式で書かれたドキュメントでなので、:mod:`__future__` をインポートし、その中身を調べるようプログラムすれば確かめられます。 + +.. Each statement in :file:`__future__.py` is of the form: + :file:`__future__.py` の各ステートメントは次のような形をしています:: + FeatureName = _Feature(OptionalRelease, MandatoryRelease, CompilerFlag) +.. where, normally, *OptionalRelease* is less than *MandatoryRelease*, and both are +.. 5-tuples of the same form as ``sys.version_info``: + ここで、普通は、 *OptionalRelease* は *MandatoryRelease* より小さく、2つと も ``sys.version_info`` と同じフォーマットの5つのタプルからなります。 :: + (PY_MAJOR_VERSION, # the 2 in 2.1.0a3; an int PY_MINOR_VERSION, # the 1; an int PY_MICRO_VERSION, # the 0; an int @@ -33,22 +57,52 @@ PY_RELEASE_SERIAL # the 3; an int ) + +.. *OptionalRelease* records the first release in which the feature was accepted. + *OptionalRelease* はその機能が導入された最初のリリースを記録します。 + +.. In the case of a *MandatoryRelease* that has not yet occurred, +.. *MandatoryRelease* predicts the release in which the feature will become part of +.. the language. + まだ時期が来ていない *MandatoryRelease* の場合、 *MandatoryRelease* はその 機能が言語の一部となるリリースを記します。 + +.. Else *MandatoryRelease* records when the feature became part of the language; in +.. releases at or after that, modules no longer need a future statement to use the +.. feature in question, but may continue to use such imports. + その他の場合、 *MandatoryRelease* はその機能がいつ言語の一部になったのかを 記録します。 そのリリースから、あるいはそれ以降のリリースでは、この機能を使う際に future ステートメントは必要ではありませんが、future ステートメントを使い続 けても構いません。 + +.. *MandatoryRelease* may also be ``None``, meaning that a planned feature got +.. dropped. + *MandatoryRelease* は ``None`` になるかもしれません。つまり、予定された機能 が破棄されたということです。 + +.. Instances of class :class:`_Feature` have two corresponding methods, +.. :meth:`getOptionalRelease` and :meth:`getMandatoryRelease`. + :class:`_Feature` クラスのインスタンスには対応する2つのメソッ ド、 :meth:`getOptionalRelease` と :meth:`getMandatoryRelease` があります。 + +.. *CompilerFlag* is the (bitfield) flag that should be passed in the fourth +.. argument to the builtin function :func:`compile` to enable the feature in +.. dynamically compiled code. This flag is stored in the :attr:`compiler_flag` +.. attribute on :class:`_Feature` instances. + *CompilerFlag* は動的にコンパイルされるコードでその機能を有効にするために、 組み込み関数 :func:`compile` の第4引数に渡されなければならない (ビットフィールド)フラグです。このフラグ は :class:`_Feature` インスタンスの :attr:`compilier_flag` 属性に保存されています。 + +.. No feature description will ever be deleted from :mod:`__future__`. + :mod:`__future__` で解説されている機能のうち、削除されたものはまだありませ ん。 ============================================================================== Revision: 12d0e11115 Author: Nozomu Kaneko <nozom****@gmail*****> Date: Sat Feb 26 08:43:56 2011 Log: Update to 2.6.6: library/__future__.rst http://code.google.com/p/python-doc-ja/source/detail?r=12d0e11115 Modified: /library/__future__.rst ======================================= --- /library/__future__.rst Sat Feb 26 08:43:53 2011 +++ /library/__future__.rst Sat Feb 26 08:43:56 2011 @@ -13,9 +13,9 @@ .. * To avoid confusing existing tools that analyze import statements and expect to .. find the modules they're importing. -.. * To ensure that future_statements run under releases prior to 2.1 at least -.. yield runtime exceptions (the import of :mod:`__future__` will fail, because -.. there was no module of that name prior to 2.1). +.. * To ensure that :ref:`future statements <future>` run under releases prior to +.. 2.1 at least yield runtime exceptions (the import of :mod:`__future__` will +.. fail, because there was no module of that name prior to 2.1). .. * To document when incompatible changes were introduced, and when they will be .. --- or were --- made mandatory. This is a form of executable documentation, and @@ -26,7 +26,7 @@ * import ステートメントを解析する既存のツールを混乱させるのを避け、 そのステートメントがインポートしようとしているモジュールを見つけられるよ うにするため。 -* 2.1 以前のリリースで future ステートメントが実行されれば、最低でもランタ イム例外を投げるようにするため。 +* 2.1 以前のリリースで :ref:`future ステートメント <future>` が実行されれ ば、最低でもランタイム例外を投げるようにするため。 (:mod:`__future__` はインポートできません。というのも、2.1 以前にはそうい う名前のモジュールはなかったからです。) * いつ互換でない変化が導入され、いつ強制的になる -- あるいは、なった -- の か文書化するため。 @@ -93,7 +93,7 @@ .. *CompilerFlag* is the (bitfield) flag that should be passed in the fourth -.. argument to the builtin function :func:`compile` to enable the feature in +.. argument to the built-in function :func:`compile` to enable the feature in .. dynamically compiled code. This flag is stored in the :attr:`compiler_flag` .. attribute on :class:`_Feature` instances. @@ -102,7 +102,44 @@ :attr:`compilier_flag` 属性に保存されています。 -.. No feature description will ever be deleted from :mod:`__future__`. +.. No feature description will ever be deleted from :mod:`__future__`. Since its +.. introduction in Python 2.1 the following features have found their way into the +.. language using this mechanism: :mod:`__future__` で解説されている機能のうち、削除されたものはまだありませ ん。 - +Python 2.1 で Future ステートメントが導入されて以来、この仕組みを使って +以下の機能が言語に導入されてきました。 + + ++------------------+-------------+--------------+---------------------------------------------+ +| feature | optional in | mandatory in | effect | ++==================+=============+==============+=============================================+ +| nested_scopes | 2.1.0b1 | 2.2 | :pep:`227`: | +| | | | *Statically Nested Scopes* | ++------------------+-------------+--------------+---------------------------------------------+ +| generators | 2.2.0a1 | 2.3 | :pep:`255`: | +| | | | *Simple Generators* | ++------------------+-------------+--------------+---------------------------------------------+ +| division | 2.2.0a2 | 3.0 | :pep:`238`: | +| | | | *Changing the Division Operator* | ++------------------+-------------+--------------+---------------------------------------------+ +| absolute_import | 2.5.0a1 | 2.7 | :pep:`328`: | +| | | | *Imports: Multi-Line and Absolute/Relative* | ++------------------+-------------+--------------+---------------------------------------------+ +| with_statement | 2.5.0a1 | 2.6 | :pep:`343`: | +| | | | *The "with" Statement* | ++------------------+-------------+--------------+---------------------------------------------+ +| print_function | 2.6.0a2 | 3.0 | :pep:`3105`: | +| | | | *Make print a function* | ++------------------+-------------+--------------+---------------------------------------------+ +| unicode_literals | 2.6.0a2 | 3.0 | :pep:`3112`: | +| | | | *Bytes literals in Python 3000* | ++------------------+-------------+--------------+---------------------------------------------+ + +.. seealso:: + + :ref:`future` + + .. How the compiler treats future imports. + + コンパイラがどのように future インポートを扱うか ============================================================================== Revision: 037349cf8d Author: Nozomu Kaneko <nozom****@gmail*****> Date: Sat Feb 26 08:43:56 2011 Log: 翻訳の改善 (library/__future__.rst) http://code.google.com/p/python-doc-ja/source/detail?r=037349cf8d Modified: /library/__future__.rst ======================================= --- /library/__future__.rst Sat Feb 26 08:43:56 2011 +++ /library/__future__.rst Sat Feb 26 08:43:56 2011 @@ -1,13 +1,13 @@ -:mod:`__future__` --- Future ステートメントの定義 +:mod:`__future__` --- future 文の定義 ================================================= .. module:: __future__ - :synopsis: Future ステートメントの定義 + :synopsis: future 文の定義 .. :mod:`__future__` is a real module, and serves three purposes: -:mod:`__future__` は実際にモジュールであり、3つの役割があります。 +:mod:`__future__` は実際にモジュールであり、次の3つの役割があります。 .. * To avoid confusing existing tools that analyze import statements and expect to @@ -23,20 +23,21 @@ .. its contents. -* import ステートメントを解析する既存のツールを混乱させるのを避け、 - そのステートメントがインポートしようとしているモジュールを見つけられるよ うにするため。 - -* 2.1 以前のリリースで :ref:`future ステートメント <future>` が実行されれ ば、最低でもランタイム例外を投げるようにするため。 - (:mod:`__future__` はインポートできません。というのも、2.1 以前にはそうい う名前のモジュールはなかったからです。) - -* いつ互換でない変化が導入され、いつ強制的になる -- あるいは、なった -- の か文書化するため。 - これは実行できる形式で書かれたドキュメントでなので、:mod:`__future__` - をインポートし、その中身を調べるようプログラムすれば確かめられます。 +* import 文を解析する既存のツールを混乱させることを避け、 + インポートしようとしているモジュールを見つけられるようにするため。 + +* 2.1 以前のリリースで :ref:`future 文 <future>` が実行された場合に、最低で もランタイム例外を投げるようにするため。 + (:mod:`__future__` のインポートは失敗します。なぜなら、 2.1 以前にはそう いう名前のモジュールはなかったからです。) + +* 互換性のない変化がいつ言語に導入され、いつ言語の一部になる --- あるい + は、なった --- のかを文書化するため。これは実行できる形式で書かれたド + キュメントなので、 :mod:`__future__` をインポートしてその中身を調べる + ことでプログラムから調査することができます。 .. Each statement in :file:`__future__.py` is of the form: -:file:`__future__.py` の各ステートメントは次のような形をしています:: +:file:`__future__.py` のそれぞれの文は次のような形式をしています:: FeatureName = _Feature(OptionalRelease, MandatoryRelease, @@ -76,7 +77,7 @@ その他の場合、 *MandatoryRelease* はその機能がいつ言語の一部になったのかを 記録します。 そのリリースから、あるいはそれ以降のリリースでは、この機能を使う際に -future ステートメントは必要ではありませんが、future ステートメントを使い続 けても構いません。 +future 文は必要ではありませんが、 future 文を使い続けても構いません。 .. *MandatoryRelease* may also be ``None``, meaning that a planned feature got @@ -97,8 +98,8 @@ .. dynamically compiled code. This flag is stored in the :attr:`compiler_flag` .. attribute on :class:`_Feature` instances. -*CompilerFlag* は動的にコンパイルされるコードでその機能を有効にするために、 組み込み関数 :func:`compile` -の第4引数に渡されなければならない (ビットフィールド)フラグです。このフラグ は :class:`_Feature` インスタンスの +*CompilerFlag* は、動的にコンパイルされるコードでその機能を有効にするため に、組み込み関数 :func:`compile` +の第4引数に渡す(ビットフィールド)フラグです。このフラグ は :class:`_Feature` インスタンスの :attr:`compilier_flag` 属性に保存されています。 @@ -106,9 +107,9 @@ .. introduction in Python 2.1 the following features have found their way into the .. language using this mechanism: -:mod:`__future__` で解説されている機能のうち、削除されたものはまだありませ ん。 -Python 2.1 で Future ステートメントが導入されて以来、この仕組みを使って -以下の機能が言語に導入されてきました。 +機能の記述が :mod:`__future__` から削除されたことはまだありません。 +Python 2.1 で future 文が導入されて以来、この仕組みを使って以下の機能が +言語に導入されてきました。 +------------------+-------------+--------------+---------------------------------------------+ ============================================================================== Revision: bc0b26a44a Author: Nozomu Kaneko <nozom****@gmail*****> Date: Sat Feb 26 08:44:19 2011 Log: 誤字を修正 http://code.google.com/p/python-doc-ja/source/detail?r=bc0b26a44a Modified: /reference/simple_stmts.rst ======================================= --- /reference/simple_stmts.rst Fri Dec 3 09:30:41 2010 +++ /reference/simple_stmts.rst Sat Feb 26 08:44:19 2011 @@ -782,7 +782,7 @@ Python 2.6 が認識する機能は、 ``unicode_literals``, ``print_function`, ``absolute_import``, ``division``, ``generators``, ``nested_scopes``, ``with_statement`` です。 ``generators``, ``with_statement``, -``nested_scopes`` は Python 2.6 異常では常に有効なので冗長です。 +``nested_scopes`` は Python 2.6 以上では常に有効なので冗長です。 future 文は、コンパイル時に特別なやり方で認識され、扱われます: 言語の中核を なす構文構成 (construct) に対する意味付けが変更されて いる場合、変更部分はしばしば異なるコードを生成することで実現されています。 新たな機能によって、(新たな予約語のような)
