diff options
author | Fred Drake <fdrake@acm.org> | 1999-11-10 16:21:37 (GMT) |
---|---|---|
committer | Fred Drake <fdrake@acm.org> | 1999-11-10 16:21:37 (GMT) |
commit | 37f1574f2e26ed12ce5d52b901f3166b4e4c0bd6 (patch) | |
tree | 4cdf27299cf246bde473615c2556e874c75535be /Doc/lib/libparser.tex | |
parent | e15eb35fd0a038aead785a57526157e6745e0b09 (diff) | |
download | cpython-37f1574f2e26ed12ce5d52b901f3166b4e4c0bd6.zip cpython-37f1574f2e26ed12ce5d52b901f3166b4e4c0bd6.tar.gz cpython-37f1574f2e26ed12ce5d52b901f3166b4e4c0bd6.tar.bz2 |
Use \citetitle and \programopt as appropriate.
Diffstat (limited to 'Doc/lib/libparser.tex')
-rw-r--r-- | Doc/lib/libparser.tex | 34 |
1 files changed, 17 insertions, 17 deletions
diff --git a/Doc/lib/libparser.tex b/Doc/lib/libparser.tex index 5a339b2..db49d89 100644 --- a/Doc/lib/libparser.tex +++ b/Doc/lib/libparser.tex @@ -35,23 +35,23 @@ the \module{parser} module are presented. Most importantly, a good understanding of the Python grammar processed by the internal parser is required. For full information on the -language syntax, refer to the \emph{Python Language Reference}. The -parser itself is created from a grammar specification defined in the file -\file{Grammar/Grammar} in the standard Python distribution. The parse -trees stored in the AST objects created by this module are the -actual output from the internal parser when created by the -\function{expr()} or \function{suite()} functions, described below. The AST -objects created by \function{sequence2ast()} faithfully simulate those -structures. Be aware that the values of the sequences which are -considered ``correct'' will vary from one version of Python to another -as the formal grammar for the language is revised. However, -transporting code from one Python version to another as source text -will always allow correct parse trees to be created in the target -version, with the only restriction being that migrating to an older -version of the interpreter will not support more recent language -constructs. The parse trees are not typically compatible from one -version to another, whereas source code has always been -forward-compatible. +language syntax, refer to the \citetitle[../ref/ref.html]{Python +Language Reference}. The parser itself is created from a grammar +specification defined in the file \file{Grammar/Grammar} in the +standard Python distribution. The parse trees stored in the AST +objects created by this module are the actual output from the internal +parser when created by the \function{expr()} or \function{suite()} +functions, described below. The AST objects created by +\function{sequence2ast()} faithfully simulate those structures. Be +aware that the values of the sequences which are considered +``correct'' will vary from one version of Python to another as the +formal grammar for the language is revised. However, transporting +code from one Python version to another as source text will always +allow correct parse trees to be created in the target version, with +the only restriction being that migrating to an older version of the +interpreter will not support more recent language constructs. The +parse trees are not typically compatible from one version to another, +whereas source code has always been forward-compatible. Each element of the sequences returned by \function{ast2list()} or \function{ast2tuple()} has a simple form. Sequences representing |