ww3_doxy_tmpl.md: fix module vars

[MatthewMasarik-NOAA]

Pull Request Summary

Fixes the module header in ww3_doxy_tmpl.md regarding variables.

Description

Provide a detailed description of what this PR does.

• The header for MODULEs displayed documentation of variables incorrectly. They were shown using the @param tag, which should not be used, and instead documentation should be done inline. That is directly above or after the variable where it occurs in the source.
• Updated 01/31/2022: Doxyfile.in parameter EXTENSION_MAPPING edited for Fortran90 files using the .F90 suffix. Fixes doxygen error, state: 22(String), identified by @ukmo-ccbunney .

What bug does it fix, or what feature does it add?

• ww3_doxy_tmpl.md: It corrects the way to document module variables.
• Doxygen.in: Fixes error state: 22(String).

Is a change of answers expected from this PR?

• No. This only affects the documentation files ww3_doxy_tmpl.md and Doxygen.in.

Please also include the following information:

• Add any suggestions for a reviewer
  • N/A.
• Mention any labels that should be added:
  • documentation.
• Are answer changes expected from this PR? Please describe the changes and the reason why in addition to which of the following labels would apply.
  • No answers to change -- no edits to source code.

Issue(s) addressed

Not associated with an issue.

Commit Message

ww3_doxy_tmpl.md, Doxyfile.in fixes

Check list

• Branch is up to date with the authoritative repository (NOAA-EMC) develop branch.
• Checked the checklist for a developer submitting to develop.
• [na] If a version number update is required, checked the updating version number checklist.
• [na] If a new feature was added, a regression test for testing the new feature is added.

Testing

• How were these changes tested?
  • No testing. No source edits were made.
• Are the changes covered by regression tests? (If not, why? Do new tests need to be added?)
  • N/A.
• Have the matrix regression tests been run (if yes, please note HPC and compiler)?
  • N/A.
• Please provide the summary output of matrix.comp (matrix.Diff.txt, matrixCompFull.txt and matrixCompSummary.txt):
  • N/A, see above.
• Please indicate the expected changes in the regression test output (Note the known list of non-identical tests).
  • N/A, see above.
• Please provide the summary output of matrix.comp (matrix.Diff.txt, matrixCompFull.txt and matrixCompSummary.txt):
  • N/A, see above.

[ukmo-ccbunney]

@MatthewMasarik-NOAA I can confirm that the f=FortranFixed f90=FortranFree F90=FortranFree addition to Doxyfile.in fixes the State errors I was getting for many files. It also fixes the weird issue with my w3ounfmetamd.F90 file requiring that comment line between the Doxygen markup and the MODULE definition line.

[MatthewMasarik-NOAA]

@MatthewMasarik-NOAA I can confirm that the f=FortranFixed f90=FortranFree F90=FortranFree addition to Doxyfile.in fixes the State errors I was getting for many files. It also fixes the weird issue with my w3ounfmetamd.F90 file requiring that comment line between the Doxygen markup and the MODULE definition line.

@ukmo-ccbunney Awesome! I'm glad to hear that : ) After making that change there were only a few errors I was getting too. @edwardhartnett mentioned removing all the errors, then requiring people's checkin's be error free going forward. This is probably the way to go, so I've worked on removing them and just have one left at this point. I'll have all the error's removed before submitting the batch of marked up files.

[aliabdolali]

After a discussion with Matt, I am happy with this PR.