Commit Graph

16682 Commits

Author SHA1 Message Date
Benjamin Peterson f9ea5f39d8 format reST directive in the usual way 2014-05-26 15:45:14 -07:00
Benjamin Peterson 0d81d80f6e link to wikipedia description of cryptographic salt 2014-05-26 15:42:29 -07:00
Benjamin Peterson 0ccff4d3e1 oxford comma 2014-05-26 15:41:26 -07:00
Benjamin Peterson 419f1fa9bc fix typo in variable name (closes #21586) 2014-05-26 15:10:42 -07:00
Raymond Hettinger e8e2df3daa Issue 21558: Fix a typo in the contextlib docs 2014-05-25 18:06:04 -07:00
Nick Coghlan e1d54e5f8e Mention setuptools & wheel as key terms for distribution 2014-05-26 00:50:11 +10:00
Terry Jan Reedy e17de09101 Issue #21545: Add .pop example and tweak comment about pure mutation methods.
Patch prepared by David Harrigan.
2014-05-23 00:34:12 -04:00
Raymond Hettinger 7096e26983 Issue 21479: Fix markup for the TarFile.open() classmethod. 2014-05-23 03:46:52 +01:00
Raymond Hettinger f7f64f94b1 Issue 21198: Minor tarfile documentation bug. 2014-05-23 00:03:45 +01:00
Raymond Hettinger bd46e48381 Issue 21554: Repair an out-of-date tutorial example to reflect changes in shutil. 2014-05-22 23:37:09 +01:00
Raymond Hettinger ae4bab71e3 Don't grow strings by concatenation. Use ''.join() instead. 2014-05-18 21:02:25 +01:00
Antoine Pitrou 75e03388d8 Issue #21430: additions to the description of non-blocking SSL sockets 2014-05-18 00:55:13 +02:00
Antoine Pitrou 2d1ec06484 Issue #21364: remove recommendation of broken pattern. 2014-05-15 22:38:56 +02:00
Victor Stinner ef5b4e3dc3 Issue #21488: Fix doc of codecs.decode() and codecs.encode(), no keyword support.
Patch written by Brad Aylsworth.
2014-05-14 17:08:45 +02:00
R David Murray ae9d193dc4 #21347: use string not list in shell=True example.
Patch by Akira.
2014-05-14 10:09:52 -04:00
Jason R. Coombs 73308d6869 Merge doc change from 3.3 2014-05-12 22:41:15 -04:00
Jason R. Coombs 13266fb5c8 Update docs to reflect resurrection of Setuptools over Distribute 2014-05-12 22:40:49 -04:00
Eric Snow 08197a4616 Issue #21226: Set all attrs in PyImport_ExecCodeModuleObject. 2014-05-12 17:54:55 -06:00
Victor Stinner b0539b27d9 Issue #21485: remove unnecesary .flush() calls in the asyncio subprocess code
example
2014-05-12 23:25:09 +02:00
Gregory P. Smith 8e0aa051e6 Change all references to Unix to POSIX in the subprocess docs. It's
more accurate and sounds less like a strange tale of yore.
2014-05-11 13:28:35 -07:00
Gregory P. Smith 6436cba9db Remove the warning-soup from the subprocess documentation by adding
a Security Considerations section as preferred by both the devguide
and documentation users who do not wish to go insane.
2014-05-11 13:26:21 -07:00
Benjamin Peterson 5c8ce188ee remove confusing delete indexing (closes #21466) 2014-05-11 11:18:51 -07:00
Brett Cannon 062fcac9a4 Issue #21438: Document what loaders don't require a module name for
load_module().
2014-05-09 11:55:49 -04:00
Brett Cannon f26702b86e Issue #21157: Touch up imp docs to be more explicit about importlib
alternatives.
2014-05-09 10:37:31 -04:00
R David Murray a83ade1d60 #21300: fix typo 2014-05-08 10:05:47 -04:00
R David Murray e25244657c #21300: Clean up the docs for the email "policy" arguments. 2014-05-06 21:33:18 -04:00
Zachary Ware 9fafc9f79a Add prompts to interactive example.
This makes it match the new example below, and allows Sphinx's
"hide the prompts and output" feature to work.
2014-05-06 09:18:17 -05:00
Zachary Ware 8edd532026 Issue #21366: Document the fact that ``return`` in a ``finally`` clause
overrides a ``return`` in the ``try`` suite.
2014-05-06 09:07:13 -05:00
Guido van Rossum 5280d2e399 asyncio docs: ProactorEventLoop does not support SSL. 2014-05-05 07:34:56 -07:00
Gregory P. Smith d8ea56d26d Document the subprocess Popen.args attribute (issue21353) 2014-04-29 11:33:56 -07:00
Gregory P. Smith 024c5eecbc Document the subprocess Popen.args attribute (issue21353) 2014-04-29 11:33:23 -07:00
Zachary Ware a67b97f438 Issue #17386: Expand Doc/make.bat to be much more similar to Doc/Makefile 2014-04-29 09:45:33 -05:00
Zachary Ware 1de519c60d Issue #17386: Update Doc/README.txt to list all targets
supported by Doc/Makefile, as well as a bit of modernization,
cleanup, and notes about the difference between Unix and Windows.
2014-04-29 09:26:56 -05:00
Zachary Ware 9393fffa5f Issue #17386: List the 'htmlview' target in the Doc/Makefile help output. 2014-04-29 09:24:40 -05:00
Terry Jan Reedy 9cc9026294 Issue #21055: Index (augmented) assignment symbols. 2014-04-29 01:19:17 -04:00
Terry Jan Reedy 7c895edabc Closes 21048: Index 'as' in import and with statements. 2014-04-29 00:58:56 -04:00
Terry Jan Reedy 43e7cd38e5 Issue #21026: Augment site doc based on experiments. Patch by Carol Willing. 2014-04-29 00:31:53 -04:00
Antoine Pitrou f9f54a2f5f Issue #9307: document the various Py_TPFLAGS_*_SUBCLASS flags. Patch by Yury V. Zaytsev. 2014-04-29 01:39:03 +02:00
R David Murray ae25f46706 #18243: Remove obsolete cautionary note from email mktime_tz docs. 2014-04-26 19:01:18 -04:00
Benjamin Peterson 9e599673b4 fix off-by-one error (closes #21330) 2014-04-22 21:54:10 -04:00
Terry Jan Reedy bddecc3861 Issue #21232: Replace .splitlines arg '1' with 'keepends=True'. 2014-04-18 17:00:19 -04:00
Zachary Ware a37ff0fb80 Issue #21289: Fix documentation building on Windows using Doc/make.bat.
Also fixes a long-standing typo in Doc/README.txt.

Initial patch by Dave Sawyer.
2014-04-18 15:10:40 -05:00
Benjamin Peterson d065c48991 fix ref count annotations on sphinx >= 1.2.1 (closes #21286) 2014-04-17 18:29:01 -04:00
Senthil Kumaran aad7cc9dba Clarify BROWSER envar behavior in webbrowser.py. Noted by David Turner. Closes #21248 2014-04-16 23:43:34 -04:00
Senthil Kumaran 8b4a272c98 Correct the URL in the http.client example. Noted by Evens Fortuné. Closes #21229 2014-04-16 23:33:02 -04:00
R David Murray f7f981829b #18628: clarify index entry for source file encoding declaration.
Patch by Sam Lucidi.
2014-04-16 21:48:04 -04:00
Senthil Kumaran cad2bf20c3 Address issue 18229 - Explain http.server.BaseHTTPRequestHandler's .headers attribute further.
Initial patch by Caelyn McAulay.
2014-04-16 13:56:19 -04:00
Terry Jan Reedy 7f84d1eb63 #18566: Whitespace 2014-04-15 23:44:14 -04:00
Terry Jan Reedy 6ac4240b6c Issue #18566: Clarify unittest setUp, tearDown doc. Patch by Nitika Agarwal. 2014-04-15 23:38:18 -04:00
R David Murray fc1020d396 #20874: reflow paragraph. 2014-04-15 20:26:54 -04:00
R David Murray 0e0e391fa3 #20874: update tutorial wording: sophisticated line editing is now standard.
Patch by Rafael Mejia.
2014-04-15 20:25:18 -04:00
Vinay Sajip 65425b4bc6 Issue #21245: updated documentation on exception() method and function. 2014-04-15 23:13:12 +01:00
R David Murray fe0e1082aa #15104: add backtick code markup. 2014-04-14 18:53:51 -04:00
R David Murray 061cb3b04d #15104: improve the discussion of __main__.
Patch by Sam Lucidi.
2014-04-14 15:04:47 -04:00
Andrew Kuchling 44da19a63d #18518: mention that including a return statement changes/breaks the behaviour 2014-04-14 13:39:43 -04:00
Mark Dickinson abf079de25 Issue #20624: Exception docs wording tweak - clarify that it's okay to inherit from a subclass of Exception. 2014-04-14 11:20:12 -04:00
R David Murray 604453c9ce #21169: add comment and doc update for getpass change. 2014-04-14 10:28:58 -04:00
Eric V. Smith 04d8a245f1 Fix faq example with division. 2014-04-14 07:52:53 -04:00
Eric V. Smith fc9a4d828e Fix text about int() with octal numbers. Closes #21212. 2014-04-14 07:41:52 -04:00
Ned Deily ecd9e8ac67 Remove references to the obsolete Mac Carbon modules in the GUI
section of the FAQ.
2014-04-12 09:32:04 -07:00
Terry Jan Reedy f98021cff2 Issue #21170: Removed invalid parameter names from unittest doc.
Patch by Kushal Das.
2014-04-11 14:11:11 -04:00
Senthil Kumaran f3ddcc9ba7 issue #21190: Fix the broken docs download link 2014-04-09 11:44:34 -04:00
Yury Selivanov af8a4dfb04 docs: Better wording for __objclass__ docs. Issue #19281 2014-04-08 14:00:35 -04:00
Yury Selivanov d3f918ca44 docs: Document __objclass__. Closes #19281.
Initial patch by Nick Coghlan
2014-04-08 12:03:07 -04:00
Benjamin Peterson ce0700ae7a PySequence_Fast generally returns a list not a tuple (closes #16395) 2014-04-08 10:48:36 -04:00
Benjamin Peterson f0f7844f38 the name of the slot of nb_multiply not nb_mul 2014-04-08 10:44:30 -04:00
Benjamin Peterson 222ef82827 fix verb (closes #21174) 2014-04-07 19:34:33 -04:00
Senthil Kumaran 6d6ec25e04 merge from 3.3 2014-04-06 11:00:15 -07:00
Senthil Kumaran f5c34054f9 minor docfix (reported at docs@python.org) trace.py argument is --count not --counts 2014-04-06 10:59:47 -07:00
Brett Cannon 18fc4e70f3 Issue #20942: PyImport_ImportFrozenModuleObject() no longer sets
__file__.

This causes _frozen_importlib to no longer have __file__ set as well
as any frozen module imported using imp.init_frozen() (which is
deprecated).
2014-04-04 10:01:46 -04:00
Raymond Hettinger b30b34c1aa Issue 21143: Fix typo in docs for max(). 2014-04-03 08:01:22 -07:00
Eli Bendersky 0bd22d4277 Issue #20375: Clarify ET's parsing of comments and processing instructions.
Based on patch by Nikolaus Rath.
2014-04-03 06:14:38 -07:00
Raymond Hettinger 31b26f637a Issue #18652: Add an itertools recipe for first_true() 2014-04-02 03:16:42 -07:00
Raymond Hettinger f4284e45d0 Documentation nit. List the traditional keyword-only argument first and the default last. 2014-04-02 00:58:47 -07:00
Raymond Hettinger da4bf8f16a Issue 21125: minor documentation tweak. 2014-04-01 22:17:33 -07:00
Benjamin Peterson 1acc69c650 update version changed 2014-04-01 19:22:06 -04:00
Benjamin Peterson 9dc203fff9 merge 3.3 (#21082) 2014-04-01 19:18:48 -04:00
Benjamin Peterson 4717e2112b merge 3.2 (#21082) 2014-04-01 19:17:57 -04:00
Benjamin Peterson ee5f1c13d1 remove directory mode check from makedirs (closes #21082) 2014-04-01 19:13:18 -04:00
Zachary Ware 9d08562ed4 Issue #15067: Port 2.7 sqlite3 docs to 3.4 2014-04-01 12:21:56 -05:00
Andrew Svetlov c3bf6922b5 #16716: remove deprecation warning 2014-04-01 02:08:25 +03:00
Andrew Svetlov 08af00047b Get rid of deprecated IOError in the doc 2014-04-01 01:13:30 +03:00
Andrew Svetlov 5898d4f4d9 IOError -> OSError 2014-04-01 00:44:13 +03:00
Andrew Svetlov 050f9ea4d7 Fix the doc: add deprecation warning in select module. 2014-04-01 00:23:23 +03:00
Benjamin Peterson 3a4340325b make partialmethod example work (closes #21105) 2014-03-30 15:07:09 -04:00
Guido van Rossum 589872cbdf Fix doc typo. 2014-03-29 21:14:04 -07:00
Raymond Hettinger 1e1e601bd1 Minor readability improvement. 2014-03-29 11:50:08 -07:00
Nick Coghlan 9aa00d1cd1 Issue #19697: document more __main__.__spec__ quirks 2014-03-29 15:39:42 +10:00
Eric Snow e50f9aa4bd Issue #19697: Document cases where __main__.__spec__ is None. 2014-03-28 18:10:33 -06:00
Raymond Hettinger 4ab532bbfe Issue 21014: Use booleans instead of 0 and 1 in examples. 2014-03-28 16:39:25 -07:00
Georg Brandl 865bdbf4af Doc: do not compress .epub for dist, it is already zipped. 2014-03-28 19:48:55 +01:00
Ned Deily e7d532fbc9 Issue #6676: Ensure a meaningful exception is raised when attempting
to parse more than one XML document per pyexpat xmlparser instance.
(Original patches by Hirokazu Yamamoto and Amaury Forgeot d'Arc, with
suggested wording by David Gutteridge)
2014-03-27 16:39:58 -07:00
Victor Stinner 215ad66405 Issue #12209: Minor edits to faulthandler doc. Patch written by Éric Araujo. 2014-03-25 12:33:56 +01:00
Vinay Sajip 4908910ab7 Updated external link in documentation. 2014-03-25 11:21:41 +00:00
Georg Brandl 1afe2af690 Closes #21045: make the Qt help build not look completely stupid 2014-03-25 10:12:47 +01:00
Victor Stinner 984600fba7 Issue #21006: asyncio doc: reorganize subprocess doc 2014-03-25 09:40:26 +01:00
Georg Brandl 1c669c1154 Closes #18456: Doc fix: PyDict_Update only works with dict-like objects, not key-value sequences. Patch by priyapappachan. 2014-03-25 09:34:30 +01:00
Donald Stufft 4137465bf5 Issue #21043: Remove the recommendation for specific CA organizations
Closes #21043 by updating the documentation to remove specific CA
organizations and update the text to no longer need to tell you to
download root certificates, but instead use the OS certificates
avaialble through SSLContext.load_default_certs.
2014-03-24 19:26:03 -04:00
Georg Brandl df48b97855 Fix a few scoping issues with versionadded/versionchanged directives. 2014-03-24 09:06:18 +01:00
Zachary Ware 645d3b7655 Remove superfluous open parenthesis. Noticed by cocoatomo on docs@. 2014-03-23 22:21:38 -05:00
Donald Stufft 6a2ba94908 Issue #21013: Enhance ssl.create_default_context() for server side contexts
Closes #21013 by modfying ssl.create_default_context() to:

* Move the restricted ciphers to only apply when using
  ssl.Purpose.CLIENT_AUTH. The major difference between restricted and not
  is the lack of RC4 in the restricted. However there are servers that exist
  that only expose RC4 still.
* Switches the default protocol to ssl.PROTOCOL_SSLv23 so that the context
  will select TLS1.1 or TLS1.2 if it is available.
* Add ssl.OP_NO_SSLv3 by default to continue to block SSL3.0 sockets
* Add ssl.OP_SINGLE_DH_USE and ssl.OP_SINGLE_ECDG_USE to improve the security
  of the perfect forward secrecy
* Add ssl.OP_CIPHER_SERVER_PREFERENCE so that when used for a server side
  socket the context will prioritize our ciphers which have been carefully
  selected to maximize security and performance.
* Documents the failure conditions when a SSL3.0 connection is required so
  that end users can more easily determine if they need to unset
  ssl.OP_NO_SSLv3.
2014-03-23 19:05:28 -04:00
Georg Brandl 553e108fce tutorial: no "linux2" sys.platform on 3.x (thanks Arfrever) 2014-03-23 23:03:59 +01:00
Antoine Pitrou f8cbbbb652 Issue #20913: make it clear that create_default_context() also enables hostname checking 2014-03-23 16:31:08 +01:00
Georg Brandl 75c5ab49ed Closes #20975: make date in the interpreter banner a little more consistent 2014-03-22 20:38:11 +01:00
Antoine Pitrou c5e075ff03 Issue #20913: improve the SSL security considerations to first advocate using create_default_context(). 2014-03-22 18:19:11 +01:00
Donald Stufft 79ccaa2cad Issue #20995: Enhance default ciphers used by the ssl module
Closes #20995 by Enabling better security by prioritizing ciphers
such that:

* Prefer cipher suites that offer perfect forward secrecy (DHE/ECDHE)
* Prefer ECDHE over DHE for better performance
* Prefer any AES-GCM over any AES-CBC for better performance and security
* Then Use HIGH cipher suites as a fallback
* Then Use 3DES as fallback which is secure but slow
* Finally use RC4 as a fallback which is problematic but needed for
  compatibility some times.
* Disable NULL authentication, NULL encryption, and MD5 MACs for security
  reasons
2014-03-21 21:33:34 -04:00
Victor Stinner 51f3129ba2 Close #21010: Fix typo in asyncio doc. Patch written by Claudiu Popa. 2014-03-21 17:17:15 +01:00
Victor Stinner 6bc239619c Issue #21006: Fix subprocess example on Windows in asyncio doc 2014-03-21 11:56:40 +01:00
Victor Stinner 7280486ce3 Close #21005: Fix documentation of asyncio.subprocess.DEVNULL 2014-03-21 11:44:49 +01:00
Benjamin Peterson 409a1be6cf improve start default for relpath 2014-03-20 12:39:53 -05:00
Zachary Ware 2f31b4b577 Fix typos in Doc/faq/extending. Found by cocoatomo on docs@. 2014-03-20 10:16:09 -05:00
Zachary Ware dbd1c43e52 Fix spelling in enum docs.
"equivalant" was caught by Tobias Käs on docs@, "seperated" and "chartruese"
were discovered by a spell-checker.
2014-03-20 10:01:48 -05:00
Zachary Ware 253deed862 Add missing parenthesis. Found by cocoatomo on docs@. 2014-03-20 09:46:09 -05:00
Zachary Ware a22ae21db6 Fix parameter name in docs for os.makedirs and os.removedirs.
Pointed out by Colin Davis on docs@.
2014-03-20 09:42:01 -05:00
Zachary Ware 088639936d Issue #20966: Fix Tkinter Resources link 2014-03-18 09:19:18 -05:00
Georg Brandl f5c801fdca Fix option description that is a warning in new Sphinx versions. 2014-03-18 07:44:07 +01:00
Éric Araujo 0b1be1a3b1 Fix typo in example (#20963) 2014-03-17 16:48:13 -04:00
Jesus Cea 28a965ff71 Typo 2014-03-17 19:22:59 +01:00
Jesus Cea bdb8bb39dd Typo 2014-03-17 19:13:09 +01:00
Jesus Cea cec25b01ec Typo 2014-03-17 19:00:48 +01:00
R David Murray f93d3dfc50 closes #20960 2014-03-17 11:20:29 -04:00
Georg Brandl a7f48019d5 merge with 3.3 2014-03-17 07:36:51 +01:00
Georg Brandl 56d3a03f70 Update doc version switcher for 3.4/3.5. 2014-03-17 07:36:45 +01:00
Larry Hastings 3c5c56f3c0 Merged default into 3.4 branch. 3.4 branch is now effectively 3.4.1rc1. 2014-03-16 22:54:05 -07:00
Benjamin Peterson 2221f666eb merge 3.3 (#11448) 2014-03-16 15:56:24 -05:00
Benjamin Peterson a48d9eaa5c improve set_tunnel docs (closes #11448)
Patch by Ryan Kelly, karl, and Nikolaus Rath.
2014-03-16 15:55:39 -05:00
Victor Stinner 7bdf786e74 Issue #20950: Fix typo asyncio doc, wait() has no self parameter
self parameter is implicit. Mention also that communicate() and wait() are
coroutines.
2014-03-16 21:29:31 +01:00
Larry Hastings 3101b70762 Final documentation fixes for 3.4.0 final. 2014-03-15 22:43:17 -07:00
Larry Hastings cf1a3cd2c7 Release bump for 3.4.0 final. 2014-03-15 22:34:24 -07:00
Larry Hastings 0548f5c514 Regenerate pydoc_topics, fix markup errors, in preparation for 3.4.0 final. 2014-03-15 22:29:19 -07:00
Larry Hastings 3732ed2414 Merge in all documentation changes since branching 3.4.0rc1. 2014-03-15 21:13:56 -07:00
Nick Coghlan ffa1f27950 Bring PEP 453 What's New entry up to date
We changed a few details of the pip integration over the course
of the Python 3.4 beta and release candidate cycle, but I hadn't
updated the What's New entry appropriately.

The Py2/Py3 split on POSIX and the generally challenges of
dealing with parallel installs means we haven't attained
complete consistency across all environments, but hopefully
this updated text is clearer about the end result.

Relevant to issue #20909.
2014-03-16 13:55:19 +10:00
R David Murray 01f2129249 whatsnew: Fix Features section title, use title/sentence case consistently.
closes #20931
2014-03-15 23:27:30 -04:00
Larry Hastings 34784e6bf7 Issue #20931: Fix other confusingly-worded heading. 2014-03-15 20:15:55 -07:00
Antoine Pitrou 8bc7ef63a4 Close #16665: improve documentation for hex(). Patch by Jessica McKellar. 2014-03-16 02:13:07 +01:00
R David Murray d5358b94d1 whatsnew: Clarify heading. 2014-03-15 21:15:18 -04:00
Antoine Pitrou 790bf0db77 Close #16665: improve documentation for hex(). Patch by Jessica McKellar. 2014-03-16 02:12:20 +01:00
Benjamin Peterson bbd392e9e2 merge 3.3 2014-03-15 15:24:10 -05:00
Benjamin Peterson 0392271073 send people to the right editors page (#20938) 2014-03-15 15:23:32 -05:00
R David Murray b69c0c16cd whatsnew: final edit pass. 2014-03-14 18:31:07 -04:00
Brett Cannon f0b2ef1502 Issue #20884: whatsnew: Frozen modules don't set __file__ anymore. 2014-03-14 09:46:28 -04:00
R David Murray a0b9eeb66d whatsnew: link from module_spec section to Deprecation, for replacements. 2014-03-13 22:17:28 -04:00
R David Murray 6dfc632f1f whatsnew: difflib.isbjunk &c were removed, not deprecated.
Also move NEWS item to correct position (it was in 3.3).
2014-03-13 21:34:54 -04:00
R David Murray d664db8a7b whatsnew: difflib.isbjunk &c were removed, not deprecated.
Also move NEWS item to correct position (it was in 3.3).
2014-03-13 21:34:54 -04:00
R David Murray 44b03c5bf0 whatsnew: small tweaks to codecs entry. 2014-03-13 20:56:27 -04:00
R David Murray bcf7012d19 whatsnew: linkify some pip things, and explain why non-inheriting is good. 2014-03-13 19:53:38 -04:00
Éric Araujo f446d7a70b Remove references to make targets deleted in eef7899ea7ab 2014-03-13 19:30:43 -04:00
Éric Araujo 7bf50318bd Clarify distutils’ clean command (ref #6142) 2014-03-13 18:32:18 -04:00
Éric Araujo ef04c59f53 Clarify distutils’ clean command (ref #6142) 2014-03-13 16:17:11 -04:00
Ned Deily a85e100b4d Issue #19407: Fix typos in new distribution & installation guides.
Also applies to cherry pick Issue #20909.
2014-03-13 12:42:36 -07:00
R David Murray 66646e2ea4 whatsnew: remove 'draft' note, tidy up summary, collect SSLContext stuff.
Since Victor linked to it in a block, it seems to make sense to have
all the SSLContext changes next to each other.  I also sorted all the
SSL security enhancements next to each other in the security
enhancements summary.
2014-03-13 14:36:09 -04:00
R David Murray d73721a7e4 whatsnew: collections no longer implicitly imports 'abc' (#20784). 2014-03-13 12:00:17 -04:00
R David Murray b895505625 whatsnew: HTTPError.headers (#15701). 2014-03-13 11:33:29 -04:00
R David Murray 5253034c78 whatsnew: make it clear I'm the editor, not author of all text. 2014-03-13 11:10:01 -04:00
Éric Araujo 45fc8713bd Make distutils error messages more helpful (#11599).
When running external programs such as a C compiler and getting an
error code, distutils only prints the program name.  With this change,
one can get the full command line by setting the DISTUTILS_DEBUG
environment variable.

This should have no compatibility issues, unless there are tools
that depend on the exact format of distutils debug messages.
2014-03-13 04:55:35 -04:00
Benjamin Peterson 21317b654e merge 3.3 (#19060) 2014-03-12 21:42:04 -05:00
Benjamin Peterson 5eea8a7780 remove unnecessary word (closes #19060)
Patch by Anastasia Filatova.
2014-03-12 21:41:35 -05:00
Éric Araujo fa5e6e4773 Fix note markup (#16805).
Patch by Tshepang Lekhonkhobe, reviewed by Georg Brandl.
2014-03-12 19:51:00 -04:00
R David Murray 40e1ffc78e whatsnew: fix unittest subtest example. 2014-03-12 09:31:50 -04:00
Victor Stinner 97c3642532 What's New in Python 3.4: more security changes 2014-03-13 14:54:46 +01:00
Nick Coghlan e300797ca4 Issue #19407: fix link 2014-03-13 22:33:33 +10:00
Nick Coghlan f7614d55a2 Close #19407: New installation & distribution guides
- based on pip and other PyPA tools
- includes references to the new Python Packaging User Guide
  where appropriate (and the relevant section is at least
  partially filled in)
- started new FAQ sections
- both guides aim to introduce users to basic open source
  concepts if they aren't aware of them
- existing guides have been relocated (now linked from the
  distutils docs) rather then removed, since there is
  some needed material that has yet to be relocated to the
  distutils docs as a reference for the legacy formats
2014-03-13 22:13:45 +10:00
Éric Araujo 9e0622713e Merge heads 2014-03-13 06:02:15 -04:00
Éric Araujo f1e8c70cf0 Merge 3.3 (#11599) 2014-03-13 05:59:31 -04:00
Victor Stinner 2fb3b82706 asyncio doc: functions are coroutine, they don't return a coroutine
It's not exact, but easier to understand.
2014-03-13 10:58:03 +01:00
Victor Stinner 39930c9ca0 Close #20889: asyncio doc: Document acquire(), locked() and release() method of
Condition
2014-03-13 10:54:18 +01:00
Victor Stinner d079d3a289 Close #20787: asyncio doc: fix typo. Patch written by akira. 2014-03-13 10:50:01 +01:00
Benjamin Peterson 605765fa32 merge 3.3 (#19060) 2014-03-12 21:42:04 -05:00
Éric Araujo abdc16ee1b Merge 3.3 (#16805) 2014-03-12 19:51:50 -04:00
Éric Araujo a0fe1f74f9 Merge 3.3 (#4931) 2014-03-12 04:10:51 -04:00
Éric Araujo fc773a2d4b Avoid “error: None” messages from distutils (#4931).
Thanks to Amaury Forgeot d’Arc and Philip J. Eby.
2014-03-12 03:34:02 -04:00
R David Murray 03a4da55cb whatsnew: spelling errors.
Corrections from Jim Jewett in #19861.
2014-03-11 21:58:54 -04:00
R David Murray 600e08dc1c Merge #20030: doc that TestLoader.discover returns a TestSuite. 2014-03-11 18:46:37 -04:00
R David Murray ed5d95b76b #20030: doc that TestLoader.discover returns a TestSuite.
Patch by Lita Cho.
2014-03-11 18:46:00 -04:00
Benjamin Peterson 86deec1917 merge 3.3 2014-03-11 14:26:21 -05:00
Benjamin Peterson 8e4b3c7f55 improve algorithms_* documentation 2014-03-11 14:26:12 -05:00
R David Murray f4ce4170ef whatsnew: doctest finds tests in extension modules (#3158)
#19861 msg213159
2014-03-11 15:10:53 -04:00
Benjamin Peterson 162d7ca3cc merge 3.3 (closes #20892) 2014-03-11 13:59:48 -05:00
Benjamin Peterson bfca3ca114 fix typo (closes #20892) 2014-03-11 13:59:37 -05:00
R David Murray 49bef7b3eb whatsnew: mention that upgrading PIP means it doesn't get unistalled.
#19861 msg213156.
2014-03-11 14:57:30 -04:00
R David Murray 6cd3a0d598 whatsnew: summary section tweaks.
Removed an entry made redundant by the new security section,
Moved 'marshal' to the section on features other platforms
will need to support, and mention that 'help' is improved
by the inspect/pydoc changes (#19561 msg213153).
2014-03-11 14:03:24 -04:00
Victor Stinner 11a4270b6a What's New in Python 3.4: Security improvements 2014-03-11 13:17:30 +01:00
Victor Stinner 637d2e9296 Issue #20888: improve "Pretty Top" example of tracemalloc, use linecache 2014-03-11 08:12:48 +01:00
R David Murray 0c18282da6 whatsnew: remove XXXs.
Can't figure out what the other issue was for the importlib
changes.  Did find a small typo in the reload doc, though.
2014-03-10 21:38:37 -04:00
R David Murray 4896ebee1f whatsnew: take credit.
They aren't all my words, but most of them are :).
2014-03-10 18:15:09 -04:00
R David Murray 9ea2a630fe whatsnew: deprecation of ElementTree XMLParser *html* and iterparse *parser*.
#17741
2014-03-10 18:09:54 -04:00
R David Murray 30781e93b0 whatsnew: urllib Request objects are now reusable.
#16464, #17485, #17272.
2014-03-10 17:06:00 -04:00
R David Murray 0c5598beaf whatsnew: shutil copyfile SameFileError (#1492704) 2014-03-10 16:12:10 -04:00
R David Murray 8df4ec70d3 whatsnew: os.open O_PATH and O_TMPFILE. 2014-03-10 15:48:22 -04:00
R David Murray a69bb5cc48 whatsnew: os.open O_TMPFILE (#18673). 2014-03-10 15:41:59 -04:00
R David Murray 60de1a0fd5 whatsnew: json dump-with-indent whitespace change (#16333). 2014-03-10 15:41:28 -04:00
R David Murray e8db162f62 whatsnew: PEP 424 implementation. 2014-03-10 15:00:33 -04:00
R David Murray d840b8d613 whatsnew: multiprocessing start methods and context (#8713 and #18999)
Also tweaked the docs a bit to use our standard style for
versionadded/changed.  (I'm guessing there are other places
in the multiprocessing docs where similar tweaks should be made.)
2014-03-10 14:27:21 -04:00
Georg Brandl 18a364fc3d Closes #20090: update Doc/README and the error message in sphinx-build.py to make
it clear that any Python 3.x is not usable with the checked out Sphinx.
2014-03-10 19:26:57 +01:00
R David Murray f2e677cec9 whatsnew: remove redundant entry. 2014-03-10 13:21:09 -04:00
R David Murray c51ebce03b whatsnew: logging.config.listen *verify* (#15452). 2014-03-10 12:03:01 -04:00
R David Murray 416616fc6f whatsnew: logging.fileConfig accepts ConfigParser instances. (#16110)
And missing NEWS entry.
2014-03-10 11:51:19 -04:00
R David Murray c5f5d69517 whatsnew: total_ordering supports NotImplemented (#10042) 2014-03-10 11:02:45 -04:00
R David Murray a6ea7a3c8f whatsnew: filecmp.DEFAULT_IGNORES (#15442) 2014-03-10 10:47:56 -04:00
R David Murray c08383633a whatsnew: Message.set_param *replace*, Policy.content_manager.
Also cleaned up the email section and fixed some markup bugs in the
email docs.
2014-03-10 10:08:05 -04:00
R David Murray c51eaf5ca0 whatsnew: ChainMap.new_child *m* argument.
And NEWS entry.
2014-03-10 09:49:19 -04:00
Georg Brandl 02e77d17fa Closes #20090: update Doc/README.txt for the changes in the 3.4 branch. 2014-03-10 19:31:52 +01:00
Georg Brandl b6111f5529 Remove unused sphinx-build.py entry script. 2014-03-10 19:10:29 +01:00
R David Murray fa06047af1 whatsnew: add porting note for pyvenv --without-pip. 2014-03-10 09:20:37 -04:00
R David Murray dcbd83321b whatsnew: tarfile cli (#13477). 2014-03-09 21:19:57 -04:00
R David Murray 7ad765169c whatsnew: dis.stack_effect (#19722). 2014-03-09 21:07:37 -04:00
R David Murray 9561ce2f0f whatsnew: oops, create_default_context doesn't return what the stdlib uses. 2014-03-09 21:00:14 -04:00
R David Murray b5ac4d7eaa whatsnew: expand re.fullmatch entry with the motivation for the feature. 2014-03-09 20:52:28 -04:00
R David Murray ced82ef752 whatsnew: give Hugo credit for his preliminary work on regex patch. 2014-03-09 20:46:32 -04:00
R David Murray 2177be2c3a whatsnew: auidioop.byteswap (#16685). 2014-03-09 20:42:49 -04:00
R David Murray 0cf177205c whatsnew: porting note for sysconfig 'SO' key deprecation. 2014-03-09 20:39:52 -04:00
R David Murray c38f89146d whatsnew: 'U' mode deprecation (#15204). 2014-03-09 20:33:35 -04:00
R David Murray 98a6738dca whatsnew: cp1125 codec (#19668). 2014-03-09 20:13:16 -04:00
R David Murray f20cfb2081 whatsnew: ssl.create_default_context (#19689). 2014-03-09 19:58:17 -04:00
R David Murray e7fa1204e2 whatsnew: allowZip64 defaults to True (#17201). 2014-03-09 19:57:19 -04:00
R David Murray 01e6accd19 whatsnew: SSLContext.load_default_certs (#19292). 2014-03-09 19:41:25 -04:00
R David Murray f3b3e9e23c whatsnew: pdb works for debugging asyncio programs (#16596). 2014-03-09 19:40:30 -04:00
R David Murray 6ae5eef542 Merge #19953: Clarify the wording of the augmented assignment discussion. 2014-03-09 18:51:35 -04:00
R David Murray 14d7b718ba #19953: Clarify the wording of the augmented assignment discussion.
Patch by Priya Pappachan, based on suggestions from Terry Reedy
and myself.
2014-03-09 18:51:16 -04:00
R David Murray c402577056 whatsnew: venv with_pip, pyvenv --without-pip (#19552) 2014-03-09 18:09:51 -04:00
R David Murray 2450c1d54a whatsnew: more accurate deprecation section titles. 2014-03-09 17:13:31 -04:00
R David Murray 336fd7f788 whatsnew: deprecation of sysconfig SO key (#19555). 2014-03-09 17:11:00 -04:00
R David Murray 6978722828 whatsnew: SSLContext.verify_flags and constants. (#8813) 2014-03-09 17:01:34 -04:00
R David Murray 1d342b2e8b whatsnew: plistlib new api and deprecations (#14455)
Also fixed the versionchanged/deprecation tags in the docs.
2014-03-09 15:09:04 -04:00
R David Murray 2dd0473722 whatsnew: SSLSocket.getpeercert new values returned. (#18379) 2014-03-09 12:55:58 -04:00
R David Murray 4e40cec924 whatsnew: sys.__interactivehook__. (#5845)
I decided to leave the (slightly expanded) Other Improvements
entry as well, since someone looking for command line behavior
changes isn't going to look in the 'sys' module section.
2014-03-09 12:03:30 -04:00
R David Murray 04ea3f35bd whatsnew: SSLcontext.load_verify_locations cadata argument (#18138) 2014-03-08 23:19:45 -05:00
R David Murray e6bd31ea92 whatsnew: hmac conforms to pep 247. (#18775) 2014-03-08 23:18:09 -05:00
R David Murray 3d234837ed whatsnew: hmac *digestmod* accepts strings, and default is deprecated. (#17276) 2014-03-08 22:43:12 -05:00
R David Murray 958e4da660 whatsnew: tidy up html notes, add porting note for expand_charrefs. 2014-03-08 21:40:29 -05:00
R David Murray 1cd0e85d01 whatsnew: glob.escape. 2014-03-08 21:23:21 -05:00
R David Murray c210de1ea1 whatsnew: base65 encodings. (#17618)
Also updated the base64 module title and introduction to adjust for
the fact that these new encodings are included.

Also adjusted the wording about the base64 alphabets (see
issue #20837).
2014-03-08 12:53:28 -05:00
R David Murray 9bd6a37df2 whatsnew: dbm.open is context manager. (#19282) 2014-03-08 12:00:52 -05:00
R David Murray cbf479ae64 whatsnew: sunau/aifc/wave writeframes[raw] accept any bytes-like (#8311) 2014-03-08 11:46:05 -05:00
R David Murray 5d6240e871 whatsnew: Wave_write handles unseekable files. (#5202)
Also clarify the documentation of this feature.
2014-03-08 11:14:29 -05:00
Nick Coghlan 1635578d5f Improve descriptions of introspection changes
Several of the introspection changes in Python 3.4 are indirect,
where inspect module changes affected pydoc, and those in turn
affected the help builtin. This update adds versionchanged
notes in the key locations, as well as more coverage in the
What's New document (in particular, a note in the porting
section regarding the expanded domain for inspect.getfullargspec).
2014-03-08 16:36:37 +10:00
R David Murray 8591563628 whatsnew: audioop accepts any bytes-like, rejects strings. 2014-03-07 21:35:31 -05:00
R David Murray 6c50101fc9 whatsnew: inet_pton/inet_ntop support windows (#7171).
Added versionchanged to docs.
2014-03-07 21:22:39 -05:00
R David Murray 99e1bfad09 whatsnew: sunau supports 24 bit samples. 2014-03-07 21:15:56 -05:00
R David Murray c4c7b1ccb6 whatsnew: cp273 codec (#10907797)
Also updated the docs and added the aliases mentioned by the
references.
2014-03-07 21:00:34 -05:00
Larry Hastings a3188ef476 Update pydoc topics and suspicious filters. 2014-03-09 04:12:12 -07:00
R David Murray 47d083cf1a whatsnew: cp273 codec (#10907797)
Also updated the docs and added the aliases mentioned by the
references.
2014-03-07 21:00:34 -05:00
R David Murray e2684d93e2 whatsnew: get[status|output] works on windows.
Since 3.3.4.... :(
2014-03-07 20:06:24 -05:00
R David Murray 48b6b70b95 #10197: Update get[status]output versionchanged with actual version.
This was perhaps on the border between a bug fix and a feature since
the Python3 docs did not originally say it was unix only.  However, the
functions never worked anywhere but unix, and the docs were changed to
say it was unix only well before the windows support was added.

Unfortunately, windows support was added in 3.3.4 as well as 3.4.
That leaves us in the uncomfortable position of needing the tag to say
"version changed: 3.3.4" :(
2014-03-07 20:04:41 -05:00
R David Murray 95b696a010 #10197: Update get[status]output versionchanged with actual version.
This was perhaps on the border between a bug fix and a feature since
the Python3 docs did not originally say it was unix only.  However, the
functions never worked anywhere but unix, and the docs were changed to
say it was unix only well before the windows support was added.

Unfortunately, windows support was added in 3.3.4 as well as 3.4.
That leaves us in the uncomfortable position of needing the tag to say
"version changed: 3.3.4" :(
2014-03-07 20:04:17 -05:00
Brett Cannon c39e892955 Issue #20813: Backport Python 2/3 HOWTO updates 2014-03-07 12:28:35 -05:00
Brett Cannon 6634e15d77 Issue #20812: Add a short opener to the Python 2/3 porting HOWTO.
Thanks to Nick Coghlan for the suggestion.
2014-03-07 12:27:10 -05:00
R David Murray beec02ac06 whatsnew: note in deprecation section about html.parser strict. 2014-03-06 13:40:53 -05:00
R David Murray 393c8f36ef whatsnew: rewrite resource entry: prlimit and new constants. 2014-03-06 12:47:31 -05:00
R David Murray 6674ac0873 whatsnew: ipaddress is_global
Also tweaked the docs a bit and added the missing entry for
the ipv6 is_global.
2014-03-06 11:51:37 -05:00