summaryrefslogtreecommitdiffstats
path: root/Doc/reference
Commit message (Collapse)AuthorAgeFilesLines
* [3.11] Add information about negative indexes to sequence datamodel doc ↵Miss Islington (bot)2024-03-251-3/+6
| | | | | | | | (GH-110903) (#117239) Co-authored by Terry Jan Reedy (cherry picked from commit c2276176d543a2fc2d57709c2787f99850fbb073) Co-authored-by: Adorilson Bezerra <adorilson@gmail.com>
* [3.11] gh-107607: Update comment about utf-8 BOM being ignored (GH-107858) ↵Miss Islington (bot)2024-03-191-4/+3
| | | | | | (#117015) (cherry picked from commit 7f64ae30ddc22577ce4101ce0b6601b3548b036f) Co-authored-by: Terry Jan Reedy tjreedy@udel.edu
* [3.11] gh-116881: Remove erroneous or redundant grammar NULL (GH-116885) ↵Miss Islington (bot)2024-03-181-1/+1
| | | | | | | | | | | (#116952) 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.11] gh-115664: Fix ordering of more versionadded and versionchanged ↵Serhiy Storchaka2024-03-072-3/+1
| | | | | | | | directives (GH-116298) (GH-116450) (GH-116452) (cherry picked from commit 1e75fe146857b5e6624bd3281675cf20cc356273) Co-authored-by: Serhiy Storchaka <storchaka@gmail.com> (cherry picked from commit 808a77612fb89b125d25efac2788522a100e8a6d)
* [3.11] gh-72971: Clarify the special no-TypeError behavior for equality ↵Miss Islington (bot)2024-03-031-1/+4
| | | | | | | (GH-110729) (#116255) (cherry picked from commit 67f742e03aacb6217c5bb496e31f96dbf31c6f86) Co-authored-by: Gouvernathor <44340603+Gouvernathor@users.noreply.github.com>
* [3.11] gh-104219: Document that idunders can return NotImplemented ↵Miss Islington (bot)2024-03-011-2/+4
| | | | | | | | | (GH-104220) (#116211) (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.11] Docs: mark up NotImplemented using the :data: role throughout the ↵Miss Islington (bot)2024-02-292-10/+10
| | | | | | | docs (GH-116135) (#116148) (cherry picked from commit dbe44f150cd161bd327ed662e527a4c93829fb3e) Co-authored-by: Erlend E. Aasland <erlend@python.org>
* [3.11] Erase some unnecessary quotes on data model doc (GH-113521) (#115897)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.11] gh-115572: Move `codeobject.replace()` docs to the data model … ↵Kirill Podoprigora2024-02-181-0/+6
| | | | | | | | | | | | | | (#115632) * [3.11] 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.11] gh-115405: add versionadded tag for co_qualname in code objects ↵Miss Islington (bot)2024-02-131-0/+2
| | | | | | | | documentation (GH-115411) (#115413) 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.11] gh-114552: Update `__dir__` method docs: it allows returning an ↵Miss Islington (bot)2024-02-101-3/+3
| | | | | | | | iterable (GH-114662) (#115235) 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.11] gh-103360: Add link in stdtypes.rst to escape sequences in ↵Miss Islington (bot)2024-02-021-0/+5
| | | | | | | | | lexical_analysis.rst (GH-103638) (#114908) (cherry picked from commit d29f57f6036353b4e705a42637177442bf7e07e5) Co-authored-by: Justin Williams <97240811+juswil@users.noreply.github.com> Co-authored-by: Terry Jan Reedy <tjreedy@udel.edu>
* [3.11] Clarify one-item tuple (GH-114745) (#114758)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.11] gh-101100: Fix sphinx warnings in `reference/import.rst` (GH-114646) ↵Nikita Sobolev2024-01-271-2/+2
| | | | (#114654)
* [3.11] gh-101100: Fix Sphinx warnings in `reference/expressions.rst` ↵Miss Islington (bot)2024-01-221-26/+26
| | | | | | (GH-114194) (#114437) Co-authored-by: Hugo van Kemenade <1324225+hugovk@users.noreply.github.com>
* [3.11] Fix the confusing "User-defined methods" reference in the datamodel ↵Miss Islington (bot)2024-01-211-1/+1
| | | | (GH-114276) (#114366)
* [3.11] gh-114070: fix token reference warnings in expressions.rst ↵Miss Islington (bot)2024-01-171-2/+3
| | | | | | (GH-114169) (#114193) Co-authored-by: Sergey B Kirpichev <skirpichev@gmail.com>
* [3.11] datamodel: Fix a typo in ``object.__init_subclass__`` (GH-111599) ↵Miss Islington (bot)2024-01-121-1/+1
| | | | | | | | (#114005) 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.11] Docs: Amend codeobject.co_lines docs; end number is exclusive ↵Miss Islington (bot)2024-01-121-3/+3
| | | | | | | | (GH-113970) (#113988) The end number should be exclusive, not inclusive. (cherry picked from commit e68806c7122070078507b370b13bb225f8501ff8) Co-authored-by: Ned Batchelder <ned@nedbatchelder.com>
* [3.11] gh-113664: Improve style of Big O notation (GH-113695) (GH-113910)Serhiy Storchaka2024-01-101-1/+1
| | | | Use cursive to make it looking like mathematic formulas. (cherry picked from commit a8629816c6c0e6770248a60529fd7c9ba08aad55)
* [3.11] Document the `co_lines` method on code objects (#113682) (#113687)Alex Waygood2024-01-031-2/+37
| | | | | (cherry-picked from commit f1f839243251fef7422c31d6a7c3c747e0b5e27c) Co-authored-by: Hugo van Kemenade <hugovk@users.noreply.github.com>
* [3.11] gh-81094: Refer to PEP 318 in compound_statements.rst (GH-113588) ↵Miss Islington (bot)2024-01-021-1/+4
| | | | | | | (#113644) Co-authored-by: John D. McDonald <43117960+Rasputin2@users.noreply.github.com> Co-authored-by: Hugo van Kemenade <hugovk@users.noreply.github.com>
* [3.11] gh-113313: Note that slice support is not required for all sequences. ↵Miss Islington (bot)2023-12-211-3/+3
| | | | (gh-113377) (gh-113383)
* [3.11] Fix typo in datamodel docs (GH-113314) (#113315)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.11] Docs: Add label to grammar spec for linking from PEPs (GH-113235) ↵Miss Islington (bot)2023-12-171-0/+2
| | | | | | (#113240) Co-authored-by: Hugo van Kemenade <hugovk@users.noreply.github.com>
* [3.11] gh-101100: Fix Sphinx nitpicks in `library/inspect.rst` and ↵Miss Islington (bot)2023-12-141-3/+3
| | | | | | | | `reference/simple_stmts.rst` (GH-113107) (#113110) 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.11] gh-101100: Improve docs on exception attributes (GH-113057) (#113062)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.11] gh-101100: Further improve docs on function attributes (#113001) ↵Alex Waygood2023-12-121-3/+4
| | | | | (#113031) (cherry-picked from commit 81a15ea74e)
* [3.11] gh-101100: Improve documentation on function attributes (#112933) ↵Alex Waygood2023-12-122-86/+105
| | | | | | (#113003) Co-authored-by: Hugo van Kemenade <hugovk@users.noreply.github.com>
* [3.11] Docs: Use 'f-strings' as header (GH-112888) (#112924)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.11] gh-101100: Improve documentation of `TracebackType` attributes ↵Miss Islington (bot)2023-12-091-21/+39
| | | | | | | | (GH-112884) (#112912) gh-101100: Improve documentation of `TracebackType` attributes (GH-112884) (cherry picked from commit 96f64a2b1b4e3d4902848c63e42717a9c5539e03) Co-authored-by: Alex Waygood <Alex.Waygood@Gmail.com>
* [3.11] gh-101100: Improve documentation for attributes on instance methods ↵Miss Islington (bot)2023-12-081-25/+52
| | | | | | | | (GH-112832) (#112873) 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.11] gh-101100: Improve documentation of code object attributes (#112781) ↵Alex Waygood2023-12-061-29/+80
| | | | | (#112817) (cherry-picked from commit e9707d3c3d)
* [3.11] gh-101100: Properly document frame object attributes (#112735) (#112775)Alex Waygood2023-12-051-25/+60
| | | | | * [3.11] gh-101100: Properly document frame object attributes (#112735) (cherry-picked from commit d109f637c0)
* [3.11] gh-101100: Fix many easily solvable Sphinx nitpicks in the datamodel ↵Miss Islington (bot)2023-12-051-26/+32
| | | | | | | | docs (GH-112737) (#112749) 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.11] gh-101100: Fix most Sphinx nitpicks in `inspect.rst` (GH-112662) ↵Miss Islington (bot)2023-12-031-0/+2
| | | | | | | | (#112667) 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.11] gh-112331: Fix reference manual description of attribute lookup ↵Miss Islington (bot)2023-11-251-6/+12
| | | | mechanics (gh-112375) (gh-112413)
* [3.11] gh-111944: Add assignment expression parentheses requirements ↵Miss Islington (bot)2023-11-131-4/+5
| | | | | | | | | | (GH-111977) (#112011) 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>
* [3.11] GH-101100: Fix reference warnings for ``__enter__`` and ``__exit__`` ↵Miss Islington (bot)2023-10-192-13/+13
| | | | | | (GH-110112) (#111076) Co-authored-by: Adam Turner <9087854+AA-Turner@users.noreply.github.com>
* [3.11] GH-101100: Fix reference warnings for ``__getitem__`` (GH-110118) ↵Miss Islington (bot)2023-10-192-4/+4
| | | | | | (#111074) Co-authored-by: Adam Turner <9087854+AA-Turner@users.noreply.github.com>
* [3.11] gh-110886 Doc: add a link to BNF Wikipedia article (GH-110887) (#110901)Miss Islington (bot)2023-10-151-1/+2
| | | | | Co-authored-by: partev <petrosyan@gmail.com> Co-authored-by: Hugo van Kemenade <hugovk@users.noreply.github.com>
* [3.11] gh-110631: Fix reST indentation in `Doc/reference` (GH-110708) (#110741)Ezio Melotti2023-10-124-76/+78
| | | | Fix wrong indentation in the Doc/reference dir.. (cherry picked from commit 41d8ec5a1bae1e5d4452da0a1a0649ace4ecb7b0)
* [3.11] gh-109634: Use :samp: role (GH-109635) (GH-109778)Serhiy Storchaka2023-09-291-42/+42
| | | | | (cherry picked from commit 92af0cc580051fd1129c7a86af2cbadeb2aa36dc) Co-authored-by: Jacob Coffee <jacob@z7x.org>
* [3.11] Datamodel: Add headings to the standard type hierarchy (GH-108146) ↵Adam Turner2023-08-251-981/+1085
| | | | | | | | | | | | (#108484) * [3.11] Datamodel: Add headings to the standard type hierarchy (GH-108146) Dedent content according to the new layout.. (cherry picked from commit 2b7bff0655a4caf51cd1a9e5bf85b3b96dd031c9) Co-authored-by: Adam Turner <9087854+AA-Turner@users.noreply.github.com> * Fix indentation
* [3.11] Docs: Datamodel: Merge "Notes on using __slots__" with the parent ↵Miss Islington (bot)2023-08-251-2/+1
| | | | | | | section (GH-108400) (#108475) (cherry picked from commit 7f5b1a06612bf1454232ac634ad4d2c845f77b37) Co-authored-by: Adam Turner <9087854+AA-Turner@users.noreply.github.com>
* [3.11] gh-101100: Sphinx warnings: pick the low hanging fruits (GH-107386) ↵Miss Islington (bot)2023-07-293-6/+6
| | | | | | | (GH-107418) (cherry picked from commit f2d07d3289947d10b065b2bb7670c8fb6b6582f2) Co-authored-by: Serhiy Storchaka <storchaka@gmail.com>
* [3.11] gh-106892: Use roles :data: and :const: for referencing module ↵Serhiy Storchaka2023-07-211-2/+2
| | | | | variables (GH-106894) (GH-106955) (cherry picked from commit d036db728ea3d54509cbad06df74e2d9a31fbec8)
* [3.11] gh-106919: Use role :c:macro: for referencing the C "constants" ↵Serhiy Storchaka2023-07-211-2/+2
| | | | | (GH-106920) (GH-106952) (cherry picked from commit fcc816dbff7ca66c26f57a506e4d2330fe41d0ff)
* [3.11] Replace the esoteric term 'datum' when describing dict comprehensions ↵Miss Islington (bot)2023-07-032-12/+12
| | | | | | | | (GH-106119) (#106349) Replace the esoteric term 'datum' when describing dict comprehensions (GH-106119) (cherry picked from commit 987b712b4aeeece336eed24fcc87a950a756c3e2) Co-authored-by: Ned Batchelder <ned@nedbatchelder.com>
* [3.11] Add single value `agen.athrow(value)` signature to the 3.11 docs ↵Federico Caselli2023-06-071-1/+2
| | | | gh-105269 (#105468)