From 211ee2cdf3e020e7d6efe2597b177a7106023e2f Mon Sep 17 00:00:00 2001 From: Sascha Willems Date: Thu, 5 Feb 2026 18:57:48 +0100 Subject: [PATCH] Update wording on modules --- README.adoc | 2 +- en/00_Introduction.adoc | 2 +- en/02_Development_environment.adoc | 13 ++++++------- 3 files changed, 8 insertions(+), 9 deletions(-) diff --git a/README.adoc b/README.adoc index 4b688e06..6aa7145c 100644 --- a/README.adoc +++ b/README.adoc @@ -16,7 +16,7 @@ Compared to the original tutorial, this version of the tutorial is teaching up-t * Dynamic rendering instead of render passes * Timeline semaphores * link:https://shader-slang.org/[Slang] as the primary shading language -* Modern C++ (20) with modules +* Modern C++ (20) * link:https://github.com/KhronosGroup/Vulkan-Hpp[Vulkan-Hpp] with link:https://en.wikipedia.org/wiki/Resource_acquisition_is_initialization[RAII] It also contains Vulkan usage clarifications, improved synchronization and new content. diff --git a/en/00_Introduction.adoc b/en/00_Introduction.adoc index 6675f17d..b4af91f0 100644 --- a/en/00_Introduction.adoc +++ b/en/00_Introduction.adoc @@ -15,7 +15,7 @@ Compared to the original tutorial, this version of the tutorial is teaching up-t * Dynamic rendering instead of render passes * Timeline semaphores * link:https://shader-slang.org/[Slang] as the primary shading language -* Modern C++ (20) with modules +* Modern C++ (20) * link:https://github.com/KhronosGroup/Vulkan-Hpp[Vulkan-Hpp] with link:https://en.wikipedia.org/wiki/Resource_acquisition_is_initialization[RAII] It also contains Vulkan usage clarifications, improved synchronization and new content. diff --git a/en/02_Development_environment.adoc b/en/02_Development_environment.adoc index 2ea36a27..29ac0d6e 100644 --- a/en/02_Development_environment.adoc +++ b/en/02_Development_environment.adoc @@ -124,13 +124,12 @@ This will allow other projects that distribute via Find*.cmake to be placed in that same folder. See the accompanying link:/attachments/CMakeLists.txt[CMakeLists.txt] for an example of a working project. -Vulkan has support for C{pp} modules which became available with c{pp}20. A -large advantage of C{pp} modules is they give all the benefits of C{pp} without -the overhead of long compile times. To do this, the .cppm file must be compiled -for your target device. This tutorial demonstrates how to take advantage of C{pp} -modules. However, to maximize compatibility across compilers and IDEs, the -attachments template has C{pp}20 module support disabled by default, but it is -recommended to enable it if your toolchain supports it. +The Vulkan C{pp} headers also offer a C{pp} module. A large advantage of C{pp} modules is they give all the benefits of C{pp} without the overhead of long compile times. To use them, the .cppm file must be compiled for your target device. + +[NOTE] +==== +Module support in the Vulkan C{pp} headers is still experimental and might not work with all compilers. Unless you want to experiment, it's recommended to **not** use them. +==== To enable the Vulkan C{pp}20 module in the attachments template, configure CMake with: