delta/cpython-git.git/Doc/tutorial, branch fix-misc-acks

bpo-38678: Improve argparse example in tutorial (GH-17207) (GH-17213)

2019-11-18T06:17:28+00:00

(cherry picked from commit 04c79d6088a22d467f04dbe438050c26de22fa85)

Co-authored-by: Raymond Hettinger

[3.7] [3.8] Update interpreter.rst (GH-17059) (GH-17060) (GH-17061)

2019-11-05T14:02:09+00:00

Fixed what seemed to be a weird phrasing.

(cherry picked from commit 5e01a6542a1beb552a17e16b71dc0ba9fc6adcfb)

Co-authored-by: Jules Lasne (jlasne) .
(cherry picked from commit 1eac437e8da106a626efffe9fce1cb47dbf5be35)

Co-authored-by: Jules Lasne (jlasne)

bpo-38130: Fix error in explaining when an exception is re-raised (GH-16016) (GH-16416)

2019-09-26T09:15:21+00:00

Co-Authored-By: Ashwin Ramaswami 
(cherry picked from commit 1ad7be2f16cc9955f271f57a5089602bb41eee85)

Co-authored-by: Mohammad Dehghan

[3.7] bpo-38218: Doc: Corrected syntax for return annotation (GH-16265) (GH-16275)

2019-09-19T05:37:38+00:00

Signed-off-by: Jason Plurad 
(cherry picked from commit 9ab6038fe843e1193d795eb58fd5931b44be5a96)

Co-authored-by: Jason Plurad

bpo-37904: Edition on python tutorial - section 4 (GH-16169) (GH-16235)

2019-09-18T10:36:35+00:00

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

Doc: Add link of GNU Readline library to interpreter tutorial (GH-16152) (GH-16188)

2019-09-16T16:29:50+00:00

(cherry picked from commit f18242be16714da2cfe013dbadfaf2e31d971562)

Co-authored-by: Adorilson Bezerra

bpo-37635: Update arg name for seek() in IO tutorial (GH-16147)

2019-09-14T20:47:39+00:00

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

Improve clarity of try-return-finally-return (GH-15677) (GH-15982)

2019-09-11T17:42:09+00:00

Clarify execution in try-return-finally-return case.
(cherry picked from commit 0cc27417f2cd399c432d7dda9aeca1d81af76936)

Co-authored-by: toonarmycaptain

Correct info about "f.read(size)". (GH13852)

2019-09-10T16:02:40+00:00

In text mode, the "size" parameter indicates the number of characters, not bytes.
(cherry picked from commit faff81c05f838b0b7a64bbc8c53c02a9b04bb79d)

Co-authored-by: William Andrea

bpo-37726: Prefer argparse over getopt in stdlib tutorial (GH-15052) (#15069)

2019-08-01T14:35:20+00:00

(cherry picked from commit 2491134029b195d3159a489e1803ee22a7839b41)

Co-authored-by: mental