File	Date	Author	Commit
build	2011-10-18	rasmussn	[a003b8] Initial version
config	2010-11-17	rasmussn	[9419b8] Merge branch 'master' of ssh://fortran-parser.g...
doc	2010-07-20	Kyle Carver	[11ceaa] Merge branch 'master' of ssh://fortran-parser.g...
src	2013-02-06	rasmussn	[86ab99] Initial version.
tests	2013-02-16	rasmussn	[51d6ca] Replaced *.f03 with *.f90 version of test file.
.gitignore	2010-02-12	Craig Rasmussen	[dd87f3] Initial version.
INSTALL	2011-08-23	Scott K Warren	[6ce3f9] Merge branch 'master' of ssh://fortran-parser.g...
LICENSE.txt	2015-09-22	Craig Rasmussen	[37c41d] Initial version.
Makefile	2011-10-17	rasmussn	[fa11d6] Merge branch 'master' of ssh://fortran-parser.g...
README	2011-08-23	Scott K Warren	[6ce3f9] Merge branch 'master' of ssh://fortran-parser.g...
acinclude.m4	2010-09-20	Scott Warren	[48ad0c] Added a --awith-antlr configure option, rolled ...
aclocal.m4	2010-02-09	Matthew Sottile	[73e22b] initial import
autoconf.sh	2010-02-09	Matthew Sottile	[73e22b] initial import
configure	2011-09-30	Craig Rasmussen	[3ccf42] Added OFP_DATE macro
configure.ac	2011-09-30	Craig Rasmussen	[3ccf42] Added OFP_DATE macro
get_antlr.sh	2011-10-17	rasmussn	[fa11d6] Merge branch 'master' of ssh://fortran-parser.g...
make.inc.in	2011-09-30	Craig Rasmussen	[15ff27] Added OFP_DATE macro

Read Me

/*******************************************************************
 *                                                                 *
 *                Open Fortran Parser (OFP)                        *
 *                           OFP                                   *
 *                      Version 0.8.4                              *
 *                                                                 *
 *  README - a brief description and pointers to more information  *
 *                                                                 *
 *******************************************************************


                          DESCRIPTION
                          -----------

The Open Fortran Parser (OFP) project provides a Fortran 2008 compliant
parser and associated tools.  These tools provide a Java and C API for
actions that are called when parser rules are completed.  These actions
allow a parser consumer to build a custom AST (Abstract Syntax Tree).

If you need access to a complete source-to-source Fortran compiler
infrastructure incorporating OFP, you should consider using ROSE (see
http://www.rosecompiler.org/).

The OFP parser is based on an ANTLR 3 grammar and ANTLR version 3.3
tools are used to generate the Fortran parser (written in Java).
The C action interfaces are currently provided by JNI.

                            RESOURCES
                            ---------

Installation instructions:

  - See the INSTALL file in the top OFP directory (./INSTALL).

Documentation:

  - Still a little sparse.  Action interfaces are defined by the Java file
    ./src/fortran/ofp/parser/java/IFortranParserAction.java.

Running parser:

  - You must set your java CLASSPATH to include the ANTLR jar files and 
    OpenFortranParser-0.8.4.jar.  If you use the bash shell, you can set the
    CLASSPATH with something like (assuming files are installed in /usr/local):

    export CLASSPATH=/usr/local/antlr/lib/antlr-3.3-complete.jar:/usr/local/ofp/lib/OpenFortranParser-0.8.4.jar

  - Run the parser with the command

         java fortran.ofp.FrontEnd [--verbose] filename

Help:

  - Please send e-mail to fortran-parser-devel@lists.sourceforge.net.

CVS Repository:

  - The public is free to check out the most recent copy of the OFP CVS
    repository and experiment with the tools.  Any patches or changes that
    you wish to have added should be sent to
    fortran-parser-devel@lists.sourceforge.net. Information regarding CVS
    checkout can be found off of the sourceforge web page:

       http://sf.net/projects/fortran-parser/


                           DIRECTORIES
                           -----------

./src/
  - Java and C source files for the project.

./build/
  - Location of the build directory.
  
./lib/
  - Contains a pre-built OpenFortranParser-0.8.4.jar file if
    an OFP distribution is downloaded.

./tests/
  - Contains Fortran test files for the parser.