Doxygen documentation: marked source files added, 5th subset

[MatthewMasarik-NOAA]

Pull Request Summary

Fifth subset of doxygen marked source files.

Description

Provide a detailed description of what this PR does.

• Ten .F90 source files have been marked-up with doxygen tags:
  • w3agcmmd.F90
  • w3bullmd.F90
  • w3cspcmd.F90
  • w3flx1md.F90
  • w3flx2md.F90
  • w3flx3md.F90
  • w3flx4md.F90
  • w3flx5md.F90
  • w3sbs1md.F90
  • w3adatmd.F90

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

• This PR adds doxygen documentation.

Is a change of answers expected from this PR?

• No. Only documentation is added.

Please also include the following information:

• Add any suggestions for a reviewer

  • @JessicaMeixner-NOAA .

• 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. No active code was edited. Only documentation was added by means of doxygen marked comments.

Issue(s) addressed

• Please list any issues associated with this PR, including those the PR will fix/close. For example:

• Addresses Add doxygen marked-down source #586, though does not close. The issue will be closed when all files in checklist have been marked off.

Commit Message

Doxygen documentation: marked source files added, 5th subset

Check list

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

Testing

• How were these changes tested?

  • The full matrix of regtests run against current develop.

• Are the changes covered by regression tests? (If not, why? Do new tests need to be added?)

  • The changes are not covered by regression tests as we do not test for documentation.

• Have the matrix regression tests been run (if yes, please note HPC and compiler)?

  • Yes. Hera / Intel.

• Please indicate the expected changes in the regression test output, (Note the list of known non-identical tests.)

  • The only expected changes are the known non-identical tests.

• Please provide the summary output of matrix.comp (matrix.Diff.txt, matrixCompFull.txt and matrixCompSummary.txt):

**********************************************************************
********************* non-identical cases ****************************
**********************************************************************
mww3_test_03/./work_PR2_UNO_MPI_d2                     (15 files differ)
mww3_test_03/./work_PR1_MPI_d2                     (19 files differ)
mww3_test_03/./work_PR3_UNO_MPI_d2_c                     (14 files differ)
mww3_test_03/./work_PR3_UQ_MPI_d2_c                     (16 files differ)
mww3_test_03/./work_PR3_UNO_MPI_d2                     (17 files differ)
mww3_test_03/./work_PR2_UQ_MPI_d2                     (15 files differ)
mww3_test_03/./work_PR3_UQ_MPI_d2                     (15 files differ)
ww3_ta1/./work_UPD0F_U                     (0 files differ)
ww3_tp2.10/./work_MPI_OMPH                     (6 files differ)
ww3_tp2.16/./work_MPI_OMPH                     (4 files differ)
ww3_tp2.17/./work_a                     (1 files differ)
ww3_tp2.17/./work_c                     (1 files differ)
ww3_tp2.17/./work_b                     (1 files differ)
ww3_tp2.6/./work_ST0                     (1 files differ)
ww3_tp2.6/./work_ST4                     (1 files differ)
ww3_tp2.6/./work_pdlib                     (1 files differ)
ww3_ufs1.3/./work_a                     (1 files differ)
**********************************************************************
************************ identical cases *****************************
**********************************************************************

• matrixCompSummary.txt
• matrixCompFull.txt
• matrixDiff.txt

[JessicaMeixner-NOAA]

**********************************************************************
********************* non-identical cases ****************************
**********************************************************************
mww3_test_03/./work_PR2_UNO_MPI_d2                     (12 files differ)
mww3_test_03/./work_PR1_MPI_d2                     (19 files differ)
mww3_test_03/./work_PR3_UNO_MPI_d2_c                     (17 files differ)
mww3_test_03/./work_PR3_UQ_MPI_d2_c                     (15 files differ)
mww3_test_03/./work_PR3_UNO_MPI_d2                     (15 files differ)
mww3_test_03/./work_PR2_UQ_MPI_d2                     (15 files differ)
mww3_test_03/./work_PR3_UQ_MPI_d2                     (15 files differ)
ww3_ta1/./work_UPD0F_U                     (0 files differ)
ww3_tp2.10/./work_MPI_OMPH                     (7 files differ)
ww3_tp2.16/./work_MPI_OMPH                     (4 files differ)
ww3_tp2.17/./work_a                     (1 files differ)
ww3_tp2.17/./work_c                     (1 files differ)
ww3_tp2.17/./work_b                     (1 files differ)
ww3_tp2.6/./work_ST0                     (1 files differ)
ww3_tp2.6/./work_ST4                     (1 files differ)
ww3_tp2.6/./work_pdlib                     (1 files differ)
ww3_ufs1.3/./work_a                     (1 files differ)

matrixCompFull.txt
matrixCompSummary.txt
matrixDiff.txt