8000 Trivial updates, including sequencing footnotes and add comma. · python/peps@acbc9ef · GitHub
[go: up one dir, main page]

Skip to content

Commit acbc9ef

Browse files
committed
Trivial updates, including sequencing footnotes and add comma.
1 parent 1223d27 commit acbc9ef

File tree

4 files changed

+37
-37
lines changed

4 files changed

+37
-37
lines changed

pep-0331.txt

Lines changed: 19 additions & 19 deletions
Original file line numberDiff line numberDiff line change
@@ -39,13 +39,13 @@ is currently implemented only in Python-space; C libraries invoked
3939
from the Python runtime are unaware of Python's ``LC_NUMERIC``
4040
setting. This is done to avoid changing the behavior of certain
4141
low-level functions that are used by the Python parser and related
42-
code [2]_.
42+
code [1]_.
4343

4444
However, this presents a problem for extension modules that wrap C
4545
libraries. Applications that use these extension modules will
4646
inconsistently display and convert floating-point values.
4747

48-
James Henstridge, the author of PyGTK [3]_, has additionally
48+
James Henstridge, the author of PyGTK [2]_, has additionally
4949
pointed out that the ``setlocale()`` function also presents
5050
thread-safety issues, since a thread may call the C library
5151
``setlocale()`` outside of the GIL, and cause Python to parse and
@@ -66,7 +66,7 @@ Example Problem
6666
===============
6767

6868
The initial problem that motivated this PEP is related to the
69-
GtkSpinButton [4]_ widget in the GTK+ UI toolkit, wrapped by the
69+
GtkSpinButton [3]_ widget in the GTK+ UI toolkit, wrapped by the
7070
PyGTK module. The widget can be set to numeric mode, and when
7171
this occurs, characters typed into it are evaluated as a number.
7272

@@ -123,18 +123,18 @@ Potential Code Contributions
123123
============================
124124

125125
This problem was initially reported as a problem in the GTK+
126-
libraries [5]_; since then it has been correctly diagnosed as an
126+
libraries [4]_; since then it has been correctly diagnosed as an
127127
inconsistency in Python's implementation. However, in a fortunate
128128
coincidence, the glib library (developed primarily for GTK+, not
129129
to be confused with the GNU C library) implements a number of
130-
``LC_NUMERIC``-agnostic functions (for an example, see [6]_) for
130+
``LC_NUMERIC``-agnostic functions (for an example, see [5]_) for
131131
reasons similar to those presented in this paper.
132132

133133
In the same GTK+ problem report, Havoc Pennington suggested that
134134
the glib authors would be willing to contribute this code to the
135135
PSF, which would simplify implementation of this PEP considerably.
136136
Alex Larsson, the original author of the glib code, submitted a
137-
PSF Contributor Agreement [7]_ on 2003-08-20 [8]_ to ensure the code
137+
PSF Contributor Agreement [6]_ on 2003-08-20 [7]_ to ensure the code
138138
could be safely integrated; this agreement has been received and
139139
accepted.
140140

@@ -153,7 +153,7 @@ as members of the GTK+ and glib teams have said they are fine with
153153
relicensing the code, and a PSF contributor agreement has been
154154
mailed in to ensure this safety.
155155

156-
Tim Peters has pointed out [9]_ that there are situations involving
156+
Tim Peters has pointed out [8]_ that there are situations involving
157157
threading in which the proposed change is insufficient to solve
158158
the problem completely. A complete solution, however, does not
159159
currently exist.
@@ -163,41 +163,41 @@ Implementation
163163
==============
164164

165165
An implementation was developed by Gustavo Carneiro <gjc at
166-
inescporto.pt>, and attached to Sourceforge.net bug 774665 [10]_
166+
inescporto.pt>, and attached to Sourceforge.net bug 774665 [9]_
167167

168-
The final patch [11]_ was integrated into Python CVS by Martin v.
168+
The final patch [10]_ was integrated into Python CVS by Martin v.
169169
Löwis on 2004-06-08, as stated in the bug report.
170170

171171

172172
References
173173
==========
174174

175-
.. [2] Python locale documentation for embedding,
175+
.. [1] Python locale documentation for embedding,
176176
http://docs.python.org/library/locale.html
177177

178-
.. [3] PyGTK homepage, http://www.daa.com.au/~james/pygtk/
178+
.. [2] PyGTK homepage, http://www.daa.com.au/~james/pygtk/
179179

180-
.. [4] GtkSpinButton screenshot (demonstrating problem),
180+
.. [3] GtkSpinButton screenshot (demonstrating problem),
181181
http://www.async.com.br/~kiko/spin.png
182182

