[Python-checkins] [2.7] bpo-30754: Document textwrap.dedent blank line behavior. (GH-14469) (GH-14475)

[Miss Islington (bot)]

https://github.com/python/cpython/commit/bc60c47169d1cb33f6fbe1ed64c09a536e82e1c3
commit: bc60c47169d1cb33f6fbe1ed64c09a536e82e1c3
branch: 2.7
author: Miss Islington (bot) <31488909+miss-islington at users.noreply.github.com>
committer: GitHub <noreply at github.com>
date: 2019-06-29T21:41:55-07:00
summary:

[2.7] bpo-30754: Document textwrap.dedent blank line behavior. (GH-14469) (GH-14475)



* Added documentation for textwrap.dedent behavior.
(cherry picked from commit eb97b9211e7c99841d6cae8c63893b3525d5a401)


Co-authored-by: tmblweed <tmblweed at users.noreply.github.com>


https://bugs.python.org/issue30754

files:
M Doc/library/textwrap.rst
M Lib/textwrap.py

diff --git a/Doc/library/textwrap.rst b/Doc/library/textwrap.rst
index a50600e464dc..6b0decb5a67f 100644
--- a/Doc/library/textwrap.rst
+++ b/Doc/library/textwrap.rst
@@ -66,6 +66,9 @@ indentation from strings that have unwanted whitespace to the left of the text.
    of this module incorrectly expanded tabs before searching for common leading
    whitespace.)
 
+   Lines containing only whitespace are ignored in the input and normalized to a
+   single newline character in the output.
+
    For example::
 
       def test():
diff --git a/Lib/textwrap.py b/Lib/textwrap.py
index 5c2e4fa5237c..8d91ffa08176 100644
--- a/Lib/textwrap.py
+++ b/Lib/textwrap.py
@@ -383,6 +383,8 @@ def dedent(text):
     considered to have no common leading whitespace.  (This behaviour is
     new in Python 2.5; older versions of this module incorrectly
     expanded tabs before searching for common leading whitespace.)
+
+    Entirely blank lines are normalized to a newline character.
     """
     # Look for the longest leading string of spaces and tabs common to
     # all lines.