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

Skip to content

Commit 5b5e81c

Browse files
tirantiran
committed
Merged revisions 59605-59624 via svnmerge from
svn+ssh://[email protected]/python/trunk ........ r59606 | georg.brandl | 2007-12-29 11:57:00 +0100 (Sat, 29 Dec 2007) | 2 lines Some cleanup in the docs. ........ r59611 | martin.v.loewis | 2007-12-29 19:49:21 +0100 (Sat, 29 Dec 2007) | 2 lines Bug #1699: Define _BSD_SOURCE only on OpenBSD. ........ r59612 | raymond.hettinger | 2007-12-29 23:09:34 +0100 (Sat, 29 Dec 2007) | 1 line Simpler documentation for itertools.tee(). Should be backported. ........ r59613 | raymond.hettinger | 2007-12-29 23:16:24 +0100 (Sat, 29 Dec 2007) | 1 line Improve docs for itertools.groupby(). The use of xrange(0) to create a unique object is less obvious than object(). ........ r59620 | christian.heimes | 2007-12-31 15:47:07 +0100 (Mon, 31 Dec 2007) | 3 lines Added wininst-9.0.exe executable for VS 2008 Integrated bdist_wininst into PCBuild9 directory ........ r59621 | christian.heimes | 2007-12-31 15:51:18 +0100 (Mon, 31 Dec 2007) | 1 line Moved PCbuild directory to PC/VS7.1 ........ r59622 | christian.heimes | 2007-12-31 15:59:26 +0100 (Mon, 31 Dec 2007) | 1 line Fix paths for build bot ........ r59623 | christian.heimes | 2007-12-31 16:02:41 +0100 (Mon, 31 Dec 2007) | 1 line Fix paths for build bot, part 2 ........ r59624 | christian.heimes | 2007-12-31 16:18:55 +0100 (Mon, 31 Dec 2007) | 1 line Renamed PCBuild9 directory to PCBuild ........
1 parent 862543a commit 5b5e81c

241 files changed

Lines changed: 18915 additions & 18878 deletions

File tree

Some content is hidden

Large Commits have some content hidden by default. Use the searchbox below for content that may be hidden.

‎.hgsvnexternals‎

Lines changed: 0 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,3 +1,2 @@
11
[Tools]
22
2to3 http://svn.python.org/projects/sandbox/trunk/2to3/
3-

‎Doc/Makefile‎

Lines changed: 8 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -16,10 +16,11 @@ ALLSPHINXOPTS = -b $(BUILDER) -d build/doctrees -D latex_paper_size=$(PAPER) \
1616

1717
help:
1818
@echo "Please use \`make <target>' where <target> is one of"
19-
@echo " html to make standalone HTML files"
20-
@echo " web to make file usable by Sphinx.web"
19+
@echo " html to make standalone HTML files"
20+
@echo " web to make file usable by Sphinx.web"
2121
@echo " htmlhelp to make HTML files and a HTML help project"
22-
@echo " latex to make LaTeX files, you can set PAPER=a4 or PAPER=letter"
22+
@echo " latex to make LaTeX files, you can set PAPER=a4 or PAPER=letter"
23+
@echo " changes to make an overview over all changed/added/deprecated items"
2324

2425
checkout:
2526
@if [ ! -d tools/sphinx ]; then \
@@ -66,6 +67,10 @@ latex: build
6667
@echo "Run \`make all-pdf' or \`make all-ps' in that directory to" \
6768
"run these through (pdf)latex."
6869

