<feed xmlns='http://www.w3.org/2005/Atom'>
<title>delta/cpython-git.git/Doc/tutorial, branch fix-namedexpr-comment</title>
<subtitle>github.com: python/cpython.git
</subtitle>
<link rel='alternate' type='text/html' href='http://git.baserock.org/cgit/delta/cpython-git.git/'/>
<entry>
<title>bpo-38678: Improve argparse example in tutorial (GH-17207)</title>
<updated>2019-11-18T06:06:19+00:00</updated>
<author>
<name>Raymond Hettinger</name>
<email>rhettinger@users.noreply.github.com</email>
</author>
<published>2019-11-18T06:06:19+00:00</published>
<link rel='alternate' type='text/html' href='http://git.baserock.org/cgit/delta/cpython-git.git/commit/?id=04c79d6088a22d467f04dbe438050c26de22fa85'/>
<id>04c79d6088a22d467f04dbe438050c26de22fa85</id>
<content type='text'>
</content>
<content type='xhtml'>
<div xmlns='http://www.w3.org/1999/xhtml'>
<pre>
</pre>
</div>
</content>
</entry>
<entry>
<title>Update interpreter.rst (GH-17059)</title>
<updated>2019-11-05T13:20:38+00:00</updated>
<author>
<name>Jules Lasne (jlasne)</name>
<email>jules.lasne@gmail.com</email>
</author>
<published>2019-11-05T13:20:38+00:00</published>
<link rel='alternate' type='text/html' href='http://git.baserock.org/cgit/delta/cpython-git.git/commit/?id=5e01a6542a1beb552a17e16b71dc0ba9fc6adcfb'/>
<id>5e01a6542a1beb552a17e16b71dc0ba9fc6adcfb</id>
<content type='text'>
Fixed what seemed to be a weird phrasing.</content>
<content type='xhtml'>
<div xmlns='http://www.w3.org/1999/xhtml'>
<pre>
Fixed what seemed to be a weird phrasing.</pre>
</div>
</content>
</entry>
<entry>
<title>bpo-38558: Mention `:=` in conditions tutorial (GH-16919)</title>
<updated>2019-10-25T22:20:05+00:00</updated>
<author>
<name>Ammar Askar</name>
<email>ammar@ammaraskar.com</email>
</author>
<published>2019-10-25T22:20:05+00:00</published>
<link rel='alternate' type='text/html' href='http://git.baserock.org/cgit/delta/cpython-git.git/commit/?id=cb2cf06b0aad1851f54999497c1b50c381d1fdd8'/>
<id>cb2cf06b0aad1851f54999497c1b50c381d1fdd8</id>
<content type='text'>
</content>
<content type='xhtml'>
<div xmlns='http://www.w3.org/1999/xhtml'>
<pre>
</pre>
</div>
</content>
</entry>
<entry>
<title>bpo-38130: Fix error in explaining when an exception is re-raised (GH-16016)</title>
<updated>2019-09-26T09:09:05+00:00</updated>
<author>
<name>Mohammad Dehghan</name>
<email>md.unicorn@gmail.com</email>
</author>
<published>2019-09-26T09:09:05+00:00</published>
<link rel='alternate' type='text/html' href='http://git.baserock.org/cgit/delta/cpython-git.git/commit/?id=1ad7be2f16cc9955f271f57a5089602bb41eee85'/>
<id>1ad7be2f16cc9955f271f57a5089602bb41eee85</id>
<content type='text'>
Co-Authored-By: Ashwin Ramaswami &lt;aramaswamis@gmail.com&gt;
</content>
<content type='xhtml'>
<div xmlns='http://www.w3.org/1999/xhtml'>
<pre>
Co-Authored-By: Ashwin Ramaswami &lt;aramaswamis@gmail.com&gt;
</pre>
</div>
</content>
</entry>
<entry>
<title>Doc: Corrected syntax for return annotation (GH-16265)</title>
<updated>2019-09-19T05:24:29+00:00</updated>
<author>
<name>Jason Plurad</name>
<email>pluradj@us.ibm.com</email>
</author>
<published>2019-09-19T05:24:29+00:00</published>
<link rel='alternate' type='text/html' href='http://git.baserock.org/cgit/delta/cpython-git.git/commit/?id=9ab6038fe843e1193d795eb58fd5931b44be5a96'/>
<id>9ab6038fe843e1193d795eb58fd5931b44be5a96</id>
<content type='text'>
Signed-off-by: Jason Plurad &lt;pluradj@us.ibm.com&gt;</content>
<content type='xhtml'>
<div xmlns='http://www.w3.org/1999/xhtml'>
<pre>
Signed-off-by: Jason Plurad &lt;pluradj@us.ibm.com&gt;</pre>
</div>
</content>
</entry>
<entry>
<title>bpo-37904: Edition on python tutorial - section 4 (GH-16169)</title>
<updated>2019-09-17T16:57:55+00:00</updated>
<author>
<name>Diego Alberto Barriga Martínez</name>
<email>diegobarriga@protonmail.com</email>
</author>
<published>2019-09-17T16:57:55+00:00</published>
<link rel='alternate' type='text/html' href='http://git.baserock.org/cgit/delta/cpython-git.git/commit/?id=b57481318e3e3cbacd398b898f9849ec8f2d7eec'/>
<id>b57481318e3e3cbacd398b898f9849ec8f2d7eec</id>
<content type='text'>
A little change on first paragraph of python tutorial to be more clearly



