DOC: Add numpydoc headings in font_manager.

QuLogic · QuLogic · commit 83755bf97329 · 2018-02-14T15:38:25.000-05:00
diff --git a/lib/matplotlib/font_manager.py b/lib/matplotlib/font_manager.py
@@ -395,10 +395,18 @@ def __repr__(self):
 
 def ttfFontProperty(font):
     """
-    A function for populating the :class:`FontKey` by extracting
-    information from the TrueType font file.
+    Extract information from a TrueType font file.
+
+    Parameters
+    ----------
+    font : `.FT2Font`
+        The TrueType font file from which information will be extracted.
+
+    Returns
+    -------
+    `FontEntry`
+        The extracted font properties.
 
-    *font* is a :class:`FT2Font` instance.
     """
     name = font.family_name
 
@@ -474,10 +482,18 @@ def ttfFontProperty(font):
 
 def afmFontProperty(fontpath, font):
     """
-    A function for populating a :class:`FontKey` instance by
-    extracting information from the AFM font file.
+    Extract information from an AFM font file.
+
+    Parameters
+    ----------
+    font : `.AFM`
+        The AFM font file from which information will be extracted.
+
+    Returns
+    -------
+    `FontEntry`
+        The extracted font properties.
 
-    *font* is a class:`AFM` instance.
     """
 
     name = font.get_familyname()
