Guidelines for contributing/maintaining code in LAPACK

Here are some of the tools and "tricks of the trade" that I use to maintain LAPACK.

Since 1999, LAPACK has been maintained in cvs. ~susan/CVS/LAPACK/.
LAPACK is ANSI standard Fortran 77 (no extensions like DO ... END DO, DO WHILE, dynamic memory allocation, etc) We do, however, allow subroutine names longer than 6 characters.

LAPACK is backward compatible. If you need to change the calling sequence to an existing routine, or its amount of workspace, then you MUST create a new routine. You cannot make any change that would break a user's existing code calling LAPACK.
Ftnchek (syntax checker for ANSI Fortran 77)
http://www.dsm.fordham.edu/~ftnchek
The most useful options to ftnchek are:
```
      ftnchek -declare -noextern -portability -library *.f > ~/listing
    
```
For example, if I want to check the s.p.complex and d.p.complex EIG codes (source and testers), I would type:
```
    alias ftnchek 'ftnchek -declare -noextern -portability -library'
    cd LAPACK/TESTING/EIG
    ftnchek c*.f z*.f ../../SRC/c*.f ../../SRC/z*.f ~/eig.listing
    
```
and then view the listing file for errors...
Be aware that d.p.complex is not part of the ANSI standard, so it won't recognize a lot of the COMPLEX*16 stuff, and will thus give a lot of extraneous error messages.
NAGWare Fortran 77 tools (nag_decs, etc)
http://www.nag.co.uk/nagware/NQ.asp
These tools polish the new codes so that they conform to to the LAPACK style. I use the same for LAPACK.
Portability testing (compiler flags for subscript checking and uninitialized variables...)
```
    SGI IRIX64

      f77 -g -DEBUG:subscript_check=ON -trapuv *.f

    ALPHA Tru64

      f77 -C=all *.f

    AIX

      xlf -C *.f

    Solaris

      f77 -C *.f 
```
Refer to the release_notes.html file for "machine specific installation hints".
If the code passes these tests, then we say that it can be included in LAPACK.
Documentation. Two Installation Guides and Users' Guide are maintained in LaTeX. Generate ps, pdf, and html version (using latex2html).