summaryrefslogtreecommitdiffstats
path: root/Doc/tutorial
Commit message (Collapse)AuthorAgeFilesLines
* gh-142411: Change documentation to reflect the new docstring adjustments in ↵decorator-factory2025-12-131-13/+10
| | | | 3.13 (#142413)
* Improve clarity in tutorial introduction (#140669)Thierry Martos2025-11-301-1/+1
|
* gh-141412: Use reliable target URL for urllib example (GH-141428)Bob Kline2025-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.
* gh-140379: add hyperlinks to list and set (GH-140399)Krishna Chaitanya2025-11-111-7/+7
| | | | add hyperlinks to list and set
* gh-139434: Update selected RFC 2822 references to RFC 5322 (#139435)Filip Łajszczak2025-11-041-1/+1
| | | | | | | | | | | | | | | | 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.
* Fix minor typo: 'web site' -> 'website' (GH-140561)commitWithTisha2025-11-042-2/+2
|
* gh-116488: Mention `dict.get` in the data structures tutorial (GH-139643)Cycloctane2025-10-061-2/+12
|
* GH-101100: Remove some entries from ``nitpick_ignore`` (#138464)Adam Turner2025-09-081-1/+1
|
* GH-138465: Improve documentation for common sequence methods (#138474)Adam Turner2025-09-053-7/+7
| | | | Co-authored-by: Serhiy Storchaka <storchaka@gmail.com>
* gh-107194: Improved language of list.index in tutorial (gh-138518)Ric2025-09-051-1/+1
|
* gh-138307: Update the Ellipsis documentation (#138306)Adorilson Bezerra2025-09-031-0/+7
| | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | * Doc: Change Ellipsis doc at library/constants * Doc: Change Ellipsis doc at library/stdtypes * Doc: Add NumPy reference into Ellipsis doc at library/stdtypes * Doc: Add Ellipsis reference into the pass statement section at tutorial * Doc: Update Ellipsis doc concerns assignments at library/constants * Update Doc/library/stdtypes.rst Co-authored-by: Stan Ulbrych <89152624+StanFromIreland@users.noreply.github.com> * Doc: Fix grammar on Ellipsis docs (library/constants.rst) Co-authored-by: Éric <merwok@netwok.org> * Doc: Fix grammar on Ellipsis docs (library/stdtypes.rst) Co-authored-by: Éric <merwok@netwok.org> * Doc: Fix grammar on Ellipsis docs (library/stdtypes.rst) Co-authored-by: Éric <merwok@netwok.org> * Doc: Remove pretty printers reference from Ellipsis doc at library/stdtypes * Doc: Update index concerns Ellipsis object and pass statement * Doc: Improve Ellipsis doc at library/constants * Doc: Improve Ellipsis doc at library/stdtypes * Doc: Change the "..." glossary entry to mention the Ellipsis object * Doc: Some improvements concern ellipsis into typing doc * Minor update Doc/tutorial/controlflow.rst Co-authored-by: Ned Batchelder <ned@nedbatchelder.com> * Update Doc/library/constants.rst Co-authored-by: Ned Batchelder <ned@nedbatchelder.com> * Update Doc/library/stdtypes.rst Co-authored-by: Ned Batchelder <ned@nedbatchelder.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>
* gh-138011: Clarify tutorial method object example code (#138014)Terry Jan Reedy2025-08-211-1/+1
| | | | | | x must be a MyClass instance for examples to work. --------- Co-authored-by: Stan Ulbrych <89152624+StanFromIreland@users.noreply.github.com>
* gh-109975: Indicate the minimum version for PyREPL in the tutorial (#136046)Konstantin Morenko2025-08-141-1/+1
|
* gh-132661: PEP 750 documentation: second pass (#137020)Adam Turner2025-08-041-5/+5
|
* gh-136843: Document how multiple inheritance works (#136844)Jelle Zijlstra2025-07-281-0/+3
| | | | Co-authored-by: Petr Viktorin <encukou@gmail.com> Co-authored-by: Akuli <akuviljanen17@gmail.com>
* gh-132661: Document t-strings and `templatelib` (#135229)Dave Peck2025-07-221-4/+5
| | | | | | | 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>
* Pedantic rewording of why relative importing doesn't work in main modules ↵Josh Cannon2025-07-211-2/+2
| | | | | (GH-136846) Pedantically reword the section about relative imports and main modules.
* Update tutorial for new "Copy" button (#135007)Stan Ulbrych2025-06-081-4/+3
| | | | Co-authored-by: Sergey B Kirpichev <skirpichev@gmail.com>
* feat(docs): type fix - apply pep8 by using docstring instead of comment in ↵Jean-Louis GUENEGO2025-06-061-2/+4
| | | | | the doc. (#135181) Giving the right example incitates the tutorial readers to do the same in the future.
* Docs: Add note to tutorial clarifying scope (#134534)Kattni2025-05-221-1/+6
| | | | | * Add note to tutorial * Update formatting
* fix indent in `controlflow.rst` docs (#134008)Yongzi Li2025-05-181-1/+1
|
* gh-133881: add forward reference to `list.sort()` in lambda expression ↵Oleg Burnaev2025-05-171-1/+2
| | | | tutorial (#133910)
* Doc: Allow translating a code block in the tutorial (#131353)Stan Ulbrych2025-05-081-0/+2
| | | | Co-authored-by: Chris Markiewicz <effigies@gmail.com> Co-authored-by: Adam Turner <9087854+AA-Turner@users.noreply.github.com>
* Python 3.15.0a0Hugo van Kemenade2025-05-073-5/+5
|
* 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)
generated by cgit v0.12 at 2026-01-16 01:05:45 (GMT)