Doxygen updates

.github/workflows/GCC.yml

@@ -26,6 +26,10 @@ jobs:
 
     steps:
 
+    - name: install-doxygen
+      run: |
+        sudo apt-get install doxygen
+
     - name: checkout-fv3atm
       uses: actions/checkout@v3
       with:
@@ -60,7 +64,7 @@ jobs:
       if: ${{ always() }}
       with:
         path: ${{ github.workspace }}/spack-develop
-        key: spack-${{ hashFiles('fv3atm/ci/spack.yaml') }}-gcc${{ matrix.gcc_ver }}-2
+        key: spack-${{ hashFiles('fv3atm/ci/spack.yaml') }}-gcc${{ matrix.gcc_ver }}-2-${{ matrix.cmake_opts }}
 
     - name: build-fv3atm
       run: |
@@ -71,13 +75,31 @@ jobs:
         git clone https://github.com/NOAA-EMC/CMakeModules
         git clone --recurse-submodules https://github.com/NOAA-PSL/stochastic_physics stochastic_physics_repo
         mkdir ${GITHUB_WORKSPACE}/build
+        sed -i 's/doc /upp_doc /' upp/docs/CMakeLists.txt
+        cat upp/docs/CMakeLists.txt
         cd ${GITHUB_WORKSPACE}/build
-        cmake ${GITHUB_WORKSPACE}/fv3atm -DBUILD_TESTING=ON ${{ matrix.cmake_opts }}
+        cmake ${GITHUB_WORKSPACE}/fv3atm -DBUILD_TESTING=ON ${{ matrix.cmake_opts }} -DENABLE_DOCS=ON
         make -j2
+        ls -l ${GITHUB_WORKSPACE}/build
+        ls -l ${GITHUB_WORKSPACE}/build/docs
+        ls -l ${GITHUB_WORKSPACE}/build/docs/html        
 
+    - uses: actions/upload-artifact@v3
+      with:
+        name: docs
+        path: |
+          ${GITHUB_WORKSPACE}/build/docs/html
+
+    - uses: actions/upload-artifact@v3
+      with:
+        name: docs2
+        path: |
+          ${GITHUB_WORKSPACE}/build/docs/html/*
+
     - name: debug-artifacts
       uses: actions/upload-artifact@v3
       if: ${{ failure() }}
       with:
         name: ccpp_prebuild_logs
         path: ${{ github.workspace }}/build/ccpp/ccpp_prebuild.*
+

CMakeLists.txt

@@ -1,3 +1,17 @@
+# This is the main CMake file for fv3atm.
+#
+# Mark Potts, Kyle Gerheiser, Alex Richert
+cmake_minimum_required(VERSION 3.19)
+
+# Handle user build options.
+option(ENABLE_DOCS "Enable generation of doxygen-based documentation." OFF)
+
+# Determine whether or not to generate documentation.
+if(ENABLE_DOCS)
+  find_package(Doxygen REQUIRED)
+  add_subdirectory(docs)  
+endif()
+
 # Enable CI build & unit testing:
 if(BUILD_TESTING)
   cmake_minimum_required(VERSION 3.19)

docs/CMakeLists.txt

@@ -0,0 +1,17 @@
+# This is the CMake file for building the docs directory of fv3atm.
+#
+# Ed Hartnett 12/28/23
+
+IF(ENABLE_DOCS)
+
+  # Create doxyfile.
+  SET(abs_top_srcdir "${CMAKE_SOURCE_DIR}")
+  SET(abs_top_builddir "${CMAKE_BINARY_DIR}")
+  CONFIGURE_FILE(${CMAKE_CURRENT_SOURCE_DIR}/Doxyfile.in ${CMAKE_CURRENT_BINARY_DIR}/Doxyfile @ONLY)
+  ADD_CUSTOM_TARGET(doxygen_doc ALL
+    ${DOXYGEN_EXECUTABLE} ${CMAKE_CURRENT_BINARY_DIR}/Doxyfile
+    WORKING_DIRECTORY ${CMAKE_CURRENT_BINARY_DIR}
+    COMMENT "Generating API Documentation with Doxygen" VERBATIM)
+
+ENDIF(ENABLE_DOCS)
+