This issue tracker has been migrated to GitHub, and is currently read-only.
For more information, see the GitHub FAQs in the Python's Developer Guide.

Author aeros
Recipients aeros, benjamin.peterson, docs@python, pitrou, rhettinger, serhiy.storchaka, stutzbach
Date 2019-07-26.19:33:38
SpamBayes Score -1.0
Marked as misclassified Yes
Message-id <1564169618.35.0.791984234665.issue37635@roundup.psfhosted.org>
In-reply-to
Content
> I don't know. "whence" is the official name of the argument in the POSIX API

> Perhaps "from_what" is assumed to be more understandable by the average reader?

From looking at the blame on GitHub, it looks like the use of the "from_what" argument in the tutorial has been there for more than 12 years, since the last commit was a massive move of the doc tree.  The documentation for the IO module was added exactly 12 years (which included the usage of the *whence* argument rather than *from_what*) ago by birkenfield. Based on that information, I think the most likely answer is that the argument used to be *from_what* in a much older version of Python. To conform to the posix standard, it was changed to *whence*, but the tutorial was never updated.

If it was simply never updated, I think that it would be better to change it to *whence*. The difference would be more likely to confuse new users of the language, if they were to start with the tutorial and later refer to the IO module documentation. 

Also the tutorial provides a fairly in-depth explanation of the purpose of the argument within seek(), so I don't think using "from_what" as the name makes its purpose any more clear to the users.
History
Date User Action Args
2019-07-26 19:33:38aerossetrecipients: + aeros, rhettinger, pitrou, benjamin.peterson, stutzbach, docs@python, serhiy.storchaka
2019-07-26 19:33:38aerossetmessageid: <1564169618.35.0.791984234665.issue37635@roundup.psfhosted.org>
2019-07-26 19:33:38aeroslinkissue37635 messages
2019-07-26 19:33:38aeroscreate