summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorMiss Islington (bot) <31488909+miss-islington@users.noreply.github.com>2019-06-29 21:41:55 -0700
committerGitHub <noreply@github.com>2019-06-29 21:41:55 -0700
commitbc60c47169d1cb33f6fbe1ed64c09a536e82e1c3 (patch)
tree432fe04b80c38cf71c9a7f97229c1bacc9ee1ff1
parent065aff3c518a641e7a734a5b93f9ebed1b405c49 (diff)
downloadcpython-git-bc60c47169d1cb33f6fbe1ed64c09a536e82e1c3.tar.gz
[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@users.noreply.github.com> https://bugs.python.org/issue30754
-rw-r--r--Doc/library/textwrap.rst3
-rw-r--r--Lib/textwrap.py2
2 files changed, 5 insertions, 0 deletions
diff --git a/Doc/library/textwrap.rst b/Doc/library/textwrap.rst
index a50600e464..6b0decb5a6 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 5c2e4fa523..8d91ffa081 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.