Merge pull request #13954 from meeseeksmachine/auto-backport-of-pr-13949-on-v3.1.x

timhoffm · web-flow · commit 5c9d36259800 · 2019-04-14T20:45:12.000+02:00
Backport PR #13949 on branch v3.1.x (DOC: Add documentation to Text.set_fontfamily)
diff --git a/lib/matplotlib/text.py b/lib/matplotlib/text.py
@@ -977,6 +977,11 @@ def set_fontfamily(self, fontname):
         name or a generic font class name.  If the latter, the specific font
         names will be looked up in the corresponding rcParams.
 
+        If a `Text` instance is constructed with ``fontfamily=None``, then the
+        font is set to :rc:`font.family`, and the
+        same is done when `set_fontfamily()` is called on an existing
+        `Text` instance.
+
         Parameters
         ----------
         fontname : {FONTNAME, 'serif', 'sans-serif', 'cursive', 'fantasy', \
