Skip to content

Commit bbf0f50

Browse files
committed
docs: a project that names its own Qt SDK states where the payload comes from
The page told the reader to comment the declaration out, which was the only way out while every declared payload was provisioned. An override states the same thing without removing the declaration, so a machine without that SDK still gets the ecosystem's.
1 parent eb29dc5 commit bbf0f50

1 file changed

Lines changed: 8 additions & 1 deletion

File tree

‎docs/rules-qt.md‎

Lines changed: 8 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -47,7 +47,14 @@ The first of three levels that names an SDK decides, and the rule records which
4747

4848
Each payload carries its runtime closure: the loader and the libraries Qt loads on Linux, and the VC++ runtime on Windows x64. 0.15.0 removed the features `rules-qt-xim`, `rules-qt-xim-base` and `rules-qt-xim-addons`, which declared a payload at a fixed version. A feature states a mechanism; the SDK a program links is the project's choice. A project that used one of those features declares the payload instead, as above.
4949

50-
A project that does not use a payload comments out its declaration, because `mcpp build` provisions every declared payload whether or not a higher level names another SDK. It then names its SDK with `QT_ROOT_DIR` or with `options::root` in `build.mcpp`:
50+
A project that names its SDK at a higher level states where the payload comes from, and it is then not provisioned (mcpp 2026.10.1.3):
51+
52+
```toml
53+
[xlings.overrides]
54+
"xim:qt-base" = { root = "/opt/Qt/6.11.1/gcc_64" }
55+
```
56+
57+
The declaration stays, so a machine without that directory still gets the ecosystem's SDK, and the build reports which one it used. Before that release a declared payload was provisioned whether or not a higher level named another SDK, and the only way out was to comment the declaration out:
5158

5259
```toml
5360
[target.'cfg(any(windows, linux, macos))'.xlings.workspace]

0 commit comments

Comments
 (0)