From 634ef9cb81ad66b335778422cd7e51bb483b9e3e Mon Sep 17 00:00:00 2001 From: Benjamin Peterson Date: Thu, 24 Feb 2011 02:46:00 +0000 Subject: [PATCH] this seems to be pointlessly nested --- Doc/library/io.rst | 15 ++++++--------- 1 file changed, 6 insertions(+), 9 deletions(-) diff --git a/Doc/library/io.rst b/Doc/library/io.rst index 26ddd8f22dd..98286622f6d 100644 --- a/Doc/library/io.rst +++ b/Doc/library/io.rst @@ -785,17 +785,14 @@ Text I/O inherits :class:`codecs.IncrementalDecoder`. -Advanced topics ---------------- - -Here we will discuss several advanced topics pertaining to the concrete -I/O implementations described above. - Performance -^^^^^^^^^^^ +----------- + +This section discusses the performance of the provided concrete IO +implementations. Binary I/O -"""""""""" +^^^^^^^^^^ By reading and writing only large chunks of data even when the user asks for a single byte, buffered I/O is designed to hide any inefficiency in @@ -808,7 +805,7 @@ platform and the backing device. Therefore, it is most always preferable to use buffered I/O rather than unbuffered I/O. Text I/O -"""""""" +^^^^^^^^ Text I/O over a binary storage (such as a file) is significantly slower than binary I/O over the same storage, because it implies conversions from