Small tweaks to documentation.

doc/index.rst

@@ -331,7 +331,7 @@ user.
     >>> try:
     ...     with open(filename) as f:
     ...         config = f.read()
-    ... except (OSError, IOError) as e:
+    ... except OSError as e:
     ...     error(os_error(e))
     error: config: no such file or directory.
 
@@ -352,7 +352,7 @@ used when reporting errors:
     ...     try:
     ...         with open(filename) as f:
     ...             config = f.read()
-    ...     except (OSError, IOError) as e:
+    ...     except OSError as e:
     ...         raise Error(os_error(e))
 
     >>> try:

doc/user.rst

@@ -1382,7 +1382,7 @@ os_error
     >>> try:
     ...     with open('temperatures.csv') as f:
     ...         contents = f.read()
-    ... except (OSError, IOError) as e:
+    ... except OSError as e:
     ...     error(os_error(e))
     myprog error: temperatures.csv: no such file or directory.
 

inform/inform.py

@@ -999,8 +999,9 @@ def full_stop(sentence, end='.', allow='.?!'):
     """Add period to end of string if it is needed.
 
     A full stop (a period) is added if there is no terminating punctuation at the
-    end of the string.  Any white space at the end of the string is removed
-    before looking for terminal punctuation.
+    end of the string.  The argument is first converted to a string, and then
+    any white space at the end of the string is removed before looking for
+    terminal punctuation.  The return value is always a string.
 
     Examples::
 
@@ -1014,7 +1015,7 @@ def full_stop(sentence, end='.', allow='.?!'):
         >>> full_stop('Is the file is out of date?')
         'Is the file is out of date?'
 
-    You can override the allowed endings and desired ending.
+    You can override the allowed and desired endings.
 
         >>> cases = '1, 3 9, 12.'.split()
         >>> print(*[full_stop(c, end=',', allow=',.') for c in cases])