summaryrefslogtreecommitdiffstats
path: root/Doc/lib/libparser.tex
diff options
context:
space:
mode:
authorFred Drake <fdrake@acm.org>1999-11-10 16:21:37 (GMT)
committerFred Drake <fdrake@acm.org>1999-11-10 16:21:37 (GMT)
commit37f1574f2e26ed12ce5d52b901f3166b4e4c0bd6 (patch)
tree4cdf27299cf246bde473615c2556e874c75535be /Doc/lib/libparser.tex
parente15eb35fd0a038aead785a57526157e6745e0b09 (diff)
downloadcpython-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.tex34
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