Merge pull request #2923 from eseiler/infra/doxygen

[INFRA] Bump doxygen to 1.9.3

.github/workflows/ci_misc.yml

@@ -124,7 +124,7 @@ jobs:
             build_threads: 2
             test_threads: 2
             cmake: 3.10.3
-            doxygen: 1.9.2
+            doxygen: 1.9.3
             requires_toolchain: false
             requires_ccache: false
             skip_build_tests: true

.github/workflows/documentation.yaml

@@ -13,7 +13,7 @@ concurrency:
 
 env:
   CMAKE_VERSION: 3.10.3
-  DOXYGEN_VERSION: 1.9.2
+  DOXYGEN_VERSION: 1.9.3
   TZ: Europe/Berlin
 
 defaults:

CHANGELOG.md

@@ -26,6 +26,12 @@ If possible, provide tooling that performs the changes, e.g. a shell-script.
 
 # 3.2.0
 
+## New features
+
+#### Build system
+
+* We now use Doxygen version 1.9.3 to build our documentation ([\#2923](https://github.com/seqan/seqan3/pull/2923)).
+
 ## Notable Bug-fixes
 
 #### Utility

include/seqan3/alignment/matrix/detail/affine_cell_proxy.hpp

@@ -393,16 +393,12 @@ namespace std
 {
 //!\cond
 template <typename tuple_t>
-//!\cond
     requires (seqan3::detail::affine_score_cell<tuple_t> || seqan3::detail::affine_score_and_trace_cell<tuple_t>)
-//!\endcond
 struct tuple_size<seqan3::detail::affine_cell_proxy<tuple_t>> : public tuple_size<tuple_t>
 {};
 
 template <size_t index, typename tuple_t>
-//!\cond
     requires (seqan3::detail::affine_score_cell<tuple_t> || seqan3::detail::affine_score_and_trace_cell<tuple_t>)
-//!\endcond
 struct tuple_element<index, seqan3::detail::affine_cell_proxy<tuple_t>> : public tuple_element<index, tuple_t>
 {};
 //!\endcond

include/seqan3/argument_parser/argument_parser.hpp

@@ -170,8 +170,8 @@ class argument_parser
      *
      * \throws seqan3::design_error if the application name contains illegal characters.
      *
-     * The application name must only contain alpha-numeric characters, '_' or '-',
-     * i.e. the following regex must evaluate to true: `\"^[a-zA-Z0-9_-]+$\"`.
+     * The application name must only contain alpha-numeric characters, `_` or `-`,
+     * i.e. the following regex must evaluate to true: `"^[a-zA-Z0-9_-]+$"`.
      *
      * See the [argument parser tutorial](https://docs.seqan.de/seqan/3-master-dev/tutorial_argument_parser.html)
      * for more information about the version check functionality.

include/seqan3/utility/tuple/pod_tuple.hpp

@@ -24,11 +24,9 @@ namespace seqan3
 #define SEQAN_NOT_POD "If you are not going to insert a POD type, use std::tuple instead."
 //!\endcond
 
-//!cond
 template <typename ...types>
 struct pod_tuple
 {};
-//!\endcond
 
 /*!\brief Behaves like std::tuple but is an aggregate [PODType](https://en.cppreference.com/w/cpp/named_req/PODType).
  * \ingroup utility_tuple

test/documentation/.vercel/install.sh

@@ -1,7 +1,7 @@
 #!/usr/bin/env bash
 set -exo pipefail
 
-DOXYGEN_VERSION=1.9.2
+DOXYGEN_VERSION=1.9.3
 SOURCE_DIR=`pwd`
 CACHE_DIR="${SOURCE_DIR}/node_modules"