Commit Graph

500 Commits

Author SHA1 Message Date
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
R David Murray 16b8c619cd Merge: #18628: clarify index entry for source file encoding declaration. 2014-04-16 21:50:25 -04:00
Benjamin Peterson d51374ed78 PEP 465: a dedicated infix operator for matrix multiplication (closes #21176) 2014-04-09 23:55:56 -04:00
Yury Selivanov 490a72e022 docs: Better wording for __objclass__ docs. Issue #19281 2014-04-08 14:01:12 -04:00
Yury Selivanov b9aa8cb0c7 docs: Document __objclass__. Closes #19281.
Initial patch by Nick Coghlan
2014-04-08 12:04:04 -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
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
Larry Hastings 3732ed2414 Merge in all documentation changes since branching 3.4.0rc1. 2014-03-15 21:13:56 -07: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
Benjamin Peterson 71215c584a merge 3.3 (closes #12704) 2014-01-26 22:58:42 -05:00
Benjamin Peterson d1c85fd283 eliminate redundancy between yield stmt and yield expr docs (closes #12704)
Patch by Nikolaus Rath.
2014-01-26 22:52:08 -05:00
Larry Hastings b7f5dcadf2 Merge 3.4.0b2 release revisions back into mainline. 2014-01-06 07:24:19 -08:00
Ethan Furman df3ed242c0 Issue19995: %o, %x, %X now only accept ints 2014-01-05 06:50:30 -08:00
Larry Hastings bfd715ebd1 Regenerated pydoc/topics.py, and fix a "suspicious" doc error. 2014-01-05 04:35:56 -08:00
Benjamin Peterson 002033ed63 correct word for __annotations__ doc (closes #20110)
Patch from Claudiu Popa.
2014-01-02 16:47:50 -06:00
Benjamin Peterson 8ec15f7a92 merge 3.3 (#20110) 2014-01-02 16:48:24 -06:00
Zachary Ware 1cb4f607d1 Merge with 3.3 2013-12-31 12:10:24 -06:00
Zachary Ware 340a692283 str subclasses may have non-empty __slots__, bytes subclasses can't. 2013-12-31 12:09:26 -06:00
Serhiy Storchaka 2a6145290b Removed spaces before commas and periods. 2013-12-23 18:21:57 +02: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
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
Georg Brandl 472a65a710 Fix a few markup problems in the new import doc. 2013-11-24 12:39:56 +01:00
Eric Snow b523f8433a Implement PEP 451 (ModuleSpec). 2013-11-22 09:05:39 -07:00
Serhiy Storchaka 0d85b5c68d Issue #19190: Improve cross-references in builtin types and functions documentation. 2013-10-09 14:03:24 +03:00
Serhiy Storchaka 0d196edc37 Issue #19190: Improve cross-references in builtin types and functions documentation. 2013-10-09 14:02:31 +03:00
Georg Brandl c13d604193 merge with 3.3 2013-10-08 21:47:35 +02:00
Georg Brandl 0aaae26518 Clarify two points about division and shifting. Suggested by Albert Hofkamp on docs@. 2013-10-08 21:47:18 +02:00
Georg Brandl 100580f4c4 merge with 3.3 2013-10-08 21:28:42 +02:00
Georg Brandl 97f962339f Add "->" as a delimiter token. Found by James Harding on docs@. 2013-10-08 21:28:22 +02:00
Georg Brandl 6930777c63 merge with 3.3 2013-10-06 10:28:48 +02:00
Georg Brandl 242e6a0bce Use "lambda expression" as preferred to "lambda form". 2013-10-06 10:28:39 +02:00
Antoine Pitrou 58720d6145 Issue #17934: Add a clear() method to frame objects, to help clean up expensive details (local variables) and break reference cycles. 2013-08-05 23:26:40 +02:00
Antoine Pitrou 796564c27b Issue #18112: PEP 442 implementation (safe object finalization). 2013-07-30 19:59:21 +02:00
Barry Warsaw 4958f714bd - Issue #18440: Clarify that `hash()` can truncate the value returned from an
object's custom `__hash__()` method.
2013-07-15 15:21:41 -04:00
Barry Warsaw 224a599c0c - Issue #18440: Clarify that `hash()` can truncate the value returned from an
object's custom `__hash__()` method.
2013-07-15 14:47:29 -04:00
Brett Cannon 82da8886cc Issue #15767: Revert 3a50025f1900 for ModuleNotFoundError 2013-07-04 17:48:16 -04:00
Brett Cannon 8f5ac5106e Issue #15767: Touch up ModuleNotFoundError usage by import.
Forgot to raise ModuleNotFoundError when None is found in sys.modules.
This led to introducing the C function PyErr_SetImportErrorSubclass()
to make setting ModuleNotFoundError easier.

Also updated the reference docs to mention ModuleNotFoundError
appropriately. Updated the docs for ModuleNotFoundError to mention the
None in sys.modules case.

Lastly, it was noticed that PyErr_SetImportError() was not setting an
exception when returning None in one case. That issue is now fixed.
2013-06-12 23:29:18 -04:00
Brett Cannon 4b4e38e7d4 Mention __cached__ in the import ref. 2013-05-25 11:32:50 -04:00
Brett Cannon b961955e95 merge 2013-05-25 11:33:13 -04:00
Ezio Melotti 1fbb773c29 #17938: merge with 3.3. 2013-05-09 15:34:09 +03:00
Ezio Melotti 955382ca54 #17938: remove duplicate paragraphs. 2013-05-09 15:33:53 +03:00
Brett Cannon 4c14b5de1c #17115,17116: Have modules initialize the __package__ and __loader__
attributes to None.

The long-term goal is for people to be able to rely on these
attributes existing and checking for None to see if they have been
set. Since import itself sets these attributes when a loader does not
the only instances when the attributes are None are from someone
overloading __import__() and not using a loader or someone creating a
module from scratch.

This patch also unifies module initialization. Before you could have
different attributes with default values depending on how the module
object was created. Now the only way to not get the same default set
of attributes is to circumvent initialization by calling
ModuleType.__new__() directly.
2013-05-04 13:56:58 -04:00
Georg Brandl cf72c5e4ea merge with 3.3 2013-04-14 10:13:50 +02:00
Georg Brandl dec3b3f704 Clarify point in name mangling doc. 2013-04-14 10:13:42 +02:00
Georg Brandl 1bab7134a8 Merge with 3.3. 2013-03-28 13:28:55 +01:00
Georg Brandl 44ea77bd81 Closes #4159: add LaTeX tabular column specifications to tables that otherwise are cut off or have overlapping text. 2013-03-28 13:28:44 +01:00
Brett Cannon 4802becb16 Issue #17117: Have both import itself and importlib.util.set_loader()
set __loader__ on a module when set to None.

Thanks to Gökcen Eraslan for the fix.
2013-03-13 10:41:36 -07:00
Benjamin Peterson 1ef876cd28 evaluate positional defaults before keyword-only defaults (closes #16967) 2013-02-10 09:29:59 -05:00
Chris Jerdonek c475278a94 Merge from 3.3: add links and index entries for "argument" and "parameter."
This adds to the work done for issue #15990 (i.e. f44b8d69e5fc and the
commits referenced there).
2012-12-25 14:59:46 -08:00
Chris Jerdonek 32bbc1c396 Merge from 3.2: add links and index entries for "argument" and "parameter."
This adds to the work done for issue #15990 (i.e. f44b8d69e5fc and the
commits referenced there).
2012-12-25 14:57:54 -08:00
Chris Jerdonek b43099464a Add additional links and index entries for "argument" and "parameter".
This adds to the work done for issue #15990 (i.e. f44b8d69e5fc and the
commits referenced there).
2012-12-25 14:54:44 -08:00
Ezio Melotti 16bdd4120d #16677: merge with 3.3. 2012-12-25 15:47:41 +02:00
Ezio Melotti 1be057673a #16677: merge with 3.2. 2012-12-25 15:46:58 +02:00
Ezio Melotti 9f929bb7df #16677: rename section header and fix markup. 2012-12-25 15:45:15 +02:00
Chris Jerdonek 7d2fad1be2 Merge from 3.3: link to "yield from" examples in yield documentation. 2012-12-23 15:35:23 -08:00
Chris Jerdonek 2654b86e88 Link to "yield from" examples in yield documentation.
This commit also simplifies the more advanced "yield from" example and removes
unused function parameters.
2012-12-23 15:31:57 -08:00
Chris Jerdonek 16459e8b16 Merge from 3.3: Add a str class entry to the string section (issue #16209).
This commit also moves the documentation for the str built-in function to
the new class entry.  Links to :class:`str` now go to the class entry with
the string methods immediately afterwards.
2012-11-28 01:45:15 -08:00
Chris Jerdonek bb4e941c6d Add a str class entry to the "Text Sequence Type" section (issue #16209).
This commit also moves the documentation for the str built-in function to
the new class entry.  Links to :class:`str` now go to the class entry with
the string methods immediately afterwards.
2012-11-28 01:38:40 -08:00
Chris Jerdonek 777db2d838 Fix label in docs (from issue #13538). 2012-11-21 05:32:44 -08:00
Chris Jerdonek d675a2c48a Merge from 3.3: Improve str() and object.__str__() docs (issue #13538). 2012-11-20 17:53:17 -08:00
Chris Jerdonek 5fae0e5854 Improve str() and object.__str__() documentation (issue #13538). 2012-11-20 17:45:51 -08:00
Chris Jerdonek 17fc44c9b3 Improve str() and object.__str__() documentation (issue #13538). 2012-11-20 17:31:02 -08:00
Barry Warsaw b72c10996e - Issue #16514: Fix regression causing a traceback when sys.path[0] is None
(actually, any non-string or non-bytes type).
2012-11-20 15:35:27 -05:00
Barry Warsaw 82c1c781c7 - Issue #16514: Fix regression causing a traceback when sys.path[0] is None
(actually, any non-string or non-bytes type).
2012-11-20 15:22:51 -05:00
Andrew Svetlov 993fd9f03a Merge issue #16144: Fix misleading sentence in reference/import.
Patch by Manuel Pégourié-Gonnard
2012-11-15 16:28:48 +02:00
Andrew Svetlov e2cf03e499 Issue #16144: Fix misleading sentence in reference/import.
Patch by Manuel Pégourié-Gonnard
2012-11-15 16:28:21 +02:00
Chris Jerdonek 21fecc764c Merge from 3.3: remove unneeded "Release" and "Date" markers from index pages. 2012-10-28 11:13:51 -07:00
Chris Jerdonek d285029ee8 Merge from 3.2: remove unneeded "Release" and "Date" markers from index pages. 2012-10-28 11:10:24 -07:00
Chris Jerdonek 8b7f9f581d Remove unneeded "Release" and "Date" markers from doc index pages. 2012-10-28 11:08:26 -07:00
Chris Jerdonek 3d6948e432 Merge from 3.3: fix formatting of syntax description of function definition. 2012-10-25 17:23:54 -07:00
Chris Jerdonek 8b0f3ad9fa Merge from 3.2: fix formatting of syntax description of function definition. 2012-10-25 17:23:14 -07:00
Chris Jerdonek c131b0760d Fix formatting of syntax description of function definition. 2012-10-25 17:21:22 -07:00
Benjamin Peterson 143d034ecd merge 3.2 2012-10-12 12:04:32 -04:00
Ezio Melotti 5c3283e43a Merge __next__ method link fixes with 3.3. 2012-10-12 13:46:37 +03:00
Ezio Melotti 1dd7c30419 Merge __next__ method link fixes with 3.2. 2012-10-12 13:45:38 +03:00
Ezio Melotti 7fa822275b Fix links to the __next__ method. 2012-10-12 13:42:08 +03:00
Chris Jerdonek 23354f505e Merge from 3.3: Fix link to str.format() in docs. 2012-10-11 18:49:52 -07:00
Chris Jerdonek 8958cd0e8d Merge from 3.2: Fix link to str.format() in docs. 2012-10-11 18:49:02 -07:00
Chris Jerdonek af94724e00 Fix link to str.format() in docs. 2012-10-11 18:47:54 -07:00
Ezio Melotti e12dc28c38 Fix markup. 2012-10-07 12:09:36 +03:00
Armin Ronacher 74b38b190f Issue #16148: Small improvements and cleanup. Added version information
to docs.
2012-10-07 10:29:32 +02:00
Georg Brandl 4614cc4f7f Closes #16149: remove now-false statement about the inability to compare Decimal and float objects. 2012-10-06 13:48:39 +02:00
Georg Brandl 7ea9a423cb Closes #16149: remove now-false statement about the inability to compare Decimal and float objects. 2012-10-06 13:48:39 +02:00
Ezio Melotti e7f90375b1 #16127: remove outdated references to narrow builds. Patch by Serhiy Storchaka. 2012-10-05 03:33:31 +03:00
Andrew Svetlov ddd74b10e5 Merge: Close open bracket, thanks to Josh Helzer from docs@ 2012-10-02 18:42:22 +03:00
Andrew Svetlov f532035551 Close open bracket, thanks to Josh Helzer from docs@ 2012-10-02 18:39:25 +03:00
Mark Dickinson 33d8ce1f0f Issue #14167: merge fix from 3.2 branch. 2012-09-24 20:17:17 +01:00
Mark Dickinson 05ee5817a1 Issue #14167: restore statement about breaks in finally clauses. 2012-09-24 20:16:38 +01:00
R David Murray a96be78ed1 Merge #14617: clarify discussion of interrelationship of __eq__ and __hash__. 2012-09-11 13:02:13 -04:00
R David Murray d8bbde35fe #14617: clarify discussion of interrelationship of __eq__ and __hash__. 2012-09-11 13:01:43 -04:00
Nick Coghlan 1685db011d s/path importer/path based finder/ (because the path based finder is not an importer and the simpler 'path finder' is too ambiguous) 2012-08-20 13:49:08 +10:00
R David Murray f669036319 Merge #15355: Mention already-executing Exception in generator docs.
Patch by Chris Jerdonek.
2012-08-17 20:49:24 -04:00
R David Murray 2c1d1d6310 #15355: Mention already-executing Exception in generator docs.
Patch by Chris Jerdonek.
2012-08-17 20:48:59 -04:00
Andrew Svetlov f06afe35b9 Issue #14167: Document return statement in finally blocks.
Patch by Yury Selivanov.
2012-08-14 15:38:58 +03:00
Andrew Svetlov f158d86074 Issue #14167: Document return statement in finally blocks.
Patch by Yury Selivanov.
2012-08-14 15:38:15 +03:00
Georg Brandl a81b481e3a Fix markup errors and update pydoc topics. 2012-08-11 08:43:59 +02:00
Nick Coghlan 4941774f59 Issue #15502: Bring the importlib.PathFinder docs and docstring more in line with the new import system documentation, and fix various parts of the new docs that weren't quite right given PEP 420 or were otherwise a bit misleading. Also note the key terminology problem still being discussed in the issue 2012-08-02 23:03:58 +10:00
Nick Coghlan e3376ef6d2 Clarify the import statement semantics, especially for implicit imports in the 'from X import Y' variant 2012-08-02 22:02:35 +10:00
Antoine Pitrou c86e8d9c17 Improve wording for __hash__ 2012-08-01 14:53:22 +02:00
Barry Warsaw dadebab42c Finally, a coherent set of terminology for all the lil' beasties involved. 2012-07-31 16:03:09 -04:00
Barry Warsaw cbc4c1930f Another XXX. 2012-07-30 16:57:20 -04:00
Barry Warsaw c1e721b979 Address substantially all of Eric Snow's comments in issue #15295, except for
those which now have additional XXX's here.  I'll get to those later. :)
2012-07-30 16:24:12 -04:00
Barry Warsaw d7d2194ea1 Integration of importdocs from the features/pep-420 repo. 2012-07-29 16:36:17 -04:00
Georg Brandl 56ed2844fa Merge with 3.2. 2012-06-24 22:50:30 +02:00
Georg Brandl 33369cf9a5 Fix a bunch of "versionchanged" related markup errors. 2012-06-24 22:48:03 +02:00
Georg Brandl 0182f38dec Fix small overeager edit from 8e47e9af826e. 2012-06-20 11:26:03 +02:00
Christian Heimes 0b3847de6d Issue #15096: Drop support for the ur string prefix 2012-06-20 11:17:58 +02:00
Nick Coghlan 305acf2fff Remove an incorrect implementation detail 2012-05-20 21:22:27 +10:00
Nick Coghlan b267475ccf Clarify a paragraph in the new metaclass docs 2012-05-20 19:36:40 +10:00
Nick Coghlan 337b2bfbc4 Describe the default hash correctly, and mark a couple of CPython implementation details 2012-05-20 18:30:49 +10:00
Nick Coghlan 78770f0b78 Fix typo in new metaclass docs 2012-05-20 18:15:11 +10:00
Nick Coghlan 7fc570a51e Close #14588: added a PEP 3115 compliant dynamic type creation mechanism 2012-05-20 02:34:13 +10:00
Brett Cannon 1b5123aae5 Issue #14628: Document the fact that import always returns the module
as found in sys.modules and not as what the loader returns (even
though it is required to by PEP 302).
2012-04-20 15:57:46 -04:00
Georg Brandl 6aacc14e29 Merge with 3.2. 2012-03-10 09:27:30 +01:00
Georg Brandl 64a40949cf Closes #14186: add link to PEP 3107 (function annotations) to the function definition section. 2012-03-10 09:22:47 +01:00
Armin Ronacher 50364b4a5c Basic documentation for PEP 414 2012-03-04 12:33:51 +00:00
Benjamin Peterson b43fde98b4 remove unapplicable statement 2012-02-21 18:03:26 -05:00
Benjamin Peterson c9f54cf512 enable hash randomization by default 2012-02-21 16:08:05 -05:00
Benjamin Peterson 79d38788ee update unicode link 2012-02-20 22:35:25 -05:00
Georg Brandl 2fb477c0f0 Merge 3.2: Issue #13703 plus some related test suite fixes. 2012-02-21 00:33:36 +01:00
Georg Brandl 09a7c72cad Merge from 3.1: Issue #13703: add a way to randomize the hash values of basic types (str, bytes, datetime)
in order to make algorithmic complexity attacks on (e.g.) web apps much more complicated.

The environment variable PYTHONHASHSEED and the new command line flag -R control this
behavior.
2012-02-20 21:31:46 +01:00
Georg Brandl 2daf6ae249 Issue #13703: add a way to randomize the hash values of basic types (str, bytes, datetime)
in order to make algorithmic complexity attacks on (e.g.) web apps much more complicated.

The environment variable PYTHONHASHSEED and the new command line flag -R control this
behavior.
2012-02-20 19:54:16 +01:00
Terry Jan Reedy 93abdd1ab8 Merge with 3.2 closes 14023 2012-02-17 19:58:41 -05:00
Terry Jan Reedy ead1de2f03 Issue 14023 Revert edit to 2.7 version. (I suspect edit is from when we thought
to to makes bytes mutable, before deciding to add bytearrays.)
2012-02-17 19:56:58 -05:00
Nick Coghlan 0ed8019c20 Add versionchanged notes for PEP 380 2012-01-14 14:43:24 +10:00
Benjamin Peterson d204934ee3 exception support is correct now (closes #13705) 2012-01-03 16:30:37 -06:00
Sandro Tosi b2794c842f Issue #13683: raise with no exception in scope throws a RuntimeError; fix by Ramchandra Apte 2012-01-01 12:17:15 +01:00
Sandro Tosi 3721fbc5de point IronPython to ironpython.net; thanks to Lazar Pancic from docs@ 2011-12-24 23:13:19 +01:00
Sandro Tosi 75c71ccf2a fix Rather that/Rather than; thanks to Reuben Thomas from docs@ 2011-12-24 19:56:04 +01:00
Benjamin Peterson 57f97f400b parameter_list was meant here 2011-12-23 20:01:43 -06:00
Benjamin Peterson ad17358a2f kill superfluous 'comprehension' case (closes #13658) 2011-12-23 20:00:56 -06:00
Nick Coghlan 1f7ce62bd6 Implement PEP 380 - 'yield from' (closes #11682) 2012-01-13 21:43:40 +10:00
Antoine Pitrou 3a5d4cb940 Issue #13748: Raw bytes literals can now be written with the `rb` prefix as well as `br`. 2012-01-12 22:46:19 +01:00
Benjamin Peterson 199808b796 merge 3.2 2012-01-03 16:30:47 -06:00
Sandro Tosi bc25dcf3f3 merge with 3.2 2012-01-01 12:17:36 +01:00
Sandro Tosi 91d9152919 merge with 3.2 2011-12-24 23:13:39 +01:00
Sandro Tosi 29cfdc7a61 merge with 3.2 2011-12-24 19:56:35 +01:00
Benjamin Peterson a883e566ac merge 3.2 2011-12-23 20:02:12 -06:00
Antoine Pitrou 86a36b500a PEP 3155 / issue #13448: Qualified name for classes and functions. 2011-11-25 18:56:07 +01:00
Ezio Melotti f7f0a66a8f Fix typos. 2011-10-25 17:22:22 +03:00
Ezio Melotti f4d76e6ca7 #13251: update string description in datamodel.rst. 2011-10-25 09:23:42 +03:00
Benjamin Peterson 3ed559a3c7 merge 3.2 (#13259) 2011-10-25 00:04:10 -04:00
Benjamin Peterson 1fafc1a11f document __bytes__ special method (closes #13259) 2011-10-25 00:03:51 -04:00
Ezio Melotti 931b8aac80 #12753: Add support for Unicode name aliases and named sequences. 2011-10-21 21:57:36 +03:00
Ezio Melotti f10644983e Merge with 3.2. 2011-10-19 11:06:26 +03:00
Ezio Melotti e130a52d8a Remove duplication. 2011-10-19 10:58:56 +03:00
Ezio Melotti 6e3b975aa5 #12531: merge with 3.2. 2011-07-30 21:26:40 +03:00