Kaydet (Commit) 57e3b68c authored tarafından Georg Brandl's avatar Georg Brandl

Update the first two parts of the reference manual for Py3k,

mainly concerning PEPs 3131 and 3120.
üst 3dc33d18
...@@ -27,6 +27,7 @@ are more than welcome as well. ...@@ -27,6 +27,7 @@ are more than welcome as well.
style.rst style.rst
rest.rst rest.rst
markup.rst markup.rst
fromlatex.rst
sphinx.rst sphinx.rst
.. XXX add credits, thanks etc. .. XXX add credits, thanks etc.
......
...@@ -22,11 +22,12 @@ language, maybe you could volunteer your time --- or invent a cloning machine ...@@ -22,11 +22,12 @@ language, maybe you could volunteer your time --- or invent a cloning machine
It is dangerous to add too many implementation details to a language reference It is dangerous to add too many implementation details to a language reference
document --- the implementation may change, and other implementations of the document --- the implementation may change, and other implementations of the
same language may work differently. On the other hand, there is currently only same language may work differently. On the other hand, CPython is the one
one Python implementation in widespread use (although alternate implementations Python implementation in widespread use (although alternate implementations
exist), and its particular quirks are sometimes worth being mentioned, continue to gain support), and its particular quirks are sometimes worth being
especially where the implementation imposes additional limitations. Therefore, mentioned, especially where the implementation imposes additional limitations.
you'll find short "implementation notes" sprinkled throughout the text. Therefore, you'll find short "implementation notes" sprinkled throughout the
text.
Every Python implementation comes with a number of built-in and standard Every Python implementation comes with a number of built-in and standard
modules. These are documented in :ref:`library-index`. A few built-in modules modules. These are documented in :ref:`library-index`. A few built-in modules
...@@ -88,11 +89,7 @@ implementation you're using. ...@@ -88,11 +89,7 @@ implementation you're using.
Notation Notation
======== ========
.. index:: .. index:: BNF, grammar, syntax, notation
single: BNF
single: grammar
single: syntax
single: notation
The descriptions of lexical analysis and syntax use a modified BNF grammar The descriptions of lexical analysis and syntax use a modified BNF grammar
notation. This uses the following style of definition: notation. This uses the following style of definition:
...@@ -118,9 +115,7 @@ meaningful to separate tokens. Rules are normally contained on a single line; ...@@ -118,9 +115,7 @@ meaningful to separate tokens. Rules are normally contained on a single line;
rules with many alternatives may be formatted alternatively with each line after rules with many alternatives may be formatted alternatively with each line after
the first beginning with a vertical bar. the first beginning with a vertical bar.
.. index:: .. index:: lexical definitions, ASCII
single: lexical definitions
single: ASCII@ASCII
In lexical definitions (as the example above), two more conventions are used: In lexical definitions (as the example above), two more conventions are used:
Two literal characters separated by three dots mean a choice of any single Two literal characters separated by three dots mean a choice of any single
......
Markdown is supported
0% or
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment