summaryrefslogtreecommitdiffstats
path: root/Doc/tutorial
Commit message (Collapse)AuthorAgeFilesLines
* [3.11] GH-97950: Use new-style index directive ('builtin') (GH-104164) (#104221)Miss Islington (bot)2023-05-062-2/+2
| | | | | | | | | | | | | | | | | | GH-97950: Use new-style index directive ('builtin') (GH-104164) * Uncomment builtin removal in pairindextypes * Use new-style index directive ('builtin') - C API * Use new-style index directive ('builtin') - Extending * Use new-style index directive ('builtin') - Library * Use new-style index directive ('builtin') - Reference * Use new-style index directive ('builtin') - Tutorial (cherry picked from commit f5088006ca8e9654fbc3de119462f0ab764e408b) Co-authored-by: Adam Turner <9087854+AA-Turner@users.noreply.github.com>
* [3.11] GH-97950: Use new-style index directive ('statement') (GH-104162) ↵Miss Islington (bot)2023-05-041-1/+1
| | | | | | (#104163) Co-authored-by: Adam Turner <9087854+AA-Turner@users.noreply.github.com>
* [3.11] GH-97950: Use new-style index directive ('object') (GH-104158) (#104159)Miss Islington (bot)2023-05-042-2/+2
| | | | | | | | | | | | | | | | GH-97950: Use new-style index directive ('object') (GH-104158) * Uncomment object removal in pairindextypes * Use new-style index directive ('object') - C API * Use new-style index directive ('object') - Library * Use new-style index directive ('object') - Reference * Use new-style index directive ('object') - Tutorial (cherry picked from commit 6ab463684b9d79880d98cd1f1406aa86af65985e) Co-authored-by: Adam Turner <9087854+AA-Turner@users.noreply.github.com>
* [3.11] GH-97950: Use new-style index directive ('module') (GH-103996) (#104154)Adam Turner2023-05-042-3/+3
|
* [doc] Fix error in tutorial example: type(exc) is the type rather than the ↵Miss Islington (bot)2023-03-221-1/+1
| | | | | | | instance (GH-102751) (cherry picked from commit 8709697292c67254ba836d7e88d1eba08c4a351a) Co-authored-by: Jens-Hilmar Bradt <17177271+jenshb@users.noreply.github.com>
* gh-102703: Fix typo in modules tutorial documentation (GH-102707)Miss Islington (bot)2023-03-151-1/+1
| | | | | | | | | **Before** This prevents directories with a common name, such as ``string``, unintentionally hiding ... **After** This prevents directories with a common name, such as ``string``, from unintentionally hiding ... (cherry picked from commit 0a539b5db312d126ff45dd4aa6a53d40a292c512) Co-authored-by: Robert Prater (B. Eng) <robcprater@gmail.com>
* [3.11] gh-102354: change python3 to python in docs examples (GH-102696) ↵Miss Islington (bot)2023-03-141-1/+1
| | | | | | | | (#102697) gh-102354: change python3 to python in docs examples (GH-102696) (cherry picked from commit 80abd62647b2a36947a11a6a8e395061be6f0c61) Co-authored-by: Paul Watson <paul.hermeneutic@gmail.com>
* docs: replace PyPI description with link (GH-101506)Miss Islington (bot)2023-02-031-2/+2
| | | | | (cherry picked from commit 45d014e03ba7ba4c9c912120ec36b2aca02061f4) Co-authored-by: François Magimel <magimel.francois@gmail.com>
* gh-100633 Tutorial: Fix dataclasses import (GH-100638)Miss Islington (bot)2022-12-311-1/+1
| | | | | | import dataclass not dataclasses from dataclasses (cherry picked from commit 98308dbeb110198ebe28bdb7720d3671b3e7f57b) Co-authored-by: Owain Davies <116417456+OTheDev@users.noreply.github.com>
* gh-55688: Add note about ending backslashes for raw strings (GH-94768)Miss Islington (bot)2022-12-281-0/+5
| | | | | | (cherry picked from commit b95b1b3b25b0a93a22c7d58ac5bd5870e62070a8) Co-authored-by: Stanley <46876382+slateny@users.noreply.github.com> Co-authored-by: hauntsaninja <hauntsaninja@gmail.com>
* gh-99908: Tutorial: Modernize the 'data-record class' example (GH-100499)Miss Islington (bot)2022-12-241-9/+15
| | | | | | (cherry picked from commit 00afa5066bd45348ed82a38d3442763b2ed1a068) Co-authored-by: JosephSBoyle <48555120+JosephSBoyle@users.noreply.github.com> Co-authored-by: Alex Waygood <Alex.Waygood@Gmail.com>
* gh-70393: Clarify mention of "middle" scope (GH-98839)Miss Islington (bot)2022-12-121-2/+2
| | | | | (cherry picked from commit 70be5e42f6e288de32e0df3c77ac22a9ddf1a74b) Co-authored-by: Shantanu <12621235+hauntsaninja@users.noreply.github.com>
* [doc] fix typo (GH-99143)Miss Islington (bot)2022-11-051-1/+1
| | | | | (cherry picked from commit 586b07e1f9f15825e6564df031744fe812b28655) Co-authored-by: Doj <34577424+visualdoj@users.noreply.github.com>
* Doc: use "unnumbered" footnotes (GH-98954)Miss Islington (bot)2022-11-011-2/+2
| | | | | | | | Use unnumbered footnote in this file to avoid reseting the footnotes numbering. Example: when building the tutorial into a PDF and using `latex_show_urls = "footnotes"`; this footnote become the number 8. However, without this change, the footnote shows the number 1. (cherry picked from commit f042646595d1cdd2ecdc15222b1766f746d010f0) Co-authored-by: Manuel Kaufmann <humitos@gmail.com>
* [3.11] Missing PS1 prompt in tutorial example (GH-98921) (GH-98944)Miss Islington (bot)2022-11-011-2/+3
| | | | | | | | (cherry picked from commit d22bde983e58eaff9773f32a8324ddf9074e95e1) Co-authored-by: Manuel Kaufmann <humitos@gmail.com> Automerge-Triggered-By: GH:rhettinger
* tutorial: remove "with single quotes" (GH-98204)Miss Islington (bot)2022-10-121-1/+1
| | | | | | | | | Closes GH-91856. On Windows double quotes are sometimes better, on Unix usually single quotes. It's not our place to explain that, so just don't. (cherry picked from commit 5f8ca1b7969f34ee09adb7b28337ebd920e6215a) Co-authored-by: Jelle Zijlstra <jelle.zijlstra@gmail.com>
* doc: remove a misleading statement. (GH-98093)Miss Islington (bot)2022-10-101-2/+2
| | | | | (cherry picked from commit 571e23d99157ed7ad67ca2334a396fc9ddbe07ec) Co-authored-by: Julien Palard <julien@palard.fr>
* [3.11] gh-97654: Add auto exception chaining example to tutorial (GH-97703) ↵Miss Islington (bot)2022-10-051-5/+23
| | | | | | | | | | (#97885) gh-97654: Add auto exception chaining example to tutorial (GH-97703) Add auto exception chaining example to tutorial (cherry picked from commit 395b66a0ae5237eec195ca97daaaf8563706ed34) Co-authored-by: Shahriar Heidrich <smheidrich@weltenfunktion.de>
* [3.11] Use SyntaxError invalid range in tutorial introduction example ↵Miss Islington (bot)2022-09-301-2/+2
| | | | | | | | | | (GH-93031) (GH-97666) Use SyntaxError invalid range in tutorial introduction example (GH-93031) Use output from a 3.10+ REPL, showing invalid range, for the SyntaxError examples in the tutorial introduction page. Co-authored-by: Eddie Hebert <eddie@eddiehebert.com>
* gh-96959: Update HTTP links which are redirected to HTTPS (GH-96961)Miss Islington (bot)2022-09-251-1/+1
| | | | | (cherry picked from commit db39050396a104c73d0da473a2f00a62f9dfdfaa) Co-authored-by: Serhiy Storchaka <storchaka@gmail.com>
* gh-81039: Add small example of f-string's "=}" to tutorial (gh-92291) (gh-96989)Miss Islington (bot)2022-09-211-1/+11
| | | | | | | (cherry picked from commit 4b81139aac3fa11779f6eedb6e621bde29e64b30) Co-authored-by: Stanley <46876382+slateny@users.noreply.github.com> Co-authored-by: Stanley <46876382+slateny@users.noreply.github.com>
* gh-95413: Remove references to deprecated CGI library (GH-95414)Miss Islington (bot)2022-08-301-1/+1
| | | | | (cherry picked from commit b17aae8bbd13bec28b7ecbb5a147503f2e9cf365) Co-authored-by: partev <petrosyan@gmail.com>
* small grammatical change (GH-96138) (GH-96157)Miss Islington (bot)2022-08-211-1/+1
|
* Doc: Add omitted secondary prompt in inputoutput tutorial (GH-30317)Miss Islington (bot)2022-07-231-1/+1
| | | | | | For the continuation lines, "..." should present as secondary prompt (cherry picked from commit de28ee8f755760fda13b481a34b1f326984d293a) Co-authored-by: Chenwei Xiao <chanvinxiao@163.com>
* Fix copy-friendliness of tutorial example (GH-93424)Miss Islington (bot)2022-07-221-0/+1
| | | | | (cherry picked from commit 34d11f1b0c0e1936a37581e0fb0daec637afca47) Co-authored-by: Chenwei Xiao <chanvinxiao@163.com>
* Docs: remove redundant "adverb-adjective" hyphens from compound modifiers ↵Miss Islington (bot)2022-07-052-2/+2
| | | | | | | | (GH-94551) (GH-94557) Discussion: https://discuss.python.org/t/slight-grammar-fix-throughout-adverbs-dont-need-hyphen/17021 (cherry picked from commit 3440d197a55800ecceea3e115e44b4262411359c) Co-authored-by: Ned Batchelder <ned@nedbatchelder.com>
* Docs: Update SyntaxError message in REPL example for list comprehension ↵Miss Islington (bot)2022-06-291-3/+3
| | | | | | | (GH-93901) (GH-94425) (cherry picked from commit 22b783aba05bcc3a21af9e5ae308ffbb98ff6a12) Co-authored-by: Cheryl Sabella <cheryl.sabella@gmail.com>
* gh-61585: Clarify import scope in modules tutorial (GH-93455) (GH-94373)Miss Islington (bot)2022-06-281-10/+11
| | | | | | | | Co-authored-by: Adam Turner <9087854+AA-Turner@users.noreply.github.com> Co-authored-by: CAM Gerlach <CAM.Gerlach@Gerlach.CAM> Co-authored-by: Stanley <46876382+slateny@users.noreply.github.com> (cherry picked from commit 4b854b746650214eddadb2440efd9e1544d08ccb)
* Closes gh-94152: Update pyvideo.org URL (GH-94075)Miss Islington (bot)2022-06-231-1/+1
| | | | | | The URL is now https://pyvideo.org, which uses HTTPS and avoids a redirect. (cherry picked from commit 7c439dca13435085efb2fddf9ac75e5305db7ada) Co-authored-by: partev <petrosyan@gmail.com>
* gh-94114: Remove obsolete reference to python.org mirrors (GH-94115)Miss Islington (bot)2022-06-221-4/+1
| | | | | | * gh-94114 (cherry picked from commit 8661c5053fbe3e246289d77e49a813470b3a16f7) Co-authored-by: partev <petrosyan@gmail.com>
* Tutorial: specify match cases don't fall through (GH-93615) (GH-94083)Miss Islington (bot)2022-06-211-2/+4
| | | | | (cherry picked from commit dd5cf84f245abf84405833320b8f25dbc43b24d2) Co-authored-by: max <36980911+pr2502@users.noreply.github.com>
* [3.11] gh-93240: clarify wording in IO tutorial (GH-93276) (GH-94082)Łukasz Langa2022-06-211-1/+1
| | | | | | Co-authored-by: Adam Turner <9087854+AA-Turner@users.noreply.github.com> (cherry picked from commit 51d673176ac90f2144e3e7a492e5b3ea53bdba2e) Co-authored-by: paulreece <96156234+paulreece@users.noreply.github.com>
* gh-89158: Add some REPL secondary prompt markers (GH-93073)Miss Islington (bot)2022-05-231-3/+3
| | | | | | | This fixes an issue on tutorial/classes.rst section 9.4 where the example "class Warehouse" was truncated when pressing the >>> button to hide the prompts and output. (cherry picked from commit 88f0d0c1e8fdda036f3f64b0048911ba28ce7f06) Co-authored-by: Nicolas Haller <nicolas@haller.im>
* gh-77521: Add link to builtin module names in modules tutorial (GH-92438)Miss Islington (bot)2022-05-081-1/+2
| | | | | | Co-authored-by: Jelle Zijlstra <jelle.zijlstra@gmail.com> (cherry picked from commit 859250cc55711f4d62b65922d3f7537826c3801e) Co-authored-by: slateny <46876382+slateny@users.noreply.github.com>
* gh-92368: Fix missing possessive apostrophe (#92397)gophra2022-05-061-1/+1
| | | * Fix missing possessive apostrophe
* gh-85679: Recommend `encoding="utf-8"` in tutorial (GH-91778)Inada Naoki2022-05-021-10/+18
|
* gh-85757: Change wording from nested to inner (GH-91811)slateny2022-04-301-1/+1
| | | | | | | | | #85757 https://docs.python.org/3/tutorial/datastructures.html#nested-list-comprehensions I do think this is clearer, but I wonder if 'nested' should be kept though to get the terminology out there more often. So perhaps it could be something like 'inner (nested) listcomp' or 'nested (inner) listcomp' despite sounding a bit redundant Automerge-Triggered-By: GH:rhettinger
* gh-89770: [PEP-678] add exception notes to tutorial (GH-30441)Irit Katriel2022-04-201-0/+64
|
* gh-91541: Fix error in example in modules tutorial (#91634)1809092022-04-171-1/+1
|
* gh-90449: Improve accuracy and readability of exceptions tutorial (GH-31899)Irit Katriel2022-04-131-46/+54
|
* bpo-22295: use python -m pip rather than plain pip in more examples (GH-24003)Ville Skyttä2022-04-091-12/+12
|
* bpo-47189: What's New in 3.11: Faster CPython (GH-32235)Ken Jin2022-04-061-0/+2
| | | | | | | Co-authored-by: Kumar Aditya <59607654+kumaraditya303@users.noreply.github.com> Co-authored-by: Jelle Zijlstra <jelle.zijlstra@gmail.com> Co-authored-by: Alex Waygood <Alex.Waygood@Gmail.com> Co-authored-by: Guido van Rossum <gvanrossum@users.noreply.github.com> Co-authored-by: Irit Katriel <1055913+iritkatriel@users.noreply.github.com>
* Follow PEP-8 guidelines in tutorial for standard library (GH-26127)Bob Kline2022-04-031-2/+3
|
* bpo-31582: Created a new documentation section describing sys.path ↵Russel Webber2022-03-231-0/+2
| | | | initialization (GH-31082)
* docs: Don't use code formatting for emphasis (GH-30519)William Andrea2022-03-081-1/+1
|
* docs: Link `match` statement in tutorial (GH-31396)William Andrea2022-02-181-1/+1
| | | | | | | | | Add a link to the `match` statement from its section in the tutorial. This should be backported to 3.10. [Initially submitted as #31395 but against the wrong branch. Thanks @Mariatta] Automerge-Triggered-By: GH:Mariatta
* [doc] Enhance readability by avoiding big blocks for small numbers. (GH-31157)Julien Palard2022-02-061-9/+3
| | | | | | Initially reported by Gregory Jacob on the docs@ mailing list: https://mail.python.org/archives/list/docs@python.org/thread/VPSFGLOZOHSPF7TGPOI65AOH25TCPSVR/
* bpo-46328: Add sys.exception() (GH-30514)Irit Katriel2022-01-131-1/+1
|
* bpo-46270: Describe the `in` and `not in` operators as membership tests. ↵Raymond Hettinger2022-01-101-4/+6
| | | | (GH-30504)
* bpo-45292: [PEP-654] exception groups and except* documentation (GH-30158)Irit Katriel2022-01-061-0/+89
|