diff -r 1771f0ac9fc2 Doc/library/inspect.rst
--- a/Doc/library/inspect.rst	Fri May 27 11:30:59 2016 +0000
+++ b/Doc/library/inspect.rst	Fri May 27 12:03:13 2016 -0400
@@ -470,8 +470,12 @@
 .. 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: