doxygen: add v1.10.0, improve maintainability

[valgur]

No description provided.

[github-actions]

This pull request has been automatically marked as stale because it has not had recent activity. It will be closed if no further activity occurs. Thank you for your contributions.

[tkhyn]

Hi,

Doxygen < 1.9.8 cannot be built with CMake >= 3.27 because of CMP0148. Could a review of this PR be prioritized?

I also have some improvement suggestions in this commit. As there are already 2 PRs on this recipe I will refrain from opening a new PR unless requested to. This commit:

• adds CPython as a build requirement (in case Python is not available globally on the build system. Edge case but definitely possible as it happened to me on a new machine)
• package_info made a bit more Conan2-friendly (i.e. properly adding the bin directory to runenv and buildenv)

[uilianries]

Just generated the missing package for xapian-core: https://c3i.jfrog.io/c3i/misc-v2/summary.html?json=https://c3i.jfrog.io/c3i/misc-v2/logs/prod-v2/TapaholesRepo/7/summary.json

Restarted the build now.

[gvol]

I would love a newer version of doxygen in conan so that I can use it at work. There are some nice features I'd like to use.

I'm not very good with conan, but is there anything I can do to help?

[conan-center-bot]

Conan v1 pipeline ❌

Failure in build 6 (4110c3e70b3b5044d9e457075220f91ff66bc5a9):

• doxygen/1.9.4:
  Didn't run or was cancelled before finishing

• doxygen/1.9.2:
  Didn't run or was cancelled before finishing

