[Python-3000-checkins] r62241 - python/branches/py3k/Lib/io.py

georg.brandl python-3000-checkins at python.org
Wed Apr 9 09:33:01 CEST 2008


Author: georg.brandl
Date: Wed Apr  9 09:33:01 2008
New Revision: 62241

Modified:
   python/branches/py3k/Lib/io.py
Log:
More docstring fixes, and an XXX.


Modified: python/branches/py3k/Lib/io.py
==============================================================================
--- python/branches/py3k/Lib/io.py	(original)
+++ python/branches/py3k/Lib/io.py	Wed Apr  9 09:33:01 2008
@@ -257,9 +257,9 @@
         return self.seek(0, 1)
 
     def truncate(self, pos: int = None) -> int:
-        """truncate(size: int = None) -> int. Truncate file to size bytes.
+        """truncate(pos: int = None) -> int. Truncate file to pos bytes.
 
-        Size defaults to the current IO position as reported by tell().
+        Pos defaults to the current IO position as reported by tell().
         Returns the new size.
         """
         self._unsupported("truncate")
@@ -465,7 +465,7 @@
     def read(self, n: int = -1) -> bytes:
         """read(n: int) -> bytes.  Read and return up to n bytes.
 
-        Returns an empty bytes array on EOF, or None if the object is
+        Returns an empty bytes object on EOF, or None if the object is
         set not to block and has no data to read.
         """
         if n is None:
@@ -478,7 +478,7 @@
         return bytes(b)
 
     def readall(self):
-        """readall() -> bytes.  Read until EOF, using multiple read() call."""
+        """readall() -> bytes.  Read until EOF, using multiple read() calls."""
         res = bytearray()
         while True:
             data = self.read(DEFAULT_BUFFER_SIZE)
@@ -521,6 +521,7 @@
     def name(self):
         return self._name
 
+    # XXX(gb): _FileIO already has a mode property
     @property
     def mode(self):
         return self._mode


More information about the Python-3000-checkins mailing list