183-
.. [5] GNOME bug report, http://bugzilla.gnome.org/show_bug.cgi?id=114132
183+
.. [4] GNOME bug report, http://bugzilla.gnome.org/show_bug.cgi?id=114132
184184

185-
.. [6] Code submission of g_ascii_strtod and g_ascii_dtostr (later
185+
.. [5] Code submission of g_ascii_strtod and g_ascii_dtostr (later
186186
renamed g_ascii_formatd) by Alex Larsson,
187187
http://mail.gnome.org/archives/gtk-devel-list/2001-October/msg00114.html
188188

189-
.. [7] PSF Contributor Agreement,
189+
.. [6] PSF Contributor Agreement,
190190
https://www.python.org/psf/contrib/contrib-form/
191191

192-
.. [8] Alex Larsson's email confirming his agreement was mailed in,
192+
.. [7] Alex Larsson's email confirming his agreement was mailed in,
193193
https://mail.python.org/pipermail/python-dev/2003-August/037755.html
194194

195-
.. [9] Tim Peters' email summarizing LC_NUMERIC trouble with Spambayes,
195+
.. [8] Tim Peters' email summarizing LC_NUMERIC trouble with Spambayes,
196196
https://mail.python.org/pipermail/python-dev 67ED /2003-September/037898.html
197197

198-
.. [10] Python bug report, https://bugs.python.org/issue774665
198+
.. [9] Python bug report, https://bugs.python.org/issue774665
199199

200-
.. [11] Integrated LC_NUMERIC-agnostic patch,
200+
.. [10] Integrated LC_NUMERIC-agnostic patch,
201201
https://sourceforge.net/tracker/download.php?group_id=5470&atid=305470&file_id=89685&aid=774665
202202

203203

pep-0439.txt

Lines changed: 4 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -188,7 +188,7 @@ Implementation
188188
==============
189189

190190
The changes to pip required by this PEP are being tracked in that project's
191-
issue tracker [2]_. Most notably, the addition of --bootstrap and --bootstrap-
191+
issue tracker [1]_. Most notably, the addition of --bootstrap and --bootstrap-
192192
to-system to the pip command-line.
193193

194194
It would be preferable that the pip and setuptools projects distribute a wheel
@@ -214,7 +214,7 @@ revocation.
214214
There is a Perl package installer also named "pip". It is quite rare and not
215215
commonly used. The Fedora variant of Linux has historically named Python's
216216
"pip" as "python-pip" and Perl's "pip" as "perl-pip". This policy has been
217-
altered\ [3]_ so that future and upgraded Fedora installations will use the name
217+
altered\ [2]_ so that future and upgraded Fedora installations will use the name
218218
"pip" for Python's "pip". Existing (non-upgraded) installations will still
219219
have the old name for the Python "pip", though the potential for confusion is
220220
now much reduced.
@@ -223,10 +223,10 @@ now much reduced.
223223
References
224224
==========
225225

226-
.. [2] pip issue tracking work needed for this PEP
226+
.. [1] pip issue tracking work needed for this PEP
227227
https://github.com/pypa/pip/issues/863
228228

229-
.. [3] Fedora's python-pip package does not provide /usr/bin/pip
229+
.. [2] Fedora's python-pip package does not provide /usr/bin/pip
230230
https://bugzilla.redhat.com/show_bug.cgi?id=958377
231231

232232

pep-0444.txt

Lines changed: 13 additions & 13 deletions
Original file line numberDiff line numberDiff line change
@@ -462,7 +462,7 @@ attributes of the ``body`` iterable returned by the application.
462462

463463
The ``environ`` dictionary is required to contain various CGI
464464
environment variables, as defined by the Common Gateway Interface
465-
specification [2]_.
465+
specification [1]_.
466466

467467
The following CGI variables **must** be present. Each key is a native
468468
string. Each value is a bytes instance.
@@ -538,7 +538,7 @@ A server or gateway **should** attempt to provide as many other CGI
538538
variables as are applicable, each with a string for its key and a
539539
bytes instance for its value. In addition, if SSL is in use, the
540540
server or gateway **should** also provide as many of the Apache SSL
541-
environment variables [4]_ as are applicable, such as ``HTTPS=on`` and
541+
environment variables [3]_ as are applicable, such as ``HTTPS=on`` and
542542
``SSL_PROTOCOL``. Note, however, that an application that uses any
543543
CGI variables other than the ones listed above are necessarily
544544
non-portable to web servers that do not support the relevant
@@ -1408,7 +1408,7 @@ Here are some alternatives to using all bytes:
14081408
Applications Should be Allowed to Read ``web3.input`` Past ``CONTENT_LENGTH``
14091409
-----------------------------------------------------------------------------
14101410

1411-
At [5]_, Graham Dumpleton makes the assertion that ``wsgi.input``
1411+
At [4]_, Graham Dumpleton makes the assertion that ``wsgi.input``
14121412
should be required to return the empty string as a signifier of
14131413
out-of-data, and that applications should be allowed to read past the
14141414
number of bytes specified in ``CONTENT_LENGTH``, depending only upon
@@ -1434,7 +1434,7 @@ There's no documented way to indicate that there is content in
14341434
``read()`` of ``web3.input`` Should Support No-Size Calling Convention
14351435
----------------------------------------------------------------------
14361436

1437-
At [5]_, Graham Dumpleton makes the assertion that the ``read()``
1437+
At [4]_, Graham Dumpleton makes the assertion that the ``read()``
14381438
method of ``wsgi.input`` should be callable without arguments, and
14391439
that the result should be "all available request content". Needs
14401440
discussion.
@@ -1447,7 +1447,7 @@ Open for discussions though.
14471447
Input Filters should set environ ``CONTENT_LENGTH`` to -1
14481448
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
14491449

1450-
At [5]_, Graham Dumpleton suggests that an input filter might set
1450+
At [4]_, Graham Dumpleton suggests that an input filter might set
14511451
``environ['CONTENT_LENGTH']`` to -1 to indicate that it mutated the
14521452
input.
14531453

@@ -1492,7 +1492,7 @@ if the server performs URL rewriting.
14921492
Long Response Headers
14931493
---------------------
14941494

1495-
Bob Brewer notes on Web-SIG [6]_:
1495+
Bob Brewer notes on Web-SIG [5]_:
14961496

14971497
Each header_value must not include any control characters,
14981498
including carriage returns or linefeeds, either embedded or at the
@@ -1504,10 +1504,10 @@ Bob Brewer notes on Web-SIG [6]_:
15041504
That's understandable, but HTTP headers are defined as (mostly)
15051505
\*TEXT, and "words of \*TEXT MAY contain characters from character
15061506
sets other than ISO-8859-1 only when encoded according to the rules of
1507-
:rfc:`2047`." [2]_ And :rfc:`2047` specifies that "an 'encoded-word' may
1507+
:rfc:`2047`." [1]_ And :rfc:`2047` specifies that "an 'encoded-word' may
15081508
not be more than 75 characters long... If it is desirable to encode
15091509
more text than will fit in an 'encoded-word' of 75 characters,
1510-
multiple 'encoded-word's (separated by CRLF SPACE) may be used." [3]_
1510+
multiple 'encoded-word's (separated by CRLF SPACE) may be used." [2]_
15111511
This satisfies HTTP header folding rules, as well: "Header fields can
15121512
be extended over multiple lines by preceding each extra line with at
15131513
least one SP or HT." (:pep:`333`)
@@ -1544,18 +1544,18 @@ has all been read in. Neither WSGI nor Web3 currently supports them.
15441544
References
15451545
==========
15461546

1547-
.. [2] The Common Gateway Interface Specification, v 1.1, 3rd Draft
1547+
.. [1] The Common Gateway Interface Specification, v 1.1, 3rd Draft
15481548
(https://datatracker.ietf.org/doc/html/draft-coar-cgi-v11-03)
15491549

1550-
.. [3] "Chunked Transfer Coding" -- HTTP/1.1, :rfc:`2616#section-3.6.1`
1550+
.. [2] "Chunked Transfer Coding" -- HTTP/1.1, :rfc:`2616#section-3.6.1`
15511551

1552-
.. [4] mod_ssl Reference, "Environment Variables"
1552+
.. [3] mod_ssl Reference, "Environment Variables"
15531553
(http://www.modssl.org/docs/2.8/ssl_reference.html#ToC25)
15541554

1555-
.. [5] Details on WSGI 1.0 amendments/clarifications.
1555+
.. [4] Details on WSGI 1.0 amendments/clarifications.
15561556
(http://blog.dscpl.com.au/2009/10/details-on-wsgi-10-amendmentsclarificat.html)
15571557

1558-
.. [6] [Web-SIG] WSGI and long response header values
1558+
.. [5] [Web-SIG] WSGI and long response header values
15591559
https://mail.python.org/pipermail/web-sig/2006-September/002244.html
15601560

15611561
Copyright

pep-0488.txt

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -91,7 +91,7 @@ based on the interpreter's optimization level (none, ``-O``, and
9191

9292
Currently bytecode file names are created by
9393
``importlib.util.cache_from_source()``, approximately using the
94-
following expression defined by :pep:`3147` [3]_, [4]_::
94+
following expression defined by :pep:`3147`, [3]_, [4]_::
9595

9696
'{name}.{cache_tag}.pyc'.format(name=module_name,
9797
cache_tag=sys.implementation.cache_tag)

0 commit comments

Comments
 (0)
0