From 9efcc4b3196b9f7c3789468658a1a5017e787534 Mon Sep 17 00:00:00 2001 From: Benjamin Peterson Date: Mon, 14 Apr 2008 21:30:21 +0000 Subject: [PATCH] Fix problems in the io docs noted by Alexandre Vassalotti --- Doc/library/io.rst | 4 ++-- Lib/io.py | 11 ++++------- 2 files changed, 6 insertions(+), 9 deletions(-) diff --git a/Doc/library/io.rst b/Doc/library/io.rst index f705c302838..4fb79b9d40b 100644 --- a/Doc/library/io.rst +++ b/Doc/library/io.rst @@ -437,12 +437,12 @@ Buffered Streams .. method:: read1() - In :class:`BytesIO`, this is the same as :meth:`read()`. + In :class:`BytesIO`, this is the same as :meth:`read`. .. method:: truncate([pos]) Truncate the file to at most *pos* bytes. *pos* defaults to the current - stream position, as returned by :meth:`tell()`. + stream position, as returned by :meth:`tell`. .. class:: BufferedReader(raw[, buffer_size]) diff --git a/Lib/io.py b/Lib/io.py index 30b256f1fa4..a308ac4300b 100644 --- a/Lib/io.py +++ b/Lib/io.py @@ -1,5 +1,4 @@ -""" -The io module provides the Python interfaces to stream handling. The +"""The io module provides the Python interfaces to stream handling. The builtin open function is defined in this module. At the top of the I/O hierarchy is the abstract base class IOBase. It @@ -78,8 +77,7 @@ class BlockingIOError(IOError): def open(file, mode="r", buffering=None, encoding=None, errors=None, newline=None, closefd=True): - r""" - Open file and return a stream. If the file cannot be opened, an + r"""Open file and return a stream. If the file cannot be opened, an IOError is raised. file is either a string giving the name (and the path if the file @@ -287,8 +285,7 @@ class UnsupportedOperation(ValueError, IOError): class IOBase(metaclass=abc.ABCMeta): - """ - The abstract base class for all I/O classes, acting on streams of + """The abstract base class for all I/O classes, acting on streams of bytes. There is no public constructor. This class provides dummy implementations for many methods that @@ -793,7 +790,7 @@ class BytesIO(BufferedIOBase): return bytes(b) def read1(self, n): - """In BytesIO, this is the same as read. + """This is the same as read. """ return self.read(n)