[Python-checkins] cpython (merge 3.2 -> default): Issue #13530: Document os.lseek() result

[victor.stinner]

http://hg.python.org/cpython/rev/b05caa600c40
changeset:   74019:b05caa600c40
parent:      74017:cc2af102c73b
parent:      74018:46c418d8a480
user:        Victor Stinner <victor.stinner at haypocalc.com>
date:        Sat Dec 17 23:15:22 2011 +0100
summary:
  Issue #13530: Document os.lseek() result

Patch written by Jérémy Anger.

files:
  Doc/library/os.rst    |  2 +-
  Misc/ACKS             |  1 +
  Modules/posixmodule.c |  3 ++-
  3 files changed, 4 insertions(+), 2 deletions(-)


diff --git a/Doc/library/os.rst b/Doc/library/os.rst
--- a/Doc/library/os.rst
+++ b/Doc/library/os.rst
@@ -977,7 +977,7 @@
    by *how*: :const:`SEEK_SET` or ``0`` to set the position relative to the
    beginning of the file; :const:`SEEK_CUR` or ``1`` to set it relative to the
    current position; :const:`os.SEEK_END` or ``2`` to set it relative to the end of
-   the file.
+   the file. Return the new cursor position in bytes, starting from the beginning.
 
    Availability: Unix, Windows.
 
diff --git a/Misc/ACKS b/Misc/ACKS
--- a/Misc/ACKS
+++ b/Misc/ACKS
@@ -32,6 +32,7 @@
 Erik Andersén
 Oliver Andrich
 Ross Andrus
+Jérémy Anger
 Jon Anglin
 Éric Araujo
 Alicia Arlen
diff --git a/Modules/posixmodule.c b/Modules/posixmodule.c
--- a/Modules/posixmodule.c
+++ b/Modules/posixmodule.c
@@ -6946,7 +6946,8 @@
 
 PyDoc_STRVAR(posix_lseek__doc__,
 "lseek(fd, pos, how) -> newpos\n\n\
-Set the current position of a file descriptor.");
+Set the current position of a file descriptor.\n\
+Return the new cursor position in bytes, starting from the beginning.");
 
 static PyObject *
 posix_lseek(PyObject *self, PyObject *args)

-- 
Repository URL: http://hg.python.org/cpython