Update 'format' README section -- don't imply it is executable (#3350)

This commit is contained in:
Guido van Rossum
2019-10-12 10:18:34 -07:00
committed by Sebastian Rittau
parent 583784d94c
commit 8ec25708d9

View File

@@ -45,10 +45,13 @@ pytype repo.
## Format
Each Python module is represented by a `.pyi` "stub". This is a normal Python
file (i.e., it can be interpreted by Python 3), except all the methods are empty.
Each Python module is represented by a `.pyi` "stub file". This is a
syntactically valid Python file, although it usually cannot be run by
Python 3 (since forward references don't require string quotes). All
the methods are empty.
Python function annotations ([PEP 3107](https://www.python.org/dev/peps/pep-3107/))
are used to describe the types the function has.
are used to describe the signature of each function or method.
See [PEP 484](http://www.python.org/dev/peps/pep-0484/) for the exact
syntax of the stub files and [CONTRIBUTING.md](CONTRIBUTING.md) for the