eig:

Syntax:	eig ( A )
	eig ( A , B )

	eigs ( A )
	eigs ( A , B )

	eign ( A )
	eign ( A , B )

Description:

	eig ( A ):

		Computes the eigenvectors, and values of matrix
		A. eig() returns a LIST with elements `val' and `vec'
		which are the eigenvalues and eigenvectors. Eig checks
		for symmetry in A, and uses the appropriate solver.

		Uses the LAPACK subroutines DSYEV/ZHEEV or
		DGEEV/ZGEEV.

	eig ( A , B ):

		Computes the eigenvectors, and values of A, and B.
		Where A * x = lambda * B * x. The values and vectors
		are returned in a list with element names `val' and
		`vec'. Eig checks for symmetry in A and B and uses the
		appropriate solver.

		Uses the LAPACK subroutines DSYGV/ZHEGV or DGEGV/ZGEGV

	eigs:	This function offers solutions to both the standard
		and generalized eigenvalue problem, like eig, but the
		symmetric solvers are always used.

	eign:	This function offers solutions to both the standard
		and generalized eigenvalue problem, like eig, but the
		non-symmetric solvers are always used. Furthermore,
		eign returns the left eigenvectors, and the
		eigenvalues in alpha/beta format for the generalized
		eigenvalue problem.
