Tim Peters | ffc215a | 2001-02-26 21:14:49 +0000 | [diff] [blame] | 1 | """__future__: Record of phased-in incompatible language changes. |
| 2 | |
| 3 | Each line is of the form: |
| 4 | |
| 5 | FeatureName = ReleaseInfo |
| 6 | |
| 7 | ReleaseInfo is a pair of the form: |
| 8 | |
| 9 | (OptionalRelease, MandatoryRelease) |
| 10 | |
| 11 | where, normally, OptionalRelease < MandatoryRelease, and both are 5-tuples |
| 12 | of the same form as sys.version_info: |
| 13 | |
| 14 | (PY_MAJOR_VERSION, # the 2 in 2.1.0a3; an int |
| 15 | PY_MINOR_VERSION, # the 1; an int |
| 16 | PY_MICRO_VERSION, # the 0; an int |
| 17 | PY_RELEASE_LEVEL, # "alpha", "beta", "candidate" or "final"; string |
| 18 | PY_RELEASE_SERIAL # the 3; an int |
| 19 | ) |
| 20 | |
| 21 | OptionalRelease records the first release in which |
| 22 | |
| 23 | from __future__ import FeatureName |
| 24 | |
| 25 | was accepted. |
| 26 | |
Tim Peters | 85ba673 | 2001-02-28 08:26:44 +0000 | [diff] [blame] | 27 | In the case of MandatoryReleases that have not yet occurred, |
| 28 | MandatoryRelease predicts the release in which the feature will become part |
Tim Peters | ffc215a | 2001-02-26 21:14:49 +0000 | [diff] [blame] | 29 | of the language. |
| 30 | |
Tim Peters | 85ba673 | 2001-02-28 08:26:44 +0000 | [diff] [blame] | 31 | Else MandatoryRelease records when the feature became part of the language; |
Tim Peters | ffc215a | 2001-02-26 21:14:49 +0000 | [diff] [blame] | 32 | in releases at or after that, modules no longer need |
| 33 | |
| 34 | from __future__ import FeatureName |
| 35 | |
| 36 | to use the feature in question, but may continue to use such imports. |
| 37 | |
Tim Peters | 85ba673 | 2001-02-28 08:26:44 +0000 | [diff] [blame] | 38 | MandatoryRelease may also be None, meaning that a planned feature got |
Tim Peters | ffc215a | 2001-02-26 21:14:49 +0000 | [diff] [blame] | 39 | dropped. |
| 40 | |
| 41 | No line is ever to be deleted from this file. |
| 42 | """ |
| 43 | |
| 44 | nested_scopes = (2, 1, 0, "beta", 1), (2, 2, 0, "final", 0) |