70+
changes: BUILDER = changes
71+
changes: build
72+
@echo "The overview file is in build/changes."
73+
6974
clean:
7075
-rm -rf build/*
7176
-rm -rf tools/sphinx

‎Doc/README.txt‎

Lines changed: 4 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -56,6 +56,10 @@ Available make targets are:
5656
* "latex", which builds LaTeX source files that can be run with "pdflatex"
5757
to produce PDF documents.
5858

59+
* "changes", which builds an overview over all versionadded/versionchanged/
60+
deprecated items in the current version. This is meant as a help for the
61+
writer of the "What's New" document.
62+
5963
A "make update" updates the Subversion checkouts in `tools/`.
6064

6165

‎Doc/c-api/exceptions.rst‎

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -31,8 +31,8 @@ The error indicator consists of three Python objects corresponding to the result
3131
of ``sys.exc_info()``. API functions exist to interact with the error indicator
3232
in various ways. There is a separate error indicator for each thread.
3333

34-
.. % XXX Order of these should be more thoughtful.
35-
.. % Either alphabetical or some kind of structure.
34+
.. XXX Order of these should be more thoughtful.
35+
Either alphabetical or some kind of structure.
3636
3737
3838
.. cfunction:: void PyErr_Print()

‎Doc/c-api/init.rst‎

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -264,7 +264,7 @@ Initialization, Finalization, and Threads
264264
as the list ``sys.path``, which may be modified to change the future search path
265265
for loaded modules.
266266

267-
.. % XXX should give the exact rules
267+
.. XXX should give the exact rules
268268
269269
270270
.. cfunction:: const char* Py_GetVersion()
@@ -357,8 +357,8 @@ Initialization, Finalization, and Threads
357357
to initialize ``sys.argv``, a fatal condition is signalled using
358358
:cfunc:`Py_FatalError`.
359359

360-
.. % XXX impl. doesn't seem consistent in allowing 0/NULL for the params;
361-
.. % check w/ Guido.
360+
.. XXX impl. doesn't seem consistent in allowing 0/NULL for the params;
361+
check w/ Guido.
362362
363363
364364
.. _threads:

‎Doc/c-api/intro.rst‎

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -484,7 +484,7 @@ Here is the corresponding C code, in all its glory::
484484
single: PyErr_Clear()
485485
single: Py_XDECREF()
486486

487-
This example represents an endorsed use of the :keyword:`goto` statement in C!
487+
This example represents an endorsed use of the ``goto`` statement in C!
488488
It illustrates the use of :cfunc:`PyErr_ExceptionMatches` and
489489
:cfunc:`PyErr_Clear` to handle specific exceptions, and the use of
490490
:cfunc:`Py_XDECREF` to dispose of owned references that may be *NULL* (note the

‎Doc/c-api/newtypes.rst‎

Lines changed: 6 additions & 7 deletions
Original file line numberDiff line numberDiff line change
@@ -459,7 +459,7 @@ type objects) *must* have the :attr:`ob_size` field.
459459
declare the instance struct) and this in turn includes the :attr:`_ob_prev` and
460460
:attr:`_ob_next` fields if they are present. This means that the only correct
461461
way to get an initializer for the :attr:`tp_basicsize` is to use the
462-
:keyword:`sizeof` operator on the struct used to declare the instance layout.
462+
``sizeof`` operator on the struct used to declare the instance layout.
463463
The basic size does not include the GC header size (this is new in Python 2.2;
464464
in 2.1 and 2.0, the GC header size was included in :attr:`tp_basicsize`).
465465

@@ -1145,7 +1145,7 @@ The next fields, up to and including :attr:`tp_weaklist`, only exist if the
11451145

11461146
PyObject * tp_descr_get(PyObject *self, PyObject *obj, PyObject *type);
11471147

1148-
XXX more
1148+
XXX explain.
11491149

11501150
This field is inherited by subtypes.
11511151

@@ -1160,7 +1160,7 @@ The next fields, up to and including :attr:`tp_weaklist`, only exist if the
11601160

11611161
This field is inherited by subtypes.
11621162

1163-
XXX more
1163+
XXX explain.
11641164

11651165

11661166
.. cmember:: long PyTypeObject.tp_dictoffset
@@ -1683,10 +1683,9 @@ member in the :ctype:`PyTypeObject` structure should be *NULL*. Otherwise, the
16831683
and :exc:`SystemError` should be raised when *segment* specifies a segment that
16841684
doesn't exist.
16851685

1686-
.. % Why doesn't it raise ValueError for this one?
1687-
.. % GJS: because you shouldn't be calling it with an invalid
1688-
.. % segment. That indicates a blatant programming error in the C
1689-
.. % code.
1686+
.. Why doesn't it raise ValueError for this one?
1687+
GJS: because you shouldn't be calling it with an invalid
1688+
segment. That indicates a blatant programming error in the C code.
16901689
16911690
16921691
.. ctype:: Py_ssize_t (*segcountproc) (PyObject *self, Py_ssize_t *lenp)

‎Doc/distutils/setupscript.rst‎

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -137,7 +137,7 @@ the Distutils to go out and find the right files; you have to specify the
137137
extension name, source file(s), and any compile/link requirements (include
138138
directories, libraries to link with, etc.).
139139

140-
.. % XXX read over this section
140+
.. XXX read over this section
141141
142142
All of this is done through another keyword argument to :func:`setup`, the
143143
:option:`ext_modules` option. :option:`ext_modules` is just a list of

‎Doc/documenting/fromlatex.rst‎

Lines changed: 20 additions & 10 deletions
Original file line numberDiff line numberDiff line change
@@ -154,25 +154,35 @@ These changes to information units should be noted:
154154

155155
Description.
156156

157-
* **New information unit**
157+
* **New information units**
158158

159-
There is a new generic information unit called "describe" which can be used
160-
to document things that are not covered by the other units::
159+
There are new generic information units: One is called "describe" and can be
160+
used to document things that are not covered by the other units::
161161

162162
.. describe:: a == b
163163

164164
The equals operator.
165165

166+
The others are::
167+
168+
.. cmdoption:: -O
169+
170+
Describes a command-line option.
171+
172+
.. envvar:: PYTHONINSPECT
173+
174+
Describes an environment variable.
175+
166176

167177
Structure
168178
---------
169179

170-
The LaTeX docs were split in several toplevel manuals. Now, all files
171-
are part of the same documentation tree, as indicated by the *toctree*
172-
directives in the sources. Every *toctree* directive embeds other files
173-
as subdocuments of the current file (this structure is not necessarily
174-
mirrored in the filesystem layout). The toplevel file is
175-
:file:`contents.rst`.
180+
The LaTeX docs were split in several toplevel manuals. Now, all files are part
181+
of the same documentation tree, as indicated by the *toctree* directives in the
182+
sources (though individual output formats may choose to split them up into parts
183+
again). Every *toctree* directive embeds other files as subdocuments of the
184+
current file (this structure is not necessarily mirrored in the filesystem
185+
layout). The toplevel file is :file:`contents.rst`.
176186

177187
However, most of the old directory structure has been kept, with the
178188
directories renamed as follows:
@@ -184,7 +194,7 @@ directories renamed as follows:
184194
* :file:`inst` -> :file:`installing`
185195
* :file:`lib` -> :file:`library`
186196
* :file:`mac` -> merged into :file:`library`, with :file:`mac/using.tex`
187-
moved to :file:`howto/pythonmac.rst`
197+
moved to :file:`using/mac.rst`
188198
* :file:`ref` -> :file:`reference`
189199
* :file:`tut` -> :file:`tutorial`, with the single TeX file split up
190200

‎Doc/documenting/markup.rst‎

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -455,7 +455,7 @@ in a different style:
455455

456456
.. describe:: keyword
457457

458-
The name of a keyword in a programming language.
458+
The name of a keyword in Python.
459459

460460
.. describe:: mailheader
461461

0 commit comments

Comments
 (0)