7b1e5a7722
Remove redundant leading zeroes in PEP references.
2016-03-31 15:31:20 +03:00
e4ba872543
Remove redundant leading zeroes in PEP references.
2016-03-31 15:30:54 +03:00
3e48b38dff
Merge 3.5 (issue #25887 )
2016-02-13 18:00:31 -05:00
77c96813ab
Issue #25887 : Raise a RuntimeError when a coroutine is awaited more than once.
2016-02-13 17:59:05 -05:00
bc1ee460dc
Issue #25179 : Documentation for formatted string literals aka f-strings
...
Some of the inspiration and wording is taken from the text of PEP 498 by Eric
V. Smith, and the existing str.format() documentation.
2016-02-13 00:41:37 +00:00
e922289620
Merge with 3.5
2016-02-03 22:07:08 -06:00
2b818142d1
Python for .NET has moved to Github.
...
Reported by Denis Akhiyarov on docs@
2016-02-03 22:05:46 -06:00
849113af6b
Issue #25791 : Warn when __package__ != __spec__.parent.
...
In a previous change, __spec__.parent was prioritized over
__package__. That is a backwards-compatibility break, but we do
eventually want __spec__ to be the ground truth for module details. So
this change reverts the change in semantics and instead raises an
ImportWarning when __package__ != __spec__.parent to give people time
to adjust to using spec objects.
2016-01-22 15:25:50 -08:00
63b8505281
Issue #25791 : Raise an ImportWarning when __spec__ or __package__ are
...
not defined for a relative import.
This is the start of work to try and clean up import semantics to rely
more on a module's spec than on the myriad attributes that get set on
a module. Thanks to Rose Ames for the patch.
2016-01-15 13:33:03 -08:00
3ad18dc7a7
Merge for issue #25500
2015-12-04 14:52:07 -08:00
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
3129571fb1
Merge: #25679 : spelling fix
2015-11-20 09:59:19 -05:00
0aaeacb3f1
Merge: #25679 : spelling fix
2015-11-20 09:58:51 -05:00
51d3f8b0ba
#25679 : spelling fix
2015-11-20 09:57:20 -05:00
e56a919100
Issue #25523 : Merge a-to-an corrections from 3.5
2015-11-02 04:27:17 +00:00
d2ad5718ad
Issue #25523 : Further a-to-an corrections new in 3.5
2015-11-02 04:20:33 +00:00
83356f7a3f
Issue #25418 : Fix markup in object.__hash__ documentation
...
Patch by TAKASE Arihiro.
2015-10-16 11:23:31 +03:00
85d5d902ce
Issue #25418 : Fix markup in object.__hash__ documentation
...
Patch by TAKASE Arihiro.
2015-10-16 11:23:11 +03:00
edb9111d41
Issue #25418 : Fix markup in object.__hash__ documentation
...
Patch by TAKASE Arihiro.
2015-10-16 11:22:50 +03:00
430f657c67
Issue #25161 : Merge full stops from 3.5
2015-10-10 10:45:00 +00:00
84835ab1cb
Issue #25161 : Merge full stops from 3.4 into 3.5
2015-10-10 10:44:25 +00:00
d21e0b52f1
Issue #25161 : Add full stops in documentation; patch by Takase Arihiro
2015-10-10 10:36:22 +00:00
3766ee5162
Issue #12067 : Merge comparisons doc from 3.5
2015-09-23 05:41:52 +00:00
e52c41a714
Issue #12067 : Merge comparisons doc from 3.4 into 3.5
2015-09-23 05:34:48 +00:00
aa0da864b8
Issue #12067 : Rewrite Comparisons section in the language reference
...
Some of the details of comparing mixed types were incorrect or ambiguous.
NotImplemented is only relevant at a lower level than the Expressions
chapter. Added details of comparing range() objects, and default behaviour
and consistency suggestions for user-defined classes. Patch from Andy Maier.
2015-09-23 05:28:13 +00:00
df395991f6
Issue #9232 : Support trailing commas in function declarations.
...
For example, "def f(*, a = 3,): pass" is now legal.
Patch from Mark Dickinson.
2015-08-12 08:00:06 +12:00
00cf3c394a
Issue #4395 : Better testing and documentation of binary operators.
...
Patch by Martin Panter.
2015-08-07 10:32:15 +12:00
d84b29f805
Issue #4395 : Better testing and documentation of binary operators.
...
Patch by Martin Panter.
2015-08-07 10:22:54 +12:00
888a6729da
Issue #24531 : Document that encoding lines cannot follow non-comment lines.
...
Patch from Terry Reedy
2015-08-06 21:14:34 +12:00
0b2833eaf2
Issue #24531 : Document that encoding lines cannot follow non-comment lines.
...
Patch from Terry Reedy
2015-08-06 21:08:44 +12:00
73c6f64a5e
Merge issue #24129 from 3.4
2015-08-05 23:23:24 +10:00
91e561aa77
Issue #24129 : Clarify reference docs for name resolution.
...
This includes removing the assumption that readers will be familiar with the
name resolution scheme Python used prior to the introduction of lexical
scoping for function namespaces.
Patch by Ivan Levkivskyi.
2015-08-05 23:07:24 +10:00
75b5ab5770
docs: Fix productionlist for async def functions
2015-08-01 16:19:36 -04:00
a1bddadddd
Issue #24713 : Use importlib.reload() in import reference document.
...
imp.reload() was deprecated in Python 3.4 and changed to call
importlib.reload().
Patch by Petr Viktorin.
2015-07-25 13:03:08 +03:00
7e732a7181
Issue #24713 : Use importlib.reload() in import reference document.
...
imp.reload() was deprecated in Python 3.4 and changed to call
importlib.reload().
Patch by Petr Viktorin.
2015-07-25 13:02:37 +03:00
8fb307cd65
Issue #24619 : New approach for tokenizing async/await.
...
This commit fixes how one-line async-defs and defs are tracked
by tokenizer. It allows to correctly parse invalid code such
as:
>>> async def f():
... def g(): pass
... async = 10
and valid code such as:
>>> async def f():
... async def g(): pass
... await z
As a consequence, is is now possible to have one-line
'async def foo(): await ..' functions:
>>> async def foo(): return await bar()
2015-07-22 13:33:45 +03:00
47066ee3db
merge 3.4 ( #24610 )
2015-07-11 16:33:39 -07:00
acb3a4d88b
fix normalization example ( closes #24610 )
...
Patch by Chris Angelico
2015-07-11 16:32:55 -07:00
4801383c29
upgrade to Unicode 8.0.0
2015-06-27 15:45:56 -05:00
66f8828bfc
Issue #24439 : Improve PEP 492 related docs.
...
Patch by Martin Panter.
2015-06-24 11:04:15 -04:00
5376ba9630
Issue #24400 : Introduce a distinct type for 'async def' coroutines.
...
Summary of changes:
1. Coroutines now have a distinct, separate from generators
type at the C level: PyGen_Type, and a new typedef PyCoroObject.
PyCoroObject shares the initial segment of struct layout with
PyGenObject, making it possible to reuse existing generators
machinery. The new type is exposed as 'types.CoroutineType'.
As a consequence of having a new type, CO_GENERATOR flag is
no longer applied to coroutines.
2. Having a separate type for coroutines made it possible to add
an __await__ method to the type. Although it is not used by the
interpreter (see details on that below), it makes coroutines
naturally (without using __instancecheck__) conform to
collections.abc.Coroutine and collections.abc.Awaitable ABCs.
[The __instancecheck__ is still used for generator-based
coroutines, as we don't want to add __await__ for generators.]
3. Add new opcode: GET_YIELD_FROM_ITER. The opcode is needed to
allow passing native coroutines to the YIELD_FROM opcode.
Before this change, 'yield from o' expression was compiled to:
(o)
GET_ITER
LOAD_CONST
YIELD_FROM
Now, we use GET_YIELD_FROM_ITER instead of GET_ITER.
The reason for adding a new opcode is that GET_ITER is used
in some contexts (such as 'for .. in' loops) where passing
a coroutine object is invalid.
4. Add two new introspection functions to the inspec module:
getcoroutinestate(c) and getcoroutinelocals(c).
5. inspect.iscoroutine(o) is updated to test if 'o' is a native
coroutine object. Before this commit it used abc.Coroutine,
and it was requested to update inspect.isgenerator(o) to use
abc.Generator; it was decided, however, that inspect functions
should really be tailored for checking for native types.
6. sys.set_coroutine_wrapper(w) API is updated to work with only
native coroutines. Since types.coroutine decorator supports
any type of callables now, it would be confusing that it does
not work for all types of coroutines.
7. Exceptions logic in generators C implementation was updated
to raise clearer messages for coroutines:
Before: TypeError("generator raised StopIteration")
After: TypeError("coroutine raised StopIteration")
2015-06-22 12:19:30 -04:00
bd44ce8ead
Merge with 3.4
2015-06-12 15:45:05 -04:00
f5d4523844
Closes issue #24405 : mark set display as code.
2015-06-12 15:44:45 -04:00
ab89f9c27f
merge
2015-05-22 16:38:16 -07:00
9ecf9e2944
Issue #24219 : Remove duplicate literal in docs.
2015-05-22 16:37:49 -07:00
f3e40fac10
Issue 24180: Documentation for PEP 492 changes.
2015-05-21 11:50:30 -04:00
8170e8c0d1
PEP 479: Change StopIteration handling inside generators.
...
Closes issue #22906 .
2015-05-09 11:44:30 -04:00
19dac071ef
Issue 24088: Clarify semantics of yield expression (merge from 3.4).
2015-05-05 12:04:35 -07:00
d0150ad59e
Issue 24088: Clarify semantics of yield expression.
2015-05-05 12:02:01 -07:00
51f58059f6
merge 3.4 ( #24049 )
2015-04-24 12:02:53 -04:00
9bdd61338d
remove dead *-import checking code ( closes #24049 )
2015-04-24 12:02:29 -04:00
b5a3d9bebb
Issue #24029 : Document the name binding behavior for submodule imports.
2015-04-22 18:38:26 -04:00
2097f53ec3
Issue #24029 : Document the name binding behavior for submodule imports.
2015-04-22 18:29:16 -04:00
f299abdafa
Issue #23731 : Implement PEP 488.
...
The concept of .pyo files no longer exists. Now .pyc files have an
optional `opt-` tag which specifies if any extra optimizations beyond
the peepholer were applied.
2015-04-13 14:21:02 -04:00
770319d6bd
Issue #23912 : Fix code formatting in datamodel.rst.
...
Patch by James Edwards.
2015-04-11 14:59:30 +03:00
2995cc6855
Issue #23912 : Fix code formatting in datamodel.rst.
...
Patch by James Edwards.
2015-04-11 14:59:50 +03:00
4785f5e249
Merge with 3.4
2015-02-19 22:15:54 -06:00
57c616f1e4
Fix a typo pointed out on docs@
2015-02-19 22:15:36 -06:00
e62430eda4
Issue22988: clarify yield and exception blocks
2015-01-14 22:26:04 -08:00
2f825af728
Issue22988: clarify yield and exception blocks
2015-01-14 22:25:27 -08:00
9fdb0fe17b
Issue20467: clarify __init__'s role
2015-01-14 21:57:15 -08:00
845d33c526
Issue20467: clarify __init__'s role
2015-01-14 21:56:49 -08:00
119479f705
Issue20467: clarify __init__'s role
2015-01-14 21:56:10 -08:00
02d8454002
Issue #23014 : Make importlib.abc.Loader.create_module() required when
...
importlib.abc.Loader.exec_module() is also defined.
Before this change, create_module() was optional **and** could return
None to trigger default semantics. This change now reduces the
options for choosing default semantics to one and in the most
backporting-friendly way (define create_module() to return None).
2015-01-09 11:39:21 -05:00
b67f6e27e1
Issue #23006 : Improve the documentation and indexing of dict.__missing__.
...
Add an entry in the language datamodel special methods section.
Revise and index its discussion in the stdtypes mapping/dict section.
2014-12-10 18:38:19 -05:00
c9f5f2ddc7
#22918 : Drop obsolete mention of 'keys' in datamodel __iter__ docs.
...
Patch by Chaitanya Agrawal.
2014-12-10 09:51:01 -05:00
b004943e9b
(3.4) Issue22780: reword NotImplemented docs to emphasise should
2014-11-26 21:15:35 -08:00
e6b2b78a7d
Merge 3.4
2014-12-10 18:39:45 -05:00
892dbd18e1
Merge: #22918 : Drop obsolete mention of 'keys' in datamodel __iter__ docs.
2014-12-10 09:51:27 -05:00
9b55089999
Issue22780: reword NotImplemented docs to emphasise should
2014-11-26 21:17:53 -08:00
b6e2556d8f
Issue #22834 : Have import suppress FileNotFoundError when the current
...
working directory no longer exists.
Thanks to Martin Panter for the bug report.
2014-11-21 12:19:28 -05:00
d0c4ef175b
Issue #22242 : Try to make some import-related loader details clearer.
...
Thanks to Jon Poler for pointing this out.
2014-11-07 11:29:33 -05:00
e21a531ef1
merge with 3.4
2014-10-31 10:39:29 +01:00
a4c8c47961
#22613 : remaining corrections in extending/reference docs (thanks Jacques Ducasse)
2014-10-31 10:38:49 +01:00
794e9bf1fe
merge with 3.4
2014-10-29 10:27:06 +01:00
525d355984
Fixing broken links in doc, part 3: the rest
2014-10-29 10:26:56 +01:00
cadc3fdcb5
Merge with 3.4
2014-10-29 08:37:29 +01:00
e73778c1ac
Use https:// URLs when referring to python.org hosts.
2014-10-29 08:36:35 +01:00
58b2ddf392
Issue7186: document that __doc__ is not inherited by subclasses
2014-10-17 22:25:47 -07:00
f87f515057
Issue7186: document that __doc__ is not inherited by subclasses
2014-10-17 22:25:22 -07:00
2623a5db6f
Merge: #18176 : Change generic UCD PropList link to version specific link.
2014-10-09 20:47:31 -04:00
5f16f90d1b
#18176 : Change generic UCD PropList link to version specific link.
2014-10-09 20:45:59 -04:00
532783bd5e
Merge: #18176 : fix another reference and add it to the makeunicodedata comment.
2014-10-09 17:41:55 -04:00
5bd62420f4
#18176 : fix another reference and add it to the makeunicodedata comment.
2014-10-09 17:39:48 -04:00
cd09571894
Merge with 3.4
2014-09-30 19:08:02 -04:00
b6271f2d2b
Issue 22465: grammar, number agreement.
2014-09-30 19:07:49 -04:00
1aca6e1a91
Issue #20643 : Removed unneeded (and wrong) class directives.
2014-09-05 23:28:19 +03:00
848c8b29f6
Issue #20643 : Removed unneeded (and wrong) class directives.
2014-09-05 23:27:36 +03:00
523136937f
Merge with 3.4
2014-08-23 19:29:58 -04:00
65e3ecb3e2
Issue #22243 : fix except grammar in reference.
2014-08-23 19:29:47 -04:00
bd592417f4
add matrix multiplication operator to correct lists ( closes #22142 )
2014-08-06 22:50:30 -07:00
e2197a4805
Merge issue #21667 from 3.4
2014-06-07 23:22:06 +10:00
1462786f00
Issue #21667 : Clarify string data model description
2014-06-07 23:21:14 +10:00
cc568b1222
Merge #21662 : fix typo, improve sentence flow
2014-06-05 15:32:34 -04:00
2c0781853a
#21662 : fix typo, improve sentence flow
...
Patch by Steve Dougherty.
2014-06-05 15:31:56 -04:00
b369f5875c
Issue #21439 : Merge with 3.4
2014-06-03 09:34:39 -05:00
2f78b84c47
Issue #21439 : Fix a couple of typos.
2014-06-03 09:32:40 -05:00
a73a34d176
merge
2014-05-26 22:21:11 -07:00
aa7886dd3f
Issue 21439: Minor issues in the reference manual.
...
(Contributed by Feliks Kluzniak.)
2014-05-26 22:20:37 -07:00
384a3ea5c5
merge 3.4
2014-05-11 11:19:17 -07:00
5c8ce188ee
remove confusing delete indexing ( closes #21466 )
2014-05-11 11:18:51 -07:00
ed49265b91
Merge with 3.4
2014-05-06 09:19:16 -05:00
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
4e6688d2b2
Issue #21366 : Document the fact that ``return`` in a ``finally`` clause
...
overrides a ``return`` in the ``try`` suite.
2014-05-06 09:07:51 -05:00
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
727a463aa6
Merge with 3.4
2014-04-29 01:19:41 -04:00
9cc9026294
Issue #21055 : Index (augmented) assignment symbols.
2014-04-29 01:19:17 -04:00
e9dcfd1870
Merge with 3.4
2014-04-29 00:59:19 -04:00
7c895edabc
Closes 21048: Index 'as' in import and with statements.
2014-04-29 00:58:56 -04:00
f7f981829b
#18628 : clarify index entry for source file encoding declaration.
...
Patch by Sam Lucidi.
2014-04-16 21:48:04 -04:00
16b8c619cd
Merge: #18628 : clarify index entry for source file encoding declaration.
2014-04-16 21:50:25 -04:00
d51374ed78
PEP 465: a dedicated infix operator for matrix multiplication ( closes #21176 )
2014-04-09 23:55:56 -04:00
490a72e022
docs: Better wording for __objclass__ docs. Issue #19281
2014-04-08 14:01:12 -04:00
b9aa8cb0c7
docs: Document __objclass__. Closes #19281 .
...
Initial patch by Nick Coghlan
2014-04-08 12:04:04 -04:00
af8a4dfb04
docs: Better wording for __objclass__ docs. Issue #19281
2014-04-08 14:00:35 -04:00
d3f918ca44
docs: Document __objclass__. Closes #19281 .
...
Initial patch by Nick Coghlan
2014-04-08 12:03:07 -04:00
9aa00d1cd1
Issue #19697 : document more __main__.__spec__ quirks
2014-03-29 15:39:42 +10:00
e50f9aa4bd
Issue #19697 : Document cases where __main__.__spec__ is None.
2014-03-28 18:10:33 -06:00
3732ed2414
Merge in all documentation changes since branching 3.4.0rc1.
2014-03-15 21:13:56 -07:00
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
71215c584a
merge 3.3 ( closes #12704 )
2014-01-26 22:58:42 -05:00
d1c85fd283
eliminate redundancy between yield stmt and yield expr docs ( closes #12704 )
...
Patch by Nikolaus Rath.
2014-01-26 22:52:08 -05:00
b7f5dcadf2
Merge 3.4.0b2 release revisions back into mainline.
2014-01-06 07:24:19 -08:00
df3ed242c0
Issue19995: %o, %x, %X now only accept ints
2014-01-05 06:50:30 -08:00
bfd715ebd1
Regenerated pydoc/topics.py, and fix a "suspicious" doc error.
2014-01-05 04:35:56 -08:00
002033ed63
correct word for __annotations__ doc ( closes #20110 )
...
Patch from Claudiu Popa.
2014-01-02 16:47:50 -06:00
8ec15f7a92
merge 3.3 ( #20110 )
2014-01-02 16:48:24 -06:00
1cb4f607d1
Merge with 3.3
2013-12-31 12:10:24 -06:00
340a692283
str subclasses may have non-empty __slots__, bytes subclasses can't.
2013-12-31 12:09:26 -06:00
2a6145290b
Removed spaces before commas and periods.
2013-12-23 18:21:57 +02:00
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
0e90e99188
Issue #19795 : Improved markup of True/False constants.
2013-11-29 12:19:53 +02:00
fbc1c26803
Issue #19795 : Improved markup of True/False constants.
2013-11-29 12:17:13 +02:00
472a65a710
Fix a few markup problems in the new import doc.
2013-11-24 12:39:56 +01:00
b523f8433a
Implement PEP 451 (ModuleSpec).
2013-11-22 09:05:39 -07:00
0d85b5c68d
Issue #19190 : Improve cross-references in builtin types and functions documentation.
2013-10-09 14:03:24 +03:00
0d196edc37
Issue #19190 : Improve cross-references in builtin types and functions documentation.
2013-10-09 14:02:31 +03:00
c13d604193
merge with 3.3
2013-10-08 21:47:35 +02:00
0aaae26518
Clarify two points about division and shifting. Suggested by Albert Hofkamp on docs@.
2013-10-08 21:47:18 +02:00
100580f4c4
merge with 3.3
2013-10-08 21:28:42 +02:00
97f962339f
Add "->" as a delimiter token. Found by James Harding on docs@.
2013-10-08 21:28:22 +02:00
6930777c63
merge with 3.3
2013-10-06 10:28:48 +02:00
242e6a0bce
Use "lambda expression" as preferred to "lambda form".
2013-10-06 10:28:39 +02:00
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
796564c27b
Issue #18112 : PEP 442 implementation (safe object finalization).
2013-07-30 19:59:21 +02:00
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
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
82da8886cc
Issue #15767 : Revert 3a50025f1900 for ModuleNotFoundError
2013-07-04 17:48:16 -04:00
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
4b4e38e7d4
Mention __cached__ in the import ref.
2013-05-25 11:32:50 -04:00
Serhiy Storchaka
Yury Selivanov
Martin Panter
Zachary Ware
Brett Cannon
R David Murray
Berker Peksag
Robert Collins
Nick Coghlan
Benjamin Peterson
Terry Jan Reedy
Raymond Hettinger
Guido van Rossum
Barry Warsaw
Ethan Furman
Georg Brandl
Eric Snow
Larry Hastings
Antoine Pitrou