summaryrefslogtreecommitdiffstats
path: root/Doc/glossary.rst
Commit message (Collapse)AuthorAgeFilesLines
* Issue #23756: Clarify the terms "contiguous" and "bytes-like object".Stefan Krah2015-08-081-2/+16
| | | | Patch by Martin Panter.
* Issue #24439: Improve PEP 492 related docs.Yury Selivanov2015-06-241-10/+11
| | | | Patch by Martin Panter.
* Issue #24400: Introduce a distinct type for 'async def' coroutines.Yury Selivanov2015-06-221-8/+17
| | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | 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")
* Issue 24180: Fixes by Berker Peksag.Yury Selivanov2015-05-211-12/+0
|
* Issue 24180: Documentation for PEP 492 changes.Yury Selivanov2015-05-211-0/+48
|
* Doc clarification / edification on the semantics of the 'w*' format unit.Larry Hastings2015-04-131-4/+11
|
* merge with 3.4Georg Brandl2015-01-151-1/+1
|\
| * Closes #23244: fix typo. Thanks Mayank Tripathi for the patch.Georg Brandl2015-01-151-1/+1
| |
* | Merge issue 19548 changes from 3.4Nick Coghlan2015-01-061-1/+4
|\ \ | |/
| * Issue 19548: update codecs module documentationNick Coghlan2015-01-061-1/+4
| | | | | | | | | | | | | | | | - clarified the distinction between text encodings and other codecs - clarified relationship with builtin open and the io module - consolidated documentation of error handlers into one section - clarified type constraints of some behaviours - added tests for some of the new statements in the docs
* | Issue #22696: Add function :func:`sys.is_finalizing` to know about ↵Antoine Pitrou2014-12-071-0/+13
| | | | | | | | interpreter shutdown.
* | Merge with 3.4Georg Brandl2014-10-291-3/+3
|\ \ | |/
| * Use https:// URLs when referring to python.org hosts.Georg Brandl2014-10-291-3/+3
| |
* | merge with 3.4Georg Brandl2014-10-061-2/+2
|\ \ | |/
| * Closes #21782: the default hash(x) is not exactly id(x) but derived from it.Georg Brandl2014-10-061-2/+2
| |
* | Merge issue #22295 fix from 3.4Nick Coghlan2014-09-061-0/+8
|\ \ | |/
| * Issue #22295: Adopt 'python -m pip' as the preferred invocationNick Coghlan2014-09-061-0/+8
| |
* | Merge with 3.4Terry Jan Reedy2014-08-231-1/+1
|\ \ | |/
| * Issue #22232 (partial fix): update Universal newlines Glossary entry.Terry Jan Reedy2014-08-231-1/+1
| |
| * Merge in all documentation changes since branching 3.4.0rc1.Larry Hastings2014-03-161-0/+8
| |
* | Issue #13742: Add key and reverse parameters to heapq.merge()Raymond Hettinger2014-05-301-3/+4
| |
* | Merge from 3.3Andrew Kuchling2014-02-151-0/+8
|\ \ | |/ |/|
| * #16728: Mention collections.abc.Sequence in 'sequence' glossary entryAndrew Kuchling2014-02-151-0/+8
| |
* | Issue #19713: Update importlib docs for module spec changes, including ↵Eric Snow2013-12-171-0/+4
| | | | | | | | deprecations.
* | Issue #18840: Introduce the json module in the tutorial, and deemphasize the ↵Antoine Pitrou2013-12-051-4/+20
|\ \ | |/ | | | | pickle module.
| * Issue #18840: Introduce the json module in the tutorial, and deemphasize the ↵Antoine Pitrou2013-12-051-4/+20
| | | | | | | | pickle module.
* | Issue #18326: merge with 3.3Zachary Ware2013-11-221-2/+4
|\ \ | |/
| * Issue #18326: Clarify that list.sort's arguments are keyword-only.Zachary Ware2013-11-221-2/+4
| | | | | | | | | | Also, attempt to reduce confusion in the glossary by not saying there are different "types" of arguments and parameters.
* | Tweak 'provisional' in glossaryNick Coghlan2013-10-201-6/+13
| |
* | Issue #19190: Improve cross-references in builtin types and functions ↵Serhiy Storchaka2013-10-091-6/+7
|\ \ | |/ | | | | documentation.
| * Issue #19190: Improve cross-references in builtin types and functions ↵Serhiy Storchaka2013-10-091-6/+7
| | | | | | | | documentation.
* | merge with 3.3Georg Brandl2013-10-081-1/+9
|\ \ | |/
| * Closes #19178: some more cross-references about packages in glossary. Patch ↵Georg Brandl2013-10-081-1/+9
| | | | | | | | by Berker Peksag.
* | merge with 3.3Georg Brandl2013-10-061-1/+1
|\ \ | |/
| * Fix small grammar mistake.Georg Brandl2013-10-061-1/+1
| |
* | moved the single-dispatch generic function definitions to the glossaryŁukasz Langa2013-06-071-0/+13
|/
* #14187: Add glossary entry for 'function annotations'.R David Murray2013-05-061-0/+10
| | | | Patch by Chris Rebert.
* Elaborate on bytes-like objects.Antoine Pitrou2013-05-041-2/+6
|
* #16518: add "bytes-like object" to the glossary.Ezio Melotti2013-04-301-0/+4
|
* #16128: merge with 3.2.Ezio Melotti2013-02-011-1/+2
|\
| * #16128: clarify that instances of user-defined classes compare equal with ↵Ezio Melotti2013-02-011-1/+2
| | | | | | | | themselves.
* | #16747: merge with 3.2.Ezio Melotti2013-01-021-11/+11
|\ \ | |/
| * #16747: fix link to file objects in the glossary.Ezio Melotti2013-01-021-11/+11
| |
* | Merge from 3.2: add links and index entries for "argument" and "parameter."Chris Jerdonek2012-12-251-2/+3
|\ \ | |/ | | | | | | This adds to the work done for issue #15990 (i.e. f44b8d69e5fc and the commits referenced there).
| * Add additional links and index entries for "argument" and "parameter".Chris Jerdonek2012-12-251-2/+3
| | | | | | | | | | This adds to the work done for issue #15990 (i.e. f44b8d69e5fc and the commits referenced there).
* | Merge from 3.2: improve argument/parameter documentation (issue #15990).Chris Jerdonek2012-11-281-18/+76
|\ \ | |/
| * Improve argument/parameter documentation (issue #15990).Chris Jerdonek2012-11-281-18/+76
| | | | | | | | | | | | This commit adds "parameter" to the glossary, improves and consolidates the "argument" glossary entry, and adds a question to the FAQ on the difference between arguments and parameters.
* | merge 3.2Benjamin Peterson2012-10-121-1/+1
|\ \ | |/
| * Fix links to the __next__ method.Ezio Melotti2012-10-121-1/+1
| |
* | Merge issue #16138: fix typo.Andrew Svetlov2012-10-051-1/+1
|\ \ | |/