summaryrefslogtreecommitdiffstats
path: root/Doc/tutorial
Commit message (Collapse)AuthorAgeFilesLines
* [3.14] Improve clarity in tutorial introduction (GH-140669) (#142112)Miss Islington (bot)2025-11-301-1/+1
| | | | Co-authored-by: Thierry Martos <81799048+ThierryMT@users.noreply.github.com>
* [3.14] gh-141412: Use reliable target URL for urllib example (GH-141474)Miss Islington (bot)2025-11-121-3/+3
| | | | | | | | The endpoint used for demonstrating reading URLs is no longer stable. This change substitutes a target over which we have more control. (cherry picked from commit fbcac799518e0cb29fcf5f84ed1fa001010b9073) Co-authored-by: Bob Kline <bkline@users.noreply.github.com>
* [3.14] gh-140379: add hyperlinks to list and set (GH-140399) (#141386)Miss Islington (bot)2025-11-111-7/+7
| | | | | | | | gh-140379: add hyperlinks to list and set (GH-140399) add hyperlinks to list and set (cherry picked from commit 92741c59f89e114474bdb2cb539107ef6bae0b9c) Co-authored-by: Krishna Chaitanya <141550576+XChaitanyaX@users.noreply.github.com>
* [3.14] gh-139434: Update selected RFC 2822 references to RFC 5322 ↵Filip Łajszczak2025-11-041-1/+1
| | | | | | | | | | | | | | | | | | | (GH-139435) (#141025) Update selected RFC 2822 references to RFC 5322 RFC 2822 was obsoleted by RFC 5322 in 2008. This updates references to use the current standard in documentation, docstrings, and comments. It preserves RFC 2822 references in legacy API components to maintain their historical context. RFC 822 → RFC 2822 → RFC 5322 progression is explained where relevant. In some places specific sections of RFC are referenced where it seems helpful. Scout rule was applied in some places and RFC mentions format was normalized in doc strings and comments. (cherry picked from commit ce1bb85d286130f44b7e874430b0b12990d61dc1)
* [3.14] Fix minor typo: 'web site' -> 'website' (GH-140561) (GH-140976)Miss Islington (bot)2025-11-042-2/+2
| | | | | (cherry picked from commit 08115d241a724a4769599993f654f77abcdebf5a) Co-authored-by: commitWithTisha <tishaa1010@gmail.com>
* [3.14] gh-116488: Mention `dict.get` in the data structures tutorial ↵Miss Islington (bot)2025-10-061-2/+12
| | | | | | (GH-139643) (#139655) Co-authored-by: Cycloctane <Cycloctane@outlook.com>
* [3.14] gh-138307: Update the Ellipsis documentation (GH-138306) (#138440)Miss Islington (bot)2025-09-111-0/+7
| | | | | | | Co-authored-by: Adorilson Bezerra <adorilson@gmail.com> Co-authored-by: Stan Ulbrych <89152624+StanFromIreland@users.noreply.github.com> Co-authored-by: Éric <merwok@netwok.org> Co-authored-by: Ned Batchelder <ned@nedbatchelder.com>
* [3.14] GH-101100: Remove some entries from ``nitpick_ignore`` (GH-138464) ↵Miss Islington (bot)2025-09-091-1/+1
| | | | | | | | | | | | | | (#138683) * GH-101100: Remove some entries from ``nitpick_ignore`` (GH-138464) (cherry picked from commit 22cb9ba8f90bfbc0b8831365b6864f41b19d0b6e) Co-authored-by: Adam Turner <9087854+AA-Turner@users.noreply.github.com> * Update check-warnings.py --------- Co-authored-by: Adam Turner <9087854+AA-Turner@users.noreply.github.com>
* [3.14] GH-138465: Improve documentation for common sequence methods ↵Miss Islington (bot)2025-09-063-7/+7
| | | | | | | | | (GH-138474) (#138560) GH-138465: Improve documentation for common sequence methods (GH-138474) (cherry picked from commit 8ed1d53e62aa9acb9a0674f479cfe4d06622b911) Co-authored-by: Adam Turner <9087854+AA-Turner@users.noreply.github.com> Co-authored-by: Serhiy Storchaka <storchaka@gmail.com>
* [3.14] gh-107194: Improved language of list.index in tutorial (gh-138518) ↵Miss Islington (bot)2025-09-051-1/+1
| | | | | | | | (#138527) gh-107194: Improved language of list.index in tutorial (gh-138518) (cherry picked from commit f19f1d8563fb3abbb673812f16e2be5f10af42e4) Co-authored-by: Ric <11750904+ricsatjr@users.noreply.github.com>
* [3.14] gh-138011: Clarify tutorial method object example code (GH-138014) ↵Miss Islington (bot)2025-08-271-1/+1
| | | | | | (#138025) Co-authored-by: Terry Jan Reedy <tjreedy@udel.edu>
* [3.14] gh-132661: PEP 750 documentation: second pass (GH-137020) (#137392)Miss Islington (bot)2025-08-161-5/+5
| | | | | | gh-132661: PEP 750 documentation: second pass (GH-137020) (cherry picked from commit 4dae9b1ff16feae03bddb57ec3be5c42de14b1d2) Co-authored-by: Adam Turner <9087854+AA-Turner@users.noreply.github.com>
* [3.14] gh-109975: Indicate the minimum version for PyREPL in the tutorial ↵Miss Islington (bot)2025-08-151-1/+1
| | | | | | (GH-136046) (#137766) Co-authored-by: Konstantin Morenko <konstantin-morenko@users.noreply.github.com>
* [3.14] gh-132661: Document t-strings and `templatelib` (GH-135229) (#136974)Miss Islington (bot)2025-07-221-4/+5
| | | | | | | | | Co-authored-by: Dave Peck <davepeck@gmail.com> Co-authored-by: Petr Viktorin <encukou@gmail.com> Co-authored-by: Hugo van Kemenade <1324225+hugovk@users.noreply.github.com> Co-authored-by: Loïc Simon <loic.pano@gmail.com> Co-authored-by: pauleveritt <pauleveritt@me.com> Co-authored-by: Lysandros Nikolaou <lisandrosnik@gmail.com>
* [3.14] Pedantic rewording of why relative importing doesn't work in main ↵Miss Islington (bot)2025-07-211-2/+2
| | | | | | | | | | modules (GH-136846) (#136940) Pedantic rewording of why relative importing doesn't work in main modules (GH-136846) Pedantically reword the section about relative imports and main modules. (cherry picked from commit 4b68289ca6954b8d135e2ee2344e67fae38239fd) Co-authored-by: Josh Cannon <joshdcannon@gmail.com>
* [3.14] Update tutorial for new "Copy" button (GH-135007) (#135270)Miss Islington (bot)2025-06-081-4/+3
| | | | | Co-authored-by: Stan Ulbrych <89152624+StanFromIreland@users.noreply.github.com> Co-authored-by: Sergey B Kirpichev <skirpichev@gmail.com>
* [3.14] feat(docs): type fix - apply pep8 by using docstring instead of ↵Miss Islington (bot)2025-06-061-2/+4
| | | | | | | | | | comment in the doc. (GH-135181) (#135212) feat(docs): type fix - apply pep8 by using docstring instead of comment in the doc. (GH-135181) Giving the right example incitates the tutorial readers to do the same in the future. (cherry picked from commit 343182853f19a42c0ba8980d3104076a8c7bcfe7) Co-authored-by: Jean-Louis GUENEGO <jlguenego@gmail.com>
* [3.14] Docs: Add note to tutorial clarifying scope (GH-134534) (#134536)Miss Islington (bot)2025-05-221-1/+6
| | | | | | | | | | Docs: Add note to tutorial clarifying scope (GH-134534) * Add note to tutorial * Update formatting (cherry picked from commit 742d5b5c5d75eae44c66a43ebfa24a4f286ea8a1) Co-authored-by: Kattni <kattni@kattni.com>
* [3.14] fix indent in `controlflow.rst` docs (GH-134008) (#134184)Miss Islington (bot)2025-05-181-1/+1
| | | | | | fix indent in `controlflow.rst` docs (GH-134008) (cherry picked from commit 4ce91871a9077fcf8806d6fd79bdb32af9587306) Co-authored-by: Yongzi Li <1538321957@qq.com>
* [3.14] gh-133881: add forward reference to `list.sort()` in lambda ↵Miss Islington (bot)2025-05-171-1/+2
| | | | | | | | expression tutorial (GH-133910) (#134126) gh-133881: add forward reference to `list.sort()` in lambda expression tutorial (GH-133910) (cherry picked from commit c1c9ad1d5a62a591eb2f0f0d29f3fa02e0949f14) Co-authored-by: Oleg Burnaev <51371645+Shepard2154@users.noreply.github.com>
* [3.14] Doc: Allow translating a code block in the tutorial (GH-131353) (#133648)Miss Islington (bot)2025-05-081-0/+2
| | | | | | | | Doc: Allow translating a code block in the tutorial (GH-131353) (cherry picked from commit 3224b99872d8ed030181e5d009ea64e8672a68ee) Co-authored-by: Stan Ulbrych <89152624+StanFromIreland@users.noreply.github.com> Co-authored-by: Chris Markiewicz <effigies@gmail.com> Co-authored-by: Adam Turner <9087854+AA-Turner@users.noreply.github.com>
* gh-130080: implement PEP 765 (#130087)Irit Katriel2025-03-171-2/+6
|
* gh-116666: Add "token" glossary term (GH-130888)Petr Viktorin2025-03-172-9/+10
| | | | | | | | | Add glossary entry for `token`, and link to it. Avoid talking about tokens in the SyntaxError intro (errors.rst); at this point tokenization is too much of a technical detail. (Even to an advanced reader, the fact that a *single* token is highlighted isn't too relevant. Also, we don't need to guarantee that it's a single token.) Co-authored-by: Adam Turner <9087854+AA-Turner@users.noreply.github.com>
* GH-130153: Reword the wildcard matching part of the tutorial (GH-129954)Tshepang Mbambo2025-03-051-2/+3
|
* gh-122876: Fix "End of lines" typo (#125310)za2025-02-191-1/+1
| | | | Co-authored-by: Hugo van Kemenade <1324225+hugovk@users.noreply.github.com>
* Python Tutorial typo fix (#128077)shallow-beach2024-12-201-1/+1
|
* gh-101100: amend references starting with `!~` in gh-127054 (#127684)Yuki Kobayashi2024-12-061-5/+5
|
* gh-101100: Fix Sphinx warnings about list methods (#127054)Yuki Kobayashi2024-12-021-5/+5
|
* gh-127265: Remove single quotes from 'arrow's in tutorial/errors.rst (GH-127267)funkyrailroad2024-11-251-1/+1
|
* gh-85583: Add f-string index in tutorial/inputoutput.rst (GH-21681)amaajemyfren2024-10-301-0/+7
| | | | | | | | | | | | * bpo-41411 fstring index in tutorial/inputoutput To assist in searching for fstrings I have added an index * Add newline --------- Co-authored-by: Adam Turner <9087854+AA-Turner@users.noreply.github.com> Co-authored-by: Carol Willing <carolcode@willingconsulting.com>
* docs: restore an anchor to for/else (#126154)Ned Batchelder2024-10-301-0/+1
|
* Fix a typo in ``Doc/tutorial/errors.rst`` exception output (#126001)Bogdana Vereha2024-10-261-1/+1
|
* gh-125615: Fix grammar nit in tutorial's interactive interpreter appendix ↵Cornelius Roemer2024-10-161-1/+1
| | | | | (GH-125617) Replace "without ... nor" with "with neither ... nor"
* gh-125403: fix console formatting in Chapter 12 of the tutorial (#125404)partev2024-10-131-8/+8
|
* gh-125383: Update `fib` function comment for accuracy (#125386)Wulian2024-10-131-2/+2
| | | `Doc/tutorial/controlflow.rst`: fix comment for `fib` function
* Prefer "similar" over "equivalent" in tutorial (#125343)Stephen Rosen2024-10-121-4/+4
| | | | | | | | | | | In the datastructures tutorial doc, some operations are described as "equivalent to" others. This has led to some user-confusion -- at least in the Discourse forums -- about cases in which the operations differ. This change doesn't systematically eliminate the word "equivalent" from the tutorial. It just substitutes "similar to" in several cases in which "equivalent to" could mislead users into expecting exact equivalence.
* Doc: Fix a typo in "Function Examples" in the control-flow tutorial (#125338)Rafael Fontenelle2024-10-121-1/+1
|
* gh-101100: Consolidate documentation on `ModuleType` attributes (#124709)Alex Waygood2024-10-091-2/+3
| | | | | | Co-authored-by: Hugo van Kemenade <1324225+hugovk@users.noreply.github.com> Co-authored-by: Barry Warsaw <barry@python.org> Co-authored-by: Jelle Zijlstra <jelle.zijlstra@gmail.com>
* Docs: make a tutorial example more precise (#125066)Ned Batchelder2024-10-071-11/+9
| | | | | Based on discussion here: https://discuss.python.org/t/omission-in-the-documentation/66816
* Docs: for for/else clarify that return or raise also skip the else (#124591)Ned Batchelder2024-09-271-2/+4
| | | Co-authored-by: Jelle Zijlstra <jelle.zijlstra@gmail.com>
* For-else deserves its own section in the tutorial (#123946)Ned Batchelder2024-09-251-31/+54
| | | | | | | | | | | | | * For-else deserves its own section in the tutorial * remove mention of unrolling the loop * Update Doc/tutorial/controlflow.rst Co-authored-by: Jelle Zijlstra <jelle.zijlstra@gmail.com> --------- Co-authored-by: Jelle Zijlstra <jelle.zijlstra@gmail.com>
* gh-101100: Add a table of class attributes to the "Custom classes" section ↵Alex Waygood2024-09-251-3/+3
| | | | of the data model docs (#124480)
* Update to 3.13 the output of exceptions raised (#123888)Rafael Fontenelle2024-09-131-3/+42
|
* gh-123492: Remove unnecessary `:func:` parentheses (#123493)Wei-Hsiang (Matt) Wang2024-08-301-1/+1
|
* GH-109975: Copyedit 3.13 What's New: New Features (#122990)Adam Turner2024-08-151-2/+2
| | | | Co-authored-by: Hugo van Kemenade <1324225+hugovk@users.noreply.github.com> Co-authored-by: Brandt Bucher <brandtbucher@gmail.com>
* gh-122944: Fix incorrect prompt strings in the Python Tutorial (#122949)Damien2024-08-124-10/+10
| | | | In the REPL, top level comments are followed by a primary, not secondary prompt. Fix the places in the in the tutorial that use the latter.
* gh-121905: Consistently use "floating-point" instead of "floating point" ↵Serhiy Storchaka2024-07-194-9/+9
| | | | (GH-121907)
* gh-120452: improve documentation about private name mangling (#120451)Bénédikt Tran2024-07-131-0/+5
| | | Co-authored-by: Jelle Zijlstra <jelle.zijlstra@gmail.com>
* gh-120345: Fix incorrect use of the :class: role with the "()" suffix ↵Serhiy Storchaka2024-06-121-2/+2
| | | | | | | (GH-120347) * Remove "()" when refer to a class as a type. * Use :func: when refer to a callable. * Fix reference to the datetime.astimezone() method.
* gh-110383: Improve 'old string formatting' text in tutorial (#120219)Erlend E. Aasland2024-06-071-3/+5
|
generated by cgit v0.12 at 2026-04-04 20:37:27 (GMT)