b68c420d8a
Issue #23286 : Fix typo in the tutorial.
...
Patch by Mayank Tripathi.
2015-01-27 02:52:14 +02:00
b76bcc4ffc
Issue #14099 : Backout changeset e5bb3044402b (except adapted tests).
2015-01-26 13:45:39 +02:00
2bef58577f
Issue #18518 : timeit now rejects statements which can't be compiled outside
...
a function or a loop (e.g. "return" or "break").
2015-01-26 12:09:17 +02:00
1923b627b5
#23215 : reflow paragraph.
2015-01-25 15:46:22 -05:00
f1f9675b8a
#23251 : Note that time.sleep affects the calling thread only.
...
This change parallels the language used in the unix man page.
2015-01-25 15:45:14 -05:00
ff37cfe9cc
Issue #23305 : clarified RotatingFileHandler documentation.
2015-01-23 21:19:04 +00:00
71e7296016
Updated pyvenv documentation to match its current behaviour.
2015-01-23 19:35:12 +00:00
5a494f6ad8
Issue #22317 : Document the action parameter in ArgumentParser.add_subparsers() docs.
...
Patch by Mike Short.
2015-01-20 06:45:53 +02:00
d3faf43f9b
Issue #23181 : More "codepoint" -> "code point".
2015-01-18 11:28:37 +02:00
ccb416fee2
Issue #23180 : Rename IDLE "Windows" menu item to "Window".
...
Patch by Al Sweigart.
2015-01-17 21:06:27 -08:00
caa12dab69
Closes #23244 : fix typo. Thanks Mayank Tripathi for the patch.
2015-01-15 08:16:01 +01:00
8a12329281
Issue22997: minor doc update; thanks to Simoen Visser
2015-01-14 22:31:50 -08:00
2f825af728
Issue22988: clarify yield and exception blocks
2015-01-14 22:25:27 -08:00
845d33c526
Issue20467: clarify __init__'s role
2015-01-14 21:56:49 -08:00
119479f705
Issue20467: clarify __init__'s role
2015-01-14 21:56:10 -08:00
82f34ada45
fix instances of consecutive articles ( closes #23221 )
...
Patch by Karan Goel.
2015-01-13 09:17:24 -05:00
73dd030c8b
Issue #22952 : improve multiprocessing doc introduction and defer notes until appropriate.
...
Patch by Davin Potts.
2015-01-11 15:05:29 +01:00
dfe0b2326b
Issue #21902 : Replace incorrect 'hyperbolic arc sine' (etc.) with 'inverse hyperbolic sine' (etc.). Remove meaningless reference to radians.
2015-01-11 13:08:05 +00:00
7eb10311be
asyncio: SelectSelector is limited to 512 sockets on Windows
2015-01-09 15:59:44 +01:00
a092a615f5
asyncio doc: fix section of event loop examples
2015-01-09 15:58:41 +01:00
399c59d7bd
asyncio doc: list limitations to run subprocesses from different threads
2015-01-09 01:32:02 +01:00
283f1aa881
Issue #20487 : Clarify meaning of "side effect" in the magic mock documentation.
...
Patch by A.M. Kuchling.
2015-01-07 21:15:02 +02:00
b9fdb7a452
Issue 19548: update codecs module documentation
...
- clarified the distinction between text encodings and other codecs
- clarified relationship with builtin open and the io module
- consolidated documentation of error handlers into one section
- clarified type constraints of some behaviours
- added tests for some of the new statements in the docs
2015-01-07 00:22:00 +10:00
5819cfa5aa
Cosmetic fixes to the 'Develop with asyncio' page
2015-01-06 00:40:43 -06:00
63b55580fb
emphasize that cffi is better than extension modules for portability
2015-01-05 14:38:46 -06:00
b461000a3f
the current marshal version is 4 ( closes #23167 )
...
Patch by Dmitry Kazakov.
2015-01-04 16:29:48 -06:00
4592497f9d
Add missing URL link to Modernize docs.
2015-01-03 00:45:55 -08:00
a453749a78
merge 3.3
2014-12-31 18:11:22 -06:00
7919acb920
merge 3.2
2014-12-31 18:10:13 -06:00
47e782a67a
update for copyright for 2015
2014-12-31 18:09:36 -06:00
bab69bf655
update docs for #23111
2014-12-30 15:17:03 -06:00
5feeebaa84
use a proper m-dash
2014-12-28 22:14:15 -06:00
a1a1409e42
Issue #23125 : Update nose project page link.
...
Reported by Damien Marié.
2014-12-28 18:48:33 +02:00
8c4e112afc
#23040 : Clarify treatment of encoding and errors when component is bytes.
...
Patch by Wojtek Ruszczewski.
2014-12-24 21:23:18 -05:00
a54f07504f
update correct French examples ( #23109 )
2014-12-24 16:07:02 -06:00
643eb4464a
improve incorrect French ( #23109 )
...
Following suggestions from Clément.
2014-12-24 13:58:05 -06:00
b33bb89b1a
doucment that Py_SetPath copies its argument ( closes #23110 )
2014-12-24 10:49:11 -06:00
4f9b773a64
asyncio doc: Fix doc of get and put methods of Queue
2014-12-22 22:07:06 +01:00
904c481099
Fix typo.
2014-12-19 11:20:00 -05:00
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
558dcf38e6
Issue #23049 : Pure python equivalent shouldn't imply more exactitude than is really there.
2014-12-16 18:16:57 -08:00
4d5115c7b5
asyncio doc: call_soon() does not call immediatly the callback. Patch written
...
by Martin Panter.
2014-12-15 17:50:55 +01:00
bd62f0a6e4
Issue #23047 : Fix typo in pyporting.rst.
...
Patch by Chaitanya agrawal.
2014-12-13 15:48:22 +02:00
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
90783ebf27
Address some comments from Nick Coghlan
2014-12-12 15:13:43 -05:00
f615d1fe8e
remove reference to dead irc channel ( closes #23038 )
2014-12-12 09:56:33 -05:00
d2a296a73a
Issue 23005: Fix typos
2014-12-11 23:56:32 -08:00
b252b5ab0c
Issue #22823 : Fixed an output of sets in examples.
2014-12-11 10:30:21 +02:00
e40031d1db
whitespace
2014-12-10 18:49:58 -05:00
06c6218d00
Issue #23006 whitespace
2014-12-10 18:48:23 -05:00
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
82c05a54a2
fix path to patchlevel.py
2014-12-10 11:04:17 -05:00
c9f5f2ddc7
#22918 : Drop obsolete mention of 'keys' in datamodel __iter__ docs.
...
Patch by Chaitanya Agrawal.
2014-12-10 09:51:01 -05:00
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
e3b743cd3e
fix reference by adding module name
2014-12-07 17:26:38 -05:00
a090f01bb6
HTTPSConnection: prefer the context's check_hostname attribute over the constructor parameter ( #22959 )
2014-12-07 13:18:25 -05:00
b92fd01189
note that sslv3 may not be available
2014-12-06 11:36:32 -05:00
17be09c475
Fix a bad link
2014-12-05 18:11:05 -05:00
b757c83ec6
Issue #22581 : Use more "bytes-like object" throughout the docs and comments.
2014-12-05 22:25:22 +02:00
6b335196c5
Issue #22914 : Update the Python 2/3 porting HOWTO to describe a more
...
automated process.
2014-12-05 10:56:12 -05:00
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
a5ef83244b
docs.inspect: Fix BoundArguments example. Issue #22998 .
2014-12-04 22:47:44 -05:00
bb37b4ca73
Issue #3068 : Document the new Configure Extensions dialog and menu entry.
2014-12-04 01:26:04 -05:00
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
2b207badd6
Fix #22987 : update the compatibility matrix for a SSLv23 client.
2014-12-03 20:00:56 +01:00
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
d87de83582
Closes #22475 : asyncio doc, fix Task.get_stack() doc
2014-12-02 17:57:04 +01:00
039f703b7b
Close #22473 : asyncio doc: rephrase Future with run_forever() example
2014-12-02 17:52:45 +01:00
56a6d855e2
Removed duplicated words in in comments and docs.
2014-12-01 18:28:43 +02:00
b7138e24e3
context is keyword-only
2014-11-29 23:38:17 -05:00
c1da3d1ed8
add context parameter to xmlrpclib.ServerProxy ( #22960 )
...
Patch by Alex Gaynor.
2014-11-29 23:32:57 -05:00
e7182979d6
Closes #22348 : Rephrase asyncio.StreamWriter.drain() documentation
...
Patch written by Martin Richard.
2014-11-28 17:45:41 +01:00
1deee54e0c
asyncio doc: reformat event loop policy doc
2014-11-28 13:58:28 +01:00
8464c24c82
asyncio doc: explain how to pass keywords to callbacks (functools.partial)
2014-11-28 13:15:41 +01:00
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
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
b004943e9b
(3.4) Issue22780: reword NotImplemented docs to emphasise should
2014-11-26 21:15:35 -08:00
61aebca09d
pydoc: Remove mention of '-g' command line option, document its removal.
2014-11-26 22:57:35 -06:00
c8c64e30e8
Issue #20351 : Add examples for csv.DictReader and csv.DictWriter.
...
Patch by Charles-Axel Dein.
2014-11-24 23:46:30 +02:00
43052a14c1
add context parameter to HTTPHandler ( closes #22788 )
2014-11-23 20:36:44 -06:00
dbd4bcfcca
correct versionchanged version
2014-11-23 20:09:31 -06:00
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
378e15d7ab
document that cadefault does nothing now
2014-11-23 11:43:33 -06:00
9fc59c9fc2
make plural s lowercase
2014-10-19 10:47:49 -04:00
f751a9e6a2
Issue #22845 : Improved formatting of dis documentation.
2014-11-11 10:02:11 +02:00
4900877bca
Issue #22839 : Fix Snapshot.statistics() link.
2014-11-10 23:15:32 +02:00
86e9b6b164
Issue 22830: Clarify docs for functools.cmp_to_key().
2014-11-09 17:20:56 -08:00
eb1a3cd4ea
Issue #22695 : Fix rendering of the deprecated-removed role in HTML.
2014-11-08 22:40:22 +02:00
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
dc69e03ef3
Issue 22803: Add missing versionadded directive.
2014-11-05 21:27:56 -08:00
b9b389efed
Closes #22525 : clarify documentation for ast.literal_eval().
2014-11-05 20:20:28 +01:00
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
a5c9c37dd5
wrap
2014-11-02 13:17:56 -05:00
77a75b3db1
note xmlrpclib doesn't verify certs (yet)
2014-10-13 11:54:50 -04:00
edc3cbaaba
Copyright year update, add version to licenses.
2014-10-04 14:16:59 +02:00
8b7e161ac3
backport context argument of urlopen ( #22366 ) for pep 476
2014-09-19 15:23:30 +08:00
64f10d4f5e
Reflow paragraph.
2014-11-02 12:32:26 -05:00
3ca68e77b8
Fix English phrasing.
2014-11-02 12:31:47 -05:00
e5cf4868d3
Issue #22388 : Unified the style of "Contributed by" sentences in What's New.
2014-11-02 19:18:52 +02:00
36ac510956
Closes #22771 : "verbose" is unused; deprecate it.
2014-10-31 10:54:06 +01:00
a4c8c47961
#22613 : remaining corrections in extending/reference docs (thanks Jacques Ducasse)
2014-10-31 10:38:49 +01:00
8ed75cd8e9
#22613 : minor other fixes in library docs (thanks Jacques Ducasse)
2014-10-31 10:25:48 +01:00
2677faecf5
#22613 : document Cmd.cmdqueue (thanks Jacques Ducasse)
2014-10-31 10:25:38 +01:00
717e02896f
#22613 : fix heading levels in tracemalloc docs (thanks Jacques Ducasse)
2014-10-31 10:21:07 +01:00
9b1b0e54e7
#22613 : elaborate on arguments of shutil archival functions (thanks Jacques Ducasse)
2014-10-31 10:02:40 +01:00
f30132fdc9
#22613 : explain what "buffer" is in the struct documentation (thanks Jacques Ducasse)
2014-10-31 09:46:41 +01:00
e4196d3f2e
#22613 : fix several factual errors in builtin docs (thanks Jacques Ducasse)
2014-10-31 09:41:46 +01:00
f0d2ed73ac
minor grammar fixes (from docs@python.org)
2014-10-31 09:29:38 +01:00
4433ff958b
unittest.mock docs: fix use of default role
2014-10-31 07:59:37 +01:00
35903c809f
Sphinx extension: move imports to the module top
2014-10-30 22:55:13 +01:00
5aa761db52
pyporting howto: fix link target
2014-10-30 22:52:02 +01:00
884217cb60
distutils example: fix invalid rst in description string
2014-10-30 22:50:46 +01:00
3b4cf554e5
rstlint: make the "html leaked markup" regex a bit less sensitive
2014-10-30 22:49:54 +01:00
ef08bde8b8
minor markup fix: no inline markup is allowed in a module synopsis
2014-10-30 22:45:27 +01:00
2273b096ce
rstlint: we do not use svn anymore
2014-10-30 22:44:41 +01:00
95988f98ea
rstlint: add more directives we use
2014-10-30 22:35:55 +01:00
eb9106c928
Doc/contents: avoid false positive in rstlint
2014-10-30 22:31:32 +01:00
f2b56518f9
rstlint: recognize "deprecated-removed" directive
2014-10-30 22:30:01 +01:00
6b4c847c4f
Doc: fix default role usage (except in unittest mock docs)
2014-10-30 22:26:26 +01:00
b7354a65ce
Fixing broken links in doc, part 4: some more breaks and redirects
2014-10-29 10:57:37 +01:00
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
525d355984
Fixing broken links in doc, part 3: the rest
2014-10-29 10:26:56 +01:00
9bdcb3bc8a
Fixing broken links in doc, part 2: howto/
2014-10-29 09:37:43 +01:00
77fe77d4af
Fixing broken links in doc, part 1: faq/
2014-10-29 09:24:54 +01:00
728e4debd8
Fix external links to docs.python.org to use internal links instead.
2014-10-29 09:00:30 +01:00
5e722f698e
Remove now-dead link to IDLE debugger doc and add PyCharm to the commercial IDEs.
2014-10-29 08:55:14 +01:00
485922ea1f
Update "where is python.org hosted" FAQ.
2014-10-29 08:52:43 +01:00
e73778c1ac
Use https:// URLs when referring to python.org hosts.
2014-10-29 08:36:35 +01:00
46761ec7c2
Use https:// URLs in the HTML templates.
2014-10-29 08:36:15 +01:00
69a7203948
Doc readme: Fix markup, use https:// URLs.
2014-10-29 08:18:43 +01:00
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
a1f8486325
Move HTML templates to their own subdir.
2014-10-29 08:11:46 +01:00
e03902910c
Move Sphinx extensions to their own subdir.
2014-10-29 08:07:37 +01:00
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
3fdea95307
Remove deprecated and now unnecessary config value from conf.py.
2014-10-29 07:58:34 +01:00
fe85807d7f
Fix link to ABOP install chapter.
2014-10-28 23:00:25 +01:00
ce64cedff4
Fix module name.
2014-10-28 22:58:24 +01:00
946faa39e3
Using "-m module" is easier to read and understand than "-mmodule".
2014-10-28 22:54:24 +01:00
4ab5733685
Update Opensolaris advice to OpenCSW instead of defunct Blastwave.
2014-10-28 22:52:49 +01:00
2b07b0e868
Closes #22249 : use IPPROTO_TCP constant instead of SOL_TCP constant for getaddrinfo() proto param
2014-10-28 22:45:27 +01:00
c943e79384
Remove duplicate bullet point.
2014-10-28 22:40:48 +01:00
bb2d669292
Closes #22736 : move seealso to the bottom of the section about RE syntax.
2014-10-28 21:41:51 +01:00
89c558da00
Closes #22748 : there are no PyString C functions in 3.x.
2014-10-28 21:38:49 +01:00
01546a88b8
Closes #22749 : remove outdated advice to use clock() for accurate timing.
2014-10-28 21:35:35 +01:00
75f7490843
PYTHONY2K is long gone. Remove traces from the docs and manpage.
2014-10-28 17:15:10 +01:00
788f2adeae
#22196 : link to Enum in the nametuple documentation. Patch by Karmen Dykstra.
2014-10-28 15:07:14 +01:00
9b1e92f5a1
#22237 : document that sorted() is guaranteed to be stable. Initial patch by Martin Panter.
2014-10-28 12:57:11 +01:00
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
6d1c149a46
Issue #22723 : Make link styling more accessible.
...
Patch by Buck Golemon.
2014-10-25 05:20:49 +03:00
2cef300187
asyncio doc: fix typo in an example
2014-10-23 22:38:46 +02:00
c803bd84b5
Issue #22695 : Fix syntax of open() doc
2014-10-22 09:55:44 +02:00
4b4ddb2190
Issue #22660 : update various mentions in the ssl module documentation.
2014-10-21 00:14:39 +02:00
67503c5f1c
Docs: 'os.pwrite()' needs bytes, not strings
2014-10-20 16:18:24 +02:00
0fc08fd2c7
merge 3.3
2014-10-19 10:47:58 -04:00
f87f515057
Issue7186: document that __doc__ is not inherited by subclasses
2014-10-17 22:25:22 -07:00
7f314ed71b
asyncio doc: write simpler examples to introduce asyncio
2014-10-15 18:49:16 +02:00
7184bac544
Issue20386: SocketType is again socket.socket; the IntEnum SOCK constants are SocketKind
2014-10-14 18:56:53 -07:00
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
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
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
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
53dfcd86e9
issue22626: Use https:// for a link to the bug tracker
2014-10-13 12:55:21 -07:00
157da6fdd2
merge 3.3
2014-10-13 11:55:02 -04:00
ed8e3a987e
asyncio: add missing @coroutine decorator
2014-10-13 00:55:50 +02:00
ab1c853079
asyncio doc: update debug traces
2014-10-12 21:37:16 +02:00
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
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
ed051594d7
asyncio doc: add TCP echo client/server using streams
2014-10-12 20:18:16 +02:00
2ac7a89843
#17325 : Improve distutils PyPI documentation.
...
Patch by Chris Jerdonek.
2014-10-12 13:14:12 -04:00
62b08136d7
Closes #22586 : clarify meaning of allow_fragments in urlparse.
2014-10-12 16:13:32 +02:00
5366434336
asyncio doc: enhance TCP client example
2014-10-12 11:35:09 +02:00
cfbea3a02e
asyncio doc: clarify how servers create protocol instances
2014-10-12 11:30:17 +02:00
c7edffdddd
asyncio doc: add UDP client and server examples
2014-10-12 11:24:26 +02:00
c2721b41d3
asyncio doc: use server.wait_closed() in TCP echo server example
2014-10-12 11:13:40 +02:00
edd6ec2dd3
Issue #22613 : Fix reprlib.Repr subclass example on Python 3.
...
Reported by Jacques Ducasse.
2014-10-12 05:11:16 +03:00
36d8ef9cc7
Issue #21061 : correctly note redirect_stdout is reentrant
2014-10-12 10:25:00 +10:00
ccd8e34508
asyncio doc: socket.socketpair() is not available on Windows yet
2014-10-11 16:30:02 +02:00
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
6888b96cee
asyncio doc: cleanup Hello World examples
2014-10-11 16:15:58 +02:00
5121a9ba4a
asyncio doc: the "Get HTTP headers" example now supports HTTPS
2014-10-11 15:52:14 +02:00
dbf8344404
Closes #18959 : move optparse and imp to new "superseded modules" chapter
2014-10-11 14:47:11 +02:00
e8ea355b72
Closes #21687 : delimiter in Py_SetPath is platform dependent
2014-10-11 14:36:02 +02:00
c5dd095a9b
Closes #21675 : fix ordering of description in library intro
2014-10-11 14:32:34 +02:00
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
f9bd920cfa
Issue 22603: add missing 'self'. Patch by Francisco Fernández Castaño.
2014-10-10 16:00:18 -04:00
cfb2a0a855
Issue #22564 : ssl doc: mention asyncio in the non-blocking section
2014-10-10 12:45:10 +02:00
d28fe8c8f4
Issue #22564 : ssl doc: mention how SSLSocket are usually created
2014-10-10 12:07:19 +02:00
3c3d3c73f3
Issue #22564 : ssl doc: use "class" marker to document the SSLSocket class
2014-10-10 12:06:51 +02:00
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
851a6cc071
Issue #22564 : ssl doc: fix typos
2014-10-10 12:04:15 +02:00
5f16f90d1b
#18176 : Change generic UCD PropList link to version specific link.
2014-10-09 20:45:59 -04:00
5bd62420f4
#18176 : fix another reference and add it to the makeunicodedata comment.
2014-10-09 17:39:48 -04:00
7445a383a6
#18176 : updated stdtypes UCD link, added reminder to makeunicodedata.
...
Patch by Alexander Belopolsky.
2014-10-09 17:30:33 -04:00
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
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
2ce95d7b7c
Merge from 3.4.2 release head back into 3.4 mainline.
2014-10-08 02:50:50 -07:00
57fb11b255
use source role instead of linking to svn
2014-10-06 21:10:25 -04:00
9205e9ebdc
Closes #16155 : fix a few errors in doctest output of the FAQ pages.
2014-10-06 17:51:09 +02:00
7fa4a8f15a
Closes #12148 : clarify "or's together option flags" in doctest docs.
2014-10-06 16:56:43 +02:00
4dd27a3edb
Closes #21782 : the default hash(x) is not exactly id(x) but derived from it.
2014-10-06 16:45:23 +02:00
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
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
a920b6d762
Closes #22507 : document that PyType_IsSubtype does not call __subclasscheck__.
2014-10-06 14:15:06 +02:00
eb7e8f607e
Document builtin classes as such, not functions.
2014-10-06 13:54:36 +02:00
97435166aa
Closes #22565 : fix argument types of PyErr_WarnEx.
2014-10-06 12:58:00 +02:00
c6ad57608b
Issue #22546 : update doc for mini-language float None presentation type.
2014-10-06 02:04:33 -04:00
c6256e5f7d
Update pydoc topics and fix supsicious markup for 3.4.2 final.
2014-10-05 19:03:48 -07:00
1c262a6c75
PyObject not PyType ( closes #18494 )
2014-10-05 21:20:36 -04:00
340c749a3a
Closes #19477 : remove outdated documentation of tp_print type object slot.
2014-10-05 16:38:02 +02:00
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
5c4fbd5fdf
Realign packaging docs with PyPUG changes
2014-10-04 21:11:25 +10:00
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
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
3f1ef9efd5
Closes #18729 : minor markup improvement.
2014-10-02 12:37:50 +02:00
c0a8f8ce84
closes #22528 : add source links to symtable and compileall
2014-10-02 08:38:39 +02:00
ea7ec2b481
Remove unused and now removed config value.
2014-10-02 08:27:05 +02:00
6e978d2754
Issue #21971 : Index and update turtledemo doc.
2014-10-02 00:16:31 -04:00
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
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
fd3a15a0cc
Make pydoctheme compatible with Sphinx 1.3 HTML output changes.
2014-10-01 19:28:23 +02:00
14366f3a8e
Fix overlooked conf.py setting in flattening of Doc directory.
2014-09-30 18:41:37 -07:00
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
b6271f2d2b
Issue 22465: grammar, number agreement.
2014-09-30 19:07:49 -04:00
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
2b1a0a30c9
Dont define an empty SPHINXOPTS, which overrides a definition from the environment.
2014-09-30 22:23:57 +02:00
bae334cda9
Prepare sphinx extensions for 1.3.
2014-09-30 22:17:41 +02:00
45d929dc64
add link to pdb source ( closes #22528 )
2014-09-30 16:02:06 -04:00
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
623ae29469
#10510 : Fix bug in forward port of 2.7 distutils patch.
...
Pointed out by Arfrever.
2014-09-28 11:01:11 -04:00
9c1dba2758
Revert #22251
2014-09-28 00:00:58 +03:00
3749404ba5
Issue #22251 : Fix ReST markup to avoid errors building docs.
2014-09-27 23:21:35 +03:00
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
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
6c1f0ad665
Issue #17462 : Add a paragraph about advantages of argparse over optparse.
...
Patch by Anastasia Filatova.
2014-09-26 15:34:26 +03:00
efd713b82b
allow archives for rc releases to be built ( closes #22484 )
2014-09-24 20:22:24 -04:00
22dd8334cd
Improve English phrasing in asyncio task docs.
2014-09-24 11:09:09 -04:00
eb83ffe1b3
fix error in split() examples ( closes #22459 )
...
Patch by Raúl Cumplido.
2014-09-22 22:43:50 -04:00
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
ca2e02cfe6
Typo: headeronly -> headersonly
2014-09-22 00:43:39 +02:00
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
3f40c40dea
Doc: remove invalid uses of ":option:" which will emit warnings in Sphinx 1.3.
2014-09-21 00:35:08 +02:00
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
cbfaa7b9d3
standardize pep 466 relnote style
2014-09-19 17:27:03 -04:00
49d77fd58a
remove extra letter
2014-09-19 17:29:08 -04:00
ce30237493
whatsnew for pep 466 ssl backport
2014-09-19 17:23:21 -04:00
2f1cd8a7fc
Issue #22436 : Improved documentation for getEffectiveLevel() and getLevelName().
2014-09-18 18:01:12 +01:00
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
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
f75805edb8
Issue21738: clarify usage of __new__ in Enum subclasses
2014-09-16 19:13:31 -07:00
7c8b89e156
make hg link secure
2014-09-13 01:44:34 -04:00
d1d4fbff63
Issue #22386 : fixed regression.
2014-09-11 23:06:09 +01:00
6d46dff5b5
y2k compliance, lol ( closes #22380 )
2014-09-10 17:13:06 -04:00
148679982f
Issue #22369 : Change "context manager protocol" to "context management protocol".
2014-09-10 23:43:41 +03:00
1d52096d14
Issue #22295 : Adopt 'python -m pip' as the preferred invocation
2014-09-06 20:38:23 +10:00
af117ed3d7
Issue #22346 : also include asyncio PEP 411 notice in 3.4
2014-09-06 19:43:06 +10:00
848c8b29f6
Issue #20643 : Removed unneeded (and wrong) class directives.
2014-09-05 23:27:36 +03:00
29020b155a
Issue #22320 : Fix broken link in the General Python FAQ.
...
Original patch by Josh Lynn.
2014-09-01 00:06:18 -07:00
41f3c3f226
Closes #22275 : asyncio: enhance documentation of OS support
2014-08-31 14:47:37 +02:00
e218bcbf39
getuid() returns real process id not effective ( closes #22307 )
2014-08-30 21:04:15 -04:00
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
52bb949fd3
asyncio, tulip issue 203: Add _FlowControlMixin.get_write_buffer_limits() method
2014-08-26 00:22:28 +02:00
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
ee55826072
Issue #13540 : add missing markup.
2014-08-23 22:21:47 -04:00
65e3ecb3e2
Issue #22243 : fix except grammar in reference.
2014-08-23 19:29:47 -04:00
004e87048a
Issue #22232 (partial fix): update Universal newlines Glossary entry.
2014-08-23 18:28:44 -04:00
a5bbc2ea3d
Forward port PEP 466 What's New in 2.7 updates
2014-08-23 14:47:47 +10:00
eb265ab873
Issue #22150 : Fix deprecated-removed directive in Sphinx 1.2.
2014-08-22 18:24:29 +03:00
f9dd274692
Issue #22178 : Fix the date of the Windows epoch (Jan 1, 1601).
2014-08-11 15:00:48 -05:00
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
ac191ce1d3
Issue #22174 : Clean-up grammar and ambiguities in property() docs.
2014-08-10 10:41:25 -07:00
31b3683d9b
Issue #22180 : Remove weak example
2014-08-10 10:33:03 -07:00
e4936b830c
Issue #21777 : separate docs for binary sequence methods
2014-08-09 16:14:04 +10:00
79a1ffde9b
#22170 : avoid printing newlines twice in tutorial example.
2014-08-08 17:23:32 +03:00
12d9ddf532
Issue #22130 : Corrected fileConfig() documentation.
2014-08-05 10:34:16 +01:00
67f6d5f4d0
#21928 : clarify functools.wraps docs.
2014-08-05 08:14:28 +03:00
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
591176e544
#18588 : update the timeit examples to be consistent.
2014-08-04 17:01:16 +03:00
c6f22cc0a6
Remove unused leftover stray line
2014-08-04 00:21:11 -07:00
c0de59bfc3
Fix markup.
2014-08-03 23:44:30 -07:00
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
b3d4c212f7
Issue #13540 : Merge changes from 3.3
2014-08-03 15:26:58 -04:00
89e186f24e
Issue #13540 : Merge changes from 3.2
2014-08-03 15:26:32 -04:00
79690ac1d0
Issue #13540 : Update references to Action class to match syntax used for other classes in this file.
2014-08-03 14:54:11 -04:00
400daedb13
Fix whitespace in example.
2014-08-02 22:32:10 -07:00
ec2ce092a2
Issue #22063 : Mention in asyncio documentation that socket operations require
...
the socket to be non-blocking
2014-07-29 23:12:22 +02:00
f200ce6333
Document lock parameter for asyncio.Condition()
2014-07-26 19:50:37 +03:00
88a1977a08
Issue #22072 : Fix a couple of SSL doc typos. Patch by Alex Gaynor.
2014-07-25 13:30:50 -05:00
45cff66cf6
Issue #16133 : The asynchat.async_chat.handle_read() method now ignores
...
BlockingIOError exceptions. Initial patch written by Xavier de Gaye.
Document also in asyncore documentation that recv() may raise BlockingIOError.
2014-07-24 18:49:36 +02:00
992019c006
Backport os.rst documentation from Python 3.5.
2014-07-24 12:42:45 +02:00
6d4f4feca2
Issue #21813 : Enhance documentation of the os.stat_result class.
2014-07-24 12:42:16 +02:00
ca4f34366a
Fix incomplete sentence in asyncio docs.
2014-07-24 11:36:33 +03:00
9ff41803af
Asyncio doc fixes: spelling, grammar, duplication.
2014-07-24 02:59:02 -04:00
c935a9530c
Englich grammar nit.
2014-07-24 02:33:14 -04:00
9f5388f24f
Fix doc example bug reported on python-list by Akshay Verma.
2014-07-23 20:30:29 -04:00
f012ba42fe
Issue #22002 : Make full use of test discovery in test sub-packages.
...
Adds `load_package_tests` function to test.support, uses it in test_asyncio,
test_email, test_json, test_tools, test_importlib and all test_importlib
sub-packages to implement test discovery.
2014-07-23 12:00:29 -05:00
588517ca63
Fix grammar
2014-07-23 11:27:17 +03:00
17f5f817de
Issue #15759 : "make suspicious", "make linkcheck" and "make doctest" in Doc/
...
now display special message when and only when there are failures.
2014-07-22 10:24:25 +03:00
eb0ef415d5
Issue #13540 : Removed redundant documentation about Action instance attributes. Updated example and documentation per recommendations by Steven Bethard in msg149524.
2014-07-20 10:52:46 -04:00
102488b644
args doesn't need to be a tuple ( closes #17210 )
2014-07-19 16:34:33 -07:00
e004c6cad5
Issue #22006 : Remove outdated _thread caveat. Thanks Dan O'Reilly for the report.
2014-07-19 21:45:06 +01:00
Berker Peksag
Serhiy Storchaka
R David Murray
Vinay Sajip
Ned Deily
Georg Brandl
Ethan Furman
Benjamin Peterson
Antoine Pitrou
Mark Dickinson
Victor Stinner
Nick Coghlan
Zachary Ware
Barry Warsaw
Raymond Hettinger
Brett Cannon
Terry Jan Reedy
Yury Selivanov
Senthil Kumaran
Ezio Melotti
Jesus Cea
Alex Gaynor
Larry Hastings
Jason R. Coombs
Andrew Svetlov