Compile issue Failed to find qtcore.tags in /usr/share/qt5/doc

[csvke]

I am on Ubuntu 24.04 and am trying to prepare the environment to build Pokit

sudo apt install qtbase5-dev qttools5-dev-tools qtconnectivity5-dev qttools5-dev qt5-doc qtconnectivity5-doc

I received this error when I run cmake -D CMAKE_BUILD_TYPE=Releases -DBUILD_WITH_QTDOCS=OFF -S ~/dokit/ -B

cmake -D CMAKE_BUILD_TYPE=Releases -DBUILD_WITH_QTDOCS=OFF -S ~/dokit/ -B ~/dokit/build
-- CMake version is 3.28.3
-- CMake build type is Releases
-- Dokit 0.5.3-pre
-- Enabling additional compile warnings
-- Treating compile warnings as errors
-- Found Qt 5.15.13
-- Found Qt Bluetooth 5.15.13
-- Found Qt Linguist Tools 5.15.13
CMake Error at /usr/share/cmake-3.28/Modules/FindPackageHandleStandardArgs.cmake:230 (message):
  Could NOT find QtDocs (missing: Core)

      Reason given by package: Failed to find qtcore.tags in /usr/share/qt5/doc

Call Stack (most recent call first):
  /usr/share/cmake-3.28/Modules/FindPackageHandleStandardArgs.cmake:600 (_FPHSA_FAILURE_MESSAGE)
  build/_deps/findqtdocs-src/FindQtDocs.cmake:105 (find_package_handle_standard_args)
  doc/CMakeLists.txt:8 (find_package)


-- Configuring incomplete, errors occurred!

[pcolby]

Hi @csvke, the short version is you also need:

sudo apt install qtbase5-doc-dev qtconnectivity5-doc-html

Longer version: to build the Doxygen-based docs, the build system wants the qtcore.tags (and qtconnctivity.tags), which are in those two packages respectively 🙂

Cheers.

PS: I have no idea why Ubuntu (and Debian?) put the qtconnectivity.tags file in a *-doc-html package 🤷🏼‍♂️

[pcolby]

I've also just added a small tip to the README.md file to show some suggested apt install commands.

Cheers.

[csvke]

Thank you @pcolby

But when I then try to build the docs

cmake -S ~/dokit/ -B ~/dokit/tmp-build
-- CMake version is 3.28.3
-- CMake build type is 
-- Dokit 0.5.3-pre
-- Enabling additional compile warnings
-- Treating compile warnings as errors
-- Found Qt 5.15.13
-- Found Qt Bluetooth 5.15.13
-- Found Qt Linguist Tools 5.15.13
-- Using Qt doc tagfiles /usr/share/qt5/doc => https://doc.qt.io/qt-5/
-- Could NOT find Doxygen (missing: DOXYGEN_EXECUTABLE) 
-- Configuring done (0.9s)
-- Generating done (0.3s)
-- Build files have been written to: /home/csvke/dokit/tmp-build

cmake --build ~/dokit/tmp-build/ --target doc doc-internal
gmake: *** No rule to make target 'doc-internal'.  Stop.

cmake --build ~/dokit/tmp-build/ --target doc

ls ~/dokit/doc/
CMakeLists.txt  doxyfile.in  doxygen-awesome-css  src

ls ~/dokit/doc/src/
internal  public

ls ~/dokit/doc/src/public/
mainpage.md

[pcolby]

Hi @csvke, it looks like its failing to find Doxygen, ie:

-- Could NOT find Doxygen (missing: DOXYGEN_EXECUTABLE)

To build the doc and doc-internal targets, you'll need to install doxygen, eg:

sudo apt install doxyen

Alternatively, download and install (or add to your $PATH) a more recent Doxygen release from https://github.com/doxygen/doxygen/releases (Ubuntu's is a little old).

Cheers.

PS, if you want o build the coverage and/or coverage-html targets, then you need to install lcov too:

sudo apt install lcov