summaryrefslogtreecommitdiffstats
path: root/Doc/tutorial
Commit message (Collapse)AuthorAgeFilesLines
* 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
|
* bpo-14050: Note that not all data can be sorted (GH-15381)Raymond Hettinger2019-08-221-0/+7
|
* bpo-37826: Document exception chaining in Python tutorial for errors. (GH-15243)Abhilash Raj2019-08-141-0/+47
| | | https://bugs.python.org/issue37826
* bpo-37726: Prefer argparse over getopt in stdlib tutorial (#15052)mental2019-08-011-4/+15
|
* Doc: Fix: Proper UpperCamelCase and lowercase. (GH-14644)Julien Palard2019-07-081-1/+1
| | | Initial report by Michael Blankenship on docs@
* bpo-37403: Touch up venv docs (GH-14458)Brett Cannon2019-06-281-0/+6
| | | Add a versionadded for PS Core and note that `.venv` is a common virtual environment name.
* Improve Windows commands in tutorial (GH-14379)Steve Dower2019-06-261-6/+4
|
* bpo-37392: Update the dir(sys) in module tutorial (GH-14365)Xtreak2019-06-251-16/+20
|
* Use `python -m pip install` in porting guide and venv docs (GH-13257)Brad2019-06-211-4/+4
| | | This is to help prevent people from accidentally installing into the wrong Python interpreter if they are not aware of which Python interpreter `pip` points to.
* Bump to 3.9.0a0Ɓukasz Langa2019-06-043-6/+6
|
* bpo-29414: Change 'the for statement is such an iterator' in Tutorial (GH-273)Marco Buttu2019-06-011-10/+16
|
* bpo-36739: Update controlflow.rst (GH-12983)pbhd2019-05-291-3/+5
| | | | in addition to global-statement also mention nonlocal-statement (in the paragraph describing access to variables which are non local to a function
* bpo-36540: Documentation for PEP570 - Python positional only arguments (#13202)Pablo Galindo2019-05-281-0/+170
| | | | | | | | | | | | | | | | | | * bpo-36540: Documentation for PEP570 - Python positional only arguments * fixup! bpo-36540: Documentation for PEP570 - Python positional only arguments * Update reference for compound statements * Apply suggestions from Carol Co-Authored-By: Carol Willing <carolcode@willingconsulting.com> * Update Doc/tutorial/controlflow.rst Co-Authored-By: Carol Willing <carolcode@willingconsulting.com> * Add extra bullet point and minor edits
* Doc: Add missing forward reference in the tutorial. (GH-13499)Julien Palard2019-05-281-3/+3
|