Skip to content

fix(build): Fix install command for documentation - #1633

Open
rlalik wants to merge 1 commit into
FairRootGroup:devfrom
rlalik:cmake_doc_fix_install
Open

rlalik wants to merge 1 commit into
FairRootGroup:devfrom
rlalik:cmake_doc_fix_install

Conversation

@rlalik

@rlalik rlalik commented Oct 27, 2026

Copy link
Copy Markdown

install(FILES ...) expects files, so it works when cmake is called for the first time, but when the make was called and the doc/html exists, and is directory, subsequent call to cmake fails because target is not file any more. Change to DIRECTORY solves the problem as cmake installs now whole directory tree structure.

install(FILES ...) expects files, so it works when cmake is called for the first time, but when the make was called and the doc/html exists, and is directory, subsequent call to cmake fails because target is not file any more. Change to DIRECTORY solves the problem as cmake installs now whole directory tree structure.
@coderabbitai

coderabbitai Bot commented Oct 27, 2026 •

Copy link
Copy Markdown

Review in Change Stack →

No actionable comments were generated in the recent review.

Recent review info
Run configuration
  • Source mode: Auto
  • Repository: Unavailable
  • Branch: Unavailable
  • File: No configuration file from this repository applied
  • Commit: Unavailable
  • Layers: Organization UI
  • Review profile: CHILL
  • Plan: Advanced
  • Run ID: 8cdd2cbe-424f-4be4-a35f-9cfd053d5412
Commits

Reviewing files that changed from the base of the PR and between 3dc9fdf and 9043556.

Files selected for processing: 2
  • CONTRIBUTORS
  • doxygen/CMakeLists.txt

Included review availability: This review used your included allowance. Your plan provides up to 1 included review per hour; 0 remain after this review.

Walkthrough

The contributors list now includes Lalik, Rafał with an ORCID profile link. The Doxygen CMake configuration installs generated HTML documentation as a directory, with the existing destination and component.

Changes: Contributor entry

Layer / File(s) Summary
Add contributor
CONTRIBUTORS
The contributors list gains Lalik, Rafał with an ORCID profile link.

Documentation installation

Layer / File(s) Summary
Install generated HTML directory
doxygen/CMakeLists.txt
The install command uses the directory form. The destination and component remain unchanged.

Priority: Low

Estimated code review effort: 1 (Trivial) | ~4 minutes

Merge Risk: Minimal · up to 90435

The changes are ready to merge; documentation installation now uses the appropriate directory form without an identified contract violation.

Pre-merge checks: Passed 5
Check name Status Explanation
Title check Passed The title names the change: the documentation install command in the build files is fixed. It matches the CMake change from install(FILES ...) to install(DIRECTORY ...) for the generated docs. The tit…
Description check Passed The description explains the problem. install(FILES ...) fails on repeated CMake runs after doc/html exists as a directory. Switching to DIRECTORY installs the whole tree. This matches the doxygen/CMa…
Docstring Coverage Passed No eligible functions found in the changed files. Skipping docstring coverage check. Docstring coverage is scoped to functions touched by this diff. Documentation-only edits and deletions within survi…
Linked Issues check Passed Check skipped because no linked issues were found for this pull request.
Out of Scope Changes check Passed Check skipped because no linked issues were found for this pull request.
Full details: Title check

Explanation

The title names the change: the documentation install command in the build files is fixed. It matches the CMake change from install(FILES ...) to install(DIRECTORY ...) for the generated docs. The title is concise and specific, though it does not say why the change is needed.

Full details: Description check

Explanation

The description explains the problem. install(FILES ...) fails on repeated CMake runs after doc/html exists as a directory. Switching to DIRECTORY installs the whole tree. This matches the doxygen/CMakeLists.txt change. The description is related to the changeset.

Full details: Docstring Coverage

Explanation

No eligible functions found in the changed files. Skipping docstring coverage check. Docstring coverage is scoped to functions touched by this diff. Documentation-only edits and deletions within surviving functions are included; unchanged diff context and fully deleted functions are excluded. Analyzed 0 functions across 0 files. (2 skipped: 2 unsupported.)

  • Autofix · Keep fixing CodeRabbit findings and required CI, and resolving merge conflicts

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

Comment @coderabbitai help to get the list of available commands.

This branch has not been deployed

No deployments
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant