]> granicus.if.org Git - python/commitdiff
this seems to be pointlessly nested
authorBenjamin Peterson <benjamin@python.org>
Thu, 24 Feb 2011 02:46:00 +0000 (02:46 +0000)
committerBenjamin Peterson <benjamin@python.org>
Thu, 24 Feb 2011 02:46:00 +0000 (02:46 +0000)
Doc/library/io.rst

index 26ddd8f22dd78c7a147ed08381a74ea081faf1ab..98286622f6dd129110925b036e82655a051f83a7 100644 (file)
@@ -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