added documentation build to workflows, turned on doxygen warnings fo…

…r missing documentation (#297)

* turning on docs build in existing workflows

Also turned on warnings in doxygen.

.github/workflows/esmf-8.0.1_jasper-2.0.22_nceplibs-1.3.0.yml

@@ -122,7 +122,7 @@ jobs:
         export ESMFMKFILE=~/esmf/lib/esmf.mk
         cd ufs_utils
         mkdir build && cd build
-        cmake .. -DCMAKE_PREFIX_PATH='~;~/jasper;~/nceplibs'
+        cmake .. -DCMAKE_PREFIX_PATH='~;~/jasper;~/nceplibs' -DENABLE_DOCS=On
         make -j2
         make test
 

.github/workflows/esmf-8.0.1_jasper-2.0.22_nceplibs-develop.yml

@@ -113,7 +113,7 @@ jobs:
         export ESMFMKFILE=~/esmf/lib/esmf.mk
         cd ufs_utils
         mkdir build && cd build
-        cmake .. -DCMAKE_PREFIX_PATH='~;~/jasper'
+        cmake .. -DCMAKE_PREFIX_PATH='~;~/jasper' -DENABLE_DOCS=On
         make -j2
         make test
 

docs/Doxyfile.in

@@ -697,7 +697,7 @@ WARNINGS               = YES
 # will automatically be disabled.
 # The default value is: YES.
 
-WARN_IF_UNDOCUMENTED   = NO
+WARN_IF_UNDOCUMENTED   = YES
 
 # If the WARN_IF_DOC_ERROR tag is set to YES, doxygen will generate warnings for
 # potential errors in the documentation, such as not documenting some parameters
@@ -731,6 +731,10 @@ WARN_FORMAT            = "$file:$line: $text"
 
 WARN_LOGFILE           =
 
+# WARN_AS_ERROR causes warnings to be treated as errors.
+
+WARN_AS_ERROR = NO
+
 #---------------------------------------------------------------------------
 # Configuration options related to the input files
 #---------------------------------------------------------------------------