mirror of
https://github.com/davidhalter/typeshed.git
synced 2025-12-15 16:27:08 +08:00
Move VERSIONS description to file itself (#5434)
This commit is contained in:
@@ -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
|
||||
|
||||
@@ -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-
|
||||
|
||||
Reference in New Issue
Block a user