Skip to content

Update cmake-presets-vs.md #3447

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
merged 4 commits into from
Dec 15, 2021
Merged

Update cmake-presets-vs.md #3447

Changes from all commits
Commits
Show all changes
4 commits
Select commit Hold shift + click to select a range
23effb2
Update cmake-presets-vs.md
sweemer Oct 10, 2021
28c4351
Update cmake-presets-vs.md
sweemer Dec 13, 2021
7314371
Update cmake-presets-vs.md
sweemer Dec 14, 2021
2349f3e
Style pass for the grammar checker bot
Dec 15, 2021
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
18 changes: 18 additions & 0 deletions docs/build/cmake-presets-vs.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -223,6 +223,24 @@ Build with `clang`:
}
```

If you use either `Visual Studio 16 2019` or `Visual Studio 17 2022` as your generator, you can use the `toolset` Configure Preset to specify the `ClangCL` toolset:

```json
"cacheVariables": {
"CMAKE_BUILD_TYPE": "Debug",
"CMAKE_INSTALL_PREFIX": "${sourceDir}/out/install/${presetName}",
},
"toolset": "ClangCL",
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

This assumes the current generator supports specifying toolsets (see docs for more info). For the Ninja generator this preset is invalid.

Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

You're right. I have pushed up a new commit to clarify that not all generators support this preset.

Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Thanks for updating that. However I don't think ClangCl will be valid until the Visual Studio 16 2019 generator, since LLVM was added in version 16.1. Also I'd be more explicit that this is only for Visual Studio generators. perhaps

if you are using either Visual Studio 16 2019 or Visual Studio 17 2022 as your generator, you can use the toolset property in the configure preset to specify the ClangCL toolset:

Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Done


"vendor": {
"microsoft.com/VisualStudioSettings/CMake/1.0": {
"intelliSenseMode": "windows-clang-x64"
}
}
```

For more information on generators that support the `toolset` specification, see [`CMAKE_GENERATOR_TOOLSET`](https://cmake.org/cmake/help/latest/variable/CMAKE_GENERATOR_TOOLSET.html) in the CMake documentation.

> [!IMPORTANT]
> In Visual Studio 2019, you must explicitly specify a Clang IntelliSense mode when you're building with `clang` or `clang-cl`.

Expand Down