Commit Graph

15913 Commits

Author SHA1 Message Date
R David Murray f9909c27df Make the 'PEP 446' string link to the PEP in whatsnew new feature description.
I also further qualified the cross reference link, since those are
global names.
2013-12-20 14:50:12 -05:00
R David Murray 6d5cb07382 Move versionadded for tracemalloc into the standard location (right after title) 2013-12-20 14:48:50 -05:00
R David Murray 43ad138160 Move versionadded for ensurepip into the standard location (right after title) 2013-12-20 14:40:11 -05:00
R David Murray 6a14381530 Fix Sphinx markup for asyncio modules so :mod:`asyncio` links work. 2013-12-20 14:37:39 -05:00
R David Murray fd1ff1c888 Add versionadded to enum docs. 2013-12-20 14:20:49 -05:00
R David Murray 6adb4543fc Add email package to whatsnew list of significantly improved stdlib modules. 2013-12-20 13:10:43 -05:00
Vinay Sajip f468d5b259 Closes #19902: Merged update from 3.3. 2013-12-19 11:51:19 +00:00
Vinay Sajip 800e11b406 Issue #19902: Added list of logging levels. 2013-12-19 11:50:24 +00:00
Zachary Ware e61f4df275 Closes #20005: Fix typo in operator docs. Patch by Claudiu Popa. 2013-12-18 12:22:35 -06:00
Zachary Ware 0bffca006a Issue #20005: Fix typo in operator docs. Patch by Claudiu Popa. 2013-12-18 12:21:49 -06:00
Nick Coghlan 9a76735b1d Close #19946: use runpy as needed in multiprocessing
- handles main files without a suffix
- handles main submodules properly
- adds test cases for the various kinds of __main__
2013-12-17 22:17:26 +10:00
Eric Snow 7cff4cd7e9 Issue #19713: Fix mistakes in the import page of language reference.
These mistakes were introduced by the initial PEP 451 merge.
2013-12-16 23:10:50 -07:00
Eric Snow ca2d854df8 Issue #19713: Update importlib docs for module spec changes, including deprecations. 2013-12-16 23:06:52 -07:00
Eli Bendersky 5100311bd8 Issue #20001: Add the SVG source of the pathlib-inheritance diagram to Hg 2013-12-16 21:13:40 -08:00
Victor Stinner 1d006a2c0e Backout a1a05e2724dd: shutil.which(bytes) is a new feature and my patch does not work on Windows 2013-12-16 23:39:40 +01:00
Victor Stinner fffb96ba66 Issue #18283: shutil.which() now supports bytes argument, not only text argument. 2013-12-16 22:48:48 +01:00
Antoine Pitrou f6abb70b48 Mention specific exceptions instead of OSError where appropriate. 2013-12-16 21:00:53 +01:00
Antoine Pitrou 0048c98fef Issue #19921: When Path.mkdir() is called with parents=True, any missing parent is created with the default permissions, ignoring the mode argument (mimicking the POSIX "mkdir -p" command).
Patch by Serhiy.
2013-12-16 20:22:37 +01:00
Nick Coghlan 720c7e28cb Issue #19700: set __spec__ appropriately in runpy
Note that __spec__.name is not currently guaranteed to be in
sys.modules when the code is running, only __name__ is.

The "running module is in sys.modules" invariant will be
expanded to also cover __spec__.name in a subsequent patch.
2013-12-15 20:33:02 +10:00
R David Murray 530a69fafc #19970: fix additional typo in 3.4 asyncio docs. 2013-12-14 11:26:06 -05:00
Ezio Melotti 66f8518acb #19981: merge with 3.3. 2013-12-14 12:43:08 +02:00
Ezio Melotti 956040a7cc #19981: fix typo in email.mailbox docs. Patch by Claudiu Popa. 2013-12-14 12:42:29 +02:00
Brett Cannon 706a7296d7 merge for issue #19963 2013-12-13 13:58:47 -05:00
Brett Cannon 98620d87f2 Issue #19963: Document that importlib.import_module() will import
parent packages automatically.
2013-12-13 13:57:41 -05:00
R David Murray 18701160cc Merge: #18036: update .pyc FAQ entry in light of PEP 3147. 2013-12-13 12:30:29 -05:00
R David Murray d913d9d54e #18036: update .pyc FAQ entry in light of PEP 3147.
Initial patch by Phil Connell.
2013-12-13 12:29:29 -05:00
Victor Stinner 774b2e0af2 Issue #14432: Document the removal of the PyFrameObject.f_tstate field 2013-12-13 14:33:01 +01:00
Victor Stinner 86e139ad65 asyncio doc: explain where does the task come from. 2013-12-13 12:51:24 +01:00
Victor Stinner 68bccb4922 asyncio doc: change style of the sequence diagram to focus on the control flow 2013-12-13 12:47:39 +01:00
Victor Stinner 2748bc735e asyncio: remove references to the Tulip project, rename Tulip to asyncio.
Patch written by Vajrasky Kok.
2013-12-13 10:57:04 +01:00
Victor Stinner 441adb8c57 Backout changeset 46393019b650
test_capi is failing and the fix is not trivial, I prefer to revert
2013-12-13 04:14:41 +01:00
Victor Stinner cd0cb8ccd3 Close #19787: PyThread_set_key_value() now always set the value. In Python 3.3,
the function did nothing if the key already exists (if the current value is a
non-NULL pointer).

