DOC: Numpydoc format.

Carreau · Carreau · commit eb25775be33a · 2020-07-11T21:51:57.000-07:00
Returns is supposed to be a description list to be properly parsed by
numpydoc, otherwise each line is parsed as an individual item.
diff --git a/lib/matplotlib/__init__.py b/lib/matplotlib/__init__.py
@@ -273,9 +273,11 @@ def _get_executable_info(name):
 
     Returns
     -------
-    If the executable is found, a namedtuple with fields ``executable`` (`str`)
-    and ``version`` (`distutils.version.LooseVersion`, or ``None`` if the
-    version cannot be determined).
+
+    tuple or None:
+        If the executable is found, a namedtuple with fields ``executable``
+        (`str`) and ``version`` (`distutils.version.LooseVersion`, or ``None``
+        if the version cannot be determined).
 
     Raises
     ------
diff --git a/lib/matplotlib/mlab.py b/lib/matplotlib/mlab.py
@@ -934,10 +934,11 @@ def cohere(x, y, NFFT=256, Fs=2, detrend=detrend_none, window=window_hanning,
 
     Returns
     -------
-    The return value is the tuple (*Cxy*, *f*), where *f* are the
-    frequencies of the coherence vector. For cohere, scaling the
-    individual densities by the sampling frequency has no effect,
-    since the factors cancel out.
+
+    tuple (*Cxy*, *f*)
+        where *f* are the frequencies of the coherence vector. For cohere,
+        scaling the individual densities by the sampling frequency has no
+        effect, since the factors cancel out.
 
     See Also
     --------
