[issue13530] Docs for os.lseek neglect to mention what it returns
New submission from Ned Batchelder <ned@nedbatchelder.com>: 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. ---------- assignee: docs@python components: Documentation messages: 148861 nosy: docs@python, nedbat priority: normal severity: normal status: open title: Docs for os.lseek neglect to mention what it returns versions: Python 2.7, Python 3.2 _______________________________________ Python tracker <report@bugs.python.org> <http://bugs.python.org/issue13530> _______________________________________
Martin v. Löwis <martin@v.loewis.de> added the comment: The only subtlety is that the result is the offset from the beginning, independent of the how value. It may also raise exceptions. ---------- nosy: +loewis _______________________________________ Python tracker <report@bugs.python.org> <http://bugs.python.org/issue13530> _______________________________________
Changes by Eli Bendersky <eliben@gmail.com>: ---------- nosy: +eli.bendersky _______________________________________ Python tracker <report@bugs.python.org> <http://bugs.python.org/issue13530> _______________________________________
Changes by Ross Lagerwall <rosslagerwall@gmail.com>: ---------- nosy: +rosslagerwall _______________________________________ Python tracker <report@bugs.python.org> <http://bugs.python.org/issue13530> _______________________________________
Jérémy Anger <kidanger@gmail.com> added the comment: Here is a patch which add the return value of lseek into the documentation. ---------- nosy: +kidanger Added file: http://bugs.python.org/file23988/patch _______________________________________ Python tracker <report@bugs.python.org> <http://bugs.python.org/issue13530> _______________________________________
Changes by Antoine Pitrou <pitrou@free.fr>: ---------- stage: -> patch review type: -> behavior versions: +Python 3.3 _______________________________________ Python tracker <report@bugs.python.org> <http://bugs.python.org/issue13530> _______________________________________
Roundup Robot <devnull@psf.upfronthosting.co.za> added the comment: 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 ---------- nosy: +python-dev _______________________________________ Python tracker <report@bugs.python.org> <http://bugs.python.org/issue13530> _______________________________________
Changes by STINNER Victor <victor.stinner@haypocalc.com>: ---------- resolution: -> fixed status: open -> closed _______________________________________ Python tracker <report@bugs.python.org> <http://bugs.python.org/issue13530> _______________________________________
STINNER Victor <victor.stinner@haypocalc.com> added the comment: Thanks for the patch Jérémy. ---------- nosy: +haypo _______________________________________ Python tracker <report@bugs.python.org> <http://bugs.python.org/issue13530> _______________________________________
Till Maas added the comment: This is not fixed for Python 2.7 and 2.6. ---------- nosy: +till _______________________________________ Python tracker <report@bugs.python.org> <http://bugs.python.org/issue13530> _______________________________________
Roundup Robot added the comment: 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 ---------- _______________________________________ Python tracker <report@bugs.python.org> <http://bugs.python.org/issue13530> _______________________________________
participants (9)
-
Antoine Pitrou -
Eli Bendersky
-
Jérémy Anger
-
Martin v. Löwis
-
Ned Batchelder
-
Ross Lagerwall
-
Roundup Robot
-
STINNER Victor
-
Till Maas