Skip to content

Test doxygen on alma10 - #22321

Draft
hageboeck wants to merge 9 commits into
root-project:masterfrom
hageboeck:doxygen_alma10
Draft

Test doxygen on alma10#22321
hageboeck wants to merge 9 commits into
root-project:masterfrom
hageboeck:doxygen_alma10

Conversation

@hageboeck

Copy link
Copy Markdown
Member

No description provided.

@hageboeck hageboeck self-assigned this May 18, 2026
@hageboeck
hageboeck force-pushed the doxygen_alma10 branch 4 times, most recently from 71dee01 to 3468ea1 Compare May 18, 2026 13:43
@hageboeck hageboeck added skip ci Skip the full builds on the actions runners skip code analysis Skip the code analysis CI steps for this PR, including verifying clang-formatting and running Ruff. labels May 18, 2026
@github-actions

github-actions Bot commented May 18, 2026

Copy link
Copy Markdown

Test Results

0 tests   0 ✅  0s ⏱️
0 suites  0 💤
0 files    0 ❌

Results for commit a629793.

♻️ This comment has been updated with latest results.

@hageboeck
hageboeck force-pushed the doxygen_alma10 branch 5 times, most recently from 0c2d436 to a102b67 Compare May 19, 2026 18:18
@hageboeck
hageboeck force-pushed the doxygen_alma10 branch 10 times, most recently from f3ba64c to 0199a7c Compare May 28, 2026 10:06
@hageboeck
hageboeck force-pushed the doxygen_alma10 branch 2 times, most recently from a365281 to bcd312d Compare June 10, 2026 05:32
@hageboeck
hageboeck force-pushed the doxygen_alma10 branch 4 times, most recently from 1debec0 to cdbcb01 Compare June 23, 2026 14:48
@hageboeck
hageboeck force-pushed the doxygen_alma10 branch 2 times, most recently from d855da6 to 9cdd8aa Compare June 24, 2026 14:26
Strings such as "\s" are not correct, any more.
For the doxygen build, it's sufficient to take the source directory
prepared by the checkout action. Therefore, a --source_dir argument has
been added to the script, which simply picks up the source directory.
- Base the doxygen job on the alma10 container.
- This allows for using a preinstalled doxygen in the container
  (currently 1.13.2), replacing the manual install of 1.10
- Also use preinstalled XRootD and qhelpgenerator
- Mount the alma10 ccache volume to speed up builds
- Remove the override step from the doxygen job.  Overrides can be
  specified as command-line arguments, which significantly shortens the
  job file.
- Remove the duplicated build step. There is no difference between the jobs,
  so we don't need build job based on the workflow trigger.
- Create & compress the tar archive in one go.
- Move to qhelpgenerator from qt6:
  In qt6, with Alma10, qhelpgenerator moved to /usr/lib64, so doxygen didn't
  find it.
The md5 and map files are used only when doxygen is run on an existing
folder. They therefore should not be uploaded or put in the tar archive.
- Add a pull request trigger. This builds the documentation when the
  doxygen job .yml or files in the doxygen folder are changed.
- For manual triggers, allow for choosing the eos upload directory as a
  job input.
- Use only one single checkout for the entire job. The github checkout
  action knows how to get the correct branch that triggered the
  workflow, or how to get the PR merge commit. ROOT is built from that
  source directory, and doxygen subsequently runs from that directory.
- Remove the workflow input "incremental". Since the documentation jobs
  don't upload or download anything, it is without effect.
- Run eos upload based on whether secrets are present (i.e. not when PR
  comes from a fork).
This helps to show the customisations wrt. a default config.
Mostly quote variables to avoid unwanted expansions.
By default, the upload action puts the archive into an archive and tries
to compress it. This is unnecessary.
Furthermore, reduce the retention period to a week. The default of 90
days is excessive for a nightly job.
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

skip ci Skip the full builds on the actions runners skip code analysis Skip the code analysis CI steps for this PR, including verifying clang-formatting and running Ruff.

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant