bpo-37253: Document PyCompilerFlags.cf_feature_version (GH-14019)

* Update PyCompilerFlags structure documentation.
* Document the new cf_feature_version field in the Changes in the C
  API section of the What's New in Python 3.8 doc.
This commit is contained in:
Victor Stinner 2019-06-13 02:01:29 +02:00 committed by GitHub
parent 468e5fec8a
commit 2c9b498759
No known key found for this signature in database
GPG key ID: 4AEE18F83AFDEB23
2 changed files with 20 additions and 4 deletions

View file

@ -388,11 +388,22 @@ the same library that the Python runtime is using.
Whenever ``PyCompilerFlags *flags`` is *NULL*, :attr:`cf_flags` is treated as
equal to ``0``, and any modification due to ``from __future__ import`` is
discarded. ::
discarded.
struct PyCompilerFlags {
int cf_flags;
}
.. c:member:: int cf_flags
Compiler flags.
.. c:member:: int cf_feature_version;
*cf_feature_version* is the minor Python version. It should be
initialized to ``PY_MINOR_VERSION``.
The field is ignored by default, it is used if and only if
``PyCF_ONLY_AST`` flag is set in *cf_flags*.
.. versionchanged:: 3.8
Added *cf_feature_version* field.
.. c:var:: int CO_FUTURE_DIVISION