Thanks to visit codestin.com
Credit goes to github.com

Skip to content

Commit 57e3b68

Browse files
committed
Update the first two parts of the reference manual for Py3k,
mainly concerning PEPs 3131 and 3120.
1 parent 3dc33d1 commit 57e3b68

3 files changed

Lines changed: 175 additions & 234 deletions

File tree

Doc/documenting/index.rst

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -27,6 +27,7 @@ are more than welcome as well.
2727
style.rst
2828
rest.rst
2929
markup.rst
30+
fromlatex.rst
3031
sphinx.rst
3132

3233
.. XXX add credits, thanks etc.

Doc/reference/introduction.rst

Lines changed: 8 additions & 13 deletions
Original file line numberDiff line numberDiff line change
@@ -22,11 +22,12 @@ language, maybe you could volunteer your time --- or invent a cloning machine
2222

2323
It is dangerous to add too many implementation details to a language reference
2424
document --- the implementation may change, and other implementations of the
25-
same language may work differently. On the other hand, there is currently only
26-
one Python implementation in widespread use (although alternate implementations
27-
exist), and its particular quirks are sometimes worth being mentioned,
28-
especially where the implementation imposes additional limitations. Therefore,
29-
you'll find short "implementation notes" sprinkled throughout the text.
25+
same language may work differently. On the other hand, CPython is the one
26+
Python implementation in widespread use (although alternate implementations
27+
continue to gain support), and its particular quirks are sometimes worth being
28+
mentioned, especially where the implementation imposes additional limitations.
29+
Therefore, you'll find short "implementation notes" sprinkled throughout the
30+
text.
3031

3132
Every Python implementation comes with a number of built-in and standard
3233
modules. These are documented in :ref:`library-index`. A few built-in modules
@@ -88,11 +89,7 @@ implementation you're using.
8889
Notation
8990
========
9091

91-
.. index::
92-
single: BNF
93-
single: grammar
94-
single: syntax
95-
single: notation
92+
.. index:: BNF, grammar, syntax, notation
9693

9794
The descriptions of lexical analysis and syntax use a modified BNF grammar
9895
notation. This uses the following style of definition:
@@ -118,9 +115,7 @@ meaningful to separate tokens. Rules are normally contained on a single line;
118115
rules with many alternatives may be formatted alternatively with each line after
119116
the first beginning with a vertical bar.
120117

121-
.. index::
122-
single: lexical definitions
123-
single: ASCII@ASCII
118+
.. index:: lexical definitions, ASCII
124119

125120
In lexical definitions (as the example above), two more conventions are used:
126121
Two literal characters separated by three dots mean a choice of any single

0 commit comments

Comments
 (0)