Commit Graph

16523 Commits

Author SHA1 Message Date
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