Fix 472 of 477 Doxygen @param warnings and add WARN_LOGFILE

- Add DOXYGEN_WARN_LOGFILE to CMakeLists.txt and Doxyfile.in to capture
  per-target warning logs during documentation builds
- Fix stale, missing, duplicate, and misspelled @param entries across 28
  source files (common, pre_process, post_process, simulation modules)
- Common module fixes (m_helper, m_model, m_mpi_common, m_phase_change,
  m_finite_differences) eliminate 3x warnings since each is shared across
  all three Doxygen targets
- Remaining 5 warnings are structural unbalanced grouping from
  fypp macro expansion, not @param issues

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

Author: sbryngelson

CMakeLists.txt

@@ -727,6 +727,8 @@ if (MFC_DOCUMENTATION)
         set(DOXYGEN_IMAGE_PATH       "\"${CMAKE_CURRENT_SOURCE_DIR}/docs/res\"\
                                       \"${CMAKE_CURRENT_SOURCE_DIR}/docs/${target}\"")
 
+        set(DOXYGEN_WARN_LOGFILE "\"${CMAKE_CURRENT_BINARY_DIR}/${target}-doxygen-warnings.log\"")
+
         file(MAKE_DIRECTORY "${DOXYGEN_OUTPUT_DIRECTORY}")
 
         configure_file(

docs/Doxyfile.in

@@ -806,7 +806,7 @@ WARN_FORMAT            = "$file:$line: $text"
 # messages should be written. If left blank the output is written to standard
 # error (stderr).
 
-WARN_LOGFILE           =
+WARN_LOGFILE           = @DOXYGEN_WARN_LOGFILE@
 
 #---------------------------------------------------------------------------
 # Configuration options related to the input files

docs/documentation/authors.md

@@ -3,3 +3,6 @@
 ## Authors
 
 Contributors to MFC since 2019 can be [viewed here](https://github.com/MFlowCode/MFC/graphs/contributors).
+
+
+<div style='text-align:center; font-size:0.75rem; color:#888; padding:16px 0 0;'>Page last updated: 2026-02-04</div>

docs/documentation/case.md

@@ -1202,3 +1202,6 @@ The above variables are used for all simulations.
 | hypoelastic variables     | N/A |
 
 The above variables correspond to optional physics.
+
+
+<div style='text-align:center; font-size:0.75rem; color:#888; padding:16px 0 0;'>Page last updated: 2026-02-15</div>

docs/documentation/contributing.md

@@ -767,3 +767,6 @@ If your change touches GPU code (`src/simulation/`), see the GPU checklist in th
 - A maintainer will merge your PR once all reviews are approved and CI is green
 
 If your PR is large or architectural, consider opening an issue first to discuss the approach.
+
+
+<div style='text-align:center; font-size:0.75rem; color:#888; padding:16px 0 0;'>Page last updated: 2026-02-15</div>

docs/documentation/docker.md

@@ -188,3 +188,6 @@ linux/loong64
 linux/arm/v7
 linux/arm/v6
 ```
+
+
+<div style='text-align:center; font-size:0.75rem; color:#888; padding:16px 0 0;'>Page last updated: 2026-02-04</div>

docs/documentation/equations.md

@@ -1049,3 +1049,6 @@ Additionally, the **artificial Mach number** technique (`pi_fac`) modifies \f$\p
 
 **Advective flux limiting** based on local volume fraction gradient \f$\chi\f$ to prevent spurious oscillations near material interfaces.
 
+
+
+<div style='text-align:center; font-size:0.75rem; color:#888; padding:16px 0 0;'>Page last updated: 2026-02-15</div>

docs/documentation/expectedPerformance.md

@@ -208,3 +208,6 @@ The "base case" uses 2M and 8M grid points per process.
 CPU strong scaling tests are done with problem sizes of 16, 32, and 64M grid points, with the base case using 2, 4, and 8M cells per process.
 
 <img src="../res/strongScaling/cpuStrongScaling.svg" style="width: 50%; border-radius: 10pt"/>
+
+
+<div style='text-align:center; font-size:0.75rem; color:#888; padding:16px 0 0;'>Page last updated: 2026-02-16</div>

docs/documentation/getting-started.md

@@ -241,3 +241,6 @@ autoload -Uz compinit && compinit
 ```
 
 After reloading your shell, press Tab to complete commands and options.
+
+
+<div style='text-align:center; font-size:0.75rem; color:#888; padding:16px 0 0;'>Page last updated: 2026-02-15</div>

docs/documentation/gpuParallelization.md

@@ -779,3 +779,6 @@ LIBOMPTARGET_JIT_SKIP_OPT=1
   - NVHPC is built on top of LLVM
 - [OpenMP Docs](https://www.openmp.org/spec-html/5.1/openmp.html)
 - [OpenACC Docs](https://www.openacc.org/sites/default/files/inline-files/OpenACC.2.7.pdf)
+
+
+<div style='text-align:center; font-size:0.75rem; color:#888; padding:16px 0 0;'>Page last updated: 2026-02-04</div>