summaryrefslogtreecommitdiffstats
path: root/Doc/tutorial
Commit message (Collapse)AuthorAgeFilesLines
* 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>
* 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.10] gh-97654: Add auto exception chaining example to tutorial (GH-97703) ↵Miss Islington (bot)2022-10-051-5/+23
| | | | | | | | (#97884) Add auto exception chaining example to tutorial (cherry picked from commit 395b66a0ae5237eec195ca97daaaf8563706ed34) Co-authored-by: Shahriar Heidrich <smheidrich@weltenfunktion.de>
* [3.10] Use SyntaxError invalid range in tutorial introduction example ↵Miss Islington (bot)2022-09-301-2/+2
| | | | | | | | | | (GH-93031) (GH-97667) 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-96990)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>
* Doc: Add omitted secondary prompt in inputoutput tutorial (GH-30317) (#95159)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> 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>
* [3.10] Docs: remove redundant "adverb-adjective" hyphens from compound ↵Łukasz Langa2022-07-052-2/+2
| | | | | | | | modifiers (GH-94551) (GH-94558) 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-94426) (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-94374)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-94084)Miss Islington (bot)2022-06-211-2/+4
| | | | | (cherry picked from commit dd5cf84f245abf84405833320b8f25dbc43b24d2) Co-authored-by: max <36980911+pr2502@users.noreply.github.com>
* gh-93240: clarify wording in IO tutorial (GH-93276) (GH-94081)Miss Islington (bot)2022-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 (GH-92397)Miss Islington (bot)2022-05-061-1/+1
| | | | | | * Fix missing possessive apostrophe (cherry picked from commit a79001ee16b3ea8b5d0fad595c969d9e1b7627f3) Co-authored-by: gophra <105054704+gophra@users.noreply.github.com>
* gh-85679: Recommend `encoding="utf-8"` in tutorial (GH-91778)Miss Islington (bot)2022-05-021-10/+18
| | | | | (cherry picked from commit 614420df9796c8a4f01e24052fc0128b4c20c5bf) Co-authored-by: Inada Naoki <songofacandy@gmail.com>
* gh-91541: Fix error in example in modules tutorial (GH-91634)Miss Islington (bot)2022-04-171-1/+1
| | | | | (cherry picked from commit efbc668183400597070356a2df2fbab114a53cb3) Co-authored-by: 180909 <734461790@qq.com>
* Follow PEP-8 guidelines in tutorial for standard library (GH-26127)Miss Islington (bot)2022-04-031-2/+3
| | | | | (cherry picked from commit 6db2db91b96aaa1270c200ec931a2250fe2799c7) Co-authored-by: Bob Kline <bkline@users.noreply.github.com>
* [3.10] docs: Don't use code formatting for emphasis (GH-30519) (GH-31764)Jelle Zijlstra2022-03-081-1/+1
| | | | | (cherry picked from commit badb637c8ce91625122d5f4d71276bfe1a8ed5e9) Co-authored-by: William Andrea <william.j.andrea@gmail.com>
* docs: Link `match` statement in tutorial (GH-31396)Miss Islington (bot)2022-02-181-1/+1
| | | | | | | | | Add a link to the `match` statement from its section in the tutorial. Automerge-Triggered-By: GH:Mariatta (cherry picked from commit 35f55cc5c690a97853f1b544aac53574ab755b54) Co-authored-by: William Andrea <william.j.andrea@gmail.com>
* bpo-46270: Describe the `in` and `not in` operators as membership tests. ↵Miss Islington (bot)2022-01-101-4/+6
| | | | (GH-30504) (GH-30509)
* bpo-34538: Remove Exception subclassing from tutorial (GH-30361)Miss Islington (bot)2022-01-031-35/+1
| | | | | | | | | | Remove the bit about subclassing exceptions. Documentation PR can skip the NEWS label. Automerge-Triggered-By: GH:iritkatriel (cherry picked from commit 2db56130631255ca2eb504519430fb2f1fe789e9) Co-authored-by: Hugo van Kemenade <hugovk@users.noreply.github.com>
* bpo-46079: Replace external link that is down for maintenance. (GH-30315) ↵Miss Islington (bot)2022-01-011-6/+6
| | | | (GH-30328)
* Fix the output of built-in iter() function example in Iterators (Section ↵Miss Islington (bot)2021-12-161-1/+1
| | | | | | | | 9.8) of The Python Tutorial (GH-30110) Updated the output for it=iter(s) from <iterator object at 0x00A1DB50> to <str_iterator object at 0x10c90e650> (cherry picked from commit c5d18a5014f649368b5a4bca94e9ec7d2908b481) Co-authored-by: Vivek Vashist <vivekvashist@gmail.com>
* bpo-46059: Clarify pattern-matching example in "control flow" docs (GH-30079)Miss Islington (bot)2021-12-141-3/+5
| | | | | | | | The "Color" example in the pattern-matching section of the "control flow" documentation is not immediately runnable, leading to confusion. Co-authored-by: Ken Jin <28750310+Fidget-Spinner@users.noreply.github.com> (cherry picked from commit 1cbb88736c32ac30fd530371adf53fe7554be0a5) Co-authored-by: Alex Waygood <Alex.Waygood@Gmail.com>
* bpo-45916: Use HTTPS link for The Perils of Floating Point (GH-29896)Miss Islington (bot)2021-12-021-1/+1
| | | | | (cherry picked from commit 9f2f7e42269db74a89fc8cd74d82a875787f01d7) Co-authored-by: Zachary Ware <zach@python.org>
* Closes bpo-45712: Add missing word in control flow tutorial (GH-29460)Miss Islington (bot)2021-11-081-1/+1
| | | | | (cherry picked from commit 7484a5c82a2dfc106bb1e4b060cad2df00521bfd) Co-authored-by: 180909 <734461790@qq.com>
* bpo-34451: Document prompt and output toggle feature in html tutorial ↵Miss Islington (bot)2021-10-211-0/+7
| | | | | | | (GH-27105) (GH-29119) (cherry picked from commit 5a14f71fe869d4a62dcdeb9a8fbbb5884c75060c) Co-authored-by: Thomas <thmsdnnr@gmail.com>
* bpo-38623: Add note about site module (site-packages) (GH-16974) (GH-28536)Miss Islington (bot)2021-09-231-1/+2
| | | | | (cherry picked from commit 55b45bf707c6c8084db259fe2f8aa08e84ea0d99) Co-authored-by: Peter Bittner <django@bittner.it>
* bpo-41203: Replace Mac OS X and OS X with macOS (GH-28515) (GH-28523)Miss Islington (bot)2021-09-231-1/+1
| | | | | | | | | | Replace old names when they refer to actual versions of macOS. Keep historical names in references to older versions. Co-authored-by: Patrick Reader <_@pxeger.com> (cherry picked from commit 36122e18148c5b6c78ebce1d36d514fd7cf250f5) Co-authored-by: Serhiy Storchaka <storchaka@gmail.com>
* bpo-39452: Rewrite and expand __main__.rst (GH-26883)Miss Islington (bot)2021-08-241-0/+2
| | | | | | | | | | Broadened scope of the document to explicitly discuss and differentiate between ``__main__.py`` in packages versus the ``__name__ == '__main__'`` expression (and the idioms that surround it), as well as ``import __main__``. Co-authored-by: Géry Ogam <gery.ogam@gmail.com> Co-authored-by: Éric Araujo <merwok@netwok.org> Co-authored-by: Łukasz Langa <lukasz@langa.pl> (cherry picked from commit 7cba23164cf82f6619db002cd30021b5dfb1f809) Co-authored-by: Jack DeVries <58614260+jdevries3133@users.noreply.github.com>
* bpo-44966: Fix out-of-date traceback message (GH-27867)Miss Islington (bot)2021-08-221-1/+1
| | | | | (cherry picked from commit 15a64d89a31b7e91f0361c305b7b27d8761db93d) Co-authored-by: Raymond Hettinger <rhettinger@users.noreply.github.com>
* introduce omitted index default before using it (GH-27775) (GH-27802)Miss Islington (bot)2021-08-171-8/+8
| | | | | (cherry picked from commit 599f5c8481ca258ca3a5d13eaee7d07a9103b5f2) Co-authored-by: Jefferson Oliveira <jefferson.dev.insights@gmail.com>
* bpo-44907: Update error messages in tutorial examples (GH-27755)Miss Islington (bot)2021-08-141-3/+3
| | | | | | (cherry picked from commit ed524b4569b1e4a166886c880018418d46284378) Co-authored-by: meowmeowmeowcat <meowmeowcat1211@gmail.com>
* bpo-41576: document BaseException in favor of bare except (GH-21917)Miss Islington (bot)2021-08-061-8/+9
| | | | | (cherry picked from commit e9a6f1b78bf57d9f3f99547bd007d7cfc9724cfb) Co-authored-by: Thomas Grainger <tagrain@gmail.com>
* bpo-44740: Lowercase "internet" and "web" where appropriate. (GH-27378) ↵Miss Islington (bot)2021-07-263-4/+4
| | | | | | | | (GH-27380) Co-authored-by: Łukasz Langa <lukasz@langa.pl> (cherry picked from commit 11749e2dc20ad6a76e9a39e948853e89b2b4bbed) Co-authored-by: Mariusz Felisiak <felisiak.mariusz@gmail.com>
* bpo-40620: Clarify tutorial controlflow.rst ``range`` examples (GH-26919) ↵Miss Islington (bot)2021-06-271-14/+8
| | | | | | | | (GH-26927) (cherry picked from commit 2f49c9debc2efe010c757be3bdbd6493f1ebc5f6) Co-authored-by: jdevries3133 <58614260+jdevries3133@users.noreply.github.com>
* bpo-43927: Change 'IOError' to 'OSError' (GH-26289)Miss Islington (bot)2021-05-211-1/+1
| | | | | | This is the last remaining instance, at least for this chapter, in 3.10 & 3.11. (cherry picked from commit 2f47d8dcc735234bf9c7f92fbdacd8c5a6ee7761) Co-authored-by: Terry Jan Reedy <tjreedy@udel.edu>
* bpo-35765: Clarify references to "object x" in the JSON tutorial (GH-22411) ↵Miss Islington (bot)2021-05-191-1/+2
| | | | | | | | (GH-26218) (cherry picked from commit 4fdcc39f711e1b586a94e2c5088fdd7e78fd9f58) Co-authored-by: Zackery Spytz <zspytz@gmail.com>
* bpo-43729: Clarify comment in tutorial example (GH-25191) (#26136)Miss Islington (bot)2021-05-141-1/+1
| | | | | | | (cherry picked from commit 07797121cc290ede0b3d3cf02068f3d993cddd15) Co-authored-by: Erlend Egeberg Aasland <erlend.aasland@innova.no> Co-authored-by: Erlend Egeberg Aasland <erlend.aasland@innova.no>
* bpo-40640: doc -- add missing ... in example of Continue (GH-26055) (GH-26057)Miss Islington (bot)2021-05-121-0/+1
| | | | | | | Co-authored-by: Chas Belov <59780179+ChasBelov@users.noreply.github.com> (cherry picked from commit 6574334a68aa324394a6fd1f855ecbad20432b1e) Co-authored-by: Irit Katriel <iritkatriel@yahoo.com>
* bpo-32822: Add finally with return/break/continue to the tutorial (GH-25600) ↵Miss Islington (bot)2021-05-041-0/+4
| | | | | | | | | | (#25893) This documents in the tutorial docs the behavior of a finally clause in case it should re-raise an exception but contains a return/break/continue statement. (cherry picked from commit a0b9915a8be98427432e13d8eb2207a8b9824179) Co-authored-by: Roberto Hueso <robertohueso96@gmail.com>
* bpo-42589: Change URL for 'from' link when used in a raised exception (GH-23872)sblondon2021-04-291-1/+1
| | | | | Links for 'raise Exception from x' target to 'The raise statement' (7.8) section instead of 'The import statement' (7.11) section. There are more modified links than in the bug report because I searched some other ones which can get the same improvement.
* bpo-43777: Drop description of "pip search" command from tutorial (GH-25287)Bob Kline2021-04-141-13/+2
|
* bpo-43325: Add FAQ entry for identity tests (GH-25168)Raymond Hettinger2021-04-041-3/+2
|
* bpo-39231: correct tutorial annotations section (GH-25029)Irit Katriel2021-03-271-1/+1
|
generated by cgit v0.12 at 2025-09-03 21:22:18 (GMT)