title: Mixed language code documentation - need help to debug doxygen
body: <p>I would be glad to make the code documentation of our big project, <a href="http://www.diracprogram.org" rel="nofollow">http://www.diracprogram.org</a>, which is a mixture of <code>F90</code>, <code>F77</code>, Fortran include files, <code>C</code> and <code>C++</code> source code files. Plus a lot of preprocessor statements (mainly in Fortran files).</p>
  
  <p>I am using <code>Doxygen 1.8.6</code>, and playing with the Doxygen.in configuration file and the doxygen debug statements.</p>
  
  <p>Fortran is the main language. </p>
  
  <p>As you can see, there is a lot of errors. Any clue how to track, understand them and then adapt the Fortran source files accordingly?</p>
  
  <pre><code>********************************************************************
  Error in file /home/ilias/Dokumenty/Work/QCH/software/dirac_git/working_trunk/utils/mx2fit.F90 line: 621, state: 21
  ********************************************************************
  ********************************************************************
  Error in file /home/ilias/Dokumenty/Work/QCH/software/dirac_git/working_trunk/utils/polfit.F90 line: 168, state: 21
  ********************************************************************
  ********************************************************************
  Error in file /home/ilias/Dokumenty/Work/QCH/software/dirac_git/working_trunk/utils/twofit.F90 line: 310, state: 21
  ********************************************************************
  ********************************************************************
  Error in file /home/ilias/Dokumenty/Work/QCH/software/dirac_git/working_trunk/src/amfi/amfi3.F line: 2824, state: 4
  ********************************************************************
  ********************************************************************
  Error in file /home/ilias/Dokumenty/Work/QCH/software/dirac_git/working_trunk/src/cc_external/hsfscc/chp_11a.F90 line: 1993, state: 21
  ********************************************************************
  parse error in end &lt;scopename&gt;********************************************************************
  Error in file /home/ilias/Dokumenty/Work/QCH/software/dirac_git/working_trunk/src/dirac/dirbss.F line: 7884, state: 6
  ********************************************************************
  /home/ilias/Dokumenty/Work/QCH/software/dirac_git/working_trunk/src/include/dcbgascip.h:37: warning: Found ';' while parsing initializer list! (doxygen could be confused by a mac
  ro call without semicolon)
  /home/ilias/Dokumenty/Work/QCH/software/dirac_git/working_trunk/src/include/dcbham.h:50: warning: Found ';' while parsing initializer list! (doxygen could be confused by a macro 
  call without semicolon)
  parse error in end &lt;scopename&gt;********************************************************************
  Error in file /home/ilias/Dokumenty/Work/QCH/software/dirac_git/working_trunk/src/krmc/krmcgascip.F line: 4684, state: 6
  ********************************************************************
  ********************************************************************
  Error in file /home/ilias/Dokumenty/Work/QCH/software/dirac_git/working_trunk/src/reladc/adccore.F line: 7170, state: 19
  ********************************************************************
  ********************************************************************
  Error in file /home/ilias/Dokumenty/Work/QCH/software/dirac_git/working_trunk/src/reladc/adcdble.F line: 2871, state: 10
  ********************************************************************
  ********************************************************************
  Error in file /home/ilias/Dokumenty/Work/QCH/software/dirac_git/working_trunk/src/reladc/adcdiag.F line: 4813, state: 10
  ********************************************************************
  ********************************************************************
  Error in file /home/ilias/Dokumenty/Work/QCH/software/dirac_git/working_trunk/src/reladc/adcexci.F line: 1995, state: 10
  ********************************************************************
  make[3]: *** [CMakeFiles/doxygen] Segmentation fault (core dumped)
  make[3]: Target `CMakeFiles/doxygen.dir/build' not remade because of errors.
  make[2]: *** [CMakeFiles/doxygen.dir/all] Error 2
  make[1]: *** [CMakeFiles/doxygen.dir/rule] Error 2
  make[1]: Target `doxygen' not remade because of errors.
  make: *** [doxygen] Error 2
  </code></pre>