A bunch of docstring fixes.

Lib/smtplib.py

@@ -77,7 +77,7 @@ class SMTPResponseException(SMTPException):
 class SMTPSenderRefused(SMTPResponseException):
     """Sender address refused.
     In addition to the attributes set by on all SMTPResponseException
-    exceptions, this sets `sender' to the string that the SMTP refused
+    exceptions, this sets `sender' to the string that the SMTP refused.
     """
 
     def __init__(self, code, msg, sender):
@@ -103,10 +103,10 @@ class SMTPDataError(SMTPResponseException):
     """The SMTP server didn't accept the data."""
 
 class SMTPConnectError(SMTPResponseException):
-    """Error during connection establishment"""
+    """Error during connection establishment."""
 
 class SMTPHeloError(SMTPResponseException):
-    """The server refused our HELO reply"""
+    """The server refused our HELO reply."""
 
 def quoteaddr(addr):
     """Quote a subset of the email addresses defined by RFC 821.
@@ -127,7 +127,7 @@ def quoteaddr(addr):
 def quotedata(data):
     """Quote data for email.
 
-    Double leading '.', and change Unix newline '\n', or Mac '\r' into
+    Double leading '.', and change Unix newline '\\n', or Mac '\\r' into
     Internet CRLF end-of-line.
     """
     return re.sub(r'(?m)^\.', '..',
@@ -138,11 +138,11 @@ class SMTP:
     SMTP Objects:
         SMTP objects have the following attributes:    
             helo_resp 
-                This is the message given by the server in responce to the 
+                This is the message given by the server in response to the 
                 most recent HELO command.
                 
             ehlo_resp
-                This is the message given by the server in responce to the 
+                This is the message given by the server in response to the 
                 most recent EHLO command. This is usually multiline.
 
             does_esmtp 
@@ -152,15 +152,15 @@ class SMTP:
             esmtp_features 
                 This is a dictionary, which, if the server supports ESMTP,
                 will _after you do an EHLO command_, contain the names of the
-                SMTP service  extentions this server supports, and their 
+                SMTP service extensions this server supports, and their
                 parameters (if any).
-                Note, all extention names are mapped to lower case in the 
+
+                Note, all extension names are mapped to lower case in the 
                 dictionary. 
 
-        For method docs, see each method's docstrings. In general, there is 
-            a method of the same name to perform each SMTP command, and there 
-            is a method called 'sendmail' that will do an entire mail 
-            transaction.
+        See each method's docstrings for details.  In general, there is a
+        method of the same name to perform each SMTP command.  There is also a
+        method called 'sendmail' that will do an entire mail transaction.
         """
     debuglevel = 0
     file = None
@@ -173,8 +173,8 @@ class SMTP:
 
         If specified, `host' is the name of the remote host to which to
         connect.  If specified, `port' specifies the port to which to connect.
-        By default, smtplib.SMTP_PORT is used.  An SMTPConnectError is
-        raised if the specified `host' doesn't respond correctly.
+        By default, smtplib.SMTP_PORT is used.  An SMTPConnectError is raised
+        if the specified `host' doesn't respond correctly.
 
         """
         self.esmtp_features = {}
@@ -425,15 +425,14 @@ class SMTP:
 
         This method will return normally if the mail is accepted for at least
         one recipient.  It returns a dictionary, with one entry for each
-        recipient that was refused.  Each entry contains a tuple of
-        the SMTP error code and the accompanying error message sent by
-        the server.
+        recipient that was refused.  Each entry contains a tuple of the SMTP
+        error code and the accompanying error message sent by the server.
 
         This method may raise the following exceptions:
 
          SMTPHeloError          The server didn't reply properly to
                                 the helo greeting. 
-         SMTPRecipientsRefused  The server rejected for ALL recipients
+         SMTPRecipientsRefused  The server rejected ALL recipients
                                 (no mail was sent).
          SMTPSenderRefused      The server didn't accept the from_addr.
          SMTPDataError          The server replied with an unexpected