summaryrefslogtreecommitdiffstats
path: root/Doc/reference
Commit message (Collapse)AuthorAgeFilesLines
* 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)
* [3.6] bpo-28315: Improve code examples in docs (GH-1372) (#1445)Mariatta2017-05-041-1/+1
| | | | | | | Replace File "<stdin>", line 1, in ? with File "<stdin>", line 1, in <module> (cherry picked from commit 8856940cf2e82cb17db2b684cd5732fe658605ca)
* [3.6] bpo-15718: Document the upper bound constrain on the __len__ return ↵Serhiy Storchaka2017-04-231-0/+9
| | | | | value. (GH-1256) (#1259) (cherry picked from commit 85157cd)
* bpo-29952: Use usual terminology of dict (GH-922)INADA Naoki2017-03-311-1/+1
| | | | s/keys and elements/keys and values/ (cherry picked from commit cdcac039fb447f2ab04efcacbe663751bb2cb4ec)
* bpo-16011: clarify that 'in' always returns a boolean value (GH-874)Mariatta2017-03-281-9/+10
| | | (cherry picked from commit 0ae7c8bd614d3aa1fcaf2d71a10ff1148c80d9b5)
* Remove an outdated statement in execution model docs (GH-754) (GH-775)Mariatta2017-03-231-6/+0
| | | (cherry picked from commit fad7f1560669af1766c583c7ef242c55d8c8de41)
* bpo-28739: Document that f-strings cannot be used as docstring (GH-592) (GH-600)Mariatta2017-03-101-0/+11
| | | (cherry picked from commit d4e89287b397c7382c12d3f3d9fd901fd8243b3c)
* bpo-26184: import.rst: Improve versionchanged note (GH-325) (GH-326)Mariatta2017-02-261-1/+1
| | | (cherry picked from commit 1f5639c77f736c18fb5a85b4a1850121e25c788e)
* bpo-26184: import.rst: Improve versionchanged note (GH-277) (#320)Mariatta2017-02-261-2/+5
| | | (cherry picked from commit 6b4a5f45e2df524174a97832571c82c76a3d424a)
* bpo-29648: import.rst: Add reference to create_module() (GH-290) (GH-314)Mariatta2017-02-261-1/+1
| | | (cherry picked from commit 46ce7599af82a929506baeaaee5c149970440c4c)
* [3.6] Fix small typos in expressions.rst (GH-276) (GH-281)Mariatta2017-02-251-2/+2
| | | (cherry picked from commit 132ac381fe7eb593e3d7c63926f90285bba13cdc)
* Issues #12067: Merge hash recommendation from 3.5Martin Panter2017-01-291-0/+4
|\
| * Issue #12067: Recommend that hash and equality be consistentMartin Panter2017-01-291-0/+4
| |
* | Issue #29012: Merge from 3.5Berker Peksag2017-01-031-5/+4
|\ \ | |/
| * Issue #29012: Remove another outdated informationBerker Peksag2017-01-031-3/+3
| | | | | | | | Patch by Jim Fasarakis-Hilliard.
* | Issue #29012: Merge from 3.5Berker Peksag2017-01-021-1/+1
|\ \ | |/
| * Issue #29012: Remove outdated information about __bases__Berker Peksag2017-01-021-1/+1
| | | | | | | | Patch by Jim Fasarakis-Hilliard.
* | Issue #28954: Merge keyword argument syntax from 3.5Martin Panter2016-12-241-1/+1
|\ \ | |/
| * Issue #28954: Add missing comma to keyword argument syntaxMartin Panter2016-12-241-1/+1
| |
* | Merge 3.5Victor Stinner2016-12-191-5/+8
|\ \ | |/
| * doc: Suggest to hash(tuple of attr) rather than XORVictor Stinner2016-12-191-5/+8
| | | | | | | | | | | | Issue #28383: __hash__ documentation recommends naive XOR to combine but this is suboptimal. Update the doc to suggest to reuse the hash() method using a tuple, with an example.
* | Issue #28091: Document PEP 525 & PEP 530.Yury Selivanov2016-12-154-4/+187
| | | | | | | | Patch by Eric Appelt.