Skip to content

Commit 67f84c8

Browse files
authored
Merge pull request #3330 from eseiler/infra/webtag
[INFRA,DOC] Update doxygen webtags
2 parents 799f3b5 + 1608903 commit 67f84c8

File tree

1 file changed

+10
-3
lines changed

1 file changed

+10
-3
lines changed

test/documentation/seqan3-doxygen.cmake

Lines changed: 10 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -46,10 +46,11 @@ if (NOT EXISTS "${SEQAN3_DOXYGEN_STD_TAGFILE}" OR SEQAN3_DOXYGEN_STD_TAGFILE STR
4646
# Reset path in case it was set from the outside, but does not exist.
4747
set (SEQAN3_DOXYGEN_STD_TAGFILE "${SEQAN3_DEFAULT_DOXYGEN_STD_TAGFILE}")
4848
include (ExternalProject)
49+
# When updating, check whether warnings in SEQAN3_TEST_DOXYGEN_FAIL_ON_WARNINGS are gone when removing sed filter.
4950
ExternalProject_Add (
5051
download-cppreference-doxygen-web-tag
51-
URL "https://github.com/PeterFeicht/cppreference-doc/releases/download/v20220730/html-book-20220730.tar.xz"
52-
URL_HASH SHA256=71f15003c168b8dc5a00cbaf19b6480a9b3e87ab7e462aa39edb63d7511c028b
52+
URL "https://github.com/PeterFeicht/cppreference-doc/releases/download/v20241110/html-book-20241110.tar.xz"
53+
URL_HASH SHA256=431e80862eb70fd4793a60d7d3b6c13c8605284978f9ea0529572e8fd1562cc6
5354
TLS_VERIFY ON
5455
DOWNLOAD_DIR "${PROJECT_BINARY_DIR}"
5556
DOWNLOAD_NAME "html-book.tar.xz"
@@ -77,8 +78,14 @@ add_test (NAME cppreference-doxygen-web-tag COMMAND ${CMAKE_COMMAND} --build ${C
7778
download-cppreference-doxygen-web-tag)
7879

7980
# doxygen does not show any warnings (doxygen prints warnings / errors to cerr)
81+
# Second line filters warnings from tag file.
82+
# Note: Because the commands are line-wise, CMake will insert a semicolon between them.
83+
# If this is changed to be a single line, the semicolon must be manually inserted.
8084
set (SEQAN3_TEST_DOXYGEN_FAIL_ON_WARNINGS
81-
"${DOXYGEN_EXECUTABLE} -q > doxygen.cout 2> doxygen.cerr; cat \"doxygen.cerr\"; test ! -s \"doxygen.cerr\""
85+
"${DOXYGEN_EXECUTABLE} -q > doxygen.cout 2> doxygen.cerr"
86+
"sed -i '/documented symbol '\\''T std::experimental::erase'\\'' was not declared or defined\\./d; /documented symbol '\\''T std::experimental::erase_if'\\'' was not declared or defined\\./d' \"doxygen.cerr\""
87+
"cat \"doxygen.cerr\""
88+
"test ! -s \"doxygen.cerr\""
8289
CACHE INTERNAL "The doxygen test command")
8390

8491
### install helper

0 commit comments

Comments
 (0)