Benjamin Peterson
bab69bf655
update docs for #23111
2014-12-30 15:17:03 -06:00
Benjamin Peterson
5feeebaa84
use a proper m-dash
2014-12-28 22:14:15 -06:00
Berker Peksag
a1a1409e42
Issue #23125 : Update nose project page link.
...
Reported by Damien Marié.
2014-12-28 18:48:33 +02:00
R David Murray
8c4e112afc
#23040 : Clarify treatment of encoding and errors when component is bytes.
...
Patch by Wojtek Ruszczewski.
2014-12-24 21:23:18 -05:00
Benjamin Peterson
a54f07504f
update correct French examples ( #23109 )
2014-12-24 16:07:02 -06:00
Benjamin Peterson
643eb4464a
improve incorrect French ( #23109 )
...
Following suggestions from Clément.
2014-12-24 13:58:05 -06:00
Benjamin Peterson
b33bb89b1a
doucment that Py_SetPath copies its argument ( closes #23110 )
2014-12-24 10:49:11 -06:00
Victor Stinner
4f9b773a64
asyncio doc: Fix doc of get and put methods of Queue
2014-12-22 22:07:06 +01:00
Barry Warsaw
904c481099
Fix typo.
2014-12-19 11:20:00 -05:00
Berker Peksag
2338156fa4
Issue #23070 : Fix a comment in the tutorial.
...
"Python" has 6 characters, not 7.
Reported by Ross Burnett.
2014-12-17 14:56:47 +02:00
Raymond Hettinger
558dcf38e6
Issue #23049 : Pure python equivalent shouldn't imply more exactitude than is really there.
2014-12-16 18:16:57 -08:00
Victor Stinner
4d5115c7b5
asyncio doc: call_soon() does not call immediatly the callback. Patch written
...
by Martin Panter.
2014-12-15 17:50:55 +01:00
Berker Peksag
bd62f0a6e4
Issue #23047 : Fix typo in pyporting.rst.
...
Patch by Chaitanya agrawal.
2014-12-13 15:48:22 +02:00
Ned Deily
5d3febf0cf
Issue #17128 : Use private version of OpenSSL for 3.x OS X 10.5+ installers.
...
Among other issues, the Apple-supplied 0.9.7 libs for the 10.5 ABI cannot
verify newer SHA-256 certs as now used by python.org services. Document
in the installer ReadMe some of the certificate management issues that
users now need to be more concerned with due to PEP 476's enabling cert
verification by default. For now, continue to use the Apple-supplied
0.9.8 libs for the 10.6+ installer since they use Apple private APIs to
verify certificates using the system- and user-managed CA keychain stores.
2014-12-13 00:17:46 -08:00
Brett Cannon
90783ebf27
Address some comments from Nick Coghlan
2014-12-12 15:13:43 -05:00
Benjamin Peterson
f615d1fe8e
remove reference to dead irc channel ( closes #23038 )
2014-12-12 09:56:33 -05:00
Raymond Hettinger
d2a296a73a
Issue 23005: Fix typos
2014-12-11 23:56:32 -08:00
Serhiy Storchaka
b252b5ab0c
Issue #22823 : Fixed an output of sets in examples.
2014-12-11 10:30:21 +02:00
Terry Jan Reedy
e40031d1db
whitespace
2014-12-10 18:49:58 -05:00
Terry Jan Reedy
06c6218d00
Issue #23006 whitespace
2014-12-10 18:48:23 -05:00
Terry Jan Reedy
b67f6e27e1
Issue #23006 : Improve the documentation and indexing of dict.__missing__.
...
Add an entry in the language datamodel special methods section.
Revise and index its discussion in the stdtypes mapping/dict section.
2014-12-10 18:38:19 -05:00
Benjamin Peterson
82c05a54a2
fix path to patchlevel.py
2014-12-10 11:04:17 -05:00
R David Murray
c9f5f2ddc7
#22918 : Drop obsolete mention of 'keys' in datamodel __iter__ docs.
...
Patch by Chaitanya Agrawal.
2014-12-10 09:51:01 -05:00
Berker Peksag
8b1cbd2b7c
Issue #12602 : Add missing cross-references to runpy and using/cmdline docs.
...
Patch by Éric Araujo.
2014-12-10 01:47:02 +02:00
Benjamin Peterson
e3b743cd3e
fix reference by adding module name
2014-12-07 17:26:38 -05:00
Benjamin Peterson
a090f01bb6
HTTPSConnection: prefer the context's check_hostname attribute over the constructor parameter ( #22959 )
2014-12-07 13:18:25 -05:00
Benjamin Peterson
b92fd01189
note that sslv3 may not be available
2014-12-06 11:36:32 -05:00
Brett Cannon
17be09c475
Fix a bad link
2014-12-05 18:11:05 -05:00
Serhiy Storchaka
b757c83ec6
Issue #22581 : Use more "bytes-like object" throughout the docs and comments.
2014-12-05 22:25:22 +02:00
Brett Cannon
6b335196c5
Issue #22914 : Update the Python 2/3 porting HOWTO to describe a more
...
automated process.
2014-12-05 10:56:12 -05:00
Terry Jan Reedy
3ab745e386
Edit Menus section of Idle doc. Make menu entries match current Idle in order
...
and case. Edit some of the explanatory sentences and end all with a period.
2014-12-05 02:43:07 -05:00
Yury Selivanov
a5ef83244b
docs.inspect: Fix BoundArguments example. Issue #22998 .
2014-12-04 22:47:44 -05:00
Terry Jan Reedy
bb37b4ca73
Issue #3068 : Document the new Configure Extensions dialog and menu entry.
2014-12-04 01:26:04 -05:00
Terry Jan Reedy
f56849486b
Issue #16893 : For Idle doc, move index entries, copy no-subprocess section
...
from idlelib/help.txt, add 'C' comment, and remove obsolete ^Z comment
Original patch by Zach Ware.
2014-12-04 00:54:59 -05:00
Antoine Pitrou
2b207badd6
Fix #22987 : update the compatibility matrix for a SSLv23 client.
2014-12-03 20:00:56 +01:00
Serhiy Storchaka
1ad088f3ea
Issue #14099 : ZipFile.open() no longer reopen the underlying file. Objects
...
returned by ZipFile.open() can now operate independently of the ZipFile even
if the ZipFile was created by passing in a file-like object as the first
argument to the constructor.
2014-12-03 09:11:57 +02:00
Victor Stinner
d87de83582
Closes #22475 : asyncio doc, fix Task.get_stack() doc
2014-12-02 17:57:04 +01:00
Victor Stinner
039f703b7b
Close #22473 : asyncio doc: rephrase Future with run_forever() example
2014-12-02 17:52:45 +01:00
Serhiy Storchaka
56a6d855e2
Removed duplicated words in in comments and docs.
2014-12-01 18:28:43 +02:00
Benjamin Peterson
b7138e24e3
context is keyword-only
2014-11-29 23:38:17 -05:00
Benjamin Peterson
c1da3d1ed8
add context parameter to xmlrpclib.ServerProxy ( #22960 )
...
Patch by Alex Gaynor.
2014-11-29 23:32:57 -05:00
Victor Stinner
e7182979d6
Closes #22348 : Rephrase asyncio.StreamWriter.drain() documentation
...
Patch written by Martin Richard.
2014-11-28 17:45:41 +01:00
Victor Stinner
1deee54e0c
asyncio doc: reformat event loop policy doc
2014-11-28 13:58:28 +01:00
Victor Stinner
8464c24c82
asyncio doc: explain how to pass keywords to callbacks (functools.partial)
2014-11-28 13:15:41 +01:00
Serhiy Storchaka
7a6915e17d
Issue #21514 : The documentation of the json module now refers to new JSON RFC
...
7159 instead of obsoleted RFC 4627.
2014-11-27 19:41:47 +02:00
Zachary Ware
4847035458
pydoc: Add a note about setting PAGER to affect console output pagination.
...
Suggested by James Lowden on docs@.
2014-11-26 23:44:25 -06:00
Ethan Furman
b004943e9b
(3.4) Issue22780: reword NotImplemented docs to emphasise should
2014-11-26 21:15:35 -08:00
Zachary Ware
61aebca09d
pydoc: Remove mention of '-g' command line option, document its removal.
2014-11-26 22:57:35 -06:00
Berker Peksag
c8c64e30e8
Issue #20351 : Add examples for csv.DictReader and csv.DictWriter.
...
Patch by Charles-Axel Dein.
2014-11-24 23:46:30 +02:00
Benjamin Peterson
43052a14c1
add context parameter to HTTPHandler ( closes #22788 )
2014-11-23 20:36:44 -06:00
Benjamin Peterson
dbd4bcfcca
correct versionchanged version
2014-11-23 20:09:31 -06:00
Benjamin Peterson
7243b574e5
don't require OpenSSL SNI to pass hostname to ssl functions ( #22921 )
...
Patch by Donald Stufft.
2014-11-23 17:04:34 -06:00
Benjamin Peterson
378e15d7ab
document that cadefault does nothing now
2014-11-23 11:43:33 -06:00
Benjamin Peterson
9fc59c9fc2
make plural s lowercase
2014-10-19 10:47:49 -04:00
Serhiy Storchaka
f751a9e6a2
Issue #22845 : Improved formatting of dis documentation.
2014-11-11 10:02:11 +02:00
Berker Peksag
4900877bca
Issue #22839 : Fix Snapshot.statistics() link.
2014-11-10 23:15:32 +02:00
Raymond Hettinger
86e9b6b164
Issue 22830: Clarify docs for functools.cmp_to_key().
2014-11-09 17:20:56 -08:00
Berker Peksag
eb1a3cd4ea
Issue #22695 : Fix rendering of the deprecated-removed role in HTML.
2014-11-08 22:40:22 +02:00
Berker Peksag
b556399fb5
Issue #22808 : Link to the correct time method in BaseEventLoop.call_at().
...
Patch by Mark Grandi.
2014-11-07 19:51:07 +02:00
Raymond Hettinger
dc69e03ef3
Issue 22803: Add missing versionadded directive.
2014-11-05 21:27:56 -08:00
Georg Brandl
b9b389efed
Closes #22525 : clarify documentation for ast.literal_eval().
2014-11-05 20:20:28 +01:00
Benjamin Peterson
4ffb075271
PEP 476: enable HTTPS certificate verification by default ( #22417 )
...
Patch by Alex Gaynor with some modifications by me.
2014-11-03 14:29:33 -05:00
Benjamin Peterson
a5c9c37dd5
wrap
2014-11-02 13:17:56 -05:00
Benjamin Peterson
77a75b3db1
note xmlrpclib doesn't verify certs (yet)
2014-10-13 11:54:50 -04:00
Georg Brandl
edc3cbaaba
Copyright year update, add version to licenses.
2014-10-04 14:16:59 +02:00
Senthil Kumaran
8b7e161ac3
backport context argument of urlopen ( #22366 ) for pep 476
2014-09-19 15:23:30 +08:00
R David Murray
64f10d4f5e
Reflow paragraph.
2014-11-02 12:32:26 -05:00
R David Murray
3ca68e77b8
Fix English phrasing.
2014-11-02 12:31:47 -05:00
Serhiy Storchaka
e5cf4868d3
Issue #22388 : Unified the style of "Contributed by" sentences in What's New.
2014-11-02 19:18:52 +02:00
Georg Brandl
36ac510956
Closes #22771 : "verbose" is unused; deprecate it.
2014-10-31 10:54:06 +01:00
Georg Brandl
a4c8c47961
#22613 : remaining corrections in extending/reference docs (thanks Jacques Ducasse)
2014-10-31 10:38:49 +01:00
Georg Brandl
8ed75cd8e9
#22613 : minor other fixes in library docs (thanks Jacques Ducasse)
2014-10-31 10:25:48 +01:00
Georg Brandl
2677faecf5
#22613 : document Cmd.cmdqueue (thanks Jacques Ducasse)
2014-10-31 10:25:38 +01:00
Georg Brandl
717e02896f
#22613 : fix heading levels in tracemalloc docs (thanks Jacques Ducasse)
2014-10-31 10:21:07 +01:00
Georg Brandl
9b1b0e54e7
#22613 : elaborate on arguments of shutil archival functions (thanks Jacques Ducasse)
2014-10-31 10:02:40 +01:00
Georg Brandl
f30132fdc9
#22613 : explain what "buffer" is in the struct documentation (thanks Jacques Ducasse)
2014-10-31 09:46:41 +01:00
Georg Brandl
e4196d3f2e
#22613 : fix several factual errors in builtin docs (thanks Jacques Ducasse)
2014-10-31 09:41:46 +01:00
Georg Brandl
f0d2ed73ac
minor grammar fixes (from docs@python.org)
2014-10-31 09:29:38 +01:00
Georg Brandl
4433ff958b
unittest.mock docs: fix use of default role
2014-10-31 07:59:37 +01:00
Georg Brandl
35903c809f
Sphinx extension: move imports to the module top
2014-10-30 22:55:13 +01:00
Georg Brandl
5aa761db52
pyporting howto: fix link target
2014-10-30 22:52:02 +01:00
Georg Brandl
884217cb60
distutils example: fix invalid rst in description string
2014-10-30 22:50:46 +01:00
Georg Brandl
3b4cf554e5
rstlint: make the "html leaked markup" regex a bit less sensitive
2014-10-30 22:49:54 +01:00
Georg Brandl
ef08bde8b8
minor markup fix: no inline markup is allowed in a module synopsis
2014-10-30 22:45:27 +01:00
Georg Brandl
2273b096ce
rstlint: we do not use svn anymore
2014-10-30 22:44:41 +01:00
Georg Brandl
95988f98ea
rstlint: add more directives we use
2014-10-30 22:35:55 +01:00
Georg Brandl
eb9106c928
Doc/contents: avoid false positive in rstlint
2014-10-30 22:31:32 +01:00
Georg Brandl
f2b56518f9
rstlint: recognize "deprecated-removed" directive
2014-10-30 22:30:01 +01:00
Georg Brandl
6b4c847c4f
Doc: fix default role usage (except in unittest mock docs)
2014-10-30 22:26:26 +01:00
Georg Brandl
b7354a65ce
Fixing broken links in doc, part 4: some more breaks and redirects
2014-10-29 10:57:37 +01:00
Georg Brandl
0ef496678a
linkcheck: ignore issue URLs and PEP URLs (the latter until the PEPs are on www.python.org again).
2014-10-29 10:57:01 +01:00
Georg Brandl
525d355984
Fixing broken links in doc, part 3: the rest
2014-10-29 10:26:56 +01:00
Georg Brandl
9bdcb3bc8a
Fixing broken links in doc, part 2: howto/
2014-10-29 09:37:43 +01:00
Georg Brandl
77fe77d4af
Fixing broken links in doc, part 1: faq/
2014-10-29 09:24:54 +01:00
Georg Brandl
728e4debd8
Fix external links to docs.python.org to use internal links instead.
2014-10-29 09:00:30 +01:00
Georg Brandl
5e722f698e
Remove now-dead link to IDLE debugger doc and add PyCharm to the commercial IDEs.
2014-10-29 08:55:14 +01:00
Georg Brandl
485922ea1f
Update "where is python.org hosted" FAQ.
2014-10-29 08:52:43 +01:00
Georg Brandl
e73778c1ac
Use https:// URLs when referring to python.org hosts.
2014-10-29 08:36:35 +01:00
Georg Brandl
46761ec7c2
Use https:// URLs in the HTML templates.
2014-10-29 08:36:15 +01:00
Georg Brandl
69a7203948
Doc readme: Fix markup, use https:// URLs.
2014-10-29 08:18:43 +01:00
Georg Brandl
9ab33eada4
Adjust the author field of the .tex files to reflect that docs are now maintained by all of us
2014-10-29 08:14:04 +01:00
Georg Brandl
a1f8486325
Move HTML templates to their own subdir.
2014-10-29 08:11:46 +01:00
Georg Brandl
e03902910c
Move Sphinx extensions to their own subdir.
2014-10-29 08:07:37 +01:00
Georg Brandl
9a333a6f65
Remove a few config values that keep the default values, move values to the correct section
2014-10-29 08:04:27 +01:00
Georg Brandl
3fdea95307
Remove deprecated and now unnecessary config value from conf.py.
2014-10-29 07:58:34 +01:00
Georg Brandl
fe85807d7f
Fix link to ABOP install chapter.
2014-10-28 23:00:25 +01:00
Georg Brandl
ce64cedff4
Fix module name.
2014-10-28 22:58:24 +01:00
Georg Brandl
946faa39e3
Using "-m module" is easier to read and understand than "-mmodule".
2014-10-28 22:54:24 +01:00
Georg Brandl
4ab5733685
Update Opensolaris advice to OpenCSW instead of defunct Blastwave.
2014-10-28 22:52:49 +01:00
Georg Brandl
2b07b0e868
Closes #22249 : use IPPROTO_TCP constant instead of SOL_TCP constant for getaddrinfo() proto param
2014-10-28 22:45:27 +01:00
Georg Brandl
c943e79384
Remove duplicate bullet point.
2014-10-28 22:40:48 +01:00
Georg Brandl
bb2d669292
Closes #22736 : move seealso to the bottom of the section about RE syntax.
2014-10-28 21:41:51 +01:00
Georg Brandl
89c558da00
Closes #22748 : there are no PyString C functions in 3.x.
2014-10-28 21:38:49 +01:00
Georg Brandl
01546a88b8
Closes #22749 : remove outdated advice to use clock() for accurate timing.
2014-10-28 21:35:35 +01:00
Georg Brandl
75f7490843
PYTHONY2K is long gone. Remove traces from the docs and manpage.
2014-10-28 17:15:10 +01:00
Ezio Melotti
788f2adeae
#22196 : link to Enum in the nametuple documentation. Patch by Karmen Dykstra.
2014-10-28 15:07:14 +01:00
Ezio Melotti
9b1e92f5a1
#22237 : document that sorted() is guaranteed to be stable. Initial patch by Martin Panter.
2014-10-28 12:57:11 +01:00
Nick Coghlan
3894ae20ea
Issue #22711 : improve links in new distribution docs
...
- key term hyperlinks for distutils, setuptools & wheel
- distutils landing page links directly to setuptools docs
- short summary of setuptools benefits provided with link
2014-10-26 00:00:04 +10:00
Berker Peksag
6d1c149a46
Issue #22723 : Make link styling more accessible.
...
Patch by Buck Golemon.
2014-10-25 05:20:49 +03:00
Victor Stinner
2cef300187
asyncio doc: fix typo in an example
2014-10-23 22:38:46 +02:00
Victor Stinner
c803bd84b5
Issue #22695 : Fix syntax of open() doc
2014-10-22 09:55:44 +02:00
Antoine Pitrou
4b4ddb2190
Issue #22660 : update various mentions in the ssl module documentation.
2014-10-21 00:14:39 +02:00
Jesus Cea
67503c5f1c
Docs: 'os.pwrite()' needs bytes, not strings
2014-10-20 16:18:24 +02:00
Benjamin Peterson
0fc08fd2c7
merge 3.3
2014-10-19 10:47:58 -04:00
Ethan Furman
f87f515057
Issue7186: document that __doc__ is not inherited by subclasses
2014-10-17 22:25:22 -07:00
Victor Stinner
7f314ed71b
asyncio doc: write simpler examples to introduce asyncio
2014-10-15 18:49:16 +02:00
Ethan Furman
7184bac544
Issue20386: SocketType is again socket.socket; the IntEnum SOCK constants are SocketKind
2014-10-14 18:56:53 -07:00
Victor Stinner
39892055cd
asyncio doc: rewrite subprocess doc
...
* add a new example using transport and protocol
* rewrite the example using streams to make it much simpler (remove error
handling, use a simpler Python code)
* copy (and adapt) more documentation from the subprocess module:
- add a note about Process.wait() deadlock
- add a note about shell injection
- etc.
* sort Process methods and attributes in the same order than subprocess.Popen
methods and attributes, so the documentation looks closer
* list differences between Process and subprocess.Popen APIs
2014-10-14 00:52:07 +02:00
Victor Stinner
3c95062f52
asyncio doc: protocol_factory of subprocess_exec() and subprocess_shell() must
...
instanciate a subclass of SubprocessProtocol
2014-10-14 00:02:10 +02:00
Victor Stinner
4270a24dd9
asyncio doc: document BaseSubprocessTransport.close() method
...
Modify also the get_pipe_transport() doc to mention explicitly the supported
file descriptors.
2014-10-13 23:56:43 +02:00
Alex Gaynor
e6f8c5025a
Use https:// URLs for the bug tracker in the :issue: role.
...
Thanks to Ezio for noticing this
2014-10-13 12:58:03 -07:00
Alex Gaynor
53dfcd86e9
issue22626: Use https:// for a link to the bug tracker
2014-10-13 12:55:21 -07:00
Benjamin Peterson
157da6fdd2
merge 3.3
2014-10-13 11:55:02 -04:00
Victor Stinner
ed8e3a987e
asyncio: add missing @coroutine decorator
2014-10-13 00:55:50 +02:00
Victor Stinner
ab1c853079
asyncio doc: update debug traces
2014-10-12 21:37:16 +02:00
Victor Stinner
980dd84f92
asyncio doc: more explicit doc for async()
...
The function schedules the execution of coroutines, it's not just a wrapper for
something.
2014-10-12 21:36:17 +02:00
Victor Stinner
33f6abe4ae
asyncio doc: reformat create_server() doc
...
Fix also the reate_unix_connection() doc: the method is not support on Windows,
not need to mention that ssl is not support with ProactorEventLoop.
2014-10-12 20:36:04 +02:00
Victor Stinner
ed051594d7
asyncio doc: add TCP echo client/server using streams
2014-10-12 20:18:16 +02:00
R David Murray
2ac7a89843
#17325 : Improve distutils PyPI documentation.
...
Patch by Chris Jerdonek.
2014-10-12 13:14:12 -04:00
Georg Brandl
62b08136d7
Closes #22586 : clarify meaning of allow_fragments in urlparse.
2014-10-12 16:13:32 +02:00
Victor Stinner
5366434336
asyncio doc: enhance TCP client example
2014-10-12 11:35:09 +02:00
Victor Stinner
cfbea3a02e
asyncio doc: clarify how servers create protocol instances
2014-10-12 11:30:17 +02:00
Victor Stinner
c7edffdddd
asyncio doc: add UDP client and server examples
2014-10-12 11:24:26 +02:00
Victor Stinner
c2721b41d3
asyncio doc: use server.wait_closed() in TCP echo server example
2014-10-12 11:13:40 +02:00
Berker Peksag
edd6ec2dd3
Issue #22613 : Fix reprlib.Repr subclass example on Python 3.
...
Reported by Jacques Ducasse.
2014-10-12 05:11:16 +03:00
Nick Coghlan
36d8ef9cc7
Issue #21061 : correctly note redirect_stdout is reentrant
2014-10-12 10:25:00 +10:00
Victor Stinner
ccd8e34508
asyncio doc: socket.socketpair() is not available on Windows yet
2014-10-11 16:30:02 +02:00
Victor Stinner
04e6df330d
asyncio doc: add examples showing the 3 ways to wait for data from an open
...
socket
2014-10-11 16:16:27 +02:00
Victor Stinner
6888b96cee
asyncio doc: cleanup Hello World examples
2014-10-11 16:15:58 +02:00
Victor Stinner
5121a9ba4a
asyncio doc: the "Get HTTP headers" example now supports HTTPS
2014-10-11 15:52:14 +02:00
Georg Brandl
dbf8344404
Closes #18959 : move optparse and imp to new "superseded modules" chapter
2014-10-11 14:47:11 +02:00
Georg Brandl
e8ea355b72
Closes #21687 : delimiter in Py_SetPath is platform dependent
2014-10-11 14:36:02 +02:00
Georg Brandl
c5dd095a9b
Closes #21675 : fix ordering of description in library intro
2014-10-11 14:32:34 +02:00
Zachary Ware
a13dab47cb
Issue #15414 : Clean and correct the os.path.join docs.
...
In particular, correctly describe the behavior of ntpath.join.
Based on a patch by Dave Sawyer.
2014-10-10 16:03:14 -05:00
Terry Jan Reedy
f9bd920cfa
Issue 22603: add missing 'self'. Patch by Francisco Fernández Castaño.
2014-10-10 16:00:18 -04:00
Victor Stinner
cfb2a0a855
Issue #22564 : ssl doc: mention asyncio in the non-blocking section
2014-10-10 12:45:10 +02:00
Victor Stinner
d28fe8c8f4
Issue #22564 : ssl doc: mention how SSLSocket are usually created
2014-10-10 12:07:19 +02:00
Victor Stinner
3c3d3c73f3
Issue #22564 : ssl doc: use "class" marker to document the SSLSocket class
2014-10-10 12:06:51 +02:00
Victor Stinner
41f92c2818
Issue #22564 : ssl doc: document read(), write(), pending, server_side and
...
server_hostname methods and attributes of SSLSocket.
2014-10-10 12:05:56 +02:00
Victor Stinner
851a6cc071
Issue #22564 : ssl doc: fix typos
2014-10-10 12:04:15 +02:00
R David Murray
5f16f90d1b
#18176 : Change generic UCD PropList link to version specific link.
2014-10-09 20:45:59 -04:00
R David Murray
5bd62420f4
#18176 : fix another reference and add it to the makeunicodedata comment.
2014-10-09 17:39:48 -04:00
R David Murray
7445a383a6
#18176 : updated stdtypes UCD link, added reminder to makeunicodedata.
...
Patch by Alexander Belopolsky.
2014-10-09 17:30:33 -04:00
Victor Stinner
13d3aa502d
Closes #22580 : Fix documentation of PyUnicode_Tailmatch()
...
The result type is Py_ssize_t (and not int).
2014-10-09 11:11:25 +02:00
Berker Peksag
b2fdafe3d2
Issue #22576 : Fix signatures of FTP.storbinary() and FTP.storlines() methods.
...
The correct parameter name is "fp", not "file".
2014-10-08 13:15:04 +03:00
Larry Hastings
2ce95d7b7c
Merge from 3.4.2 release head back into 3.4 mainline.
2014-10-08 02:50:50 -07:00
Benjamin Peterson
57fb11b255
use source role instead of linking to svn
2014-10-06 21:10:25 -04:00
Georg Brandl
9205e9ebdc
Closes #16155 : fix a few errors in doctest output of the FAQ pages.
2014-10-06 17:51:09 +02:00
Georg Brandl
7fa4a8f15a
Closes #12148 : clarify "or's together option flags" in doctest docs.
2014-10-06 16:56:43 +02:00
Georg Brandl
4dd27a3edb
Closes #21782 : the default hash(x) is not exactly id(x) but derived from it.
2014-10-06 16:45:23 +02:00
Georg Brandl
a94ad1e508
Closes #10031 : overhaul the "imports" section of the programming FAQ.
...
Remove the advice to never use relative imports; it is a leftover from 2.x implicit relative imports.
Remove the advice to locally import modules in __init__, it is a strange practice.
Remove the advice to use "from ... import *" with some modules.
2014-10-06 16:02:09 +02:00
Georg Brandl
f6d6dc2e36
Clean up the docs of PyObject_IsSubclass and PyObject_IsInstance, and mention that they call the PEP 3119 methods.
2014-10-06 14:38:53 +02:00
Georg Brandl
a920b6d762
Closes #22507 : document that PyType_IsSubtype does not call __subclasscheck__.
2014-10-06 14:15:06 +02:00
Georg Brandl
eb7e8f607e
Document builtin classes as such, not functions.
2014-10-06 13:54:36 +02:00
Georg Brandl
97435166aa
Closes #22565 : fix argument types of PyErr_WarnEx.
2014-10-06 12:58:00 +02:00
Terry Jan Reedy
c6ad57608b
Issue #22546 : update doc for mini-language float None presentation type.
2014-10-06 02:04:33 -04:00
Larry Hastings
c6256e5f7d
Update pydoc topics and fix supsicious markup for 3.4.2 final.
2014-10-05 19:03:48 -07:00
Benjamin Peterson
1c262a6c75
PyObject not PyType ( closes #18494 )
2014-10-05 21:20:36 -04:00
Georg Brandl
340c749a3a
Closes #19477 : remove outdated documentation of tp_print type object slot.
2014-10-05 16:38:02 +02:00
R David Murray
9db487b31f
#14201 : Update ctypes docs to match behavior changed from 214b28d7a999.
...
Original patch by Erik Johansson, slightly updated by Meador Inge.
2014-10-04 18:25:07 -04:00
Nick Coghlan
5c4fbd5fdf
Realign packaging docs with PyPUG changes
2014-10-04 21:11:25 +10:00
R David Murray
bf92bceaaa
#14056 : Small improvements to the tarfile documentation.
...
Patch by Éric Araujo with help from Lars Gustäbel.
2014-10-03 20:18:48 -04:00
Zachary Ware
7280561b5b
Fix a few typo/grammar issues in the multiprocessing docs.
...
Reported by Scott Hinton on docs@.
2014-10-03 10:55:12 -05:00
Georg Brandl
3f1ef9efd5
Closes #18729 : minor markup improvement.
2014-10-02 12:37:50 +02:00
Georg Brandl
c0a8f8ce84
closes #22528 : add source links to symtable and compileall
2014-10-02 08:38:39 +02:00
Georg Brandl
ea7ec2b481
Remove unused and now removed config value.
2014-10-02 08:27:05 +02:00
Terry Jan Reedy
6e978d2754
Issue #21971 : Index and update turtledemo doc.
2014-10-02 00:16:31 -04:00
Terry Jan Reedy
1895f2b544
Issue 22492: Be explicit that print does not support binary mode files.
...
Original patch by Georg Brandl.
2014-10-01 15:37:42 -04:00
Georg Brandl
0428e6cc89
Remove old overridden version of a Sphinx CSS file.
...
All Python-specific styling is now in the theme anyway.
2014-10-01 19:41:31 +02:00
Georg Brandl
fd3a15a0cc
Make pydoctheme compatible with Sphinx 1.3 HTML output changes.
2014-10-01 19:28:23 +02:00
Ned Deily
14366f3a8e
Fix overlooked conf.py setting in flattening of Doc directory.
2014-09-30 18:41:37 -07:00
R David Murray
6bd68608ff
#21739 : mention subtle difference between loops and listcomps in tutorial.
...
We don't want to go into a full explanation of scopes at this point in the
tutorial, so we just mention that the loop creates or overwrites a persistent
variable while the listcomp doesn't. Not mentioning this would lead someone
to incorrectly assume loops and listcomps were *completely* equivalent, which
would confuse them later.
Original patch by Rose Ames, tweaked to remove the word 'scope'.
2014-09-30 21:25:38 -04:00
Terry Jan Reedy
b6271f2d2b
Issue 22465: grammar, number agreement.
2014-09-30 19:07:49 -04:00
Georg Brandl
97e9ec688c
Move Doc/tools/sphinxext content to Doc/tools, there is no need for the nested subdirectory anymore.
2014-09-30 22:51:30 +02:00
Georg Brandl
2b1a0a30c9
Dont define an empty SPHINXOPTS, which overrides a definition from the environment.
2014-09-30 22:23:57 +02:00
Georg Brandl
bae334cda9
Prepare sphinx extensions for 1.3.
2014-09-30 22:17:41 +02:00
Benjamin Peterson
45d929dc64
add link to pdb source ( closes #22528 )
2014-09-30 16:02:06 -04:00
R David Murray
12dc0d96e0
#20135 : FAQ entry for list mutation. (See also 6375bf34fff6.)
...
I accidentally committed this in 6375bf34fff6; this changeset addresses the
last review comments on the patch.
This is a perennial question and something someone opens a ticket for probably
every other month or so, so I'm surprised we didn't already have a FAQ entry
for it.
The original patch was written by M. Votz, refined first by Ezio Melotti and
further refined by me.
2014-09-29 10:17:28 -04:00
R David Murray
623ae29469
#10510 : Fix bug in forward port of 2.7 distutils patch.
...
Pointed out by Arfrever.
2014-09-28 11:01:11 -04:00
Berker Peksag
9c1dba2758
Revert #22251
2014-09-28 00:00:58 +03:00
Berker Peksag
3749404ba5
Issue #22251 : Fix ReST markup to avoid errors building docs.
2014-09-27 23:21:35 +03:00
R David Murray
9cc5fd7b59
#18854 : make it explicit that is_multipart does not mean 'multipart/xxx'.
...
Original patch (and the idea of using _structure) by Abhilash Raj.
2014-09-27 15:37:40 -04:00
R David Murray
1f3a88fe55
#20974 : Update version table in email intro.
...
Note that the email version string in 3.3 and 3.4 is inaccurate, since it
still exists but wasn't updated while the code was.
2014-09-27 14:59:36 -04:00
Berker Peksag
6c1f0ad665
Issue #17462 : Add a paragraph about advantages of argparse over optparse.
...
Patch by Anastasia Filatova.
2014-09-26 15:34:26 +03:00
Benjamin Peterson
efd713b82b
allow archives for rc releases to be built ( closes #22484 )
2014-09-24 20:22:24 -04:00
R David Murray
22dd8334cd
Improve English phrasing in asyncio task docs.
2014-09-24 11:09:09 -04:00
Benjamin Peterson
eb83ffe1b3
fix error in split() examples ( closes #22459 )
...
Patch by Raúl Cumplido.
2014-09-22 22:43:50 -04:00
Georg Brandl
90d76ca765
Closes #21431 : make docs depend on Sphinx 1.2 and fix pydoc-topics builder to
...
return Unicode strings on Python 3.
2014-09-22 21:18:24 +02:00
Jesus Cea
ca2e02cfe6
Typo: headeronly -> headersonly
2014-09-22 00:43:39 +02:00
Antoine Pitrou
afe8d0646c
Issue #21332 : Ensure that ``bufsize=1`` in subprocess.Popen() selects line buffering, rather than block buffering.
2014-09-21 21:10:56 +02:00
Georg Brandl
3f40c40dea
Doc: remove invalid uses of ":option:" which will emit warnings in Sphinx 1.3.
2014-09-21 00:35:08 +02:00
R David Murray
8a97896a76
#21091 : make is_attachment a method.
...
Since EmailMessage is a provisional API we can fix API bugs in a
maintenance release, but I used a trick suggested by Serhiy to
maintain backward compatibility with 3.4.0/1.
2014-09-20 18:05:28 -04:00
Benjamin Peterson
cbfaa7b9d3
standardize pep 466 relnote style
2014-09-19 17:27:03 -04:00
Benjamin Peterson
49d77fd58a
remove extra letter
2014-09-19 17:29:08 -04:00
Benjamin Peterson
ce30237493
whatsnew for pep 466 ssl backport
2014-09-19 17:23:21 -04:00
Vinay Sajip
2f1cd8a7fc
Issue #22436 : Improved documentation for getEffectiveLevel() and getLevelName().
2014-09-18 18:01:12 +01:00
Senthil Kumaran
15e4833662
Issue #16827 : Make Interpreter introduction section of the tutorial more
...
focussed and move advanced section and customization information to a separate
file called appendix.
Patch credits: Jamayla Wiley, Ya-Ting Huang and James Brewer.
2014-09-18 21:30:28 +08:00
Berker Peksag
2d510e3bab
Issue #14824 : Update Repr.repr_TYPE documentation to use correct name mangling implementation.
...
Patch by Chris Rebert.
2014-09-18 06:05:14 +03:00
Ethan Furman
f75805edb8
Issue21738: clarify usage of __new__ in Enum subclasses
2014-09-16 19:13:31 -07:00
Benjamin Peterson
7c8b89e156
make hg link secure
2014-09-13 01:44:34 -04:00
Vinay Sajip
d1d4fbff63
Issue #22386 : fixed regression.
2014-09-11 23:06:09 +01:00
Benjamin Peterson
6d46dff5b5
y2k compliance, lol ( closes #22380 )
2014-09-10 17:13:06 -04:00
Serhiy Storchaka
148679982f
Issue #22369 : Change "context manager protocol" to "context management protocol".
2014-09-10 23:43:41 +03:00
Nick Coghlan
1d52096d14
Issue #22295 : Adopt 'python -m pip' as the preferred invocation
2014-09-06 20:38:23 +10:00
Nick Coghlan
af117ed3d7
Issue #22346 : also include asyncio PEP 411 notice in 3.4
2014-09-06 19:43:06 +10:00
Serhiy Storchaka
848c8b29f6
Issue #20643 : Removed unneeded (and wrong) class directives.
2014-09-05 23:27:36 +03:00
Ned Deily
29020b155a
Issue #22320 : Fix broken link in the General Python FAQ.
...
Original patch by Josh Lynn.
2014-09-01 00:06:18 -07:00
Victor Stinner
41f3c3f226
Closes #22275 : asyncio: enhance documentation of OS support
2014-08-31 14:47:37 +02:00
Benjamin Peterson
e218bcbf39
getuid() returns real process id not effective ( closes #22307 )
2014-08-30 21:04:15 -04:00
Victor Stinner
d84fd73de2
Issue #22063 : Fix asyncio documentation of socket and pipe operations regarding
...
to non-blocking mode. The non-blocking mode does not matter when using a
ProactorEventLoop, only for SelectorEventLoop.
2014-08-26 01:01:59 +02:00
Victor Stinner
52bb949fd3
asyncio, tulip issue 203: Add _FlowControlMixin.get_write_buffer_limits() method
2014-08-26 00:22:28 +02:00
Victor Stinner
d71dcbb043
asyncio: update the doc
...
* dev: mention that the logging must be configured at DEBUG level
* streams: drain() has no more a strange return value, it's just
a standard coroutine
2014-08-25 17:04:12 +02:00
Terry Jan Reedy
ee55826072
Issue #13540 : add missing markup.
2014-08-23 22:21:47 -04:00
Terry Jan Reedy
65e3ecb3e2
Issue #22243 : fix except grammar in reference.
2014-08-23 19:29:47 -04:00
Terry Jan Reedy
004e87048a
Issue #22232 (partial fix): update Universal newlines Glossary entry.
2014-08-23 18:28:44 -04:00
Nick Coghlan
a5bbc2ea3d
Forward port PEP 466 What's New in 2.7 updates
2014-08-23 14:47:47 +10:00
Berker Peksag
eb265ab873
Issue #22150 : Fix deprecated-removed directive in Sphinx 1.2.
2014-08-22 18:24:29 +03:00
Zachary Ware
f9dd274692
Issue #22178 : Fix the date of the Windows epoch (Jan 1, 1601).
2014-08-11 15:00:48 -05:00
Victor Stinner
337e03ff78
Issue #22112 , asyncio doc: replace loop.create_task(coro) with
...
asyncio.async(coro), mention that asyncio.async() can be used to scheduler a
coroutine, and make it clear that create_task() is only available in Python
3.4.2 and later.
2014-08-11 01:11:13 +02:00
Raymond Hettinger
ac191ce1d3
Issue #22174 : Clean-up grammar and ambiguities in property() docs.
2014-08-10 10:41:25 -07:00
Raymond Hettinger
31b3683d9b
Issue #22180 : Remove weak example
2014-08-10 10:33:03 -07:00
Nick Coghlan
e4936b830c
Issue #21777 : separate docs for binary sequence methods
2014-08-09 16:14:04 +10:00
Ezio Melotti
79a1ffde9b
#22170 : avoid printing newlines twice in tutorial example.
2014-08-08 17:23:32 +03:00
Vinay Sajip
12d9ddf532
Issue #22130 : Corrected fileConfig() documentation.
2014-08-05 10:34:16 +01:00
Ezio Melotti
67f6d5f4d0
#21928 : clarify functools.wraps docs.
2014-08-05 08:14:28 +03:00
Ezio Melotti
e4aad5ab32
#18034 : update FAQ to suggest importlib.import_module instead of __import__. Patch by Wouter van Heyst.
2014-08-04 19:34:29 +03:00
Ezio Melotti
591176e544
#18588 : update the timeit examples to be consistent.
2014-08-04 17:01:16 +03:00
Raymond Hettinger
c6f22cc0a6
Remove unused leftover stray line
2014-08-04 00:21:11 -07:00
Raymond Hettinger
c0de59bfc3
Fix markup.
2014-08-03 23:44:30 -07:00
Raymond Hettinger
c566431bf0
Improve regex tokenizer example by using re.finditer().
...
Also, improve variable names and fix column numbers
in the generated output.
2014-08-03 23:38:54 -07:00