Debugging parser errors

In order to diagnose parser failures the FORTRAN parser can be run in a standalone debug mode. If you encounter repeated errors ("Error parsing file...") during indexing a particular FORTRAN source file follow the instructions below to help identify the cause/type of the error. Please include this output when submitting bugs related to parser failures.

Note: Debug information should not contain any subroutine/function contents. However, if the code you are working with is proprietary you may want to verify the output is clean before adding it to a public issue.

Running the parser in debug mode

The parser can be run on a given file in debug mode using to command below. If the file uses fixed format add the --fixed flag to the parser as well.

python /path/to/autocomplete-fortran/python/parse_fortran.py -d --files=/path/to/source_file.f90

The Atom package install path can be found under the install tab of Atom's settings.