summaryrefslogtreecommitdiffstats
path: root/Doc/reference
Commit message (Collapse)AuthorAgeFilesLines
* [3.12] Remove outdated note about instance methods from datamodel.rst ↵Miss Islington (bot)2024-07-301-8/+1
| | | | | | | | (GH-122471) (#122480) Remove outdated note about instance methods from datamodel.rst (GH-122471) (cherry picked from commit c68cb8e0c9bd75ded25578c2fba6469e55a06e93) Co-authored-by: Thomas Grainger <tagrain@gmail.com>
* [3.12] gh-121905: Consistently use "floating-point" instead of "floating ↵Serhiy Storchaka2024-07-193-21/+21
| | | | | point" (GH-121907) (GH-122013) (cherry picked from commit 1a0c7b9ba48a2dffb70bb0c7327abae1d3e87356)
* [3.12] gh-120452: improve documentation about private name mangling ↵Miss Islington (bot)2024-07-131-11/+40
| | | | | | | | | (GH-120451) (#121716) gh-120452: improve documentation about private name mangling (GH-120451) (cherry picked from commit f4d6e45c1e7161878b36ef9e876ca3e44b80a97d) Co-authored-by: Bénédikt Tran <10796600+picnixz@users.noreply.github.com> Co-authored-by: Jelle Zijlstra <jelle.zijlstra@gmail.com>
* [3.12] gh-121355: Fix incorrect word in simple_stmts.rst (GH-121356) (#121363)Miss Islington (bot)2024-07-041-1/+1
| | | | | (cherry picked from commit 715ec630dd78819ed79cad5ac28617daefe1e745) Co-authored-by: Jongbum Won <71166964+Wondaeng@users.noreply.github.com>
* [3.12] gh-114104: clarify asynchronous comprehension docs to match runtime ↵Miss Islington (bot)2024-07-011-4/+6
| | | | | | | | behavior (GH-121175) (#121235) gh-114104: clarify asynchronous comprehension docs to match runtime behavior (GH-121175) (cherry picked from commit 91313afdb392d0d6105e9aaa57b5a50112b613e7) Co-authored-by: Danny Yang <yangdanny97@users.noreply.github.com>
* [3.12] doc: Mention the missing reflected special methods for all binary ↵Miss Islington (bot)2024-06-291-7/+17
| | | | | | | | operations (GH-119931) (#120064) doc: Mention the missing reflected special methods for all binary operations (GH-119931) (cherry picked from commit bf5e1065f4ec2077c6ca352fc1ad940a76d1f6c9) Co-authored-by: Paulo Freitas <me@paulofreitas.me>
* [3.12] gh-120937: Reference weakref from the `__del__` documentation ↵Miss Islington (bot)2024-06-261-0/+2
| | | | | | | | | (GH-120940) (#121062) gh-120937: Reference weakref from the `__del__` documentation (GH-120940) (cherry picked from commit 1c13b29d54ad6d7c9e030227d575ad7d21b4054f) Co-authored-by: chaen <christophe.haen@cern.ch> Co-authored-by: Hugo van Kemenade <1324225+hugovk@users.noreply.github.com>
* [3.12] gh-120521: clarify except* documentation to allow tuples (GH-120523) ↵Miss Islington (bot)2024-06-191-9/+10
| | | | | | | | | (#120751) (cherry picked from commit 58b3f111767148e9011ccd52660e208f0c834b2a) Co-authored-by: Danny Yang <yangdanny97@users.noreply.github.com> Co-authored-by: Jelle Zijlstra <jelle.zijlstra@gmail.com> Co-authored-by: Irit Katriel <1055913+iritkatriel@users.noreply.github.com>
* [3.12] annotations: expand documentation on "simple" assignment targets ↵Miss Islington (bot)2024-06-151-2/+5
| | | | | | | | | | | | (GH-120535) (#120556) This behavior is rather surprising and it was not clearly specified. (cherry picked from commit 9e0b11eb21930b7b8e4a396200a921e9985cfca4) Co-authored-by: Jelle Zijlstra <jelle.zijlstra@gmail.com> Co-authored-by: Alex Waygood <Alex.Waygood@Gmail.com>
* [3.12] gh-100117: Fix inaccuracy in documentation of the CodeObject's ↵Miss Islington (bot)2024-05-311-1/+1
| | | | | | | | co_positions field. (GH-119364) (#119870) gh-100117: Fix inaccuracy in documentation of the CodeObject's co_positions field. (GH-119364) (cherry picked from commit 015b1fdd0ae03f94a5dfda051b020810d1c952dd) Co-authored-by: Irit Katriel <1055913+iritkatriel@users.noreply.github.com>
* [3.12] Clarifying nonlocal doc: SyntaxError is raised if nearest enclosing ↵Miss Islington (bot)2024-04-211-2/+3
| | | | | | | | | scope is global (GH-114009) (#118128) Clarifying nonlocal doc: SyntaxError is raised if nearest enclosing scope is global (GH-114009) (cherry picked from commit 1558d993166636f371c1003107ec979db6744f21) Co-authored-by: Quazi Irfan <quazirfan@gmail.com> Co-authored-by: Jelle Zijlstra <jelle.zijlstra@gmail.com>
* [3.12] Add 'The Python 2.3 Method Resolution Order' (GH-116435) (#117885)Hugo van Kemenade2024-04-151-5/+2
| | | | Co-authored-by: Hugo van Kemenade <1324225+hugovk@users.noreply.github.com>
* [3.12] Add information about negative indexes to sequence datamodel doc ↵Miss Islington (bot)2024-03-251-3/+6
| | | | | | | | (GH-110903) (#117238) Co-authored by Terry Jan Reedy (cherry picked from commit c2276176d543a2fc2d57709c2787f99850fbb073) Co-authored-by: Adorilson Bezerra <adorilson@gmail.com>
* [3.12] gh-56374: Clarify documentation of nonlocal (GH-116942) (#117023)Miss Islington (bot)2024-03-191-13/+17
| | | | | | | Define 'nonlocal scopes' in a way that excludes class scopes. Rearrange the rest of the doc. Add "Programmer's note". (cherry picked from commit 025ef7a5f7b424fba8713e448244b952bf897df3) Co-authored-by: Terry Jan Reedy <tjreedy@udel.edu>
* [3.12] gh-107607: Update comment about utf-8 BOM being ignored (GH-107858) ↵Miss Islington (bot)2024-03-191-4/+3
| | | | | | (#117016) (cherry picked from commit 7f64ae30ddc22577ce4101ce0b6601b3548b036f) Co-authored-by: Terry Jan Reedy tjreedy@udel.edu
* [3.12] gh-116881: Remove erroneous or redundant grammar NULL (GH-116885) ↵Miss Islington (bot)2024-03-181-1/+1
| | | | | | | | | | | (#116951) In Lexical Analysis f-strings section, NULL in the description of 'literal character' means '\0'. In the format_spec grammar production, it is wrong with that meaning and redundant if instead interpreted as <nothing>. Remove it there. (cherry picked from commit 4e45c6c54a9457b1ca5b4cf3aa2843b7218d4414) Co-authored-by: Terry Jan Reedy <tjreedy@udel.edu>
* [3.12] gh-115664: Fix ordering of more versionadded and versionchanged ↵Serhiy Storchaka2024-03-072-3/+1
| | | | | directives (GH-116298) (GH-116450) (cherry picked from commit 808a77612fb89b125d25efac2788522a100e8a6d)
* [3.12] gh-72971: Clarify the special no-TypeError behavior for equality ↵Miss Islington (bot)2024-03-031-1/+4
| | | | | | | (GH-110729) (#116254) (cherry picked from commit 67f742e03aacb6217c5bb496e31f96dbf31c6f86) Co-authored-by: Gouvernathor <44340603+Gouvernathor@users.noreply.github.com>
* [3.12] gh-104219: Document that idunders can return NotImplemented ↵Miss Islington (bot)2024-03-011-2/+4
| | | | | | | | | (GH-104220) (#116210) (cherry picked from commit 2713c2abc8d0f30cd0060cd307bb4ec92f1f04bf) Co-authored-by: Gouvernathor <44340603+Gouvernathor@users.noreply.github.com> Co-authored-by: C.A.M. Gerlach <CAM.Gerlach@Gerlach.CAM> Co-authored-by: Jelle Zijlstra <jelle.zijlstra@gmail.com>
* [3.12] Docs: mark up NotImplemented using the :data: role throughout the ↵Miss Islington (bot)2024-02-292-10/+10
| | | | | | | docs (GH-116135) (#116147) (cherry picked from commit dbe44f150cd161bd327ed662e527a4c93829fb3e) Co-authored-by: Erlend E. Aasland <erlend@python.org>
* [3.12] Erase some unnecessary quotes on data model doc (GH-113521) (#115896)Miss Islington (bot)2024-02-251-4/+4
| | | | | | | Thanks to Pedro Arthur Duarte (pedroarthur.jedi at gmail.com) for help with this bug. (cherry picked from commit f7455864f22369cc23bf3428624f310305cac999) Co-authored-by: Adorilson Bezerra <adorilson@gmail.com>
* [3.12] gh-115572: Move `codeobject.replace()` docs to the data model … ↵Kirill Podoprigora2024-02-181-0/+6
| | | | | | | | | | | | | | (#115633) * [3.12] gh-115572: Move `codeobject.replace()` docs to the data model (GH-115631) (cherry picked from commit 0c80da4c14d904a367968955544dd6ae58c8101c) Co-authored-by: Daler <48939169+daler-sz@users.noreply.github.com> * Remove note about copy.replace --------- Co-authored-by: Daler <48939169+daler-sz@users.noreply.github.com>
* [3.12] gh-115405: add versionadded tag for co_qualname in code objects ↵Miss Islington (bot)2024-02-131-0/+2
| | | | | | | | documentation (GH-115411) (#115412) gh-115405: add versionadded tag for co_qualname in code objects documentation (GH-115411) (cherry picked from commit de07941729b8899b187b8ef9690f9a74b2d6286b) Co-authored-by: Christophe Papazian <114495376+christophe-papazian@users.noreply.github.com>
* [3.12] gh-114552: Update `__dir__` method docs: it allows returning an ↵Miss Islington (bot)2024-02-101-3/+3
| | | | | | | | iterable (GH-114662) (#115234) gh-114552: Update `__dir__` method docs: it allows returning an iterable (GH-114662) (cherry picked from commit e19103a346f0277c44a43dfaebad9a5aa468bf1e) Co-authored-by: Nikita Sobolev <mail@sobolevn.me>
* [3.12] Clarify one-item tuple (GH-114745) (#114757)Miss Islington (bot)2024-01-301-2/+3
| | | | | | | A 'single tuple' means 'one tuple, of whatever length. Remove the unneeded and slightly distracting parenthetical 'singleton' comment. (cherry picked from commit a1332a99cf1eb9b879d4b1f28761b096b5749a0d) Co-authored-by: Terry Jan Reedy <tjreedy@udel.edu>
* [3.12] gh-101100: Fix sphinx warnings in `reference/import.rst` (GH-114646) ↵Miss Islington (bot)2024-01-271-3/+4
| | | | | | (#114652) Co-authored-by: Nikita Sobolev <mail@sobolevn.me>
* [3.12] gh-101100: Fix Sphinx warnings in `reference/expressions.rst` ↵Miss Islington (bot)2024-01-221-26/+26
| | | | | | (GH-114194) (#114436) Co-authored-by: Hugo van Kemenade <1324225+hugovk@users.noreply.github.com>
* [3.12] Fix the confusing "User-defined methods" reference in the datamodel ↵Miss Islington (bot)2024-01-211-1/+1
| | | | (GH-114276) (#114365)
* [3.12] gh-114070: fix token reference warnings in expressions.rst ↵Miss Islington (bot)2024-01-171-2/+3
| | | | | | (GH-114169) (#114192) Co-authored-by: Sergey B Kirpichev <skirpichev@gmail.com>
* [3.12] datamodel: Fix a typo in ``object.__init_subclass__`` (GH-111599) ↵Miss Islington (bot)2024-01-121-1/+1
| | | | | | | | (#114004) datamodel: Fix a typo in ``object.__init_subclass__`` (GH-111599) (cherry picked from commit a47353d587b78bb5501b21343d9bca739c49a43a) Co-authored-by: InSync <122007197+InSyncWithFoo@users.noreply.github.com>
* [3.12] Docs: Amend codeobject.co_lines docs; end number is exclusive ↵Miss Islington (bot)2024-01-121-3/+3
| | | | | | | | (GH-113970) (#113987) The end number should be exclusive, not inclusive. (cherry picked from commit e68806c7122070078507b370b13bb225f8501ff8) Co-authored-by: Ned Batchelder <ned@nedbatchelder.com>
* [3.12] gh-113664: Improve style of Big O notation (GH-113695) (GH-113909)Miss Islington (bot)2024-01-101-1/+1
| | | | | | Use cursive to make it looking like mathematic formulas. (cherry picked from commit a8629816c6c0e6770248a60529fd7c9ba08aad55) Co-authored-by: Serhiy Storchaka <storchaka@gmail.com>
* [3.12] Document the `co_lines` method on code objects (#113682) (#113686)Alex Waygood2024-01-031-2/+37
| | | | | (cherry-picked from commit f1f839243251fef7422c31d6a7c3c747e0b5e27c) Co-authored-by: Hugo van Kemenade <hugovk@users.noreply.github.com>
* [3.12] gh-81094: Refer to PEP 318 in compound_statements.rst (GH-113588) ↵Miss Islington (bot)2024-01-021-1/+4
| | | | | | | (#113643) Co-authored-by: John D. McDonald <43117960+Rasputin2@users.noreply.github.com> Co-authored-by: Hugo van Kemenade <hugovk@users.noreply.github.com>
* [3.12] gh-113313: Note that slice support is not required for all sequences. ↵Miss Islington (bot)2023-12-211-3/+3
| | | | (gh-113377) (gh-113382)
* [3.12] Fix typo in datamodel docs (GH-113314) (#113316)Miss Islington (bot)2023-12-201-1/+1
| | | | | | Fix typo in datamodel docs (GH-113314) (cherry picked from commit 5a7cc667f816f0377f763322c2367301ea3379ee) Co-authored-by: Rodrigo Girão Serrão <5621605+rodrigogiraoserrao@users.noreply.github.com>
* [3.12] Docs: Add label to grammar spec for linking from PEPs (GH-113235) ↵Miss Islington (bot)2023-12-171-0/+2
| | | | | | (#113239) Co-authored-by: Hugo van Kemenade <hugovk@users.noreply.github.com>
* [3.12] gh-101100: Fix Sphinx nitpicks in `library/inspect.rst` and ↵Miss Islington (bot)2023-12-141-3/+3
| | | | | | | | `reference/simple_stmts.rst` (GH-113107) (#113109) gh-101100: Fix Sphinx nitpicks in `library/inspect.rst` and `reference/simple_stmts.rst` (GH-113107) (cherry picked from commit 4b3cb082da82da744f5db0b7315aa80558c51557) Co-authored-by: Alex Waygood <Alex.Waygood@Gmail.com>
* [3.12] gh-101100: Improve docs on exception attributes (GH-113057) (#113061)Miss Islington (bot)2023-12-132-9/+22
| | | | | | | gh-101100: Improve docs on exception attributes (GH-113057) (cherry picked from commit d05a180350fe20d5fde56c7e525e394a0b282703) Co-authored-by: Alex Waygood <Alex.Waygood@Gmail.com>
* [3.12] gh-101100: Further improve docs on function attributes (GH-113001) ↵Miss Islington (bot)2023-12-121-3/+6
| | | | | | | | (#113030) gh-101100: Further improve docs on function attributes (GH-113001) (cherry picked from commit 81a15ea74e2607728fceb822dfcc1aabff00478a) Co-authored-by: Alex Waygood <Alex.Waygood@Gmail.com>
* [3.12] gh-101100: Improve documentation on function attributes (GH-112933) ↵Hugo van Kemenade2023-12-122-93/+111
| | | | | | | (#112974) (cherry picked from commit 4c5b9c107a1d158b245f21a1839a2bec97d05383) Co-authored-by: Alex Waygood <Alex.Waygood@Gmail.com>
* [3.12] Docs: Use 'f-strings' as header (GH-112888) (#112923)Miss Islington (bot)2023-12-101-2/+4
| | | | | | Docs: Use 'f-strings' as header (GH-112888) (cherry picked from commit 5bf7580d72259d7d64f5ee8cfc2df677de5310a4) Co-authored-by: Hugo van Kemenade <hugovk@users.noreply.github.com>
* [3.12] gh-101100: Improve documentation of `TracebackType` attributes ↵Miss Islington (bot)2023-12-091-21/+39
| | | | | | | | (GH-112884) (#112911) gh-101100: Improve documentation of `TracebackType` attributes (GH-112884) (cherry picked from commit 96f64a2b1b4e3d4902848c63e42717a9c5539e03) Co-authored-by: Alex Waygood <Alex.Waygood@Gmail.com>
* [3.12] gh-101100: Improve documentation for attributes on instance methods ↵Miss Islington (bot)2023-12-081-25/+52
| | | | | | | | (GH-112832) (#112872) gh-101100: Improve documentation for attributes on instance methods (GH-112832) (cherry picked from commit ed21d0c1f4bd17b392e24bfd83e652723dad4ddf) Co-authored-by: Alex Waygood <Alex.Waygood@Gmail.com>
* [3.12] gh-101100: Improve documentation of code object attributes (#112781) ↵Alex Waygood2023-12-061-30/+84
| | | | | (#112816) (cherry-picked from commit e9707d3c3d)
* [3.12] gh-101100: Properly document frame object attributes (GH-112735) ↵Miss Islington (bot)2023-12-051-25/+59
| | | | | | | | (#112772) gh-101100: Properly document frame object attributes (GH-112735) (cherry picked from commit d109f637c048c2b5fc95dc7fdfd50f8ac41a7747) Co-authored-by: Alex Waygood <Alex.Waygood@Gmail.com>
* [3.12] gh-101100: Fix many easily solvable Sphinx nitpicks in the datamodel ↵Miss Islington (bot)2023-12-051-26/+32
| | | | | | | | docs (GH-112737) (#112748) gh-101100: Fix many easily solvable Sphinx nitpicks in the datamodel docs (GH-112737) (cherry picked from commit 2f20cafdbfc39925f9374f36f9d53bac365ed32a) Co-authored-by: Alex Waygood <Alex.Waygood@Gmail.com>
* [3.12] gh-101100: Fix most Sphinx nitpicks in `inspect.rst` (GH-112662) ↵Miss Islington (bot)2023-12-031-0/+2
| | | | | | | | (#112666) gh-101100: Fix most Sphinx nitpicks in `inspect.rst` (GH-112662) (cherry picked from commit 45650d1c479a8b0370f126d821718dd3c502f333) Co-authored-by: Alex Waygood <Alex.Waygood@Gmail.com>
* [3.12] gh-112331: Fix reference manual description of attribute lookup ↵Miss Islington (bot)2023-11-251-6/+12
| | | | mechanics (gh-112375) (#112412)
* [3.12] gh-111944: Add assignment expression parentheses requirements ↵Miss Islington (bot)2023-11-131-4/+5
| | | | | | | | | | (GH-111977) (#112010) Augment the list of places where parentheses are required around assignnment statements. In particular, 'a := 0' and 'a = b := 1' are syntax errors. (cherry picked from commit 9a2f25d374f027f6509484d66e1c7bba03977b99) Co-authored-by: Terry Jan Reedy <tjreedy@udel.edu>