From f55011f8b63d3b046c1ec580312bc52ca47d721b Mon Sep 17 00:00:00 2001
From: Antoine Pitrou <solipsis@pitrou.net>
Date: Wed, 12 Oct 2011 18:57:23 +0200
Subject: [PATCH] Update doc for BlockingIOError and its alias in the io module

---
 Doc/library/exceptions.rst |  9 +++++++++
 Doc/library/io.rst         | 12 ++----------
 2 files changed, 11 insertions(+), 10 deletions(-)

diff --git a/Doc/library/exceptions.rst b/Doc/library/exceptions.rst
index 67f2c63bdcd..ca8e4d8b6d1 100644
--- a/Doc/library/exceptions.rst
+++ b/Doc/library/exceptions.rst
@@ -396,6 +396,15 @@ depending on the system error code.
    Corresponds to :c:data:`errno` ``EAGAIN``, ``EALREADY``,
    ``EWOULDBLOCK`` and ``EINPROGRESS``.
 
+   In addition to those of :exc:`OSError`, :exc:`BlockingIOError` can have
+   one more attribute:
+
+   .. attribute:: characters_written
+
+      An integer containing the number of characters written to the stream
+      before it blocked.  This attribute is available when using the
+      buffered I/O classes from the :mod:`io` module.
+
 .. exception:: ChildProcessError
 
    Raised when an operation on a child process failed.
diff --git a/Doc/library/io.rst b/Doc/library/io.rst
index 76c856edad6..86faa5827bb 100644
--- a/Doc/library/io.rst
+++ b/Doc/library/io.rst
@@ -109,16 +109,8 @@ High-level Module Interface
 
 .. exception:: BlockingIOError
 
-   Error raised when blocking would occur on a non-blocking stream.  It inherits
-   :exc:`IOError`.
-
-   In addition to those of :exc:`IOError`, :exc:`BlockingIOError` has one
-   attribute:
-
-   .. attribute:: characters_written
-
-      An integer containing the number of characters written to the stream
-      before it blocked.
+   This is a compatibility alias for the builtin :exc:`BlockingIOError`
+   exception.
 
 
 .. exception:: UnsupportedOperation