/*D
    mpif77 - Compiles and links MPI programs written in Fortran 77

    Description:
    This command can be used to compile and link MPI programs written in
    Fortran.  It provides the options and any special libraries that are
    needed to compile and link MPI programs.  

    It is important to use this command, particularly when linking programs, 
    as it provides the necessary libraries.  

    Command line arguments:
+  -show      - Show the commands that would be used without
             runnning them
.  -help      - Give short help
.  -f77=name   - Use compiler 'name' instead of the default choice.  Use
                this only if the compiler is compatible with the MPICH
                library (see below)
.  -config=name - Load a configuration file for a particular compiler.
                This allows a single 'mpif77' command to be used with 
                multiple compilers.
.  -compile_info - Show the steps for compiling a program.  This option
                can be used to see what options and include paths are
		used by mpif77.
.  -link_info - Show the steps for linking a program.  This optoin 
                can be used to see what options and libraries are used by
                mpif77.
.  -echo      - Show exactly what this program is doing.
                This option should normally not be used.
-  others     - are passed to the compiler or linker.  For example, '-c'
                causes files to be compiled, '-g' selects compilation with
                debugging on most systems, and '-o name' causes linking 
                with the output executable given the name 'name'.

    Environment Variables:
    The environment variables 'MPICH_F77' may be used
    to select different Fortran compiler and linker.  Note that since
    MPICH is built with a particular C and Fortran compiler, change the
    compilers used can cause problems.  Use this only if you could intermix
    code compiled with the different compilers.

    Compatible Compilers:
    The MPI library may be used with any compiler that uses the same 
    lengths for basic data objects (such as 'long double') and that 
    uses compatible run-time libraries.  On many systems, the various
    compilers are compatible and may be used interchangably.  There are 
    exceptions; if you use the 'MPICH_F77' environment variable or the 
    '-f77=name' command-line argument to override the choice of compiler 
    and encounter problems, try reconfiguring MPICH2 with the new compiler 
    and installing MPICH2 in a separate location.  See the installation manual 
    for more details.

    Examples:
To compile a single file 'foo.f', use
.vb
   mpif77 -c foo.f 
.ve

To link the output and make an executable, use
.vb
   mpif77 -o foo foo.o
.ve
Combining compilation and linking in a single command
.vb
   mpif77 -o foo foo.f
.ve
is a convenient way to build simple programs.

.seealso: mpicc, mpicxx, mpif90, mpiexec
D*/
