summaryrefslogtreecommitdiffstats
path: root/Doc/reference
Commit message (Collapse)AuthorAgeFilesLines
* Correct a couple of unbalanced parenthesis. (GH-10779)Miss Islington (bot)2018-12-051-1/+1
| | | | | (cherry picked from commit 55f41e45b4318cbe19209f5144641344d0049fb8) Co-authored-by: Andre Delfino <adelfino@gmail.com>
* Move __missing__ after __delitem__ in Data model. (GH-10923)Miss Islington (bot)2018-12-051-8/+8
| | | | | (cherry picked from commit 1ce853f37783575e2b3aaa159ddcebc8660830ef) Co-authored-by: Andre Delfino <adelfino@gmail.com>
* Fix outdated info in datamodel about dicts (GH-9807)Miss Islington (bot)2018-11-161-2/+2
| | | | | (cherry picked from commit a48e0eb9673ec96d1decb8a230331533cfb6138b) Co-authored-by: wim glenn <wim.glenn@gmail.com>
* bpo-33816: Remove outdated metaclass example (GH-7566)Miss Islington (bot)2018-11-161-34/+2
| | | | | (cherry picked from commit c2ccac7b9f9a1132ca36255b0ddfeecef4371aa3) Co-authored-by: Andrés Delfino <adelfino@gmail.com>
* bpo-33878: Doc: Fix missing case by simplifying. (GH-7762)Miss Islington (bot)2018-11-121-6/+3
| | | | | | | | The documentation was not covering multiple targets enclosed by parenthesis nor multiple targets enclosed by brackets, adding them all would be heavy, an else cover them all and is lighter to read. (cherry picked from commit 082875dcd6d482558e5f1da97a1c801d60b3ed5b) Co-authored-by: Julien Palard <julien@palard.fr>
* bpo-33699: Describe try's else clause with the rest of the try clause (GH-7252)Miss Islington (bot)2018-11-111-7/+5
| | | | | | https://bugs.python.org/issue33699 (cherry picked from commit b086c8afdb8c862011e3e27d4c8f6833749f2c56) Co-authored-by: Andrés Delfino <adelfino@gmail.com>
* Add link to PEP 525 in Expressions. (GH-10333)Miss Islington (bot)2018-11-071-1/+5
| | | | | (cherry picked from commit bfe1839aa994f0d84471254418a4ecfa7c7c9b9c) Co-authored-by: Andrés Delfino <adelfino@gmail.com>
* Add future_stmt to simple_stmt production list. (GH-8239)Miss Islington (bot)2018-11-071-0/+1
| | | | | (cherry picked from commit cdb96f45b61a40a7e7c4c83b4b1f14ef6f5cf4fa) Co-authored-by: Andrés Delfino <adelfino@gmail.com>
* Mark -c and -O as command line options in reStructuredText. (GH-10103)Miss Islington (bot)2018-11-073-3/+3
| | | | | (cherry picked from commit ea6a28c9f7e4baa5fe775cebce697a14a7d7da8b) Co-authored-by: Andrés Delfino <adelfino@gmail.com>
* bpo-35119: Fix RecursionError in example of customizing module attribute ↵Miss Islington (bot)2018-11-061-1/+1
| | | | | | | | access. (GH-10323) https://bugs.python.org/issue35119 (cherry picked from commit 0bee3c36d406e47fa9f99cfc1e07b701512c4f3f) Co-authored-by: Denis Osipov <osipov_d@list.ru>
* bpo-35054: Add yet more index entries for symbols. (GH-10121) (GH-10171)Miss Islington (bot)2018-10-285-93/+80
| | | | | (cherry picked from commit 913876d824d969f8c7431e8a9d4610a9a11a786e) Co-authored-by: Serhiy Storchaka <storchaka@gmail.com>
* Fix mistakes on function coroutines related definitions (GH-9871)Miss Islington (bot)2018-10-281-8/+8
| | | | | | | | | | Fix a bug I introduced in GH-9864 by which coroutines are treated as synonymous of function coroutines. Also, fix the same mistake (coroutines == function coroutines) already present in other parts of the reference. I'm very sorry for the hassle. (cherry picked from commit 95f68b10d5c9852ef4dcf5b9f2ae15fdf74e8f1c) Co-authored-by: Andrés Delfino <adelfino@gmail.com>
* [3.7] bpo-35054: Add more index entries for symbols. (GH-10064). (GH-10120)Serhiy Storchaka2018-10-267-49/+230
| | | | | (cherry picked from commit ddb961d2abe5d5fde76d85b21a77e4e91e0043ad) Co-authored-by: Serhiy Storchaka <storchaka@gmail.com>
* bpo-33726, doc: Add short descriptions to PEP references in seealso (GH-7294)Miss Islington (bot)2018-10-192-2/+17
| | | | | (cherry picked from commit 0f14fc1a7cb2ea0012d0a943e4460acdee2108d7) Co-authored-by: Andrés Delfino <adelfino@gmail.com>
* Update compound_stmts.rst (GH-9864) (GH-9869)Miss Islington (bot)2018-10-141-4/+4
| | | | | (cherry picked from commit c8bb467f4006fbf5d24d2491248bcbabee5d827e) Co-authored-by: Andrés Delfino <adelfino@gmail.com>
* closes bpo-28955: Clarified comparisons between NaN and number in reference ↵Miss Islington (bot)2018-09-141-6/+5
| | | | | | | | documentation (GH-5982) Co-authored-by: Benjamin Peterson <benjamin@python.org> (cherry picked from commit ad8a0004206ba7aec5a8a60fce413da718080db2) Co-authored-by: Tony Flury <anthony.flury@btinternet.com>
* Fix HTML formatting in datamodel.rst (GH-8693)Miss Islington (bot)2018-08-061-3/+3
| | | | | (cherry picked from commit 3c1b590472d567e22a607ba31271865cd90c8e9b) Co-authored-by: Berker Peksag <berker.peksag@gmail.com>
* Use 'for example' instead of 'in other words' in compound statement doc ↵Miss Islington (bot)2018-07-301-1/+1
| | | | | | | (GH-8401) (cherry picked from commit 6921ef7bef4eab3819b3d0fda5fa3e3b2a8c0613) Co-authored-by: Andrés Delfino <adelfino@gmail.com>
* bpo-33702: Add some missing links in production lists and do a little polish ↵Miss Islington (bot)2018-07-073-25/+25
| | | | | | | (GH-7259) (cherry picked from commit caccca78e46bf3c3b24e09b3afb1c1b08c39990c) Co-authored-by: Andrés Delfino <adelfino@gmail.com>
* bpo-33877: Remove UNIX qualification for running complete programs (GH-7744)Miss Islington (bot)2018-06-221-5/+6
| | | | | | The statement is true for Windows (and macOS) also. (cherry picked from commit c9d43c702a53804c23ecb22a0dbf6a47c804d2b1) Co-authored-by: Andrés Delfino <adelfino@gmail.com>
* bpo-33847: Add '@' operator entry to index (GH-7669)Miss Islington (bot)2018-06-151-1/+3
| | | | | (cherry picked from commit 695118600fecaa7b95634e168ad7cbbc561fd1ec) Co-authored-by: Andrés Delfino <adelfino@gmail.com>
* bpo-33852: Remove misplaced parentheses around 'list'. (GH-7672)Miss Islington (bot)2018-06-151-1/+1
| | | | | | 'expresson list' refers to the grammar term 'expression_list' in the subscription production. (cherry picked from commit 4fddd4e4069aad9efad999d8d9ce3cd9fb523a5c) Co-authored-by: Andrés Delfino <adelfino@gmail.com>
* bpo-33766: Document that end of file or string is a newline (GH-7383)Miss Islington (bot)2018-06-101-5/+6
| | | | | (cherry picked from commit 0aa17ee6a76df0946d42e7657a501f1862065a22) Co-authored-by: Ammar Askar <ammar_askar@hotmail.com>
* update to Unicode 11.0.0 (closes bpo-33778) (GH-7439) (GH-7470)Miss Islington (bot)2018-06-071-2/+2
| | | | | | Also, standardize indentation of generated tables. (cherry picked from commit 7c69c1c0fba8c1c8ff3969bce4c1135736a4cc58) Co-authored-by: Benjamin Peterson <benjamin@python.org>
* Fix typo in datamodel.rst (GH-6964)Miss Islington (bot)2018-06-021-1/+1
| | | | | | This is a simple grammatical fix correcting "...object whose `__self__` attributes is ..." to "...object whose `__self__` attribute is ...". (cherry picked from commit 00818c8ffd657f9ec727e366bfffd9c2135fa5ab) Co-authored-by: Zach Mitchell <zmitchell@users.noreply.github.com>
* Fix lambda parameters being refered as arguments (GH-7037)Miss Islington (bot)2018-05-221-2/+2
| | | | | (cherry picked from commit 268cc7c3f8f58075b42ff0cd6b6c6c5d76044895) Co-authored-by: Andrés Delfino <adelfino@gmail.com>
* bpo-23722: Fix docs for future __classcell__ changes. (GH-6999) (GH-7000)Miss Islington (bot)2018-05-201-1/+1
| | | | | (cherry picked from commit 8ae8e6af37f29163ee263e293570cb892dc5b5d5) Co-authored-by: Serhiy Storchaka <storchaka@gmail.com>
* [3.7] bpo-32996: The bulk of What's New in Python 3.7 (GH-6978). (GH-6998)Elvis Pranskevichus2018-05-201-0/+2
| | | | | (cherry picked from commit 63536bd286097e770909052052a21804a5e09b66) Co-authored-by: Elvis Pranskevichus <elvis@magic.io>
* bpo-32717: Document PEP 560 (GH-6726)Miss Islington (bot)2018-05-081-0/+37
| | | | | (cherry picked from commit bd5f96581bf23f6d05fc106996428a8043b6b084) Co-authored-by: Ivan Levkivskyi <levkivskyi@gmail.com>
* Clarify that __path__ can't be just any value (GH-6554)Miss Islington (bot)2018-04-201-2/+1
| | | | | (cherry picked from commit 441d945eb33f8dc130b268ebfa11315b98a2433c) Co-authored-by: Brett Cannon <brettcannon@users.noreply.github.com>
* bpo-33260: Regenerate token.py after removing ASYNC and AWAIT. (GH-6447)Miss Islington (bot)2018-04-111-1/+1
| | | | | (cherry picked from commit d08972fdb92cad6b813d22205752c97ea18df060) Co-authored-by: Serhiy Storchaka <storchaka@gmail.com>
* bpo-26701: Improve documentation for the rounding special methods. (GH-6054)Miss Islington (bot)2018-03-101-12/+18
| | | | | (cherry picked from commit 496431ffb6c29719332bf2af773349e8dd85e45a) Co-authored-by: Serhiy Storchaka <storchaka@gmail.com>
* bpo-26701: Add documentation for __trunc__ (GH-6049)Miss Islington (bot)2018-03-101-0/+9
| | | | | | | `int` fails back to `__trunc__` is `__int__` isn't defined, so cover that in the docs. (cherry picked from commit 308eab979d153f1ab934383dc08bc4546ced8b6c) Co-authored-by: Eric Appelt <eric.appelt@gmail.com>
* bpo-30579: Docs for dynamic traceback creation (GH-5653)Miss Islington (bot)2018-02-131-12/+34
| | | | | (cherry picked from commit aec7532ed3ccbd29d3429a3f375e25f956c44003) Co-authored-by: Nick Coghlan <ncoghlan@gmail.com>
* [3.7] bpo-8722: Document __getattr__ behavior with AttributeError in ↵Miss Islington (bot)2018-02-051-4/+6
| | | | | | | | | | property (GH-5543) When `__getattr__` is implemented, attribute lookup will always fall back to that, even if the initial failure comes from `__getattribute__` or a descriptor's `__get__` method (including property methods). (cherry picked from commit d1f318105b8781b01f3507d5cb0fd841b977d5f2) Co-authored-by: Cheryl Sabella <cheryl.sabella@gmail.com>
* bpo-32735: Fix typo in f-strings datetime format specifier example (GH-5464)Cheryl Sabella2018-01-311-1/+1
| | | | The f-string example for using datetime format specifier does not match the given output. Changed the format from %b to %B so it matches the output of "January".
* bpo-27505: Add change notes in module attribute docs (GH-5320)Cheryl Sabella2018-01-271-0/+11
| | | | | | Make it clear that setting __class__ on a module has worked since 3.5, but support for __getattr__ and __dir__ on module instances requires 3.7+ Patch by Cheryl Sabella.
* String annotations [PEP 563] (#4390)Guido van Rossum2018-01-262-12/+28
| | | | | | | | * Document `from __future__ import annotations` * Provide plumbing and tests for `from __future__ import annotations` * Implement unparsing the AST back to string form This is required for PEP 563 and as such only implements a part of the unparsing process that covers expressions.
* Lexical Analysis ref doc: Fix a typo in the string concatenation internal ↵İsmail Arılık2018-01-121-1/+1
| | | | | | | link (GH-5157) In lexical analysis reference documentation, the internal link to the string literal concatenation section was written as`.. _string-catenation:`. Changed that to `.. _string-concatenation:`.
* Improve the F-strings and format specifier documentation (GH-4931)KatherineMichel2017-12-191-4/+5
| | | | Mention that the format-specifier mini language in f-strings is the same one used by str.format.
* bpo-32377: improve __del__ docs and fix mention about resurrection (#4927)Antoine Pitrou2017-12-191-39/+47
| | | | | | * Fix #32377: improve __del__ docs and fix mention about resurrection * Mention that CPython only calls __del__ once.
* F-strings docs: link to Format Specifiers (GH-4888)Mariatta2017-12-151-1/+2
| | | Link to the Format Specification Mini Language section from f-strings' documentation.
* bpo-32225: Implementation of PEP 562 (#4731)Ivan Levkivskyi2017-12-141-0/+45
| | | | | Implement PEP 562: module __getattr__ and __dir__. The implementation simply updates module_getattro and module_dir.
* closes bpo-31650: PEP 552 (Deterministic pycs) implementation (#4575)Benjamin Peterson2017-12-091-0/+27
| | | | | | | | | | | | | | | | | | | | | | | | | Python now supports checking bytecode cache up-to-dateness with a hash of the source contents rather than volatile source metadata. See the PEP for details. While a fairly straightforward idea, quite a lot of code had to be modified due to the pervasiveness of pyc implementation details in the codebase. Changes in this commit include: - The core changes to importlib to understand how to read, validate, and regenerate hash-based pycs. - Support for generating hash-based pycs in py_compile and compileall. - Modifications to our siphash implementation to support passing a custom key. We then expose it to importlib through _imp. - Updates to all places in the interpreter, standard library, and tests that manually generate or parse pyc files to grok the new format. - Support in the interpreter command line code for long options like --check-hash-based-pycs. - Tests and documentation for all of the above.
* bpo-10544: Deprecate "yield" in comprehensions and generator expressions. ↵Serhiy Storchaka2017-12-011-8/+53
| | | | | | | | | | | | | | (GH-4579) The current behaviour of yield expressions inside comprehensions and generator expressions is essentially an accident of implementation - it arises implicitly from the way the compiler handles yield expressions inside nested functions and generators. Since the current behaviour wasn't deliberately designed, and is inherently confusing, we're deprecating it, with no current plans to reintroduce it. Instead, our advice will be to use a named nested generator definition for cases where this behaviour is desired.
* Remove redundant 'exc = True' line (GH-4357)Berker Peksag2017-11-111-1/+0
| | | It can be removed after https://github.com/python/peps/commit/c28890fb421c906241da6da718f9eacc5a3109ee
* bpo-31810: added missing keywords to docs. (#4140)Tom Floyer2017-11-081-7/+7
| | | | | async and await keywords has been merged into upstream, but they are all missing in the lexical analysis docs. This change adds them to the appropriate keywords section in documentation.
* Fix a grammatical problem and reword for clarity. (#4257)Barry Warsaw2017-11-031-5/+4
| | | bpo-31936
* bpo-31799: Make module.__spec__ more discoverable (#4010)Barry Warsaw2017-10-171-2/+3
| | | | bpo-31799: Make module.__spec__ more discoverable
* bpo-31708: Allow async generator expressions in synchronous functions (#3905)Yury Selivanov2017-10-061-8/+10
|