summaryrefslogtreecommitdiffstats
path: root/Doc/reference
Commit message (Collapse)AuthorAgeFilesLines
* [3.6] Correct a couple of unbalanced parenthesis. (GH-10779). (GH-10945)Andre Delfino2018-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>
* 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 future_stmt to simple_stmt production list. (GH-8239)Miss Islington (bot)2018-11-081-0/+1
| | | | | (cherry picked from commit cdb96f45b61a40a7e7c4c83b4b1f14ef6f5cf4fa) 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>
* 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>
* [3.6] bpo-35054: Add yet more index entries for symbols. (GH-10121). (GH-10182)Serhiy Storchaka2018-10-285-93/+80
| | | | (cherry picked from commit 913876d824d969f8c7431e8a9d4610a9a11a786e)
* [3.6] bpo-35054: Add more index entries for symbols. (GH-10064). (GH-10119)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>
* 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>
* 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)Miss Islington (bot)2018-05-201-1/+1
| | | | | (cherry picked from commit 8ae8e6af37f29163ee263e293570cb892dc5b5d5) Co-authored-by: Serhiy Storchaka <storchaka@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-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-6050)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-30449: Improve __slots__ documentation (GH-1819)Miss Islington (bot)2018-02-221-14/+15
| | | | | | (cherry picked from commit 2b44e302ec3079363c4d5c875677945953705c58) Co-authored-by: Aaron Hall, MBA <aaronchall@yahoo.com>
* [3.6] bpo-8722: Document __getattr__ behavior with AttributeError in ↵Miss Islington (bot)2018-02-051-4/+6
| | | | | | | | | | property (GH-5542) 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) ↵Miss Islington (bot)2018-01-311-1/+1
| | | | | | | | | (GH-5465) 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". (cherry picked from commit b299393cc372f3ecbef4304f8eaa4c7838e975ca) Co-authored-by: Cheryl Sabella <cheryl.sabella@gmail.com>
* [3.6] bpo-27505: Retrofit module __class__ documentation from 3.7 (GH-5321)Cheryl Sabella2018-01-271-0/+33
| | | | | | | | The module `__class__` attribute documentation added to 3.7 for PEP 562 (dynamic module attributes) also applies to earlier versions. This backports that subset of the new docs to the 3.6 branch so that it will appear in the main online documentation and in the final 3.6 binary release. Patch by Cheryl Sabella.
* Lexical Analysis ref doc: Fix a typo in the string concatenation internal ↵Miss Islington (bot)2018-01-121-1/+1
| | | | | | | | link (GH-5157) (GH-5160) In lexical analysis reference documentation, the internal link to the string literal concatenation section was written as`.. _string-catenation:`. Changed that to `.. _string-concatenation:`. (cherry picked from commit 3764bb075a73074f55568fc7c37adde6054eb59a)
* Improve the F-strings and format specifier documentation (GH-4931) (GH-4933)Miss Islington (bot)2017-12-191-4/+5
| | | | | Mention that the format-specifier mini language in f-strings is the same one used by str.format. (cherry picked from commit f4e21a2a72f76d75a6cc6f74faf910a5f3108482)
* bpo-32377: improve __del__ docs and fix mention about resurrection (GH-4927) ↵Miss Islington (bot)2017-12-191-39/+47
| | | | | | | | (#4929) * Fix GH-32377: improve __del__ docs and fix mention about resurrection * Mention that CPython only calls __del__ once. (cherry picked from commit 4b965930e8625f77cb0e821daf5cc40e85b45f84)
* F-strings docs: link to Format Specifiers (GH-4888) (GH-4889)Miss Islington (bot)2017-12-151-1/+2
| | | | Link to the Format Specification Mini Language section from f-strings' documentation. (cherry picked from commit d924fa523df766dbf2f8b6a28ae502eb3433bfe5)
* Remove redundant 'exc = True' line (GH-4357)Miss Islington (bot)2017-11-111-1/+0
| | | | It can be removed after https://github.com/python/peps/commit/c28890fb421c906241da6da718f9eacc5a3109ee (cherry picked from commit 7c9da3e5ba060463b661da58ec3fe6beedce5566)
* [3.6] bpo-31799: Make module.__spec__ more discoverable (GH-4010) (#4021)Miss Islington (bot)2017-10-171-2/+3
| | | | bpo-31799: Make module.__spec__ more discoverable (cherry picked from commit 191e3138200906e43cba9347177914325b54843f)
* bpo-31621: Fix typo in Simple Statements documentation (GH-3809) (GH-3810)Miss Islington (bot)2017-09-281-1/+1
| | | | Replace "restriction" with "restrictions". (cherry picked from commit 8d59aca4a953b097a9b02b0ecafef840e4ac5855)
* bpo-31571: Remove duplicated info in Lexical Analysis documentation ↵Miss Islington (bot)2017-09-251-7/+0
| | | | | | | (GH-3691) (GH-3754) - Remove the second mention about the `u` prefix - Remove the second mention about numeric literals do not include a sign (cherry picked from commit 4a2d00cb4525fcb3209f04531472ba6a359ed418)
* bpo-31501: Operator precedence description for arithmetic operators ↵Miss Islington (bot)2017-09-191-2/+2
| | | | | (GH-3633) (GH-3638) (cherry picked from commit 9b47af65375fab9318e88ccb061394a36c8c6c33)
* bpo-31487: Update F-strings doc example (GH-3627) (GH-3628)Miss Islington (bot)2017-09-171-1/+1
| | | | Shorten the comment to: "using integer format specifier" (cherry picked from commit 63c591c0b0b57870a606e8edc59afe6264e7504d)
* bpo-31487: Improve f-strings documentation (GH-3604) (GH-3619)Miss Islington (bot)2017-09-161-0/+6
| | | | | Provide additional examples of using format specifiers in f-strings Added examples for using integer and date format specifiers. (cherry picked from commit f3618970690b08ed88e430ba8017859b4fafc3f9)
* [3.6] Mention enum as a potential use for metaclasses (GH-2982) (GH-3527)Miss Islington (bot)2017-09-131-2/+2
| | | (cherry picked from commit b8d1b9d7c697dd0401491b6d43047acbaf425f02)
* [3.6] link to legacy doc on the non-legacy website (GH-3362) (#3368)Benjamin Peterson2017-09-061-1/+1
| | | (cherry picked from commit 60dbed18509f99af8eaa685d9736f954b8d621fb)
* fix some reference to Unicode 8 that should be to Unicode 9 (#2346)Benjamin Peterson2017-06-231-2/+2
|
* bpo-30052: Link `bytes` & `bytearray` to stdtypes not functions (GH-1271) ↵Mariatta2017-06-021-8/+8
| | | | | | | | | | | | | (GH-1915) Builtin container types have two potential link targets in the docs: - their entry in the list of builtin callables - their type documentation This change brings `bytes` and `bytearray` into line with other container types by having cross-references default to linking to their type documentation, rather than their builtin callable entry.. (cherry picked from commit c6db4811f9ea3aeff0e1fafe1c60a22835ef359e)
* [3.6] Fix a trivial typo in global section (GH-1497) (GH-1880)Mariatta2017-05-311-1/+1
| | | (cherry picked from commit f34c6850203a2406c4950af7a9c8a134145df4ea)
* bpo-17188: add missing periods at the end of sentences (GH-1875) (GH-1876)Mariatta2017-05-301-2/+2
| | | (cherry picked from commit 9efad1e5aef32a6d8ca288793e8ee6df8782f615)
* bpo-30354: Update data model documentation for super() (GH-1561) (GH-1868)csabella2017-05-301-6/+6
| | | | | | | | | | | The data model section of the language reference was written well before the zero-argument form of super() was added. To avoid giving the impression that they're doing something unusual, this updates the description of `__new__` and `__init__` to use the zero-argument form. Patch by Cheryl Sabella. (cherry picked from commit 12b1c180986fc744331b8f30d3d2f49a0fdb43dd)
* bpo-17188: DOC: Document 'from None' in raise statement (GH-1671) (GH-1867)csabella2017-05-301-2/+20
| | | | Original patch by Dennis Mårtensson. (cherry picked from commit 763557eac06ba60d7c5133e4f80df8870d8f917e)
* Improve grammar in The Import System documentation (GH-1862) (GH-1863)Mariatta2017-05-301-6/+6
| | | | | Replace `an ModuleNotFoundError` with `a ModuleNotFoundError`. Replace `an path` with `a path`. (cherry picked from commit 9c972b578002cc3bbbf2ebf2856c69de892bc9e2)
* [3.6] bpo-30372: Clarify that '__builtins__' is a CPython Implementation ↵Mariatta2017-05-221-9/+9
| | | | | detail (GH-1725) (GH-1727) (cherry picked from commit 43c8a9e39bb2d4f25ed7ae17a55f34e375d1868b)
* [3.6] Fix typos in multiple `.rst` files (GH-1668) (#1702)delirious-lettuce2017-05-211-1/+1
| | | (cherry picked from commit 3378b2062c7fbb77a9b5e6d315d6b94160fac69a)
* Fix ModuleNotFoundError typo in import reference (#1610)Dominik Miedziński2017-05-171-1/+1
| | | (cherry picked from commit c138d84b8d27d338872587aae69a73d8f9d16641)