[Python-checkins] r56671 - in doctools/trunk/Doc-3k: library/ast.rst reference/expressions.rst reference/simple_stmts.rst

[georg.brandl]

Author: georg.brandl
Date: Thu Aug  2 18:13:06 2007
New Revision: 56671

Removed:
   doctools/trunk/Doc-3k/library/ast.rst
Modified:
   doctools/trunk/Doc-3k/reference/expressions.rst
   doctools/trunk/Doc-3k/reference/simple_stmts.rst
Log:
Extra 3k fixes.


Deleted: /doctools/trunk/Doc-3k/library/ast.rst
==============================================================================
--- /doctools/trunk/Doc-3k/library/ast.rst	Thu Aug  2 18:13:06 2007
+++ (empty file)
@@ -1,62 +0,0 @@
-.. % XXX Label can't be _ast?
-.. % XXX Where should this section/chapter go?
-
-
-.. _ast:
-
-*********************
-Abstract Syntax Trees
-*********************
-
-.. sectionauthor:: Martin v. Löwis <martin at v.loewis.de>
-
-
-.. versionadded:: 2.5
-
-The ``_ast`` module helps Python applications to process trees of the Python
-abstract syntax grammar. The Python compiler currently provides read-only access
-to such trees, meaning that applications can only create a tree for a given
-piece of Python source code; generating byte code from a (potentially modified)
-tree is not supported. The abstract syntax itself might change with each Python
-release; this module helps to find out programmatically what the current grammar
-looks like.
-
-An abstract syntax tree can be generated by passing ``_ast.PyCF_ONLY_AST`` as a
-flag to the :func:`compile` builtin function. The result will be a tree of
-objects whose classes all inherit from ``_ast.AST``.
-
-The actual classes are derived from the ``Parser/Python.asdl`` file, which is
-reproduced below. There is one class defined for each left-hand side symbol in
-the abstract grammar (for example, ``_ast.stmt`` or ``_ast.expr``). In addition,
-there is one class defined for each constructor on the right-hand side; these
-classes inherit from the classes for the left-hand side trees. For example,
-``_ast.BinOp`` inherits from ``_ast.expr``. For production rules with
-alternatives (aka "sums"), the left-hand side class is abstract: only instances
-of specific constructor nodes are ever created.
-
-Each concrete class has an attribute ``_fields`` which gives the names of all
-child nodes.
-
-Each instance of a concrete class has one attribute for each child node, of the
-type as defined in the grammar. For example, ``_ast.BinOp`` instances have an
-attribute ``left`` of type ``_ast.expr``.   Instances of ``_ast.expr`` and
-``_ast.stmt`` subclasses also have lineno and col_offset attributes.  The lineno
-is the line number of source text (1 indexed so the first line is line 1) and
-the col_offset is the utf8 byte offset of the first token that generated the
-node.  The utf8 offset is recorded because the parser uses utf8  internally.
-
-If these attributes are marked as optional in the grammar (using a question
-mark), the value might be ``None``. If the attributes can have zero-or-more
-values (marked with an asterisk), the values are represented as Python lists.
-
-
-Abstract Grammar
-================
-
-The module defines a string constant ``__version__`` which is the decimal
-subversion revision number of the file shown below.
-
-The abstract grammar is currently defined as follows:
-
-
-.. XXX includefile ../../Parser/Python.asdl

Modified: doctools/trunk/Doc-3k/reference/expressions.rst
==============================================================================
--- doctools/trunk/Doc-3k/reference/expressions.rst	(original)
+++ doctools/trunk/Doc-3k/reference/expressions.rst	Thu Aug  2 18:13:06 2007
@@ -31,9 +31,11 @@
 
 .. index:: pair: arithmetic; conversion
 
+.. XXX no coercion rules are documented anymore
+
 When a description of an arithmetic operator below uses the phrase "the numeric
 arguments are converted to a common type," the arguments are coerced using the
-coercion rules listed at  :ref:`coercion-rules`.  If both arguments are standard
+coercion rules.  If both arguments are standard
 numeric types, the following coercions are applied:
 
 * If either argument is a complex number, the other is converted to complex;

Modified: doctools/trunk/Doc-3k/reference/simple_stmts.rst
==============================================================================
--- doctools/trunk/Doc-3k/reference/simple_stmts.rst	(original)
+++ doctools/trunk/Doc-3k/reference/simple_stmts.rst	Thu Aug  2 18:13:06 2007
@@ -59,7 +59,7 @@
 
 In interactive mode, if the value is not ``None``, it is converted to a string
 using the built-in :func:`repr` function and the resulting string is written to
-standard output (see section :ref:`print`) on a line by itself.  (Expression
+standard output (see :func:`print`) on a line by itself.  (Expression
 statements yielding ``None`` are not written, so that procedure calls do not
 cause any output.)