docs(matrices): update matrices doc

Author: AnzhiZhang

src/matrices/binomial.jl

@@ -3,12 +3,10 @@ Binomial Matrix
 ===============
 The matrix is a multiple of an involutory matrix.
 
-*Input options:*
-
-+ dim: the dimension of the matrix.
-
-*References:*
+# Input Options
+- dim: the dimension of the matrix.
 
+# References
 **G. Boyd, C.A. Micchelli, G. Strang and D.X. Zhou**,
 Binomial matrices, Adv. in Comput. Math., 14 (2001), pp 379-391.
 """

src/matrices/cauchy.jl

@@ -4,18 +4,13 @@ Cauchy Matrix
 Given two vectors `x` and `y`, the `(i,j)` entry of the Cauchy matrix is
 `1/(x[i]+y[j])`.
 
-*Input options*:
-
- + x: an integer, as vectors 1:x and 1:x.
-
- + x, y: two integers, as vectors 1:x and 1:y.
-
- + x: a vector. `y` defaults to `x`.
-
- + x, y: two vectors.
-
-*References:*
+# Input Options
+- x: an integer, as vectors 1:x and 1:x.
+- x, y: two integers, as vectors 1:x and 1:y.
+- x: a vector. `y` defaults to `x`.
+- x, y: two vectors.
 
+# References
 **N. J. Higham**, Accuracy and Stability of Numerical Algorithms,
 second edition, Society for Industrial and Applied Mathematics, Philadelphia, PA, USA,
 2002; sec. 28.1

src/matrices/chebspec.jl

@@ -6,15 +6,12 @@ If `k = 0`,the generated matrix is nilpotent and a vector with
         matrix is nonsingular and well-conditioned. Its eigenvalues
         have negative real parts.
 
-*Input options:*
-
-+ dim, k: `dim` is the dimension of the matrix and
+# Input Options
+- dim, k: `dim` is the dimension of the matrix and
         `k = 0 or 1`.
+- dim: `k=0`.
 
-+ dim: `k=0`.
-
-*References:*
-
+# References
 **L. N. Trefethen and M. R. Trummer**, An instability
         phenomenon in spectral methods, SIAM J. Numer. Anal., 24 (1987), pp. 1008-1023.
 """

src/matrices/chow.jl

@@ -3,16 +3,13 @@ Chow Matrix
 ===========
 The Chow matrix is a singular Toeplitz lower Hessenberg matrix.
 
-*Input options:*
-
-+ dim, alpha, delta: `dim` is dimension of the matrix.
+# Input Options
+- dim, alpha, delta: `dim` is dimension of the matrix.
             `alpha`, `delta` are scalars such that `A[i,i] = alpha + delta` and
             `A[i,j] = alpha^(i + 1 -j)` for `j + 1 <= i`.
+- dim: `alpha = 1`, `delta = 0`.
 
-+ dim: `alpha = 1`, `delta = 0`.
-
-*References:*
-
+# References
 **T. S. Chow**, A class of Hessenberg matrices with known
                 eigenvalues and inverses, SIAM Review, 11 (1969), pp. 391-395.
 """

src/matrices/circulant.jl

@@ -5,14 +5,11 @@ A circulant matrix has the property that each row is obtained
 by cyclically permuting the entries of the previous row one
 step forward.
 
-*Input options:*
-
-+ vec: a vector.
-
-+ dim: an integer, as vector 1:dim.
-
-*References:*
+# Input Options
+- vec: a vector.
+- dim: an integer, as vector 1:dim.
 
+# References
 **P. J. Davis**, Circulant Matrices, John Wiley, 1977.
 """
 struct Circulant{T<:Number} <: AbstractMatrix{T}

src/matrices/clement.jl

@@ -4,16 +4,13 @@ Clement Matrix
 The Clement matrix is a tridiagonal matrix with zero
         diagonal entries. If k = 1, the matrix is symmetric.
 
-*Input options:*
-
-+ dim, k: `dim` is the dimension of the matrix.
+# Input Options
+- dim, k: `dim` is the dimension of the matrix.
         If `k = 0`, the matrix is of type `Tridiagonal`.
         If `k = 1`, the matrix is of type `SymTridiagonal`.
+- dim: `k = 0`.
 
-+ dim: `k = 0`.
-
-*References:*
-
+# References
 **P. A. Clement**, A class of triple-diagonal
         matrices for test purposes, SIAM Review, 1 (1959), pp. 50-52.
 """

src/matrices/companion.jl

@@ -8,13 +8,10 @@ The companion matrix to a monic polynomial
     is the n-by-n matrix with ones on the subdiagonal and
     the last column given by the coefficients of `a(x)`.
 
-*Input options:*
-
-+ vec: `vec` is a vector of coefficients.
-
-+ dim: `vec = [1:dim;]`. `dim` is the dimension of the matrix.
-
-+ polynomial: `polynomial` is a polynomial. vector will be appropriate values from coefficients.
+# Input Options
+- vec: `vec` is a vector of coefficients.
+- dim: `vec = [1:dim;]`. `dim` is the dimension of the matrix.
+- polynomial: `polynomial` is a polynomial. vector will be appropriate values from coefficients.
 """
 struct Companion{T<:Number} <: AbstractMatrix{T}
     n::Integer

src/matrices/dingdong.jl

@@ -5,12 +5,10 @@ The Dingdong matrix is a symmetric Hankel matrix invented
 by DR. F. N. Ris of IBM, Thomas J Watson Research Centre.
 The eigenvalues cluster around `π/2` and `-π/2`.
 
-*Input options:*
-
-+ dim: the dimension of the matrix.
-
-*References:*
+# Input Options
+- dim: the dimension of the matrix.
 
+# References
 **J. C. Nash**, Compact Numerical Methods for
 Computers: Linear Algebra and Function Minimisation,
 second edition, Adam Hilger, Bristol, 1990 (Appendix 1).

src/matrices/fiedler.jl

@@ -4,14 +4,11 @@ Fiedler Matrix
 The Fiedler matrix is symmetric matrix with a dominant
       positive eigenvalue and all the other eigenvalues are negative.
 
-*Input options:*
-
-+ vec: a vector.
-
-+ dim: `dim` is the dimension of the matrix. `vec=[1:dim;]`.
-
-*References:*
+# Input Options
+- vec: a vector.
+- dim: `dim` is the dimension of the matrix. `vec=[1:dim;]`.
 
+# References
 **G. Szego**, Solution to problem 3705, Amer. Math.
             Monthly, 43 (1936), pp. 246-259.
 

src/matrices/forsythe.jl

@@ -4,12 +4,10 @@ Forsythe Matrix
 The Forsythe matrix is a n-by-n perturbed Jordan block.
 This generator is adapted from N. J. Higham's Test Matrix Toolbox.
 
-*Input options:*
-
-+ dim, alpha, lambda: `dim` is the dimension of the matrix.
+# Input Options
+- dim, alpha, lambda: `dim` is the dimension of the matrix.
     `alpha` and `lambda` are scalars.
-
-+ dim: `alpha = sqrt(eps(type))` and `lambda = 0`.
+- dim: `alpha = sqrt(eps(type))` and `lambda = 0`.
 """
 struct Forsythe{T<:Number} <: AbstractMatrix{T}
     n::Integer