diff -r ed4eec682199 Doc/library/inspect.rst
--- a/Doc/library/inspect.rst	Wed May 25 11:26:07 2016 -0700
+++ b/Doc/library/inspect.rst	Wed May 25 16:44:59 2016 -0400
@@ -470,8 +470,10 @@
 .. function:: cleandoc(doc)
 
    Clean up indentation from docstrings that are indented to line up with blocks
-   of code.  Any whitespace that can be uniformly removed from the second line
-   onwards is removed.  Also, all tabs are expanded to spaces.
+   of code.  All leading whitespace is removed from the first line.  Any leading
+   whitespace that can be uniformly removed from the second line onwards is
+   removed.  Empty lines at the beginning and end are subsequently removed.  Also,
+   all tabs are expanded to spaces.
 
 
 .. _inspect-signature-object: