Skip to content

Install documentation to destination dir#36

Open
ekohl wants to merge 6 commits intoteddych:masterfrom
ekohl:simplify-docs-building-v2
Open

Install documentation to destination dir#36
ekohl wants to merge 6 commits intoteddych:masterfrom
ekohl:simplify-docs-building-v2

Conversation

@ekohl
Copy link
Contributor

@ekohl ekohl commented Feb 6, 2026

My goal is to install the documentation natively and I think this is cleaner. I've tried to separate it into individual commits so it's easier to follow (hence the v2 in my branch name).

Another approach I considered was to create Documentation/CMakeLists.txt to separate it, allowing you to build documentation from that directory. Let me know if that is a preferred approach and I can dig up the branch where I experimented with that.

@teddych
Copy link
Owner

teddych commented Feb 6, 2026

Fuddl already change plenty of CMakeLists.txt across the documentation so this can't be merged...

@Fuddl1
Copy link
Contributor

Fuddl1 commented Feb 6, 2026

My apologies, I didn't notice @ekohl was working on this. I highly appreciate when someone improves my messy cmake configuration.

@ekohl
Copy link
Contributor Author

ekohl commented Feb 6, 2026

My apologies, I didn't notice @ekohl was working on this. I highly appreciate when someone improves my messy cmake configuration.

That's ok, since I split it into smaller commits it's hopefully easier to rebase.

@Fuddl1 any thoughts on introducing Documentation/CMakeLists.txt to split it out?

ekohl added 6 commits February 6, 2026 20:46
This makes it clearer how items are related.
Instead of using a custom command, this uses the built in functionality.
It's up for debate whether this is better or worse. It is fewer lines of
code, but it's also easy to miss when a file is added/removed.

It doesn't do the same for DOC_{DE,EN,ES} because I'm unsure if it
affects the resulting build.
@ekohl ekohl force-pushed the simplify-docs-building-v2 branch from 9d2c86a to 8f2578a Compare February 6, 2026 20:05
@Fuddl1
Copy link
Contributor

Fuddl1 commented Feb 7, 2026

@Fuddl1 any thoughts on introducing Documentation/CMakeLists.txt to split it out?

I lack cmake experience to judge that well-founded. My 2 cents: I favour the easy to understand solution over a technical sophisticated one in this case. Hope that helps :)

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.

3 participants