From: Antoine Pitrou Date: Sat, 29 May 2010 12:10:15 +0000 (+0000) Subject: Merged revisions 81595 via svnmerge from X-Git-Tag: v3.1.3rc1~695 X-Git-Url: https://granicus.if.org/sourcecode?a=commitdiff_plain;h=ea2b0b4992384b299f54e047b986c1b4ba743995;p=python Merged revisions 81595 via svnmerge from svn+ssh://pythondev@svn.python.org/python/branches/py3k ................ r81595 | antoine.pitrou | 2010-05-29 14:08:25 +0200 (sam., 29 mai 2010) | 9 lines Merged revisions 81594 via svnmerge from svn+ssh://pythondev@svn.python.org/python/trunk ........ r81594 | antoine.pitrou | 2010-05-29 14:06:13 +0200 (sam., 29 mai 2010) | 3 lines Issue #8840: Make documentation for truncate() clearer ........ ................ --- diff --git a/Doc/library/io.rst b/Doc/library/io.rst index 8bbd6cb753..3e98ca9a02 100644 --- a/Doc/library/io.rst +++ b/Doc/library/io.rst @@ -309,10 +309,12 @@ I/O Base Classes .. method:: truncate(size=None) - Truncate the file to at most *size* bytes. *size* defaults to the current - file position, as returned by :meth:`tell`. Note that the current file - position isn't changed; if you want to change it to the new end of - file, you have to :meth:`seek()` explicitly. + Resize the stream to the given *size* in bytes (or the current position + if *size* is not specified). The current stream position isn't changed. + This resizing can extend or reduce the current file size. In case of + extension, the contents of the new file area depend on the platform + (on most systems, additional bytes are zero-filled, on Windows they're + undetermined). The new file size is returned. .. method:: writable()