blob: 2c263b7872e204de014ebbee4dda2f845766c794 [file] [log] [blame]
Tim Petersffc215a2001-02-26 21:14:49 +00001"""__future__: Record of phased-in incompatible language changes.
2
3Each line is of the form:
4
5 FeatureName = ReleaseInfo
6
7ReleaseInfo is a pair of the form:
8
9 (OptionalRelease, MandatoryRelease)
10
11where, normally, OptionalRelease < MandatoryRelease, and both are 5-tuples
12of 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
21OptionalRelease records the first release in which
22
23 from __future__ import FeatureName
24
25was accepted.
26
Tim Peters85ba6732001-02-28 08:26:44 +000027In the case of MandatoryReleases that have not yet occurred,
28MandatoryRelease predicts the release in which the feature will become part
Tim Petersffc215a2001-02-26 21:14:49 +000029of the language.
30
Tim Peters85ba6732001-02-28 08:26:44 +000031Else MandatoryRelease records when the feature became part of the language;
Tim Petersffc215a2001-02-26 21:14:49 +000032in releases at or after that, modules no longer need
33
34 from __future__ import FeatureName
35
36to use the feature in question, but may continue to use such imports.
37
Tim Peters85ba6732001-02-28 08:26:44 +000038MandatoryRelease may also be None, meaning that a planned feature got
Tim Petersffc215a2001-02-26 21:14:49 +000039dropped.
40
41No line is ever to be deleted from this file.
42"""
43
44nested_scopes = (2, 1, 0, "beta", 1), (2, 2, 0, "final", 0)