Skip to content
Chris MacMackin edited this page Jun 25, 2015 · 8 revisions

FORD can not handle all conceivable Fortran codes as of yet. Limitations include:

  • FORTRAN77 syntax. Fixed-form source is currently not compatible with FORD. Furthermore, PARAMETER, DATA, and EXTERNAL statements are ignored.
  • Implicit typing. FORD can not handle non-default implicit typing. While this shouldn't be too hard to implement, it is low priority since I don't really want to be support bad coding style.
  • include statements. These are totally ignored and nothing in the included file will be documented.
  • Files which would be compiled after having been preprocesses will be run through gfortran's preprocessor prior to extracting the documentation. While this means that the final API will be reflected in the documentation, it may be less useful for developers who might like to know what particular macros are for.
  • Multiple entities with same name. If you have more than one entity of the same type (e.g. variable, procedure, module, etc.) within your project then their pages will be overwritten. For most projects this probably wouldn't be an issue, but for complex ones with different compile options it could be.
  • No concept of only when a module is used. This is only a problem when names are changed in this statement, as FORD will not be aware that this has happened. Otherwise, FORD has been written in such a way that no problems should occur.
Clone this wiki locally