MAINT: move matrix tests in core, polynomial to matrixlib.

1 files changed, 6 insertions, 7 deletions

diff --git a/numpy/core/fromnumeric.py b/numpy/core/fromnumeric.py
index 75bcedd81..58903d411 100644
--- a/numpy/core/fromnumeric.py
+++ b/numpy/core/fromnumeric.py
@@ -1336,10 +1336,10 @@ def diagonal(a, offset=0, axis1=0, axis2=1):
     Returns
     -------
     array_of_diagonals : ndarray
-        If `a` is 2-D and not a `matrix`, a 1-D array of the same type as `a`
-        containing the diagonal is returned. If `a` is a `matrix`, a 1-D
+        If `a` is 2-D, a 1-D array of the same type as `a` containing the
+        diagonal is returned (except if `a` is a `matrix`, in which case a 1-D
         array containing the diagonal is returned in order to maintain
-        backward compatibility.
+        backward compatibility).
         If ``a.ndim > 2``, then the dimensions specified by `axis1` and `axis2`
         are removed, and a new axis inserted at the end corresponding to the
         diagonal.
@@ -1496,10 +1496,9 @@ def ravel(a, order='C'):
     Returns
     -------
     y : array_like
-        If `a` is a matrix, y is a 1-D ndarray, otherwise y is an array of
-        the same subtype as `a`. The shape of the returned array is
-        ``(a.size,)``. Matrices are special cased for backward
-        compatibility.
+        y is an array of the same subtype as `a`, with shape ``(a.size,)``
+        (Note: matrices are special-cases for backward compatibility: if `a`
+        is a matrix, y is a 1-D ndarray.)
 
     See Also
     --------