A bunch more doc fixes.

[dunshire.git] / dunshire / matrices.py

diff --git a/dunshire/matrices.py b/dunshire/matrices.py
index a5a02e9d069eea87b2cf44cb70054133f3e4ae8c..f35827d16be600cec3ee5d1c2d0fbcea27a9484d 100644 (file)
--- a/dunshire/matrices.py
+++ b/dunshire/matrices.py
@@ -18,8 +18,11 @@ def append_col(left, right):
     Parameters
     ----------
 
-    left, right : matrix
-        The two matrices to append to one another.
+    left : matrix
+        The "original" matrix, the one that will wind up on the left.
+
+    right : matrix
+        The matrix to be appended on the right of ``left``.
 
     Returns
     -------
@@ -57,8 +60,11 @@ def append_row(top, bottom):
     Parameters
     ----------
 
-    top, bottom : matrix
-        The two matrices to append to one another.
+    top : matrix
+        The "original" matrix, the one that will wind up on top.
+
+    bottom : matrix
+        The matrix to be appended below ``top``.
 
     Returns
     -------
@@ -265,8 +271,11 @@ def inner_product(vec1, vec2):
     Parameters
     ----------
 
-    vec1, vec2 : matrix
-        The two vectors whose inner product you want.
+    vec1 : matrix
+        The first vector, whose inner product with ``vec2`` you want.
+
+    vec2 : matrix
+        The second vector, whose inner product with ``vec1`` you want.
 
     Returns
     -------
@@ -346,7 +355,7 @@ def specnorm(mat):
     Return the spectral norm of a matrix.
 
     The spectral norm of a matrix is its largest singular value, and it
-    corresponds to the operator norm induced by the vector ``2``-norm.
+    corresponds to the operator norm induced by the vector Euclidean norm.
 
     Parameters
     ----------