https://bugs.python.org/issue37904



Automerge-Triggered-By: @ericvsmith</content>
<content type='xhtml'>
<div xmlns='http://www.w3.org/1999/xhtml'>
<pre>
A little change on first paragraph of python tutorial to be more clearly



https://bugs.python.org/issue37904



Automerge-Triggered-By: @ericvsmith</pre>
</div>
</content>
</entry>
<entry>
<title>Doc: Add link of GNU Readline library to interpreter tutorial (GH-16152)</title>
<updated>2019-09-16T16:18:04+00:00</updated>
<author>
<name>Adorilson Bezerra</name>
<email>adorilson@gmail.com</email>
</author>
<published>2019-09-16T16:18:04+00:00</published>
<link rel='alternate' type='text/html' href='http://git.baserock.org/cgit/delta/cpython-git.git/commit/?id=f18242be16714da2cfe013dbadfaf2e31d971562'/>
<id>f18242be16714da2cfe013dbadfaf2e31d971562</id>
<content type='text'>
</content>
<content type='xhtml'>
<div xmlns='http://www.w3.org/1999/xhtml'>
<pre>
</pre>
</div>
</content>
</entry>
<entry>
<title>Doc: remove duplicate word in controlflow tutorial (GH-16163)</title>
<updated>2019-09-16T07:04:58+00:00</updated>
<author>
<name>Adorilson Bezerra</name>
<email>adorilson@gmail.com</email>
</author>
<published>2019-09-16T07:04:58+00:00</published>
<link rel='alternate' type='text/html' href='http://git.baserock.org/cgit/delta/cpython-git.git/commit/?id=b7af4e75657e6478920d00260c48a1a3020002fc'/>
<id>b7af4e75657e6478920d00260c48a1a3020002fc</id>
<content type='text'>
</content>
<content type='xhtml'>
<div xmlns='http://www.w3.org/1999/xhtml'>
<pre>
</pre>
</div>
</content>
</entry>
<entry>
<title>bpo-37635: Update arg name for seek() in IO tutorial (GH-16147)</title>
<updated>2019-09-14T20:29:23+00:00</updated>
<author>
<name>Kyle Stanley</name>
<email>aeros167@gmail.com</email>
</author>
<published>2019-09-14T20:29:23+00:00</published>
<link rel='alternate' type='text/html' href='http://git.baserock.org/cgit/delta/cpython-git.git/commit/?id=ff603f6c3d3dc0e9ea8c1c51ce907c4821f42c54'/>
<id>ff603f6c3d3dc0e9ea8c1c51ce907c4821f42c54</id>
<content type='text'>
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</content>
<content type='xhtml'>
<div xmlns='http://www.w3.org/1999/xhtml'>
<pre>
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</pre>
</div>
</content>
</entry>
<entry>
<title>Improve clarity of try-return-finally-return (GH-15677)</title>
<updated>2019-09-11T15:37:13+00:00</updated>
<author>
<name>toonarmycaptain</name>
<email>toonarmycaptain@hotmail.com</email>
</author>
<published>2019-09-11T15:37:13+00:00</published>
<link rel='alternate' type='text/html' href='http://git.baserock.org/cgit/delta/cpython-git.git/commit/?id=0cc27417f2cd399c432d7dda9aeca1d81af76936'/>
<id>0cc27417f2cd399c432d7dda9aeca1d81af76936</id>
<content type='text'>
Clarify execution in try-return-finally-return case.</content>
<content type='xhtml'>
<div xmlns='http://www.w3.org/1999/xhtml'>
<pre>
Clarify execution in try-return-finally-return case.</pre>
</div>
</content>
</entry>
</feed>
