Move VERSIONS description to file itself (#5434)

This commit is contained in:
Sebastian Rittau
2021-05-13 15:14:44 +02:00
committed by GitHub
parent a34e5a36a8
commit d98fdd934c
2 changed files with 17 additions and 17 deletions

View File

@@ -31,27 +31,11 @@ For more details, read below.
### Standard library stubs
The `stdlib` directory contains stubs for modules in the
Python standard library -- which
Python standard library which
includes pure Python modules, dynamically loaded extension modules,
hard-linked extension modules, and the builtins. The `VERSIONS` file lists
the versions of Python where the module is available.
The structure of the `VERSIONS` file is as follows:
- Blank lines and lines starting with `#` are ignored.
- Lines contain the name of a top-level module, followed by a colon,
a space, and a version range (for example: `symbol: 2.7-3.9`).
Version ranges may be of the form "X.Y-A.B" or "X.Y-". The
first form means that a module was introduced in version X.Y and last
available in version A.B. The second form means that the module was
introduced in version X.Y and is still available in the latest
version of Python.
Python versions before 2.7 are ignored, so any module that was already
present in 2.7 will have "2.7" as its minimum version. Version ranges
for unsupported versions of Python 3 (currently 3.5 and lower) are
generally accurate but we do not guarantee their correctness.
The `stdlib/@python2` subdirectory contains Python 2-only stubs,
both for modules that must be kept different for Python 2 and 3, like
`builtins.pyi`, and for modules that only existed in Python 2, like

View File

@@ -1,3 +1,19 @@
# The structure of this file is as follows:
# - Blank lines and lines starting with `#` are ignored.
# - Lines contain the name of a top-level module, followed by a colon,
# a space, and a version range (for example: `symbol: 2.7-3.9`).
#
# Version ranges may be of the form "X.Y-A.B" or "X.Y-". The
# first form means that a module was introduced in version X.Y and last
# available in version A.B. The second form means that the module was
# introduced in version X.Y and is still available in the latest
# version of Python.
#
# Python versions before 2.7 are ignored, so any module that was already
# present in 2.7 will have "2.7" as its minimum version. Version ranges
# for unsupported versions of Python 3 (currently 3.5 and lower) are
# generally accurate but we do not guarantee their correctness.
__future__: 2.7-
__main__: 2.7-
_ast: 2.7-