INSTALL.md

OFP installation and build instructions

version 0.8.4

Contents

• Help
• Required packages
• Before you start to compile OFP
• UNIX configure/compile instructions
• Running OFP

Help

• For help, please e-mail [email protected]

Required packages

The Open Fortran Parser (OFP) tools require ANTLR 3.3. You can obtain ANTLR from. OFP also requires a Java installation.

Before you start to compile OFP

Assuming that you have downloaded the OFP distribution, unpacked, and untarred it, there should be, at least, the following files and directories:

• configure ................ used for Unix builds
• test ......................... test files
• src .......................... the OFP source code

UNIX configure/compile instructions

The instructions for building OFP on all Unix platforms are the same. First, cd to the OFP top level directory and do the following:

1. Configure for your environment. A convenient way to see the possible options is to type

    ./configure --help

The primary options are --enable-c-actions and --enable-c-main. These are only needed if you wish build the action interfaces in C and are enabled by default. Normally

    ./configure

is sufficient for most users. The --prefix option may be used to change the location of the install directory.

2. Run 'make' to build the OFP libraries.

   IMPORTANT NOTE: Because of a bug (we think) in antlr-3.3, the build reports an error a couple of times during the build process but continues to finish. This is expected behavior.

3. Run 'make install' to install the OFP files under the location specified with the prefix configure option. Note that you must have the necessary privileges to write to the install directory.

Running OFP

• Run the parser with the command

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

Your Java CLASSPATH must include the OpenFortranParser-0.8.4.jar and the antlr-3.3-complete.jar files (see the README.md file).