Update to use /examples directory instead of /example

- Changed cpp-library.cmake to look for examples/*.cpp instead of example/*.cpp
- Updated Doxyfile template to use EXAMPLES_PATH instead of EXAMPLE_PATH
- Updated docs module to set EXAMPLES_PATH variable correctly
- Maintains consistency with modern project conventions

Author: sean-parent

cmake/cpp-library-ci.cmake

@@ -7,7 +7,6 @@ function(_cpp_library_setup_ci)
         NAME
         VERSION
         DESCRIPTION
-        CI_DEPLOY_DOCS  # Always YES, but kept as parameter for template substitution
     )
 
     cmake_parse_arguments(ARG "" "${oneValueArgs}" "" ${ARGN})

cmake/cpp-library-docs.cmake

@@ -42,7 +42,7 @@ function(_cpp_library_setup_docs)
     set(INPUT_DIR "${CMAKE_CURRENT_SOURCE_DIR}/include")
     set(OUTPUT_DIR "${CMAKE_CURRENT_BINARY_DIR}")
     set(AWESOME_CSS_PATH "${AWESOME_CSS_DIR}")
-    set(EXAMPLE_PATH "${CMAKE_CURRENT_SOURCE_DIR}/example")
+    set(EXAMPLES_PATH "${CMAKE_CURRENT_SOURCE_DIR}/examples")
 
     # Convert exclude symbols list to space-separated string
     if(ARG_DOCS_EXCLUDE_SYMBOLS)

cpp-library.cmake

@@ -113,21 +113,20 @@ function(cpp_library_setup)
             NAME "${ARG_NAME}"
             VERSION "${ARG_VERSION}"
             DESCRIPTION "${ARG_DESCRIPTION}"
-            CI_DEPLOY_DOCS YES  # Always enable docs deployment
         )
     endif()
 
     # Build examples if specified  
     if(ARG_EXAMPLES)
         foreach(example IN LISTS ARG_EXAMPLES)
-            if(EXISTS "${CMAKE_CURRENT_SOURCE_DIR}/example/${example}.cpp")
+            if(EXISTS "${CMAKE_CURRENT_SOURCE_DIR}/examples/${example}.cpp")
                 string(REPLACE "${ARG_NAMESPACE}-" "" CLEAN_NAME "${ARG_NAME}")
 
                 # Check if this is a compile-fail test (has "_fail" in the name)
                 string(FIND "${example}" "_fail" fail_pos)
                 if(fail_pos GREATER -1)
                     # Negative compile test: this example must fail to compile
-                    add_executable(${example} EXCLUDE_FROM_ALL "example/${example}.cpp")
+                    add_executable(${example} EXCLUDE_FROM_ALL "examples/${example}.cpp")
                     target_link_libraries(${example} PRIVATE ${ARG_NAMESPACE}::${CLEAN_NAME})
                     add_test(
                         NAME compile_${example}
@@ -137,12 +136,12 @@ function(cpp_library_setup)
                     set_tests_properties(compile_${example} PROPERTIES WILL_FAIL TRUE)
                 else()
                     # Regular example
-                    add_executable(${example} "example/${example}.cpp")
+                    add_executable(${example} "examples/${example}.cpp")
                     target_link_libraries(${example} PRIVATE ${ARG_NAMESPACE}::${CLEAN_NAME})
                     add_test(NAME ${example} COMMAND ${example})
                 endif()
             else()
-                message(WARNING "Example file example/${example}.cpp not found")
+                message(WARNING "Example file examples/${example}.cpp not found")
             endif()
         endforeach()
     endif()

templates/Doxyfile.in

@@ -8,7 +8,7 @@ WARN_IF_UNDOCUMENTED   = YES
 INPUT                  = @INPUT_DIR@
 RECURSIVE              = YES
 EXCLUDE_SYMBOLS        = @EXCLUDE_SYMBOLS@
-EXAMPLE_PATH           = @EXAMPLE_PATH@
+EXAMPLE_PATH           = @EXAMPLES_PATH@
 HTML_EXTRA_STYLESHEET  = @AWESOME_CSS_PATH@/doxygen-awesome.css \
                          @AWESOME_CSS_PATH@/doxygen-awesome-sidebar-only.css \
                          @AWESOME_CSS_PATH@/doxygen-awesome-sidebar-only-darkmode-toggle.css