Issue 1859: Doc that textwrap does not break on \n (pending possible behavior patch). Patch by Jeremy Thurgood.
diff --git a/Doc/library/textwrap.rst b/Doc/library/textwrap.rst
index f881701..860f81f 100644
--- a/Doc/library/textwrap.rst
+++ b/Doc/library/textwrap.rst
@@ -121,6 +121,13 @@
each tab character will be replaced by a single space, which is *not*
the same as tab expansion.
+ .. note::
+
+ If :attr:`replace_whitespace` is false, newlines may appear in the
+ middle of a line and cause strange output. For this reason, text should
+ be split into paragraphs (using :meth:`str.splitlines` or similar)
+ which are wrapped separately.
+
.. attribute:: drop_whitespace