diff --git a/Doc/library/__future__.rst b/Doc/library/__future__.rst index 1ebff4409b1e95..6355bb6e192fad 100644 --- a/Doc/library/__future__.rst +++ b/Doc/library/__future__.rst @@ -82,36 +82,34 @@ language using this mechanism: where, normally, *OptionalRelease* is less than *MandatoryRelease*, and both are 5-tuples of the same form as :data:`sys.version_info`:: - (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 - PY_RELEASE_LEVEL, # "alpha", "beta", "candidate" or "final"; string - PY_RELEASE_SERIAL # the 3; an int + (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. + PY_RELEASE_LEVEL, # One of "alpha", "beta", "candidate" or "final"; string. + PY_RELEASE_SERIAL # The 3; an int. ) +The release information for features is captured through *OptionalRelease* and +*MandatoryRelease*. The *OptionalRelease* records the first release in which the +feature was accepted, *MandatoryRelease* records when the feature became part +of the language. Once a feature is included in a *MandatoryRelease*, modules no +longer need a future statement to use the feature, but they may continue to use +such imports if needed. + .. method:: _Feature.getOptionalRelease() - *OptionalRelease* records the first release in which the feature was accepted. + This method returns the release information for the OptionalRelease of a feature. .. method:: _Feature.getMandatoryRelease() - 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. - - 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* may also be ``None``, meaning that a planned feature got - dropped or that it is not yet decided. + This method returns the release information for the MandatoryRelease of a feature. .. attribute:: _Feature.compiler_flag - *CompilerFlag* is the (bitfield) flag that should be passed in the fourth - argument to the built-in function :func:`compile` to enable the feature in - dynamically compiled code. This flag is stored in the :attr:`_Feature.compiler_flag` - attribute on :class:`_Feature` instances. + The *CompilerFlag* is a bitfield flag that should be passed in the fourth + argument to the built-in function :func:`compile` in order to enable the + feature in dynamically compiled code. This flag is stored in the + :attr:`_Feature.compiler_flag` attribute on :class:`_Feature` instances. .. [1] ``from __future__ import annotations`` was previously scheduled to