f95totex: a special-case prettyprinter for Fortran
-----------------------------------------------------------------

Syntax: f95totex [-o outfile] infile1 [infile2 ...]

The f95totex program converts free-form-source Fortran files to
.tex files, which can then be processed into viewable and
printable files with LaTeX.

If the infiles do not contain a file extension, .f90 is assumed;
similarly, a file extension of .tex is assumed for the outfile.
If the outfile is not specified, the name of the first infile is
used with the extension changed.

Comment blocks starting with "!" in the first column are presumed
to be LaTeXable documentation.  All forms of LaTeX commands can
be used; most notably, the amsmath package is loaded, allowing
for use of the range of AMS equation-formatting commands to
document math-intensive programs.  The remainder of the program
-- that is, the actual code -- is formatted using the "listings"
package.

At present, modules, programs, functions, and subroutines can be
introduced with appropriate headers via \module{}, \program{},
\function{}, and \subroutine{} commands in comments preceeding
the Fortran declaration.  These insert sections and subsections
as appropriate.  (Note that, at present, the names are required
to conform to LaTeX syntax, and must have underscores escaped as
\_.)

The f95totex.f90 file is the Fortran source code.  Presently, it
is in a form for the Intel Fortran compiler; it should be 
standard Fortran 95 aside from the POSIX functions used to access
the command-line arguments.

The f95totex.pdf file is simply the source code run through the
compiled program and then through pdflatex, as an example of the
capabilities of the program.

-----------------------------------------------------------------

(C) Copyright Brooks Moses, 2005.  This program is licensed under
the terms of the GNU Public License, version 2 or higher.