_testcapi.run_in_subinterp() now correctly sets the new Python thread state of
the current thread when a subinterpreter is created.
2013-12-13 03:22:00 +01:00
Victor Stinner 1c4b892d71 Add a sequence diagram for the chained coroutines example 2013-12-12 12:35:17 +01:00
R David Murray 50bfbb9903 #19063: fix set_payload handling of non-ASCII string input.
This version of the fix raises an error instead of accepting the invalid
input (ie: if a non-ASCII string is used but no charset is specified).
2013-12-11 16:52:11 -05:00
Eric Snow b282b3d804 Issue #18864: Add a setter for ModuleSpec.has_location. 2013-12-10 22:16:41 -07:00
Nick Coghlan 1f609e9b02 Issue #19407: merge PPUG notes from 3.3 2013-12-10 21:31:14 +10:00
Nick Coghlan b5c4fd0a96 Issue #19407: add Python Packaging User Guide notes
The stdlib docs for package distribution and building extensions
are rather dated, and that isn't expected to change for 2.7 and
3.3.

The Python Packaging User Guide isn't complete either, but it's
already a much better road map for new users than the existing
stdlib docs.
2013-12-10 21:24:55 +10:00
Victor Stinner a6fa15367f asyncio doc: simplify task example 2013-12-10 12:20:14 +01:00
Victor Stinner 0839ed4730 asyncio doc: don't document Task.cancel(), already documented in Future.cancel() 2013-12-10 12:18:15 +01:00
Victor Stinner 742520be43 asyncio: document Task.current_task() 2013-12-10 12:14:50 +01:00
Victor Stinner fc25d629ab asyncio: don't document private functions 2013-12-10 02:52:49 +01:00
Victor Stinner 34f2946a11 asyncio: fix 2nd task example 2013-12-10 02:51:05 +01:00
Victor Stinner dbd8950b28 asyncio doc: rewrite the callback hello world to use call_soon() instead of a
direct call.
2013-12-10 02:47:22 +01:00
Victor Stinner b69d62dcac assyncio doc: rewrite, improve and move coroutine, Future and Task examples 2013-12-10 02:09:46 +01:00
Stefan Krah 29e64548c5 Fix typo. 2013-12-09 19:18:59 +01:00
Stefan Krah 345ec35da3 Fix whitespace. 2013-12-09 19:11:05 +01:00
Stefan Krah 2d181de44c Merge 3.3. 2013-12-09 19:03:24 +01:00
Victor Stinner a881a7f205 asyncio doc: explain why the loop is running twice 2013-12-09 13:19:23 +01:00
Victor Stinner d8f11e9265 asyncio: another Future example using add_done_callback() 2013-12-09 13:04:12 +01:00
Victor Stinner 45c2fd9f8a asyncio doc: add an example with Future 2013-12-09 12:40:17 +01:00
Stefan Krah 1761fa9dd1 Add libmpdec license. 2013-12-08 20:54:02 +01:00
Nadeem Vawda bd6932a576 Closes #18430: Document that peek() may change the position of the underlying
file for the BZ2File, GzipFile and LZMAFile classes.
2013-12-08 19:50:05 +01:00
Nadeem Vawda 6976104a36 #18430: Document that peek() may change the position of the underlying file for
the BZ2File, GzipFile and LZMAFile classes.
2013-12-08 19:47:22 +01:00
doko@ubuntu.com ca616a2709 - Issue #19736: Add module-level statvfs constants defined for GNU/glibc
based systems.
2013-12-08 15:23:07 +01:00
Christian Heimes 5bb414d176 Issue #19343: Expose FreeBSD-specific APIs in resource module. Original patch by Koobs. 2013-12-08 14:35:55 +01:00
Guido van Rossum 9710ff04ac Silently ignore unregistering closed files. Fixes issue 19876. With docs and slight test refactor. 2013-12-07 15:57:01 -08:00
Alexandre Vassalotti d05c9ff845 Issue #6784: Strings from Python 2 can now be unpickled as bytes objects.
Initial patch by Merlijn van Deen.

