summaryrefslogtreecommitdiffstats
path: root/Doc/tutorial
Commit message (Collapse)AuthorAgeFilesLines
* bpo-43777: Drop description of "pip search" command from tutorial (GH-25287)Miss Islington (bot)2021-04-141-13/+2
| | | | | (cherry picked from commit 133705b85cc25d1e6684d32f8943ca288fadfda0) Co-authored-by: Bob Kline <bkline@users.noreply.github.com>
* bpo-39231: correct tutorial annotations section (GH-25029)Miss Islington (bot)2021-03-271-1/+1
| | | | | (cherry picked from commit a53e9a7cf5912a44c5143e353912e44cfcfca7dc) Co-authored-by: Irit Katriel <iritkatriel@yahoo.com>
* bpo-43042: Augment tutorial sentence (GH-24514)Miss Islington (bot)2021-02-201-1/+2
| | | | | | Calling same function also gets new local namespace. (cherry picked from commit b30fcba3a8abaabd1087f2392ae8aec4c1b1f210) Co-authored-by: Terry Jan Reedy <tjreedy@udel.edu>
* bpo-42489: Fix the signature for list.sort() in the tutorial (GH-23538)Miss Islington (bot)2020-11-281-1/+1
| | | | | (cherry picked from commit d41ec65ab7411e877ca33d05e8c900feca530635) Co-authored-by: Zackery Spytz <zspytz@gmail.com>
* bpo-17852: Doc: Fix the tutorial about closing files (GH-23135)Miss Islington (bot)2020-11-271-5/+10
| | | | | | Co-authored-by: Inada Naoki <songofacandy@gmail.com> (cherry picked from commit c8aaf71dde4888864c0c351e2f935f87652c3d54) Co-authored-by: Volker-Weissmann <39418860+Volker-Weissmann@users.noreply.github.com>
* bpo-41776: Revise example of "continue" in the tutorial documentation ↵Miss Islington (bot)2020-09-151-5/+5
| | | | | | | | | | (GH-22234) (GH-22256) Revise example of "continue" in the tutorial documentation (cherry picked from commit 7bcc6456ad4704da9b287c8045768fa53961adc5) Co-authored-by: Neeraj Samtani <neerajjsamtani@gmail.com> Co-authored-by: Neeraj Samtani <neerajjsamtani@gmail.com>
* Fix grammar in Doc/tutorial/controlflow.rst (GH-21885) (#21923)Miss Islington (bot)2020-08-221-1/+1
| | | | | | | Automerge-Triggered-By: @csabella (cherry picked from commit 0be7c216e16f0d459f1c8f6209734c9b2b82fbd4) Co-authored-by: Denis Ovsienko <denis@ovsienko.info>
* bpo-40204: Allow pre-Sphinx 3 syntax in the doc (GH-21844) (GH-21901) (GH-21928)Victor Stinner2020-08-201-1/+1
| | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | * bpo-40204: Allow pre-Sphinx 3 syntax in the doc (GH-21844) Enable Sphinx 3.2 "c_allow_pre_v3" option and disable the c_warn_on_allowed_pre_v3 option to make the documentation compatible with Sphinx 2 and Sphinx 3. (cherry picked from commit 423e77d6de497931585d1883805a9e3fa4096b0b) * bpo-40204: Fix Sphinx sytanx in howto/instrumentation.rst (GH-21858) Use generic '.. object::' to declare markers, rather than abusing '.. c:function::' which fails on Sphinx 3. (cherry picked from commit 43577c01a2ab49122db696e9eaec6cb31d11cc81) * bpo-40204: Fix duplicates in the documentation (GH-21857) Fix two Sphinx 3 issues: Doc/c-api/buffer.rst:304: WARNING: Duplicate C declaration, also defined in 'c-api/buffer'. Declaration is 'PyBUF_ND'. Doc/c-api/unicode.rst:1603: WARNING: Duplicate C declaration, also defined in 'c-api/unicode'. Declaration is 'PyObject* PyUnicode_Translate(PyObject *str, PyObject *table, const char *errors)'. (cherry picked from commit 46d10b1237c67ff8347f533eda6a5468d098f7eb) * bpo-40204: Add :noindex: in the documentation (GH-21859) Add :noindex: to duplicated documentation to fix "duplicate object description" errors. For example, fix this Sphinx 3 issue: Doc/library/configparser.rst:1146: WARNING: duplicate object description of configparser.ConfigParser.optionxform, other instance in library/configparser, use :noindex: for one of them (cherry picked from commit d3ded080482beae578faa704b13534a62d066f9f) * bpo-40204, doc: Fix syntax of C variables (GH-21846) For example, fix the following Sphinx 3 errors: Doc/c-api/buffer.rst:102: WARNING: Error in declarator or parameters Invalid C declaration: Expected identifier in nested name. [error at 5] void \*obj -----^ Doc/c-api/arg.rst:130: WARNING: Unparseable C cross-reference: 'PyObject*' Invalid C declaration: Expected end of definition. [error at 8] PyObject* --------^ The modified documentation is compatible with Sphinx 2 and Sphinx 3. (cherry picked from commit 474652fe9346382dbf793f20b671eb74668bebde) * bpo-40204: Fix reference to terms in the doc (GH-21865) 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. (cherry picked from commit bb0b08540cc93e56f3f1bde1b39ce086d9e35fe1) * bpo-40204: Fix duplicated productionlist names in the doc (GH-21900) Sphinx 3 disallows having more than one productionlist markup with the same name. Simply remove names in this case, since names are not shown anyway. For example, fix the Sphinx 3 warning: Doc/reference/introduction.rst:96: duplicate token description of *:name, other instance in reference/expressions (cherry picked from commit 1abeda80f760134b4233608e2c288790f955b95a) (cherry picked from commit 8f88190af529543c84d5dc78f19abbfd73335cf4)
* Fix repeated words in Classes tutorial (GH-21455)Miss Islington (bot)2020-07-141-2/+2
| | | | | | | | The phrase "At any time during execution," was repeated twice. Automerge-Triggered-By: @Mariatta (cherry picked from commit 4f28f75deefc6e8f65694f96f1a40b0a26fc385d) Co-authored-by: Paul McMillan <paul@mcmillan.ws>
* bpo-28681: Clarify multiple function names in the tutorial (GH-21340) (GH-21344)Miss Islington (bot)2020-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> (cherry picked from commit d12af71047f0eae86440654d3ea74c032c7c3558) Co-authored-by: Joannah Nanjekye <33177550+nanjekyejoannah@users.noreply.github.com> Co-authored-by: Joannah Nanjekye <33177550+nanjekyejoannah@users.noreply.github.com>
* bpo-26205: Specify the number of nested scopes (GH-21324) (GH-21342)Miss Islington (bot)2020-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> (cherry picked from commit 9ed3cd8ba052b395ab50692bb65988b065d68e27) Co-authored-by: Joannah Nanjekye <33177550+nanjekyejoannah@users.noreply.github.com> Co-authored-by: Joannah Nanjekye <33177550+nanjekyejoannah@users.noreply.github.com>
* Improve IO tutorial's "Old string formatting" section (GH-16251)Miss Islington (bot)2020-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> (cherry picked from commit eaca2aa117d663acf8160a0b4543ee2c7006fcc7) Co-authored-by: Adorilson Bezerra <adorilson@gmail.com>
* bpo-39869: Fix typo in 'Instance objects' section. (GH-18889)Miss Islington (bot)2020-03-141-1/+1
| | | | | (cherry picked from commit e5e56328afac50aad6d8893185d8e7ba8928afe2) Co-authored-by: Antoine <43954001+awecx@users.noreply.github.com>
* Grammar fix in tutorial (GH-18425) (GH-18426)Miss Islington (bot)2020-02-101-1/+1
| | | | | | (cherry picked from commit 3ed4d251587c36c3853daf42602eaad121b59bba) Co-authored-by: Don Kirkby <donkirkby@users.noreply.github.com>
* bpo-39534: Doc: Clarify return in finally (GH-18324)Miss Islington (bot)2020-02-061-9/+27
| | | | | (cherry picked from commit 446463f8dbce0556be8020914f37089b63bb8ab6) Co-authored-by: Julien Palard <julien@palard.fr>
* bpo-38558: Link to further docs from walrus operator mention in tutorial ↵Miss Islington (bot)2020-02-031-3/+4
| | | | | | | (GH-16973) (cherry picked from commit 5807efd4c396d5718325e21f5a14e324a77ff77c) Co-authored-by: Adorilson Bezerra <adorilson@gmail.com>
* bpo-39431: Also mention nonlocal in assignment quirk (GH-17375)Miss Islington (bot)2020-01-231-4/+4
| | | | | (cherry picked from commit 7142df5ea23b4ce0efb72746b4b3b65414e8dcb1) Co-authored-by: Shanavas M <shanavas.m2@gmail.com>
* bpo-38678: Improve argparse example in tutorial (GH-17207) (GH-17212)Miss Islington (bot)2019-11-181-15/+17
| | | | | (cherry picked from commit 04c79d6088a22d467f04dbe438050c26de22fa85) Co-authored-by: Raymond Hettinger <rhettinger@users.noreply.github.com>
* [3.8] Update interpreter.rst (GH-17059) (GH-17060)Jules Lasne (jlasne)2019-11-051-1/+1
| | | | | | | Fixed what seemed to be a weird phrasing. (cherry picked from commit 5e01a6542a1beb552a17e16b71dc0ba9fc6adcfb) Co-authored-by: Jules Lasne (jlasne) <jules.lasne@gmail.com>
* bpo-38558: Mention `:=` in conditions tutorial (GH-16919)Miss Skeleton (bot)2019-10-251-4/+4
| | | | | (cherry picked from commit cb2cf06b0aad1851f54999497c1b50c381d1fdd8) Co-authored-by: Ammar Askar <ammar@ammaraskar.com>
* bpo-38130: Fix error in explaining when an exception is re-raised (GH-16016) ↵Miss Islington (bot)2019-09-261-1/+1
| | | | | | | | (GH-16415) Co-Authored-By: Ashwin Ramaswami <aramaswamis@gmail.com> (cherry picked from commit 1ad7be2f16cc9955f271f57a5089602bb41eee85) Co-authored-by: Mohammad Dehghan <md.unicorn@gmail.com>
* [3.8] bpo-38218: Doc: Corrected syntax for return annotation (GH-16265) ↵Miss Islington (bot)2019-09-191-1/+1
| | | | | | | | (GH-16274) Signed-off-by: Jason Plurad <pluradj@us.ibm.com> (cherry picked from commit 9ab6038fe843e1193d795eb58fd5931b44be5a96) Co-authored-by: Jason Plurad <pluradj@us.ibm.com>
* bpo-37904: Edition on python tutorial - section 4 (GH-16169) (GH-16234)Miss Islington (bot)2019-09-181-2/+2
| | | | | | | | | | A little change on first paragraph of python tutorial to be more clearly https://bugs.python.org/issue37904 Automerge-Triggered-By: @ericvsmith (cherry picked from commit b57481318e3e3cbacd398b898f9849ec8f2d7eec) Co-authored-by: Diego Alberto Barriga Martínez <diegobarriga@protonmail.com>
* Doc: Add link of GNU Readline library to interpreter tutorial (GH-16152) ↵Miss Islington (bot)2019-09-161-7/+8
| | | | | | | (GH-16189) (cherry picked from commit f18242be16714da2cfe013dbadfaf2e31d971562) Co-authored-by: Adorilson Bezerra <adorilson@gmail.com>
* Doc: remove duplicate word in controlflow tutorial (GH-16163)Miss Islington (bot)2019-09-161-1/+1
| | | | | (cherry picked from commit b7af4e75657e6478920d00260c48a1a3020002fc) Co-authored-by: Adorilson Bezerra <adorilson@gmail.com>
* bpo-37635: Update arg name for seek() in IO tutorial (GH-16147)Miss Islington (bot)2019-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.htmlGH-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 (cherry picked from commit ff603f6c3d3dc0e9ea8c1c51ce907c4821f42c54) Co-authored-by: Kyle Stanley <aeros167@gmail.com>
* Improve clarity of try-return-finally-return (GH-15677) (GH-15981)Miss Islington (bot)2019-09-111-9/+22
| | | | | | Clarify execution in try-return-finally-return case. (cherry picked from commit 0cc27417f2cd399c432d7dda9aeca1d81af76936) Co-authored-by: toonarmycaptain <toonarmycaptain@hotmail.com>
* Correct info about "f.read(size)". (GH13852)Miss Islington (bot)2019-09-101-2/+2
| | | | | | In text mode, the "size" parameter indicates the number of characters, not bytes. (cherry picked from commit faff81c05f838b0b7a64bbc8c53c02a9b04bb79d) Co-authored-by: William Andrea <william.j.andrea@gmail.com>
* bpo-14112: Allow beginners to explore shallowness in greater depth ;-) ↵Miss Islington (bot)2019-08-241-1/+2
| | | | | | | (GH-15465) (GH-15469) (cherry picked from commit 69ee87e99cfe0b79389cffa92d126af868baf353) Co-authored-by: Raymond Hettinger <rhettinger@users.noreply.github.com>
* bpo-30826: Improve control flow examples (GH-15407) (GH-15410)Miss Islington (bot)2019-08-231-14/+14
| | | | | (cherry picked from commit 6fcb6cfb139ade1aac6dbee0b18ca72b18cbe0d2) Co-authored-by: Raymond Hettinger <rhettinger@users.noreply.github.com>
* bpo-12634: Clarify an awkward section of the tutorial (GH-15406) (GH-15409)Miss Islington (bot)2019-08-231-6/+14
| | | | | (cherry picked from commit 483ae0cf1dcf46f8b71c4bf32419dd138e908553) Co-authored-by: Raymond Hettinger <rhettinger@users.noreply.github.com>
* bpo-14050: Note that not all data can be sorted (GH-15381) (GH-15395)Miss Islington (bot)2019-08-221-0/+7
| | | | | (cherry picked from commit 4109263a7edce11194e301138cf66fa2d07f7ce4) Co-authored-by: Raymond Hettinger <rhettinger@users.noreply.github.com>
* bpo-37726: Prefer argparse over getopt in stdlib tutorial (GH-15052) (#15070)Miss Islington (bot)2019-08-011-4/+15
| | | | | (cherry picked from commit 2491134029b195d3159a489e1803ee22a7839b41) Co-authored-by: mental <m3nta1@yahoo.com>
* Doc: Fix: Proper UpperCamelCase and lowercase. (GH-14644)Miss Islington (bot)2019-07-081-1/+1
| | | | | | Initial report by Michael Blankenship on docs@ (cherry picked from commit 2da622ff77a763327895656779370b80a833d95c) Co-authored-by: Julien Palard <julien@palard.fr>
* bpo-37403: Touch up venv docs (GH-14458)Miss Islington (bot)2019-06-281-0/+6
| | | | | | Add a versionadded for PS Core and note that `.venv` is a common virtual environment name. (cherry picked from commit f9f8e3ce709ceb15c8db8c8dde940daf1febf13d) Co-authored-by: Brett Cannon <54418+brettcannon@users.noreply.github.com>
* Improve Windows commands in tutorial (GH-14400)Steve Dower2019-06-261-6/+4
|
* 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
|
* bpo-36008: Doc update for 3.8 migration (GH-12887)Utkarsh Gupta2019-05-131-2/+2
|
* Add a footnote about Cheese Shop in Doc/tutorial (GH-13103)Adorilson Bezerra2019-05-071-1/+7
|
* bpo-36189: Fixing typo in tutorial introduction (GH-13090)Jonatan2019-05-041-1/+1
|
* closes bpo-35329: Change 'Package' to 'package' in accordance with PEP8. ↵Utkarsh Gupta2019-04-301-1/+1
| | | | (GH-13008)
* Clarify file-closing example in tutorial (GH-11652)Colin Watson2019-04-171-0/+2
|
* better __init__.py explanation in tutorial (#12763)Inada Naoki2019-04-111-3/+3
| | | | | | | | * better __init__.py explanation in tutorial * Update Doc/tutorial/modules.rst Co-Authored-By: methane <songofacandy@gmail.com>
* bpo-36377: Specify that range() can not be compared (GH-12468)Emmanuel Arias2019-04-021-12/+11
|
* Revert "Minor doc improvement (GH-10341)" (GH-12597)Raymond Hettinger2019-03-281-2/+2
| | | This reverts commit dfd775a0b1aee51d842b20cdebd97cc52c0b32e7.
* Minor doc improvement (GH-10341)Andre Delfino2019-03-271-2/+2
| | | Change "star-operator" to "* operator".
* Replace "DOS box" with link to Windows FAQ. (GH-12390)Ned Deily2019-03-241-1/+1
|
generated by cgit v0.12 at 2025-01-21 07:19:34 (GMT)