From 34d1597bb72644e137f88fb47ba0b01e9c7dafb8 Mon Sep 17 00:00:00 2001 From: Georg Brandl Date: Fri, 31 Oct 2014 09:41:46 +0100 Subject: [PATCH] #22613: fix several factual errors in builtin docs (thanks Jacques Ducasse) --- Doc/library/functions.rst | 5 ++++- Doc/library/stdtypes.rst | 8 +++----- 2 files changed, 7 insertions(+), 6 deletions(-) diff --git a/Doc/library/functions.rst b/Doc/library/functions.rst index c9d34dc7e7..1683b29444 100644 --- a/Doc/library/functions.rst +++ b/Doc/library/functions.rst @@ -218,7 +218,7 @@ available. They are listed here in alphabetical order. The optional arguments *flags* and *dont_inherit* control which future statements (see :pep:`236`) affect the compilation of *source*. If neither is present (or both are zero) the code is compiled with those future - statements that are in effect in the code that is calling compile. If the + statements that are in effect in the code that is calling :func:`compile`. If the *flags* argument is given and *dont_inherit* is not (or is zero) then the future statements specified by the *flags* argument are used in addition to those that would be used anyway. If *dont_inherit* is a non-zero integer then @@ -233,6 +233,9 @@ available. They are listed here in alphabetical order. This function raises :exc:`SyntaxError` if the compiled source is invalid, and :exc:`TypeError` if the source contains null bytes. + If you want to parse Python code into its AST representation, see + :func:`ast.parse`. + .. note:: When compiling a string with multi-line code in ``'single'`` or diff --git a/Doc/library/stdtypes.rst b/Doc/library/stdtypes.rst index 56f0957be7..fa4304cffd 100644 --- a/Doc/library/stdtypes.rst +++ b/Doc/library/stdtypes.rst @@ -433,8 +433,7 @@ The priorities of the binary bitwise operations are all lower than the numeric operations and higher than the comparisons; the unary operation ``~`` has the same priority as the other unary numeric operations (``+`` and ``-``). -This table lists the bitwise operations sorted in ascending priority -(operations in the same box have the same priority): +This table lists the bitwise operations sorted in ascending priority: +------------+--------------------------------+----------+ | Operation | Result | Notes | @@ -722,9 +721,8 @@ operations have the same priorities as the comparison operations. The ``+`` and ``*`` operations have the same priority as the corresponding numeric operations. [3]_ Additional methods are provided for :ref:`typesseq-mutable`. -This table lists the sequence operations sorted in ascending priority -(operations in the same box have the same priority). In the table, *s* and *t* -are sequences of the same type; *n*, *i* and *j* are integers: +This table lists the sequence operations sorted in ascending priority. +In the table, *s* and *t* are sequences of the same type; *n*, *i* and *j* are integers: +------------------+--------------------------------+----------+ | Operation | Result | Notes | -- 2.50.1