I've added a few unrelated docstring fixes in the patch while I was at
it, which makes the documentation for pickle a bit more consistent.
2013-12-07 01:09:27 -08:00
Benjamin Peterson d45a46b60d merge 3.3 (#19910) 2013-12-06 20:12:51 -05:00
Benjamin Peterson 933142a8f2 document that compile() can take bytes (closes #19910) 2013-12-06 20:12:39 -05:00
Antoine Pitrou 9bcb1127f1 Mention pickle protocol 4, and some tweaks. 2013-12-07 01:05:57 +01:00
Antoine Pitrou 9858e8b98d Issue #19900: improve generalities at the start of the pickle module doc 2013-12-07 00:57:44 +01:00
Antoine Pitrou d4d60554bc Issue #19900: improve generalities at the start of the pickle module doc 2013-12-07 00:56:59 +01:00
Vinay Sajip 1b8b868b84 Merged minor documentation update from 3.3. 2013-12-06 11:23:08 +00:00
Vinay Sajip b1a92a4c89 Added minor clarification in logging HOWTO. 2013-12-06 11:22:24 +00:00
Antoine Pitrou 710280b6d6 Issue #18840: Introduce the json module in the tutorial, and deemphasize the pickle module. 2013-12-05 23:48:10 +01:00
Antoine Pitrou dd799d2e32 Issue #18840: Introduce the json module in the tutorial, and deemphasize the pickle module. 2013-12-05 23:46:32 +01:00
Antoine Pitrou f9c54944df Merge socket doc changes from 3.3 2013-12-04 21:15:24 +01:00
Antoine Pitrou a5cc9d68b9 Tweak the socket module doc layout 2013-12-04 21:11:03 +01:00
Antoine Pitrou e3658a70c3 Issue #19882: tweak docs for socket.close() 2013-12-04 21:02:42 +01:00
Victor Stinner 31d83228c2 asyncio doc: add some notes on the ping example 2013-12-04 11:16:17 +01:00
Victor Stinner 99c2ab4b83 asyncio doc: oh, asyncio module has its own Future class
Improve also wait() documentation: mention that the first parameter is a
sequence
2013-12-03 19:17:25 +01:00
Victor Stinner cf6f72e329 Fix typo in asyncio.AbstractServer documentation 2013-12-03 18:23:52 +01:00
Victor Stinner c6fba92ebc asyncio doc: add one more example of coroutines 2013-12-03 17:37:31 +01:00
Victor Stinner 85a2be7da7 ayncio: replace the disclamer with a seealso section 2013-12-03 15:04:36 +01:00
Victor Stinner 15faa9c8ad asyncio doc: simplify ping example, remove the useless timeout 2013-12-03 15:04:18 +01:00
Victor Stinner afbf827875 asyncio doc: fix definition of stop() method 2013-12-03 02:05:42 +01:00
Victor Stinner 933a8c82ce asyncio doc: reorder methods; typo 2013-12-03 01:59:38 +01:00
Victor Stinner 1ca5ba611b asyncio io: group transports and protocols in a new title 2013-12-03 01:49:43 +01:00
Victor Stinner 0c6f1ca40c asyncio doc: write a complete TCP echo example, client and server
Example based on tcp_echo.py example from Tulip source code.
2013-12-03 01:46:39 +01:00
Victor Stinner 3e09e32c8a asyncio doc: move coroutine example to the Task page 2013-12-03 01:22:06 +01:00
Victor Stinner ea3183f5b8 Split asyncio documentation into subfiles 2013-12-03 01:08:00 +01:00
Victor Stinner fa2ce78a21 asyncio doc: change level of titles
Remove also a duplicated Protocols section!
2013-12-03 00:56:27 +01:00
Victor Stinner b3be72cac3 asyncio doc: reorder sections 2013-12-03 00:49:26 +01:00
Victor Stinner 34d8df5171 asyncio: document wait() function 2013-12-03 00:42:59 +01:00
Victor Stinner dd339a248c asyncio doc
* complete create_connection() prototype
* link to Server
* document get_extra_info() keys
2013-12-03 00:32:48 +01:00
Christian Heimes a5768f7292 Issue #19785: smtplib now supports SSLContext.check_hostname and server name
indication for TLS/SSL connections.
2013-12-02 20:44:17 +01:00
Christian Heimes 216d463b1f Issue #19783: nntplib now supports SSLContext.check_hostname and server name
indication for TLS/SSL connections.
2013-12-02 20:20:11 +01:00
Christian Heimes 1bc7068d7f Issue #19784: poplib now supports SSLContext.check_hostname and server name
indication for TLS/SSL connections.
2013-12-02 20:10:50 +01:00
Christian Heimes b8a3f58158 merge 2013-12-02 20:02:04 +01:00
Christian Heimes 48aae57996 Issue #19782: imaplib now supports SSLContext.check_hostname and server name
indication for TLS/SSL connections.
2013-12-02 20:01:29 +01:00
Serhiy Storchaka 6de88b3107 Fixed formatting (was parsed as description list). 2013-12-02 20:31:00 +02:00
Serhiy Storchaka 475546facf Fixed regex match representation in an example. 2013-12-02 20:23:19 +02:00
Victor Stinner 0c924b83ee asyncio: sort some methods 2013-12-02 17:52:31 +01:00
Victor Stinner b09f9b33d2 asyncio doc: group transport method by classes
Declare classes because they are mentionned in documentation of other functions
2013-12-02 17:46:04 +01:00
Victor Stinner e91f180efe asyncio: more documentation 2013-12-02 17:40:48 +01:00
Victor Stinner be490633be asyncio: document network functions, and stream reader/writer 2013-12-02 17:28:32 +01:00
Eli Bendersky b55c4d4539 Issue #19814: Clarify argparse's docs w.r.t prefix matching 2013-12-02 05:50:48 -08:00
Eli Bendersky f3114532e4 Issue #19814: Clarify argparse's docs w.r.t prefix matching 2013-12-02 05:49:54 -08:00
Victor Stinner c37dd614b6 asyncio: document locks 2013-12-02 14:31:16 +01:00
Victor Stinner 0da1d29c8a asyncio: document Queue classes 2013-12-02 14:06:03 +01:00
Victor Stinner 60efaae4f9 Document Task class and task functions 2013-12-02 13:47:23 +01:00
Victor Stinner 3c3c4f5a11 asyncio: cleanup doc 2013-12-02 13:04:25 +01:00
Victor Stinner 550a09ef86 Issue #19833: Document more asyncio.BaseEventLoop methods 2013-12-02 12:41:54 +01:00
Victor Stinner 4e70bb84e6 Issue #19833: add 2 examples to asyncio doc (hello world) 2013-12-02 12:21:30 +01:00
Victor Stinner 8dc434e092 Issue #19833: asyncio doc: add class name to methods 2013-12-02 12:20:57 +01:00
Victor Stinner 5f5657ee50 (Merge 3.3) Issue #19728: Fix sys.getfilesystemencoding() documentation 2013-12-02 12:17:29 +01:00
Victor Stinner 22d0418f71 Issue #19728: Fix sys.getfilesystemencoding() documentation 2013-12-02 12:16:46 +01:00
Christian Heimes e5b5edfa2c Issue #19781: ftplib now supports SSLContext.check_hostname and server name
indication for TLS/SSL connections.
2013-12-02 02:56:02 +01:00
Christian Heimes 1aa9a75fbf Issue #19509: Add SSLContext.check_hostname to match the peer's certificate
with server_hostname on handshake.
2013-12-02 02:41:19 +01:00
Charles-François Natali 837a6e012f Issue #19849: selectors: Document the possibility of early select() wakeup upon
EINTR.
2013-12-01 13:23:48 +01:00
Zachary Ware 7c63c85f17 Issue #19845: Updated the Compiling Python on Windows docs. 2013-11-30 17:03:03 -06:00
Zachary Ware f8ceb04fcf Issue #19845: Updated the Compiling Python on Windows docs. 2013-11-30 16:59:33 -06:00
Vinay Sajip 8b1e2f351d Closes #19789: Merged update from 3.3. 2013-11-30 22:46:29 +00:00
Vinay Sajip a9c179bd3e Issue #19789: Clarified documentation for logging.disable. 2013-11-30 22:45:29 +00:00
Guido van Rossum 8519e5ade6 More realistic example for selectors.py. 2013-11-29 14:51:18 -08:00
Charles-François Natali a951f3d1ac Remove trailing blanks. 2013-11-29 18:57:47 +01:00
Charles-François Natali a9f90bc602 Set the FDs non-blocking in the selectors example. 2013-11-29 18:52:51 +01:00
Serhiy Storchaka 0e90e99188 Issue #19795: Improved markup of True/False constants. 2013-11-29 12:19:53 +02:00
Serhiy Storchaka fbc1c26803 Issue #19795: Improved markup of True/False constants. 2013-11-29 12:17:13 +02:00
Eli Bendersky b6e66ebdf7 Some minor clarifications in the documentation of pathlib + inheritance diagram 2013-11-28 06:53:05 -08:00
Serhiy Storchaka 889d24ee3a Revert unrelated changes introduced by changeset b2066bc8cab9 (issue #19795). 2013-11-29 23:40:35 +02:00
Ned Deily c034156f26 Change pathlib documentation to use "raise" instead of "throw". 2013-11-27 14:42:55 -08:00
Victor Stinner 5362abf4ec Issue #19818: tracemalloc, the number of frame limit cannot be zero anymore 2013-11-27 23:39:55 +01:00
Victor Stinner 3c0481d426 Close #19798: replace "maximum" term with "peak" in get_traced_memory()
documentation. Use also the term "current" for the current size.
2013-11-27 21:39:49 +01:00
Benjamin Peterson 5143ce5a01 merge 3.3 (#19805) 2013-11-26 23:05:37 -06:00
Benjamin Peterson b152e177ef recommend OrderedDict for this FAQ (closes #19805) 2013-11-26 23:05:25 -06:00
Serhiy Storchaka 03cc56539f Issue #19793: Improved markup for True/False constants in pathlib documentation. 2013-11-26 21:37:12 +02:00
Serhiy Storchaka 6bfe39272e Issue #19794: Improved markup for True/False constants. 2013-11-26 17:33:13 +02:00
Serhiy Storchaka 22dc4d5fa8 Issue #19794: Improved markup for True/False constants. 2013-11-26 17:32:16 +02:00
Georg Brandl 5831882c08 merge with 3.3 2013-11-26 08:25:45 +01:00
Georg Brandl 1833ac37b5 Markup fix. 2013-11-26 08:25:24 +01:00
Victor Stinner 8e3708d88b Issue #18874: allow to call tracemalloc.Snapshot.statistics(cumulative=True)
with traceback_limit=1
2013-11-26 00:45:47 +01:00
Victor Stinner 00773df9f3 Issue #18874: apply Jim Jewett's patch on tracemalloc doc 2013-11-26 00:40:10 +01:00
Ezio Melotti dd7e291dc3 #13592, #17087: add whatsnew entry about regex/match object repr improvements. 2013-11-25 23:20:20 +02:00
Ezio Melotti 613a97e193 #19778: fix a couple of re reprs in the documentation. 2013-11-25 22:47:01 +02:00
Antoine Pitrou c7cf5fca7c Issue #19691: remove outdated mention about RuntimeError 2013-11-25 19:11:07 +01:00
Antoine Pitrou 9527f16bf4 Issue #19691: remove outdated mention about RuntimeError 2013-11-25 19:08:32 +01:00
Victor Stinner d2736affa1 Mention the new tracemalloc module in the What's New in Python 3.4 document 2013-11-25 09:40:27 +01:00
Georg Brandl d476ab1276 merge with 3.3 2013-11-25 08:52:24 +01:00
Georg Brandl 37b70bb908 Closes #19622: clarify message about bufsize changes in 3.2.4 and 3.3.1. 2013-11-25 08:48:37 +01:00
Georg Brandl db5e74fab3 Fix doc markup error. 2013-11-25 08:29:44 +01:00
Ezio Melotti fb310a9ec6 Merge broken link fix from 3.3. 2013-11-25 06:41:00 +02:00
Ezio Melotti f5005883ba Fix broken link in html.entities docs. 2013-11-25 06:40:12 +02:00
Ezio Melotti 250a06c3cb Add whatsnew section about the html package. 2013-11-25 06:18:47 +02:00
Georg Brandl 4d01c4b6bb merge with 3.3 2013-11-24 16:18:23 +01:00
Georg Brandl 44d2429a25 Doc/Makefile: also do "make suspicious" during daily autobuild 2013-11-24 16:17:54 +01:00
Georg Brandl ed007d5b1b Fix suspicious markup in the docs. 2013-11-24 16:09:26 +01:00
Georg Brandl 472a65a710 Fix a few markup problems in the new import doc. 2013-11-24 12:39:56 +01:00
Zachary Ware a4b7a7548c Issue #3158: doctest can now find doctests in functions and methods
written in C.

As a part of this, a few doctests have been added to the builtins module
(on hex(), oct(), and bin()), a doctest has been fixed (hopefully on all
platforms) on float, and test_builtins now runs doctests in builtins.
2013-11-24 01:19:09 -06:00
Serhiy Storchaka d27b455bbc Issue #13477: Added command line interface to the tarfile module.
Original patch by Berker Peksag.
2013-11-24 01:53:29 +02:00