• doxygen/1.12.0:
  CI failed to create some packages (All logs)

  Logs for packageID 938fc0434a5c874be39c9c0d55018d3cc290b53e:

  [settings]
  arch=x86_64
  build_type=Release
  compiler=gcc
  compiler.libcxx=libstdc++11
  compiler.version=7
  os=Linux
  

  [...]
                                ^
  /home/conan/workspace/prod-v1/bsr/94238/bfbfe/.conan/data/doxygen/1.12.0/_/_/build/938fc0434a5c874be39c9c0d55018d3cc290b53e/src/src/searchindex.cpp: In member function ‘void SearchIndexExternal::write(const QCString&)’:
  /home/conan/workspace/prod-v1/bsr/94238/bfbfe/.conan/data/doxygen/1.12.0/_/_/build/938fc0434a5c874be39c9c0d55018d3cc290b53e/src/src/searchindex.cpp:510:25: warning: unused variable ‘name’ [-Wunused-variable]
       for (auto &[name,doc] : m_docEntries)
                           ^
  /home/conan/workspace/prod-v1/bsr/94238/bfbfe/.conan/data/doxygen/1.12.0/_/_/build/938fc0434a5c874be39c9c0d55018d3cc290b53e/src/src/sqlite3gen.cpp:2538:38: warning: ISO C++11 requires at least one argument for the "..." in a variadic macro
       err("sqlite3_initialize failed\n");
                                        ^
  /home/conan/workspace/prod-v1/bsr/94238/bfbfe/.conan/data/doxygen/1.12.0/_/_/build/938fc0434a5c874be39c9c0d55018d3cc290b53e/src/src/sqlite3gen.cpp:2553:93: warning: ISO C++11 requires at least one argument for the "..." in a variadic macro
         err("doxygen_sqlite3.db already exists! Rename, remove, or archive it to regenerate\n");
                                                                                               ^
  /home/conan/workspace/prod-v1/bsr/94238/bfbfe/.conan/data/doxygen/1.12.0/_/_/build/938fc0434a5c874be39c9c0d55018d3cc290b53e/src/src/sqlite3gen.cpp:2601:56: warning: ISO C++11 requires at least one argument for the "..." in a variadic macro
       err("sqlite generator: prepareStatements failed!\n");
                                                          ^
  /home/conan/workspace/prod-v1/bsr/94238/bfbfe/.conan/data/doxygen/1.12.0/_/_/build/938fc0434a5c874be39c9c0d55018d3cc290b53e/src/src/searchindex_js.cpp: In function ‘void createJavaScriptSearchIndex()’:
  /home/conan/workspace/prod-v1/bsr/94238/bfbfe/.conan/data/doxygen/1.12.0/_/_/build/938fc0434a5c874be39c9c0d55018d3cc290b53e/src/src/searchindex_js.cpp:479:29: warning: unused variable ‘name’ [-Wunused-variable]
       for (auto &[name,symList] : sii.symbolMap) // for each symbol in the index
                               ^
  /home/conan/workspace/prod-v1/bsr/94238/bfbfe/.conan/data/doxygen/1.12.0/_/_/build/938fc0434a5c874be39c9c0d55018d3cc290b53e/src/src/searchindex_js.cpp: In function ‘void writeJavascriptSearchData(const QCString&)’:
  /home/conan/workspace/prod-v1/bsr/94238/bfbfe/.conan/data/doxygen/1.12.0/_/_/build/938fc0434a5c874be39c9c0d55018d3cc290b53e/src/src/searchindex_js.cpp:513:38: warning: unused variable ‘list’ [-Wunused-variable]
           for (const auto &[letter,list] : sii.symbolMap)
                                        ^
  /home/conan/workspace/prod-v1/bsr/94238/bfbfe/.conan/data/doxygen/1.12.0/_/_/build/938fc0434a5c874be39c9c0d55018d3cc290b53e/src/src/searchindex_js.cpp: In function ‘void writeJavaScriptSearchIndex()’:
  /home/conan/workspace/prod-v1/bsr/94238/bfbfe/.conan/data/doxygen/1.12.0/_/_/build/938fc0434a5c874be39c9c0d55018d3cc290b53e/src/src/searchindex_js.cpp:781:39: warning: unused variable ‘letter’ [-Wunused-variable]
         for (const auto &[letter,symList] : sii.symbolMap)
                                         ^
  /home/conan/workspace/prod-v1/bsr/94238/bfbfe/.conan/data/doxygen/1.12.0/_/_/build/938fc0434a5c874be39c9c0d55018d3cc290b53e/src/src/searchindex_js.cpp:804:39: warning: unused variable ‘letter’ [-Wunused-variable]
         for (const auto &[letter,symList] : sii.symbolMap)
                                         ^
  /home/conan/workspace/prod-v1/bsr/94238/bfbfe/.conan/data/doxygen/1.12.0/_/_/build/938fc0434a5c874be39c9c0d55018d3cc290b53e/src/src/vhdldocgen.cpp:3068:38: warning: ISO C++11 requires at least one argument for the "..." in a variadic macro
       err("could not create dot file\n");
                                        ^
  /home/conan/workspace/prod-v1/bsr/94238/bfbfe/.conan/data/doxygen/1.12.0/_/_/build/938fc0434a5c874be39c9c0d55018d3cc290b53e/src/src/xmlgen.cpp: In function ‘void writeExports(const ImportInfoMap&, TextStream&)’:
  /home/conan/workspace/prod-v1/bsr/94238/bfbfe/.conan/data/doxygen/1.12.0/_/_/build/938fc0434a5c874be39c9c0d55018d3cc290b53e/src/src/xmlgen.cpp:1298:36: warning: unused variable ‘moduleName’ [-Wunused-variable]
     for (auto &[moduleName,importInfo] : exportMap)
                                      ^
  /home/conan/workspace/prod-v1/bsr/94238/bfbfe/.conan/data/doxygen/1.12.0/_/_/build/938fc0434a5c874be39c9c0d55018d3cc290b53e/src/addon/doxyparse/doxyparse.cpp: In function ‘int main(int, char**)’:
  /home/conan/workspace/prod-v1/bsr/94238/bfbfe/.conan/data/doxygen/1.12.0/_/_/build/938fc0434a5c874be39c9c0d55018d3cc290b53e/src/addon/doxyparse/doxyparse.cpp:498:9: warning: ignoring return value of ‘int scanf(const char*, ...)’, declared with attribute warn_unused_result [-Wunused-result]
           (void)scanf("%s[^\n]", filename);
           ^~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  /home/conan/workspace/prod-v1/bsr/94238/bfbfe/.conan/data/doxygen/1.12.0/_/_/build/938fc0434a5c874be39c9c0d55018d3cc290b53e/src/addon/doxyparse/doxyparse.cpp:536:3: warning: ignoring return value of ‘int system(const char*)’, declared with attribute warn_unused_result [-Wunused-result]
     (void)system(cleanup_command.c_str());
     ^~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  WARN: *** Conan 1 is legacy and on a deprecation path ***
  WARN: *** Please upgrade to Conan 2 ***
  WARN: xapian-core/1.4.19: requirement zlib/[>=1.2.11 <2] overridden by doxygen/1.12.0 to zlib/1.3.1 
  doxygen/1.12.0: WARN: Using the new toolchains and generators without specifying a build profile (e.g: -pr:b=default) is discouraged and might cause failures and unexpected behavior
  doxygen/1.12.0: WARN: Using the new toolchains and generators without specifying a build profile (e.g: -pr:b=default) is discouraged and might cause failures and unexpected behavior
  [HOOK - conan-center.py] post_package(): ERROR: [DEFAULT PACKAGE LAYOUT (KB-H013)] Unknown folder 'share' in the package (https://github.com/conan-io/conan-center-index/blob/master/docs/error_knowledge_base.md#KB-H013-DEFAULT-PACKAGE-LAYOUT) 
  ERROR: [HOOK - conan-center.py] post_package(): Some checks failed running the hook, check the output
  

• doxygen/1.8.18:
  Didn't run or was cancelled before finishing

• doxygen/1.9.1:
  Didn't run or was cancelled before finishing

• doxygen/1.8.20:
  Didn't run or was cancelled before finishing

• doxygen/1.8.17:
  Didn't run or was cancelled before finishing

---

^{Note: To save resources, CI tries to finish as soon as an error is found. For this reason you might find that not all the references have been launched or not all the configurations for a given reference. Also, take into account that we cannot guarantee the order of execution as it depends on CI workload and workers availability.}