Build System: Update Doxygen to >=1.10.0 to fix URLs in Headlines

[crasbe]

Description

While updating the LOSTANDFOUND.md file, I noticed that the headlines are not correctly formatted. After some (a lot) of searching I found out that this is a Doxygen bug ( doxygen/doxygen#10466 ) which has been fixed in version >=1.10.0 ( doxygen/doxygen#10466 (comment) ).

I'm not sure if that was a regression introduced to Doxygen at some point or if it never looked right (which I doubt).
Perhaps something in the RIOT documentation will break when updating Doxygen. For testing, I installed the lastest 1.12.0 and it complained about some configuration options being deprecrated. However my Doxygen knowledge is quite limited, so this might have some side effects or additional effort attached to it.

Current Behavior

This is a screenshot taken from https://doc.riot-os.org/md_LOSTANDFOUND.html

Expected Behaviour

This was rendered on my machine with Doxygen 1.12.0:

[miri64]

I mainly assigned @OlegHahm to figure out, if this somehow conflicts with the cronjob that generates https://doc.riot-os.org/.

[crasbe]

The main headache with this issue is that several Linux distributions don't ship Doxygen 1.10.0 yet. For example, this is the current state for Ubuntu (which I think the CI uses?) https://launchpad.net/ubuntu/+source/doxygen
Therefore it would have to be installed manually, but I don't know much about how the CI works.

The current version of Doxygen is 1.13.2 by the way and the old 1.9.8 is from late 2023 🫠
For some packages the "old is gold" strategy from Debian-based distributions can be quite annoying, but that's beside the point 😅

[OlegHahm]

I just updated the docker container for the build job to the latest Alpine version and doxygen is now at 1.12.0. I also re-delivered the latest webhook that triggers building the documentation. As far as I can tell that seems to have worked.

[crasbe]

It looks fixed indeed. Thank you @OlegHahm :)

[miri64]

I just updated the docker container for the build job to the latest Alpine version and doxygen is now at 1.12.0. I also re-delivered the latest webhook that triggers building the documentation. As far as I can tell that seems to have worked.

Does this also fix the generation by Murdock on PRs?

[OlegHahm]

Not sure I know the entire workflow. There is a webhook called by Github on any push which will trigger to rebuild the documentation. I don't know where (and for what reason) Murdock is involved. Is there some sort of a preview for PRs?

[crasbe]

Worst case we'll have to wait for a day or two and see once the next PR is merged.

[miri64]

Is there some sort of a preview for PRs?

Yes, see e.g. #21154 (comment)

[miri64]

I think this is the dockerfile for the container of the murdock build https://github.com/RIOT-OS/murdock-scripts/blob/master/Dockerfile. With the actual build happening here https://github.com/RIOT-OS/murdock-scripts/blob/master/build.sh#L279-L283. The webhook is only for pushes to master.

[OlegHahm]

The Dockerfile in murdock is based on Ubuntu 22.04 where doxygen is apparently still the 1.9 version. Not sure if updating this dockerfile is easily possible.

[OlegHahm]

But even in newer Ubuntu versions the doxygen package seems to stick to this version.