Martin Panter
3766ee5162
Issue #12067 : Merge comparisons doc from 3.5
2015-09-23 05:41:52 +00:00
Martin Panter
e52c41a714
Issue #12067 : Merge comparisons doc from 3.4 into 3.5
2015-09-23 05:34:48 +00:00
Martin Panter
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
Robert Collins
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
Robert Collins
00cf3c394a
Issue #4395 : Better testing and documentation of binary operators.
...
Patch by Martin Panter.
2015-08-07 10:32:15 +12:00
Robert Collins
d84b29f805
Issue #4395 : Better testing and documentation of binary operators.
...
Patch by Martin Panter.
2015-08-07 10:22:54 +12:00
Robert Collins
888a6729da
Issue #24531 : Document that encoding lines cannot follow non-comment lines.
...
Patch from Terry Reedy
2015-08-06 21:14:34 +12:00
Robert Collins
0b2833eaf2
Issue #24531 : Document that encoding lines cannot follow non-comment lines.
...
Patch from Terry Reedy
2015-08-06 21:08:44 +12:00
Nick Coghlan
73c6f64a5e
Merge issue #24129 from 3.4
2015-08-05 23:23:24 +10:00
Nick Coghlan
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
Yury Selivanov
75b5ab5770
docs: Fix productionlist for async def functions
2015-08-01 16:19:36 -04:00
Berker Peksag
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
Berker Peksag
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
Yury Selivanov
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
Benjamin Peterson
47066ee3db
merge 3.4 ( #24610 )
2015-07-11 16:33:39 -07:00
Benjamin Peterson
acb3a4d88b
fix normalization example ( closes #24610 )
...
Patch by Chris Angelico
2015-07-11 16:32:55 -07:00
Benjamin Peterson
4801383c29
upgrade to Unicode 8.0.0
2015-06-27 15:45:56 -05:00
Yury Selivanov
66f8828bfc
Issue #24439 : Improve PEP 492 related docs.
...
Patch by Martin Panter.
2015-06-24 11:04:15 -04:00
Yury Selivanov
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
Terry Jan Reedy
bd44ce8ead
Merge with 3.4
2015-06-12 15:45:05 -04:00
Terry Jan Reedy
f5d4523844
Closes issue #24405 : mark set display as code.
2015-06-12 15:44:45 -04:00
Raymond Hettinger
ab89f9c27f
merge
2015-05-22 16:38:16 -07:00
Raymond Hettinger
9ecf9e2944
Issue #24219 : Remove duplicate literal in docs.
2015-05-22 16:37:49 -07:00
Yury Selivanov
f3e40fac10
Issue 24180: Documentation for PEP 492 changes.
2015-05-21 11:50:30 -04:00
Yury Selivanov
8170e8c0d1
PEP 479: Change StopIteration handling inside generators.
...
Closes issue #22906 .
2015-05-09 11:44:30 -04:00
Guido van Rossum
19dac071ef
Issue 24088: Clarify semantics of yield expression (merge from 3.4).
2015-05-05 12:04:35 -07:00
Guido van Rossum
d0150ad59e
Issue 24088: Clarify semantics of yield expression.
2015-05-05 12:02:01 -07:00
Benjamin Peterson
51f58059f6
merge 3.4 ( #24049 )
2015-04-24 12:02:53 -04:00
Benjamin Peterson
9bdd61338d
remove dead *-import checking code ( closes #24049 )
2015-04-24 12:02:29 -04:00
Barry Warsaw
b5a3d9bebb
Issue #24029 : Document the name binding behavior for submodule imports.
2015-04-22 18:38:26 -04:00
Barry Warsaw
2097f53ec3
Issue #24029 : Document the name binding behavior for submodule imports.
2015-04-22 18:29:16 -04:00
Brett Cannon
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
Berker Peksag
770319d6bd
Issue #23912 : Fix code formatting in datamodel.rst.
...
Patch by James Edwards.
2015-04-11 14:59:30 +03:00
Berker Peksag
2995cc6855
Issue #23912 : Fix code formatting in datamodel.rst.
...
Patch by James Edwards.
2015-04-11 14:59:50 +03:00
Zachary Ware
4785f5e249
Merge with 3.4
2015-02-19 22:15:54 -06:00
Zachary Ware
57c616f1e4
Fix a typo pointed out on docs@
2015-02-19 22:15:36 -06:00
Ethan Furman
e62430eda4
Issue22988: clarify yield and exception blocks
2015-01-14 22:26:04 -08:00
Ethan Furman
2f825af728
Issue22988: clarify yield and exception blocks
2015-01-14 22:25:27 -08:00
Ethan Furman
9fdb0fe17b
Issue20467: clarify __init__'s role
2015-01-14 21:57:15 -08:00
Ethan Furman
845d33c526
Issue20467: clarify __init__'s role
2015-01-14 21:56:49 -08:00
Ethan Furman
119479f705
Issue20467: clarify __init__'s role
2015-01-14 21:56:10 -08:00
Brett Cannon
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
Terry Jan Reedy
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
R David Murray
c9f5f2ddc7
#22918 : Drop obsolete mention of 'keys' in datamodel __iter__ docs.
...
Patch by Chaitanya Agrawal.
2014-12-10 09:51:01 -05:00
Ethan Furman
b004943e9b
(3.4) Issue22780: reword NotImplemented docs to emphasise should
2014-11-26 21:15:35 -08:00
Terry Jan Reedy
e6b2b78a7d
Merge 3.4
2014-12-10 18:39:45 -05:00
R David Murray
892dbd18e1
Merge: #22918 : Drop obsolete mention of 'keys' in datamodel __iter__ docs.
2014-12-10 09:51:27 -05:00
Ethan Furman
9b55089999
Issue22780: reword NotImplemented docs to emphasise should
2014-11-26 21:17:53 -08:00
Brett Cannon
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
Brett Cannon
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
Georg Brandl
e21a531ef1
merge with 3.4
2014-10-31 10:39:29 +01:00
Georg Brandl
a4c8c47961
#22613 : remaining corrections in extending/reference docs (thanks Jacques Ducasse)
2014-10-31 10:38:49 +01:00
Georg Brandl
794e9bf1fe
merge with 3.4
2014-10-29 10:27:06 +01:00
Georg Brandl
525d355984
Fixing broken links in doc, part 3: the rest
2014-10-29 10:26:56 +01:00
Georg Brandl
cadc3fdcb5
Merge with 3.4
2014-10-29 08:37:29 +01:00
Georg Brandl
e73778c1ac
Use https:// URLs when referring to python.org hosts.
2014-10-29 08:36:35 +01:00
Ethan Furman
58b2ddf392
Issue7186: document that __doc__ is not inherited by subclasses
2014-10-17 22:25:47 -07:00
Ethan Furman
f87f515057
Issue7186: document that __doc__ is not inherited by subclasses
2014-10-17 22:25:22 -07:00
R David Murray
2623a5db6f
Merge: #18176 : Change generic UCD PropList link to version specific link.
2014-10-09 20:47:31 -04:00
R David Murray
5f16f90d1b
#18176 : Change generic UCD PropList link to version specific link.
2014-10-09 20:45:59 -04:00
R David Murray
532783bd5e
Merge: #18176 : fix another reference and add it to the makeunicodedata comment.
2014-10-09 17:41:55 -04:00
R David Murray
5bd62420f4
#18176 : fix another reference and add it to the makeunicodedata comment.
2014-10-09 17:39:48 -04:00
Terry Jan Reedy
cd09571894
Merge with 3.4
2014-09-30 19:08:02 -04:00
Terry Jan Reedy
b6271f2d2b
Issue 22465: grammar, number agreement.
2014-09-30 19:07:49 -04:00
Serhiy Storchaka
1aca6e1a91
Issue #20643 : Removed unneeded (and wrong) class directives.
2014-09-05 23:28:19 +03:00
Serhiy Storchaka
848c8b29f6
Issue #20643 : Removed unneeded (and wrong) class directives.
2014-09-05 23:27:36 +03:00
Terry Jan Reedy
523136937f
Merge with 3.4
2014-08-23 19:29:58 -04:00
Terry Jan Reedy
65e3ecb3e2
Issue #22243 : fix except grammar in reference.
2014-08-23 19:29:47 -04:00
Benjamin Peterson
bd592417f4
add matrix multiplication operator to correct lists ( closes #22142 )
2014-08-06 22:50:30 -07:00
Nick Coghlan
e2197a4805
Merge issue #21667 from 3.4
2014-06-07 23:22:06 +10:00
Nick Coghlan
1462786f00
Issue #21667 : Clarify string data model description
2014-06-07 23:21:14 +10:00
R David Murray
cc568b1222
Merge #21662 : fix typo, improve sentence flow
2014-06-05 15:32:34 -04:00
R David Murray
2c0781853a
#21662 : fix typo, improve sentence flow
...
Patch by Steve Dougherty.
2014-06-05 15:31:56 -04:00
Zachary Ware
b369f5875c
Issue #21439 : Merge with 3.4
2014-06-03 09:34:39 -05:00
Zachary Ware
2f78b84c47
Issue #21439 : Fix a couple of typos.
2014-06-03 09:32:40 -05:00
Raymond Hettinger
a73a34d176
merge
2014-05-26 22:21:11 -07:00
Raymond Hettinger
aa7886dd3f
Issue 21439: Minor issues in the reference manual.
...
(Contributed by Feliks Kluzniak.)
2014-05-26 22:20:37 -07:00
Benjamin Peterson
384a3ea5c5
merge 3.4
2014-05-11 11:19:17 -07:00
Benjamin Peterson
5c8ce188ee
remove confusing delete indexing ( closes #21466 )
2014-05-11 11:18:51 -07:00
Zachary Ware
ed49265b91
Merge with 3.4
2014-05-06 09:19:16 -05: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
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
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
Terry Jan Reedy
727a463aa6
Merge with 3.4
2014-04-29 01:19:41 -04:00
Terry Jan Reedy
9cc9026294
Issue #21055 : Index (augmented) assignment symbols.
2014-04-29 01:19:17 -04:00
Terry Jan Reedy
e9dcfd1870
Merge with 3.4
2014-04-29 00:59:19 -04:00
Terry Jan Reedy
7c895edabc
Closes 21048: Index 'as' in import and with statements.
2014-04-29 00:58:56 -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
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