[DOC] Update doxygen to 1.9.3 and fix warnings (#59)

Signed-off-by: Lydia Buntrock <[email protected]>

Co-authored-by: Enrico Seiler <[email protected]>

.github/workflows/ci_misc.yml

@@ -74,7 +74,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

include/sharg/argument_parser.hpp

@@ -160,8 +160,8 @@ class argument_parser
      *
      * \throws sharg::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/sharg/validators.hpp

@@ -363,7 +363,6 @@ class file_validator_base
 
     /*!\brief Checks if the given path is readable.
      * \param path The path to check.
-     * \returns `true` if readable, otherwise `false`.
      * \throws sharg::validation_error if the path is not readable, or
      *         std::filesystem::filesystem_error on underlying OS API errors.
      */
@@ -391,7 +390,6 @@ class file_validator_base
 
     /*!\brief Checks if the given path is writable.
      * \param path The path to check.
-     * \returns `true` if writable, otherwise `false`.
      * \throws sharg::validation_error if the file could not be opened for writing, or
      *         std::filesystem::filesystem_error on underlying OS API errors.
      */