Tree [51d6ca] master /
History



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