Debugging parser errors

In order to diagnose parser failures the fortls parser can be run in a standalone debug mode. If you encounter repeated parsing errors for 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 the command below (if you installed FORTRAN Language Server using pip).

fortls --debug_parser --debug_filepath=/path/to/source_file.f90