Update doc for BlockingIOError and its alias in the io module

diff --git a/Doc/library/exceptions.rst b/Doc/library/exceptions.rst
index 67f2c63bdcd11438c88ec77ef0970e6e48907033..ca8e4d8b6d152a10bb203b5f5e08eb60becc3e56 100644 (file)
--- 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 76c856edad65982a6bf893e0066edef539f3fd00..86faa5827bb346e68d191cb8b0feb9c96095e182 100644 (file)
--- 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