From 2933d2df89942643131731337cc55abd656b5498 Mon Sep 17 00:00:00 2001 From: Guido van Rossum Date: Sat, 12 Oct 2019 09:27:44 -0700 Subject: [PATCH] Update 'format' README section -- don't imply it is executable --- README.md | 9 ++++++--- 1 file changed, 6 insertions(+), 3 deletions(-) diff --git a/README.md b/README.md index 76f3ed924e05..1bb538f06e76 100644 --- a/README.md +++ b/README.md @@ -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