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.

classification
Title: Docs for os.lseek neglect to mention what it returns
Type: behavior Stage: patch review
Components: Documentation Versions: Python 3.2, Python 3.3, Python 2.7
process
Status: closed Resolution: fixed
Dependencies: Superseder:
Assigned To: docs@python Nosy List: docs@python, eli.bendersky, kidanger, loewis, nedbat, python-dev, rosslagerwall, till, vstinner
Priority: normal Keywords:

Created on 2011-12-05 03:26 by nedbat, last changed 2022-04-11 14:57 by admin. This issue is now closed.

Files
File name Uploaded Description Edit
patch kidanger, 2011-12-17 16:24 review
Messages (7)
msg148861 - (view) Author: Ned Batchelder (nedbat) * (Python triager) Date: 2011-12-05 03:26
The docs for os.lseek don't make any mention of its return value.  I believe it's the new offset in the file, but I'm not sure if there are other subtleties to be mentioned.
msg148863 - (view) Author: Martin v. Löwis (loewis) * (Python committer) Date: 2011-12-05 07:27
The only subtlety is that the result is the offset from the beginning, independent of the how value. It may also raise exceptions.
msg149675 - (view) Author: Jérémy Anger (kidanger) Date: 2011-12-17 16:24
Here is a patch which add the return value of lseek into the documentation.
msg149709 - (view) Author: Roundup Robot (python-dev) (Python triager) Date: 2011-12-17 22:13
New changeset 46c418d8a480 by Victor Stinner in branch '3.2':
Issue #13530: Document os.lseek() result
http://hg.python.org/cpython/rev/46c418d8a480

New changeset b05caa600c40 by Victor Stinner in branch 'default':
Issue #13530: Document os.lseek() result
http://hg.python.org/cpython/rev/b05caa600c40
msg149710 - (view) Author: STINNER Victor (vstinner) * (Python committer) Date: 2011-12-17 22:14
Thanks for the patch Jérémy.
msg213130 - (view) Author: Till Maas (till) Date: 2014-03-11 09:24
This is not fixed for Python 2.7 and 2.6.
msg213133 - (view) Author: Roundup Robot (python-dev) (Python triager) Date: 2014-03-11 09:29
New changeset 168e40af4a20 by Georg Brandl in branch '2.7':
#13530: port to 2.7 branch (document what os.lseek returns).
http://hg.python.org/cpython/rev/168e40af4a20
History
Date User Action Args
2022-04-11 14:57:24adminsetgithub: 57739
2014-03-11 09:29:13python-devsetmessages: + msg213133
2014-03-11 09:24:06tillsetnosy: + till
messages: + msg213130
2011-12-17 22:14:18vstinnersetnosy: + vstinner
messages: + msg149710
2011-12-17 22:14:09vstinnersetstatus: open -> closed
resolution: fixed
2011-12-17 22:13:52python-devsetnosy: + python-dev
messages: + msg149709
2011-12-17 16:45:53pitrousetstage: patch review
type: behavior
versions: + Python 3.3
2011-12-17 16:24:44kidangersetfiles: + patch
nosy: + kidanger
messages: + msg149675

2011-12-10 13:34:46rosslagerwallsetnosy: + rosslagerwall
2011-12-06 06:01:25eli.benderskysetnosy: + eli.bendersky
2011-12-05 07:27:55loewissetnosy: + loewis
messages: + msg148863
2011-12-05 03:26:58nedbatcreate