Added what's new entry and example for autowrapping text

sptm · sptm · commit ada3f9ad5352 · 2015-05-21T23:34:38.000-04:00
diff --git a/doc/users/whats_new/autowrap_text.rst b/doc/users/whats_new/autowrap_text.rst
@@ -0,0 +1,7 @@
+Auto-wrapping Text
+------------------
+Added the keyword argument "wrap" to Text, which automatically breaks long lines of text when being drawn.
+Works for any rotated text, different modes of alignment, and for text that are either labels or titles.
+
+Example:
+    plt.text(1, 1, "This is a really long string that should be wrapped so that it does not go outside the figure.", wrap=True)
diff --git a/examples/text_labels_and_annotations/autowrap_demo.py b/examples/text_labels_and_annotations/autowrap_demo.py
@@ -0,0 +1,19 @@
+"""
+Auto-wrapping text demo.
+"""
+import matplotlib.pyplot as plt
+
+fig = plt.figure()
+plt.axis([0, 10, 0, 10])
+t = "This is a really long string that I'd rather have wrapped so that it"\
+    " doesn't go outside of the figure, but if it's long enough it will go"\
+    " off the top or bottom!"
+plt.text(4, 1, t, ha='left', rotation=15, wrap=True)
+plt.text(6, 5, t, ha='left', rotation=15, wrap=True)
+plt.text(5, 5, t, ha='right', rotation=-15, wrap=True)
+plt.text(5, 10, t, fontsize=18, style='oblique', ha='center',
+        va='top', wrap=True)
+plt.text(3, 4, t, family='serif', style='italic', ha='right', wrap=True)
+plt.text(-1, 0, t, ha='left', rotation=-15, wrap=True)
+
+plt.show()
