# HG changeset patch
# User Jason Grout <jason.grout@drake.edu>
# Date 1292703722 21600
# Node ID 7bb6be38ecb2137a203bb524ebb982b14c96e30a
# Parent  921c0dd89392e86e9ef9f9c387674c1ef7841118
#8094: correct and expand docs for matrix shortcuts .T, .I, .C, and .H

diff -r 921c0dd89392 -r 7bb6be38ecb2 sage/matrix/matrix2.pyx
--- a/sage/matrix/matrix2.pyx	Sat Dec 18 13:54:26 2010 -0600
+++ b/sage/matrix/matrix2.pyx	Sat Dec 18 14:22:02 2010 -0600
@@ -6637,15 +6637,17 @@
             [-j + 1      1]
             [     0   -2*j]
 
-        Shortcuts::
+        There is a shortcut for the conjugate::
+
             sage: M.C
             [-j + 1      1]
             [     0   -2*j]
             
-        Conjugate and transpose::
+        There is also a shortcut for the conjugate transpose, or "Hermitian transpose"::
+
             sage: M.H
-            [     1 -j + 1]
-            [  -2*j      0]
+            [-j + 1      0]
+            [     1   -2*j]
 
         Conjugates work (trivially) for matrices over rings that embed
         canonically into the real numbers::
@@ -7211,15 +7213,19 @@
     Provides shortcuts for various methods like transpose()
     """
     property T:
+        "``m.T`` gives the transpose of the matrix ``m``"
         def __get__(self):
             return self.transpose()
     property C:
+        "``m.C`` gives the conjugate of the matrix ``m``"
         def __get__(self):
             return self.conjugate()
     property H:
+        """``m.H`` gives the conjugate transpose, or "Hermitian transpose", of the matrix ``m``"""
         def __get__(self):
             return self.conjugate().transpose()
     property I:
+        "``m.I`` gives the inverse of the matrix ``m``"
         def __get__(self):
             return self.inverse()
 
diff -r 921c0dd89392 -r 7bb6be38ecb2 sage/matrix/matrix_dense.pyx
--- a/sage/matrix/matrix_dense.pyx	Sat Dec 18 13:54:26 2010 -0600
+++ b/sage/matrix/matrix_dense.pyx	Sat Dec 18 14:22:02 2010 -0600
@@ -176,7 +176,7 @@
             [1 2]
             [3 4]
 
-        ``.T`` is a convenient shortcut::
+        ``.T`` is a convenient shortcut for the transpose::
 
            sage: A.T
            [1 3]
diff -r 921c0dd89392 -r 7bb6be38ecb2 sage/matrix/matrix_double_dense.pyx
--- a/sage/matrix/matrix_double_dense.pyx	Sat Dec 18 13:54:26 2010 -0600
+++ b/sage/matrix/matrix_double_dense.pyx	Sat Dec 18 14:22:02 2010 -0600
@@ -1077,7 +1077,7 @@
             [1.0 4.0]
             [2.0 5.0]
 
-        ``.T`` is a convenient shortcut::
+        ``.T`` is a convenient shortcut for the transpose::
 
             sage: m.T
             [2.0 3.0]
diff -r 921c0dd89392 -r 7bb6be38ecb2 sage/matrix/matrix_integer_dense.pyx
--- a/sage/matrix/matrix_integer_dense.pyx	Sat Dec 18 13:54:26 2010 -0600
+++ b/sage/matrix/matrix_integer_dense.pyx	Sat Dec 18 14:22:02 2010 -0600
@@ -4698,7 +4698,7 @@
             [0 1 2]
             [3 4 5]
 
-        ``.T`` is a convenient shortcut::
+        ``.T`` is a convenient shortcut for the transpose::
 
             sage: A.T
             [0 3]
diff -r 921c0dd89392 -r 7bb6be38ecb2 sage/matrix/matrix_mod2_dense.pyx
--- a/sage/matrix/matrix_mod2_dense.pyx	Sat Dec 18 13:54:26 2010 -0600
+++ b/sage/matrix/matrix_mod2_dense.pyx	Sat Dec 18 14:22:02 2010 -0600
@@ -1412,7 +1412,8 @@
             sage: B.transpose() == A
             True
 
-        ``.T`` is a convenient shortcut::
+        ``.T`` is a convenient shortcut for the transpose::
+
             sage: A.T
             [1 0 1]
             [0 1 1]
diff -r 921c0dd89392 -r 7bb6be38ecb2 sage/matrix/matrix_modn_sparse.pyx
--- a/sage/matrix/matrix_modn_sparse.pyx	Sat Dec 18 13:54:26 2010 -0600
+++ b/sage/matrix/matrix_modn_sparse.pyx	Sat Dec 18 14:22:02 2010 -0600
@@ -678,7 +678,8 @@
             [1 0 0]
             [0 0 0]
 
-        ``.T`` is a convenient shortcut::
+        ``.T`` is a convenient shortcut for the transpose::
+
             sage: A.T
             [0 2 3]
             [1 0 0]
diff -r 921c0dd89392 -r 7bb6be38ecb2 sage/matrix/matrix_rational_dense.pyx
--- a/sage/matrix/matrix_rational_dense.pyx	Sat Dec 18 13:54:26 2010 -0600
+++ b/sage/matrix/matrix_rational_dense.pyx	Sat Dec 18 14:22:02 2010 -0600
@@ -2320,7 +2320,7 @@
             [0 1 2]
             [3 4 5]
 
-        ``.T`` is a convenient shortcut::
+        ``.T`` is a convenient shortcut for the transpose::
 
             sage: print A.T
             [0 3]
diff -r 921c0dd89392 -r 7bb6be38ecb2 sage/matrix/matrix_sparse.pyx
--- a/sage/matrix/matrix_sparse.pyx	Sat Dec 18 13:54:26 2010 -0600
+++ b/sage/matrix/matrix_sparse.pyx	Sat Dec 18 14:22:02 2010 -0600
@@ -328,7 +328,7 @@
             [1 2]
             [3 4]
 
-        ``.T`` is a convenient shortcut::
+        ``.T`` is a convenient shortcut for the transpose::
 
            sage: A.T
            [1 3]
diff -r 921c0dd89392 -r 7bb6be38ecb2 sage/matrix/matrix_symbolic_dense.pyx
--- a/sage/matrix/matrix_symbolic_dense.pyx	Sat Dec 18 13:54:26 2010 -0600
+++ b/sage/matrix/matrix_symbolic_dense.pyx	Sat Dec 18 14:22:02 2010 -0600
@@ -61,12 +61,14 @@
     ArithmeticError: self must be a square matrix
 
 Transposition::
+
     sage: m = matrix(SR, 2, [sqrt(2), -1, pi, e^2])
     sage: m.transpose()
     [sqrt(2)      pi]
     [     -1     e^2]
 
-``.T`` is a convenient shortcut::
+``.T`` is a convenient shortcut for the transpose::
+
     sage: m.T
     [sqrt(2)      pi]
     [     -1     e^2]