Backport PR #13949: DOC: Add documentation to Text.set_fontfamily

timhoffm · MeeseeksDev[bot] · commit 8b8e398416e4 · 2019-04-14T17:59:43.000Z
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', \
