Commit Graph

18905 Commits

Author SHA1 Message Date
Yury Selivanov 9179c40a9f Merge 3.5 (issue #25486) 2016-01-11 21:05:18 -05:00
Yury Selivanov a7c159ddf3 Issue #25486: Drop "removed in 3.6" wording from inspect.getargspec docs. 2016-01-11 21:04:50 -05:00
Ezio Melotti 1d37771292 #25517: merge with 3.5. 2016-01-12 00:09:43 +02:00
Ezio Melotti 84c63e8df4 #25517: fix regex in the regex howto. Patch by Elena Oat. 2016-01-12 00:09:13 +02:00
Ezio Melotti d4d4f20284 #25991: merge with 3.5. 2016-01-11 23:31:38 +02:00
Ezio Melotti 7c018aa377 #25991: fix readline example to limit history size. Patch by Daniel Dye. 2016-01-11 23:30:56 +02:00
Yury Selivanov 37dc2b2883 Issue #25486: Resurrect inspect.getargspec in 3.6. Backout a565aad5d6e1.
The decision is that we shouldn't remove popular APIs (however long they
are depreacted) from Python 3, while 2.7 is still around and supported.
2016-01-11 15:15:01 -05:00
Andrew Svetlov f7272a667e merge 3.5 2016-01-11 15:42:05 +02:00
Andrew Svetlov ea471348f4 Fix versionadded to use 3.5.1 only for 3.5 branch 2016-01-11 15:41:43 +02:00
Andrew Svetlov 38bb42c132 merge 3.5 2016-01-11 14:45:49 +02:00
Andrew Svetlov 3af81f2505 merge 3.4 2016-01-11 14:45:25 +02:00
Andrew Svetlov f1240169b3 Document asyncio.timeout() 2016-01-11 14:40:35 +02:00
Benjamin Peterson 7e23fe1ce1 merge 3.5 (#26066) 2016-01-09 23:56:40 -08:00
Benjamin Peterson 4d927420b8 merge 3.4 (#26066) 2016-01-09 23:56:31 -08:00
Benjamin Peterson 6829dbbf3f delete old crypto prose (closes #26066) 2016-01-09 23:55:47 -08:00
Senthil Kumaran 656a8415aa merge from 3.5
Issue23675 - A tiny clarification in the MRO glossary term.
2016-01-09 22:34:40 -08:00
Senthil Kumaran 3858a1c18c Issue23675 - A tiny clarification in the MRO glossary term. 2016-01-09 22:33:54 -08:00
Terry Jan Reedy c0a732e901 Merge with 3.5 2016-01-09 12:22:13 -05:00
Terry Jan Reedy 6401e79520 Issue #26029: Finish correction. 2016-01-09 12:22:00 -05:00
Terry Jan Reedy 3acf170869 Merge with 3.5 2016-01-09 03:28:01 -05:00
Terry Jan Reedy 2a97f8a6d1 Issue #26029: Remove extraneous word. Patch by Upendra Kumar. 2016-01-09 03:27:37 -05:00
Brett Cannon a85e927e39 Issue #25802: Add an examples section to importlib.
Thanks to Berker Peksag for the patch review.
2016-01-08 14:33:09 -08:00
Senthil Kumaran fd65958f4f merge from 3.5
Issue20969 - Set the Epub Author and Epub Publisher in Python docs.
2016-01-08 01:03:03 -08:00
Senthil Kumaran cbe6356c42 Issue20969 - Set the Epub Author and Epub Publisher in Python docs. 2016-01-08 01:01:56 -08:00
Benjamin Peterson 3407473f91 merge 3.5 (#26046) 2016-01-07 22:02:13 -08:00
Benjamin Peterson e95fd0b411 merge 3.4 (#26046) 2016-01-07 22:02:01 -08:00
Benjamin Peterson 8a6ddb98e6 fix typo in unittest docs (closes #26046)
Patch from Upendra Kumar.
2016-01-07 22:01:26 -08:00
Berker Peksag d56e67e116 Issue #5501: Clarify that invoking freeze_support() on non-Windows platforms has no effect
Patch by Davin Potts and Camilla Montonen.
2016-01-07 18:45:47 +02:00
Berker Peksag 94541f464c Issue #5501: Clarify that invoking freeze_support() on non-Windows platforms has no effect
Patch by Davin Potts and Camilla Montonen.
2016-01-07 18:45:22 +02:00
Senthil Kumaran d68cc8416d merge from 3.5
Issue16544 - Add a link to an external documentation resource in ast module docs.
2016-01-06 21:31:09 -08:00
Senthil Kumaran 0deaf9ac30 merge from 3.4
Issue16544 - Add a link to an external documentation resource in ast module docs.
2016-01-06 21:30:30 -08:00
Senthil Kumaran f3695bfacf Issue16544 - Add a link to an external documentation resource in ast module docs. 2016-01-06 21:26:53 -08:00
Guido van Rossum f08a308ebb Docs for issue #22570. (Merge 3.5->3.6) 2016-01-06 11:37:52 -08:00
Guido van Rossum 1469d744bc Cross-reference os.DirEntry and pathlib.Path for issue #22570. 2016-01-06 11:36:03 -08:00
Guido van Rossum 05075203c5 Add versionadded (3.4.5) to docs for issue #22570. (Merge 3.4->3.5) 2016-01-06 11:26:36 -08:00
Guido van Rossum b1360543e5 Add versionadded (3.4.5) to docs for issue #22570. 2016-01-06 11:23:31 -08:00
Guido van Rossum 406005144b Docs for issue #22570. (Merge 3.4->3.5) 2016-01-06 11:16:28 -08:00
Guido van Rossum df85946e8a Docs for issue #22570. 2016-01-06 11:15:52 -08:00
Senthil Kumaran dcf76c9d0a merge from 3.5
Issue24898 - Improve str.find documentation.

Simplify str.find explaination as per Georg Brandl's suggestion.
2016-01-03 18:00:31 -08:00
Senthil Kumaran f34c3fe20c merge from 3.4
Issue24898 - Improve str.find documentation.

Simplify str.find explaination as per Georg Brandl's suggestion.
2016-01-03 17:58:24 -08:00
Senthil Kumaran 114a1d638e Issue24898 - Improve str.find documentation.
Simplify str.find explaination as per Georg Brandl's suggestion.
2016-01-03 17:57:10 -08:00
Senthil Kumaran 15777231e9 merge from 3.5
Issue21221 - Explain the usage of tm_isdst attribute of mktime, with valid
values and meaning.

Patch contributed by Andrew Scheller.
2016-01-03 00:45:05 -08:00
Senthil Kumaran 6ffbcdf13f merge from 3.4
Issue21221 - Explain the usage of tm_isdst attribute of mktime, with valid
values and meaning.

Patch contributed by Andrew Scheller.
2016-01-03 00:43:23 -08:00
Senthil Kumaran a880800363 Issue21221 - Explain the usage of tm_isdst attribute of mktime, with valid
values and meaning.

Patch contributed by Andrew Scheller.
2016-01-03 00:40:03 -08:00
R David Murray 75f104a745 #21815: Make the doc change match what I actually did. 2016-01-02 17:25:59 -05:00
R David Murray 317f64f048 #21815: violate IMAP RFC to be compatible with, e.g., gmail
and others, including imaplib's own behavior.  I'm applying this only to 3.6
because there's a potential backward compatibility concern: if there are
servers that include ] characters in the 'text' portion of their imap
responses, this code change could introduce a new bug.

Patch by Lita Cho, reviewed by Jessica McKellar, Berker Peksag, Maciej Szulik,
silentghost, and me (I fleshed out the comments with the additional
info/concerns.)
2016-01-02 17:18:34 -05:00
Senthil Kumaran 5b3455c793 merge from 3.5
Issue25917 : Fix howto links in docs. Point the reference documentation instead of wiki.
2016-01-01 23:27:38 -08:00
Senthil Kumaran fcb6db50d3 merge from 3.4
Issue25917 : Fix howto links in docs. Point the reference documentation instead of wiki.
2016-01-01 23:26:53 -08:00
Senthil Kumaran d03d1d45f5 Issue25917 : Fix howto links in docs. Point the reference documentation instead of wiki. 2016-01-01 23:25:58 -08:00
Zachary Ware bdce29b9a4 Merge with 3.5 2016-01-01 12:24:12 -06:00
Zachary Ware 46a78bc92c Fix grammar.
Reported by Anatoly Techtonik on docs@
2016-01-01 12:22:16 -06:00
Benjamin Peterson 3e47a1337c merge 3.5 2016-01-01 11:56:35 -06:00
Benjamin Peterson 4e3dd51396 merge 3.4 2016-01-01 11:56:16 -06:00
Benjamin Peterson 630329e4ea merge 3.3 2016-01-01 11:55:47 -06:00
Benjamin Peterson 0e617e22f0 remove some copyright notices supserseded by the toplevel ones 2016-01-01 11:53:47 -06:00
Benjamin Peterson 71db903563 merge 3.5 2016-01-01 10:25:22 -06:00
Benjamin Peterson 4c70293755 merge 3.4 2016-01-01 10:25:12 -06:00
Benjamin Peterson e8c2a957c8 merge 3.3 2016-01-01 10:24:21 -06:00
Benjamin Peterson 75e3630c60 2016 will be another year of writing copyrighted code 2016-01-01 10:23:45 -06:00
Brett Cannon eae3079041 Issue #25802: Deprecate load_module() on importlib.machinery.SourceFileLoader and SourcelessFileLoader.
They were the only remaining implementations of load_module() not
documented as deprecated.
2015-12-28 17:55:27 -08:00
Brett Cannon 01f7ac3bb0 Backport of fix for issue #25930 2015-12-28 17:30:32 -08:00
Brett Cannon 050391774a Issue #25930: Document that os.unlink and os.remove are *semantically* identical.
Saying that the functions were identical confused some users who were
upset when the functions were no longer simply the same function under
different names.

Thanks to Anthony Sottile for the bug report and Swati Jaiswal for the
initial patch.
2015-12-28 17:28:19 -08:00
Stefan Krah 53f2e0ad45 Issue #25928: Add Decimal.as_integer_ratio(). Python parts and docs by
Mark Dickinson.
2015-12-28 23:02:02 +01:00
Brett Cannon 1e3c3e906c Issue #25768: Make compileall functions return booleans and document
the return values as well as test them.

Thanks to Nicholas Chammas for the bug report and initial patch.
2015-12-27 13:17:04 -08:00
Brett Cannon 4a4ca7c13f Merge for issue #12484 2015-12-27 12:24:36 -08:00
Brett Cannon 762d5ea875 Issue #12484: Remove a mention of Py_InitModule() and _PyImport_FixupExtension().
Thanks to Alejandro Santos for the bug report and Anish Shah for the
patch.
2015-12-27 12:24:06 -08:00
Brett Cannon 0792451ea4 Merge for issue #25874 2015-12-27 12:09:10 -08:00
Brett Cannon 85622e4bc9 Issue #25874: Clarify platform support in the "Using Python on Windows" doc.
Thanks to Chris Wilcox for the initial patch.
2015-12-27 12:08:37 -08:00
R David Murray 2bd58e3991 Merge: #1753718: clarify RFC compliance and bytes/string argument types. 2015-12-23 21:19:53 -05:00
R David Murray a198645fa0 #1753718: clarify RFC compliance and bytes/string argument types.
Patch includes contributions by Isobel Hooper, incorporating suggestions from
Paul Winkler.  Reviewed by Martin Panter.

In addition to accepting the corrections for the RFC compliance wording, I
went through and corrected all the argument and return types, and made the
pattern of how the arguments and return types are documented consistent.
So, this patch also addresses #20782, though I had forgotten about that issue
and its patch.
2015-12-23 21:17:17 -05:00
Yury Selivanov 7f955ab16a Merge 3.5 2015-12-17 18:26:53 -05:00
Yury Selivanov 3dc74bf703 docs: Document ASYNC/AWAIT tokens (issue #25580)
Initial patch by SilentGhost
2015-12-17 18:26:41 -05:00
Yury Selivanov 90791ce220 Merge 3.5 2015-12-16 21:31:15 -05:00
Yury Selivanov 9920e293c3 Merge 3.4 2015-12-16 21:31:04 -05:00
Yury Selivanov cba0053bef docs/asyncio: Twek sections names per Nick Coghlan suggestion 2015-12-16 21:30:52 -05:00
Yury Selivanov f4f67e52b4 Merge 3.5 2015-12-15 00:45:39 -05:00
Yury Selivanov e319ab01ce docs/asyncio: Update ensure_future & run_coroutine_threadsafe docs 2015-12-15 00:45:24 -05:00
Yury Selivanov 2c008d83dc Merge 3.5 2015-12-15 00:38:38 -05:00
Yury Selivanov 4a18b35dbd docs/whatsnew/3.5: Fix ref link 2015-12-15 00:38:28 -05:00
Yury Selivanov e93f407a0f Merge 3.5 2015-12-15 00:30:32 -05:00
Yury Selivanov bf077ee043 whatsnew/3.5: Mention new asyncio APIs in 3.5.1 2015-12-15 00:30:18 -05:00
Gregory P. Smith 60889d1238 Issue #11072: change the incorrect "deprecation" of ftplib dir() and nlst()
APIs into a note that mlsd() is a nicer API if the server supports
it.  They aren't deprecated, they are all different server commands.
Not all servers support all commands.
2015-12-13 22:10:58 -08:00
Gregory P. Smith f1b3134d28 Issue #11072: change the incorrect "deprecation" of ftplib dir() and nlst()
APIs into a note that mlsd() is a nicer API if the server supports
it.  They aren't deprecated, they are all different server commands.
Not all servers support all commands.
2015-12-13 22:10:28 -08:00
R David Murray d991963a9d Merge: #25495: Clarify b2a_base64 documentation vis 57 bytes.
In 3.6 the parameter to control the appending of the newline was finally
added, so I dropped the historical note about why a new line was always
appended.
2015-12-13 18:11:07 -05:00
R David Murray 51a4b22f99 Merge: #25495: Clarify b2a_base64 documentation vis 57 bytes. 2015-12-13 18:04:56 -05:00
R David Murray 2b4f47ee35 #25495: Clarify b2a_base64 documentation vis 57 bytes. 2015-12-13 18:04:27 -05:00
Martin Panter 70fe09bc67 Issue #22341: Merge CRC doc from 3.5 2015-12-11 05:41:48 +00:00
Martin Panter b82032f935 Issue #22341: Drop Python 2 workaround and document CRC initial value
Also align the parameter naming in binascii to be consistent with zlib.
2015-12-11 05:19:29 +00:00
Martin Panter 8c0b5b998a Issue #14285: Merge runpy fix from 3.5 2015-12-11 03:35:31 +00:00
Martin Panter 7dda421bff Issue #14285: Do not catch exceptions initializing any ancestor package
The previous fix only handled the case of the parent package of __main__
failing to initialize.

Also make the "Error while finding spec" formatting slightly more appealing,
and document and test that the module name must be absolute.
2015-12-10 06:47:06 +00:00
Zachary Ware e0ffe17e72 Merge with 3.5 2015-12-09 02:03:18 -06:00
Zachary Ware 3181feb601 Clarify that only *documentation* bugs should go to docs@python.org 2015-12-09 01:53:44 -06:00
Berker Peksag 2e7fca8e48 Issue #21240: Add an abstractmethod directive to mark abstract methods in the docs more explicitly 2015-12-08 12:15:19 +02:00
Berker Peksag 6e9d2e687b Issue #21240: Add an abstractmethod directive to mark abstract methods in the docs more explicitly 2015-12-08 12:14:50 +02:00
Martin Panter e7ceef66dd Issue #25701: Merge set and delete documentation from 3.5 2015-12-08 00:05:06 +00:00
Martin Panter 45be8d67be Issue #25701: Document C API functions that both set and delete objects
Also document that the separate functions that delete objects are preferred;
using PyObject_SetAttr(), _SetAttrString(), and PySequence_SetItem() to
delete is deprecated.
2015-12-08 00:03:20 +00:00
Brett Cannon aa3e69e57f Merge for issue #23936 2015-12-04 15:46:43 -08:00
Brett Cannon ccddbb186b Issue #23936: Clarify what finders are.
Thanks to Raúl Cumplido for the bug report and Thomas Kluyver for the
patch.
2015-12-04 15:46:21 -08:00
Brett Cannon 3ad18dc7a7 Merge for issue #25500 2015-12-04 14:52:07 -08:00
Brett Cannon f4f25fe576 Issue #25500: Fix the language reference to not claim that import
statements search for __import__ in the global scope.

Thanks to Sergei Lebedev for finding the documentation bug.
2015-12-04 14:51:26 -08:00
Zachary Ware df144092a3 Closes #25767: Merge with 3.5 2015-11-30 22:57:22 -06:00
Zachary Ware ee1a0e4b8c Issue #25767: Merge with 3.4 2015-11-30 22:57:01 -06:00
Zachary Ware 992bfe093e Issue #25767: Link to English Wikipedia instead of French. 2015-11-30 22:56:17 -06:00
Martin Panter b4ce1fc31b Issue #5319: New Py_FinalizeEx() API to exit with status 120 on failure 2015-11-30 03:18:29 +00:00
R David Murray 4f09806e66 #25485: Add context manager support to Telnet class.
Patch by Stéphane Wirtel.
2015-11-28 12:24:52 -05:00
Martin Panter 2ed41f305e Issue #22989, #21228: Merge urlopen() doc from 3.5 2015-11-26 11:04:06 +00:00
Martin Panter 9e87f3d79f Issue #22989, #21228: Merge urlopen() doc from 3.4 into 3.5 2015-11-26 11:03:50 +00:00
Martin Panter 747d48cf27 Issues #22989, #21228: Document HTTP response object for urlopen()
Previous documentation was not clear if the geturl(), info() and getcode()
were valid for HTTP responses. The “msg” attribute is different to the usual
HTTPResponse.msg attribute. Based on patch by Evens Fortuné.
2015-11-26 11:01:58 +00:00
Vinay Sajip e5beb3da00 Closes #25508: Merged documentation fix from 3.5. 2015-11-24 23:24:17 +00:00
Vinay Sajip 46cc4a8f32 Issue #25508: Merged documentation fix from 3.4. 2015-11-24 23:22:48 +00:00
Vinay Sajip 4f44d53770 Issue #25508: Clarify documentation on LogRecord args attribute. 2015-11-24 23:21:15 +00:00
Martin Panter a561c038ab Issue #25576: Merge www-form-urlencoded doc from 3.5 2015-11-24 22:59:28 +00:00
Martin Panter f7e8d07538 Issue #25576: Merge www-form-urlencoded doc from 3.4 into 3.5 2015-11-24 22:57:46 +00:00
Martin Panter cda85a0d1c Issue #25576: Remove application/x-www-form-urlencoded charset advice
No charset parameter is standardized for this Content-Type value. Also
clarify that urlencode() outputs ASCII.
2015-11-24 22:33:18 +00:00
Raymond Hettinger c880ef8d30 merge 2015-11-23 22:19:12 -08:00
Raymond Hettinger 6e701310d1 Issue #25700: Clarify that namedtuple property docstrings became writeable in 3.5 2015-11-23 22:18:55 -08:00
Serhiy Storchaka f50fe724de Issue #25706: Fixed markup in the documentation. 2015-11-23 16:44:30 +02:00
Serhiy Storchaka 1f847659f3 Issue #25706: Fixed markup in the documentation. 2015-11-23 16:43:54 +02:00
Serhiy Storchaka bf7b9ede1a Issue #25706: Fixed markup in the documentation. 2015-11-23 16:43:05 +02:00
Martin Panter d6a59bacd8 Issue #25689: Merge ftplib and nntplib docs from 3.5 2015-11-21 22:49:06 +00:00
Martin Panter 23244e5787 Issue #25689: Merge ftplib and nntplib docs from 3.4 into 3.5 2015-11-21 22:48:54 +00:00
Martin Panter 828123ce4e Issue #25689: Fix language in ftplib and nntplib docs
Original patch by Silent Ghost.
2015-11-21 22:03:08 +00:00
Martin Panter 36befa5b4c Issue #25626: Merge zlib fix from 3.5 2015-11-21 10:57:15 +00:00
Ethan Furman 748dad5b6a Close 25594: advise against accessing Enum members from other members 2015-11-20 13:12:26 -08:00
R David Murray 3129571fb1 Merge: #25679: spelling fix 2015-11-20 09:59:19 -05:00
R David Murray 0aaeacb3f1 Merge: #25679: spelling fix 2015-11-20 09:58:51 -05:00
R David Murray 51d3f8b0ba #25679: spelling fix 2015-11-20 09:57:20 -05:00
Martin Panter e99e97762c Issue #25626: Change zlib to accept Py_ssize_t and cap to UINT_MAX
The underlying zlib library stores sizes in “unsigned int”. The corresponding
Python parameters are all sizes of buffers filled in by zlib, so it is okay
to reduce higher values to the UINT_MAX internal cap. OverflowError is still
raised for sizes that do not fit in Py_ssize_t.

Sizes are now limited to Py_ssize_t rather than unsigned long, because Python
byte strings cannot be larger than Py_ssize_t. Previously this could result
in a SystemError on 32-bit platforms.

This resolves a regression in the gzip module when reading more than UINT_MAX
or LONG_MAX bytes in one call, introduced by revision 62723172412c.
2015-11-20 08:13:35 +00:00
Ethan Furman 92e5d2f0eb Close issue25594: advise against accessing Enum members from other members 2015-11-20 13:17:27 -08:00
Guido van Rossum 13d9b86d46 Issue #25593: Change semantics of EventLoop.stop(). (Merge 3.5->3.6) 2015-11-19 13:34:24 -08:00
Guido van Rossum 82f9feaf10 Issue #25593: Change semantics of EventLoop.stop(). (Merge 3.4->3.5) 2015-11-19 13:33:34 -08:00
Guido van Rossum 41f69f4cc7 Issue #25593: Change semantics of EventLoop.stop(). 2015-11-19 13:28:47 -08:00
Yury Selivanov 255230595f Merge 3.5 2015-11-18 12:44:59 -05:00
Yury Selivanov 6efc7e726f Merge 3.4 2015-11-18 12:44:49 -05:00
Yury Selivanov 01a65af4a1 asyncio.docs: Fix versionadded 2015-11-18 12:44:31 -05:00
Martin Panter b62226ccc4 Issue #23200: Merge zlib doc from 3.5 2015-11-18 02:46:16 +00:00
Martin Panter 1535311edc Issue #23200: Merge zlib doc from 3.4 into 3.5 2015-11-18 02:45:51 +00:00
Martin Panter 38fe4dc400 Issue #23200: Document that max_length=0 is not supported 2015-11-18 00:59:17 +00:00
Martin Panter acec450bfd Issue #20468: Merge getpagesize doc from 3.5 2015-11-17 22:26:23 +00:00
Martin Panter ce19839961 Issue #20468: Merge getpagesize doc from 3.4 into 3.5 2015-11-17 22:23:21 +00:00
Martin Panter f8f66eb985 Issue #20468: Remove incorrect information about maxrss and page size
Extract of patch by Ronald Oussoren.
2015-11-17 22:13:47 +00:00
Martin Panter 27b735ab0f Issue #25615: Merge glob doc from 3.5 2015-11-17 00:19:27 +00:00
Martin Panter 4eccf4b1ac Issue #25615: Merge glob doc from 3.4 into 3.5 2015-11-17 00:19:10 +00:00
Martin Panter 9f3c094e68 Issue #25615: Document unsorted behaviour of glob; patch by Dave Jones 2015-11-16 23:46:22 +00:00
Yury Selivanov caf6452af2 Merge 3.5 2015-11-16 12:47:25 -05:00
Yury Selivanov 344904cf1f asyncio.docs: Document Transport.is_closing (merge 3.4) 2015-11-16 12:47:15 -05:00
Yury Selivanov 1744d53930 asyncio.docs: Document Transport.is_closing 2015-11-16 12:46:41 -05:00
Martin Panter 28a465c9e0 Issue #23883: Add news listing modules with new exported APIs 2015-11-14 12:52:08 +00:00
Martin Panter d226d308a3 Issue #23883: Add test.support.check__all__() and test gettext.__all__
Patches by Jacek Kołodziej.
2015-11-14 11:47:00 +00:00
Martin Panter fad4b60074 Adjust grammar and punctuation in whatsnew/3.6.rst 2015-11-14 01:29:17 +00:00