From: Carol Willing <carolcode@willingconsulting.com>
Date: Thu, 13 Sep 2018 23:14:41 +0000 (-0700)
Subject: polish exceptions and platforms (GH-9272)
X-Git-Tag: v3.8.0a1~1005
X-Git-Url: https://granicus.if.org/sourcecode?a=commitdiff_plain;h=a3c8ba723530ceb3328d184d3e0020534b522778;p=python

polish exceptions and platforms (GH-9272)
---

diff --git a/Doc/library/asyncio-exceptions.rst b/Doc/library/asyncio-exceptions.rst
index bcd3599477..7f3ed85794 100644
--- a/Doc/library/asyncio-exceptions.rst
+++ b/Doc/library/asyncio-exceptions.rst
@@ -19,11 +19,12 @@ Exceptions
 
    The operation has been cancelled.
 
-   This exception can be caught to perform custom operations on
+   This exception can be caught to perform custom operations
    when asyncio Tasks are cancelled.  In almost all situations the
    exception must always be re-raised.
 
    .. note::
+
       This exception is a subclass of :exc:`Exception`, so it can be
       accidentally suppressed by ``try..except`` block::
 
@@ -54,7 +55,7 @@ Exceptions
 
 .. exception:: SendfileNotAvailableError
 
-   The "sendfile" syscall for is not available for the given
+   The "sendfile" syscall is not available for the given
    socket or file type.
 
    A subclass of :exc:`RuntimeError`.
diff --git a/Doc/library/asyncio-platforms.rst b/Doc/library/asyncio-platforms.rst
index afdbce67cd..2f0f534952 100644
--- a/Doc/library/asyncio-platforms.rst
+++ b/Doc/library/asyncio-platforms.rst
@@ -9,7 +9,8 @@ Platforms Support
 =================
 
 The :mod:`asyncio` module has been designed to be portable,
-but some platforms have subtle differences and limitations.
+but some platforms have subtle differences and limitations
+due to the platforms' underlying architecture and capabilities.
 
 
 All Platforms
@@ -26,7 +27,7 @@ All event loops on Windows do not support the following methods:
 
 * :meth:`loop.create_unix_connection` and
   :meth:`loop.create_unix_server` are not supported.
-  The :data:`socket.AF_UNIX` socket family is specific to UNIX/
+  The :data:`socket.AF_UNIX` socket family is specific to UNIX.
 
 * :meth:`loop.add_signal_handler` and
   :meth:`loop.remove_signal_handler` are not supported.
@@ -66,8 +67,8 @@ Windows configuration.
 Subprocess Support on Windows
 -----------------------------
 
-:class:`SelectorEventLoop` on Windows does not support subproceses,
-so :class:`ProactorEventLoop` should be used instead::
+:class:`SelectorEventLoop` on Windows does not support subproceses.
+On Windows, :class:`ProactorEventLoop` should be used instead::
 
   import asyncio