From: Berker Peksag <berker.peksag@gmail.com>
Date: Wed, 24 Sep 2014 09:43:29 +0000 (+0300)
Subject: Issue #21860: Correct docstrings of FileIO.seek() and FileIO.truncate() methods.
X-Git-Tag: v3.4.3rc1~623
X-Git-Url: http://git.ipfire.org/gitweb.cgi?a=commitdiff_plain;h=b87630c273ab3ff68d4dbee61fe7ec9c65eeccb8;p=thirdparty%2FPython%2Fcpython.git

Issue #21860: Correct docstrings of FileIO.seek() and FileIO.truncate() methods.

Patch by Terry Chia.
---

diff --git a/Misc/ACKS b/Misc/ACKS
index 4a69dfe6e115..1cd18f42d5b8 100644
--- a/Misc/ACKS
+++ b/Misc/ACKS
@@ -237,6 +237,7 @@ Nicolas Chauvat
 Jerry Chen
 Michael Chermside
 Ingrid Cheung
+Terry Chia
 Albert Chin-A-Young
 Adal Chiriliuc
 Matt Chisholm
diff --git a/Modules/_io/fileio.c b/Modules/_io/fileio.c
index 81e2906a2643..a2b253bd03b1 100644
--- a/Modules/_io/fileio.c
+++ b/Modules/_io/fileio.c
@@ -1124,7 +1124,8 @@ PyDoc_STRVAR(fileno_doc,
 "This is needed for lower-level file interfaces, such the fcntl module.");
 
 PyDoc_STRVAR(seek_doc,
-"seek(offset: int[, whence: int]) -> None.  Move to new file position.\n"
+"seek(offset: int[, whence: int]) -> int.  Move to new file position and\n"
+"return the file position.\n"
 "\n"
 "Argument offset is a byte count.  Optional argument whence defaults to\n"
 "0 (offset from start of file, offset should be >= 0); other values are 1\n"
@@ -1136,9 +1137,10 @@ PyDoc_STRVAR(seek_doc,
 
 #ifdef HAVE_FTRUNCATE
 PyDoc_STRVAR(truncate_doc,
-"truncate([size: int]) -> None.  Truncate the file to at most size bytes.\n"
+"truncate([size: int]) -> int.  Truncate the file to at most size bytes\n"
+"and return the truncated size.\n"
 "\n"
-"Size defaults to the current file position, as returned by tell()."
+"Size defaults to the current file position, as returned by tell().\n"
 "The current file position is changed to the value of size.");
 #endif