summaryrefslogtreecommitdiffstats
path: root/Doc/tutorial
Commit message (Collapse)AuthorAgeFilesLines
* 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
|
* bpo-43319: Fixed the tutorial on venv about standard library (GH-24740)cmhzc2021-03-071-1/+1
| | | | | | | | | In the [official tutorial on virtual environment](https://docs.python.org/3/tutorial/venv.html#creating-virtual-environments) > This will create the tutorial-env directory if it doesn’t exist, and also create directories inside it containing a copy of the Python interpreter, **the standard library**, and various supporting files. According to the actual behavior of `venv` and [PEP 405](https://www.python.org/dev/peps/pep-0405/#id15)'s description about virtual environment, no standard library file is included in the virtual environment's directory. Automerge-Triggered-By: GH:vsajip
* bpo-42128: Add documentation for pattern matching (PEP 634) (#24664)Daniel F Moisset2021-03-011-0/+169
| | | | | | | | | This is a first edition, ready to go out with the implementation. We'll iterate during the rest of the period leading up to 3.10.0. Co-authored-by: Carol Willing <carolcode@willingconsulting.com> Co-authored-by: Fidget-Spinner <28750310+Fidget-Spinner@users.noreply.github.com> Co-authored-by: Brandt Bucher <brandt@python.org> Co-authored-by: Raymond Hettinger <1623689+rhettinger@users.noreply.github.com> Co-authored-by: Guido van Rossum <guido@python.org>
* bpo-43042: Augment tutorial sentence (GH-24514)Terry Jan Reedy2021-02-201-1/+2
| | | Calling same function also gets new local namespace.
* Doc: errors tutorial improvements (GH-16269)Adorilson Bezerra2021-01-311-21/+21
| | | | | | | | | | | Improvements: - Improvements in how try clause works section This suggestion is because the execution continues after *except*, not after *try* but before *except*. I guess this form more clear. - Surrounding some keywords with \*...\* For uniformity the highlighted terms - Adjust the number of chars per line to 80
* bpo-42179: Clarify exception chaining (GH-23160)Vladimir2020-12-161-4/+4
| | | | | | | | | | | | | | | | | * Update errors.rst Clarify exception chaining behaviour and give a reference to the library documentation. * Update errors.rst Wording * Update errors.rst Spelling * Update errors.rst Remove mentioning of special attributes as folks think it's too much for beginners.
* bpo-42489: Fix the signature for list.sort() in the tutorial (GH-23538)Zackery Spytz2020-11-281-1/+1
|
* bpo-17852: Doc: Fix the tutorial about closing files (GH-23135)Volker-Weissmann2020-11-271-5/+10
| | | Co-authored-by: Inada Naoki <songofacandy@gmail.com>
* bpo-42179: Doc/tutorial: Remove mention of __cause__ (GH-23162)Inada Naoki2020-11-061-9/+10
|
* [doc] Update references to NumPy (GH-22458)Andre Delfino2020-10-011-1/+1
| | | Numeric(al) Python to NumPy. It seems the old name hasn't been used for some time.
* Revert "Fix all Python Cookbook links (#22205)" (GH-22424)Andre Delfino2020-09-271-1/+1
| | | This commit reverts commit ac0333e1e117b7f61ed7ef1dbcdb6e515ada603b as the original links are working again and they provide extended features such as comments and alternative versions.
* Fix all Python Cookbook links (#22205)Andre Delfino2020-09-151-1/+1
|
* bpo-41776: Revise example of "continue" in the tutorial documentation (GH-22234)Neeraj Samtani2020-09-151-5/+5
| | | Revise example of "continue" in the tutorial documentation
* Fix grammar in Doc/tutorial/controlflow.rst (GH-21885)Denis Ovsienko2020-08-191-1/+1
| | | Automerge-Triggered-By: @csabella
* bpo-40204: Fix reference to terms in the doc (GH-21865)Victor Stinner2020-08-141-1/+1
| | | | | | | | Sphinx 3 requires to refer to terms with the exact case. For example, fix the Sphinx 3 warning: Doc/library/pkgutil.rst:71: WARNING: term Loader not found in case sensitive match.made a reference to loader instead.
* Fix repeated words in Classes tutorial (GH-21455)Paul McMillan2020-07-141-2/+2
| | | | | The phrase "At any time during execution," was repeated twice. Automerge-Triggered-By: @Mariatta
* bpo-28681: Clarify multiple function names in the tutorial (GH-21340)Joannah Nanjekye2020-07-061-5/+4
| | | | | | | | | * improve control flow docs * Add also Co-authored-by: Terry Jan Reedy <tjreedy@udel.edu> Co-authored-by: Terry Jan Reedy <tjreedy@udel.edu>
* bpo-26205: Specify the number of nested scopes (GH-21324)Joannah Nanjekye2020-07-061-2/+2
| | | | | | | | | * Clarify number of scopes * Indicate 3 or 4 Co-authored-by: Terry Jan Reedy <tjreedy@udel.edu> Co-authored-by: Terry Jan Reedy <tjreedy@udel.edu>
* Improve IO tutorial's "Old string formatting" section (GH-16251)Adorilson Bezerra2020-05-281-5/+5
| | | | | | * Use a more universal explanation of string interpolation rather than specifically referencing sprintf(), which depends on the reader having a C background. Co-authored-by: Kyle Stanley <aeros167@gmail.com>
* bpo-40552 Add 'users' variable in code sample (tutorial 4.2). (GH-19992)Antoine2020-05-231-0/+3
| | | | | | | * Add 'users' variable in code sample. * 📜🤖 Added by blurb_it. Co-authored-by: blurb-it[bot] <43283697+blurb-it[bot]@users.noreply.github.com>
* Python 3.10.0a0 (GH-20198)Pablo Galindo2020-05-193-7/+7
|
* bpo-39705 : sorted() tutorial example under looping techniques improved ↵Rahul Kumaresan2020-05-181-0/+15
| | | | (GH-18999)
* Change 'exception happened' to 'exception occurred' in two places (#19767)Noah Doersing2020-05-011-1/+1
|
* bpo-39869: Fix typo in 'Instance objects' section. (GH-18889)Antoine2020-03-101-1/+1
|
* Grammar fix in tutorial (GH-18425)Don Kirkby2020-02-101-1/+1
|
* bpo-39534: Doc: Clarify return in finally (GH-18324)Julien Palard2020-02-061-9/+27
|
* bpo-38558: Link to further docs from walrus operator mention in tutorial ↵Adorilson Bezerra2020-02-031-3/+4
| | | | (GH-16973)
* bpo-39431: Also mention nonlocal in assignment quirk (GH-17375)Shanavas M2020-01-231-4/+4
|
* bpo-38678: Improve argparse example in tutorial (GH-17207)Raymond Hettinger2019-11-181-15/+17
|
* Update interpreter.rst (GH-17059)Jules Lasne (jlasne)2019-11-051-1/+1
| | | Fixed what seemed to be a weird phrasing.
* bpo-38558: Mention `:=` in conditions tutorial (GH-16919)Ammar Askar2019-10-251-4/+4
|
* bpo-38130: Fix error in explaining when an exception is re-raised (GH-16016)Mohammad Dehghan2019-09-261-1/+1
| | | | Co-Authored-By: Ashwin Ramaswami <aramaswamis@gmail.com>
* Doc: Corrected syntax for return annotation (GH-16265)Jason Plurad2019-09-191-1/+1
| | | Signed-off-by: Jason Plurad <pluradj@us.ibm.com>
* bpo-37904: Edition on python tutorial - section 4 (GH-16169)Diego Alberto Barriga Martínez2019-09-171-2/+2
| | | | | | | | | | | A little change on first paragraph of python tutorial to be more clearly https://bugs.python.org/issue37904 Automerge-Triggered-By: @ericvsmith
* Doc: Add link of GNU Readline library to interpreter tutorial (GH-16152)Adorilson Bezerra2019-09-161-7/+8
|
* Doc: remove duplicate word in controlflow tutorial (GH-16163)Adorilson Bezerra2019-09-161-1/+1
|
* bpo-37635: Update arg name for seek() in IO tutorial (GH-16147)Kyle Stanley2019-09-141-3/+3
| | | | | | | | | | | | | | | | | | | Typically, the second positional argument for ``seek()`` is *whence*. That is the POSIX standard name (http://man7.org/linux/man-pages/man3/lseek.3p.html) and the name listed in the documentation for ``io`` module (https://docs.python.org/3/library/io.html#io.IOBase.seek). The tutorial for IO is the only location where the second positional argument for ``seek()`` is referred to as *from_what*. I suspect this was created at an early point in Python's history, and was never updated (as this section predates the GitHub repository): ``` $ git grep "from_what" Doc/tutorial/inputoutput.rst:To change the file object's position, use ``f.seek(offset, from_what)``. The position is computed Doc/tutorial/inputoutput.rst:the *from_what* argument. A *from_what* value of 0 measures from the beginning Doc/tutorial/inputoutput.rst:the reference point. *from_what* can be omitted and defaults to 0, using the ``` For consistency, I am suggesting that the tutorial be updated to use the same argument name as the IO documentation and POSIX standard for ``seek()``, particularly since this is the only location where *from_what* is being used. Note: In the POSIX standard, *whence* is technically the third positional argument, but the first argument *fildes* (file descriptor) is implicit in Python. https://bugs.python.org/issue37635
* Improve clarity of try-return-finally-return (GH-15677)toonarmycaptain2019-09-111-9/+22
| | | Clarify execution in try-return-finally-return case.
* Correct info about "f.read(size)". (GH13852)William Andrea2019-09-101-2/+2
| | | In text mode, the "size" parameter indicates the number of characters, not bytes.
* bpo-14112: Allow beginners to explore shallowness in greater depth ;-) ↵Raymond Hettinger2019-08-241-1/+2
| | | | (GH-15465)
* bpo-30826: Improve control flow examples (GH-15407)Raymond Hettinger2019-08-231-14/+14
|
* bpo-12634: Clarify an awkward section of the tutorial (GH-15406)Raymond Hettinger2019-08-231-6/+14
|
generated by cgit v0.12 at 2026-04-06 22:18:47 (GMT)