testing

.clang-format_14

@@ -74,7 +74,7 @@ NamespaceIndentation : All
 PackConstructorInitializers : NextLine
 PPIndentWidth : -1
 PointerAlignment : Middle
-QualifierAlignment : Right
+# QualifierAlignment : Right    # Far too slow, and far from perfect!
 ReferenceAlignment : Pointer
 ReflowComments : true
 RemoveBracesLLVM : false

.clang-format_15

@@ -74,7 +74,7 @@ NamespaceIndentation : All
 PackConstructorInitializers : NextLine
 PPIndentWidth : -1
 PointerAlignment : Middle
-QualifierAlignment : Right
+# QualifierAlignment : Right    # Far too slow, and far from perfect!
 ReferenceAlignment : Pointer
 ReflowComments : true
 RemoveBracesLLVM : false

.clang-format_16

@@ -83,7 +83,7 @@ NamespaceIndentation : All
 PackConstructorInitializers : NextLine
 PPIndentWidth : -1
 PointerAlignment : Middle
-QualifierAlignment : Right
+# QualifierAlignment : Right    # Far too slow, and far from perfect!
 ReferenceAlignment : Pointer
 ReflowComments : true
 RemoveBracesLLVM : false

.clang-format_17

@@ -89,7 +89,7 @@ NamespaceIndentation : All
 PackConstructorInitializers : NextLine
 PPIndentWidth : -1
 PointerAlignment : Middle
-QualifierAlignment : Right
+# QualifierAlignment : Right    # Far too slow, and far from perfect!
 ReferenceAlignment : Pointer
 ReflowComments : true
 RemoveBracesLLVM : false

.clang-format_18

@@ -92,7 +92,7 @@ NamespaceIndentation : All
 PackConstructorInitializers : NextLine
 PPIndentWidth : -1
 PointerAlignment : Middle
-QualifierAlignment : Right
+# QualifierAlignment : Right    # Far too slow, and far from perfect!
 ReferenceAlignment : Pointer
 ReflowComments : true
 RemoveBracesLLVM : false

.clang-format_19

@@ -99,7 +99,7 @@ NamespaceIndentation : All
 PackConstructorInitializers : NextLine
 PPIndentWidth : -1
 PointerAlignment : Middle
-QualifierAlignment : Right
+# QualifierAlignment : Right    # Far too slow, and far from perfect!
 ReferenceAlignment : Pointer
 ReflowComments : true
 RemoveBracesLLVM : false

.clang-format_20

@@ -102,7 +102,7 @@ NamespaceIndentation : All
 PackConstructorInitializers : NextLine
 PPIndentWidth : -1
 PointerAlignment : Middle
-QualifierAlignment : Right
+# QualifierAlignment : Right    # Far too slow, and far from perfect!
 ReferenceAlignment : Pointer
 ReflowComments : true
 RemoveBracesLLVM : false

.clang-format_21

@@ -104,7 +104,7 @@ NamespaceIndentation : All
 PackConstructorInitializers : NextLine
 PPIndentWidth : -1
 PointerAlignment : Middle
-QualifierAlignment : Right
+# QualifierAlignment : Right    # Far too slow, and far from perfect!
 ReferenceAlignment : Pointer
 ReflowComments : true
 RemoveBracesLLVM : false

.github/workflows/build.yml

@@ -42,9 +42,9 @@ jobs:
           { os: windows-2025, cxx: clang-cl,   c: clang-cl, arch: x64, gen: Ninja,                 cxx_max: 23 },
           # { os: windows-2025, cxx: c++,        c: cc,       arch: x64, gen: Visual Studio 17 2022, cxx_max: 23 },
 
-          { os: macos-26,     cxx: /opt/homebrew/opt/llvm/bin/clang++, c: /opt/homebrew/opt/llvm/bin/clang, arch: x64, gen: Ninja, modules: true, cxx_max: 23, cxx_flags: '-I/opt/homebrew/opt/llvm/include/c++/v1 -isysroot /Library/Developer/CommandLineTools/SDKs/MacOSX.sdk', linker_flags: '-L/opt/homebrew/opt/llvm/lib/c++' },
-          { os: ubuntu-24.04, cxx: clang++-21, c: clang-21, arch: x64, gen: Ninja, modules: true, cxx_max: 23, cxx_flags: '-stdlib=libc++', linker_flags: '-stdlib=libc++ -lc++abi' },
-          { os: windows-2025, cxx: cl,         c: cl      , arch: x64, gen: Ninja, modules: true, cxx_max: 23, cxx_flags: '//EHsc' },
+          # { os: macos-26,     cxx: /opt/homebrew/opt/llvm/bin/clang++, c: /opt/homebrew/opt/llvm/bin/clang, arch: x64, gen: Ninja, modules: true, cxx_max: 23, cxx_flags: '-I/opt/homebrew/opt/llvm/include/c++/v1 -isysroot /Library/Developer/CommandLineTools/SDKs/MacOSX.sdk', linker_flags: '-L/opt/homebrew/opt/llvm/lib/c++' },
+          # { os: ubuntu-24.04, cxx: clang++-21, c: clang-21, arch: x64, gen: Ninja, modules: true, cxx_max: 23, cxx_flags: '-stdlib=libc++', linker_flags: '-stdlib=libc++ -lc++abi' },
+          # { os: windows-2025, cxx: cl,         c: cl      , arch: x64, gen: Ninja, modules: true, cxx_max: 23, cxx_flags: '//EHsc' },
         ]
 
     env:
@@ -107,17 +107,18 @@ jobs:
           cmake --build build --parallel --config $BUILD_TYPE --clean-first
         done
 
-    # Build samples using highest available C++ standard.
-    - name: Build Samples with C++${{matrix.env.cxx_max}}
-      if: (!matrix.env.modules) # Exclude module runners.
-      run: |
-        for BUILD_TYPE in Debug Release; do
-          cmake -B build -G '${{matrix.env.gen}}' --fresh --preset samples \
-            ${{ env.VAR_CMAKE_FLAGS }}                                     \
-            -D CMAKE_CXX_STANDARD=${{matrix.env.cxx_max}}                  \
-            -D CMAKE_BUILD_TYPE=$BUILD_TYPE
-          cmake --build build --parallel --config $BUILD_TYPE --clean-first
-        done
+    # temporarily disabled due to lack of smart handles!
+    # # Build samples using highest available C++ standard.
+    # - name: Build Samples with C++${{matrix.env.cxx_max}}
+    #   if: (!matrix.env.modules) # Exclude module runners.
+    #   run: |
+    #     for BUILD_TYPE in Debug Release; do
+    #       cmake -B build -G '${{matrix.env.gen}}' --fresh --preset samples \
+    #         ${{ env.VAR_CMAKE_FLAGS }}                                     \
+    #         -D CMAKE_CXX_STANDARD=${{matrix.env.cxx_max}}                  \
+    #         -D CMAKE_BUILD_TYPE=$BUILD_TYPE
+    #       cmake --build build --parallel --config $BUILD_TYPE --clean-first
+    #     done
 
     # Run all unit tests with C++11 to maximum support C++ version.
     # Module runners ignore all versions below C++23

RAII_Samples/01_InitInstance/01_InitInstance.cpp

@@ -22,7 +22,7 @@
 static std::string AppName    = "01_InitInstanceRAII";
 static std::string EngineName = "Vulkan.hpp";
 
-int main( int /*argc*/, char ** /*argv*/ )
+int main()
 {
   /* VULKAN_HPP_KEY_START */
 

RAII_Samples/02_EnumerateDevices/02_EnumerateDevices.cpp

@@ -32,7 +32,7 @@
 static std::string AppName    = "02_EnumerateDevicesRAII";
 static std::string EngineName = "Vulkan.hpp";
 
-int main( int /*argc*/, char ** /*argv*/ )
+int main()
 {
   try
   {

RAII_Samples/03_InitDevice/03_InitDevice.cpp

@@ -22,7 +22,7 @@
 static char const * AppName    = "03_InitDeviceRAII";
 static char const * EngineName = "Vulkan.hpp";
 
-int main( int /*argc*/, char ** /*argv*/ )
+int main()
 {
   try
   {

RAII_Samples/04_InitCommandBuffer/04_InitCommandBuffer.cpp

@@ -22,7 +22,7 @@
 static char const * AppName    = "04_InitCommandBufferRAII";
 static char const * EngineName = "Vulkan.hpp";
 
-int main( int /*argc*/, char ** /*argv*/ )
+int main()
 {
   try
   {

RAII_Samples/05_InitSwapchain/05_InitSwapchain.cpp

@@ -22,7 +22,7 @@
 static char const * AppName    = "05_InitSwapchainRAII";
 static char const * EngineName = "Vulkan.hpp";
 
-int main( int /*argc*/, char ** /*argv*/ )
+int main()
 {
   try
   {

RAII_Samples/06_InitDepthBuffer/06_InitDepthBuffer.cpp

@@ -22,7 +22,7 @@
 static char const * AppName    = "06_InitDepthBuffer";
 static char const * EngineName = "Vulkan.hpp";
 
-int main( int /*argc*/, char ** /*argv*/ )
+int main()
 {
   try
   {

RAII_Samples/07_InitUniformBuffer/07_InitUniformBuffer.cpp

@@ -35,7 +35,7 @@
 static char const * AppName    = "07_InitUniformBuffer";
 static char const * EngineName = "Vulkan.hpp";
 
-int main( int /*argc*/, char ** /*argv*/ )
+int main()
 {
   try
   {

RAII_Samples/08_InitPipelineLayout/08_InitPipelineLayout.cpp

@@ -22,7 +22,7 @@
 static char const * AppName    = "08_InitPipelineLayout";
 static char const * EngineName = "Vulkan.hpp";
 
-int main( int /*argc*/, char ** /*argv*/ )
+int main()
 {
   try
   {

RAII_Samples/09_InitDescriptorSet/09_InitDescriptorSet.cpp

@@ -35,7 +35,7 @@
 static char const * AppName    = "09_InitDescriptorSet";
 static char const * EngineName = "Vulkan.hpp";
 
-int main( int /*argc*/, char ** /*argv*/ )
+int main()
 {
   try
   {

RAII_Samples/10_InitRenderPass/10_InitRenderPass.cpp

@@ -34,7 +34,7 @@
 static char const * AppName    = "10_InitRenderPass";
 static char const * EngineName = "Vulkan.hpp";
 
-int main( int /*argc*/, char ** /*argv*/ )
+int main()
 {
   try
   {

RAII_Samples/11_InitShaders/11_InitShaders.cpp

@@ -24,7 +24,7 @@
 static char const * AppName    = "11_InitShaders";
 static char const * EngineName = "Vulkan.hpp";
 
-int main( int /*argc*/, char ** /*argv*/ )
+int main()
 {
   try
   {

RAII_Samples/12_InitFrameBuffers/12_InitFrameBuffers.cpp

@@ -22,7 +22,7 @@
 static char const * AppName    = "12_InitFrameBuffers";
 static char const * EngineName = "Vulkan.hpp";
 
-int main( int /*argc*/, char ** /*argv*/ )
+int main()
 {
   try
   {

RAII_Samples/13_InitVertexBuffer/13_InitVertexBuffer.cpp

@@ -33,7 +33,7 @@
 static char const * AppName    = "13_InitVertexBuffer";
 static char const * EngineName = "Vulkan.hpp";
 
-int main( int /*argc*/, char ** /*argv*/ )
+int main()
 {
   try
   {

RAII_Samples/14_InitPipeline/14_InitPipeline.cpp

@@ -36,7 +36,7 @@
 static char const * AppName    = "14_InitPipeline";
 static char const * EngineName = "Vulkan.hpp";
 
-int main( int /*argc*/, char ** /*argv*/ )
+int main()
 {
   try
   {

RAII_Samples/15_DrawCube/15_DrawCube.cpp

@@ -37,7 +37,7 @@
 static char const * AppName    = "15_DrawCube";
 static char const * EngineName = "Vulkan.hpp";
 
-int main( int /*argc*/, char ** /*argv*/ )
+int main()
 {
   try
   {

RAII_Samples/16_Vulkan_1_1/16_Vulkan_1_1.cpp

@@ -20,7 +20,7 @@
 static char const * AppName    = "16_Vulkan_1_1";
 static char const * EngineName = "Vulkan.hpp";
 
-int main( int /*argc*/, char ** /*argv*/ )
+int main()
 {
   try
   {

RAII_Samples/CopyBlitImage/CopyBlitImage.cpp

@@ -22,7 +22,7 @@
 static char const * AppName    = "CopyBlitImage";
 static char const * EngineName = "Vulkan.hpp";
 
-int main( int /*argc*/, char ** /*argv*/ )
+int main()
 {
   try
   {

RAII_Samples/CreateDebugUtilsMessenger/CreateDebugUtilsMessenger.cpp

@@ -27,8 +27,9 @@ static char const * EngineName = "Vulkan.hpp";
 VKAPI_ATTR VkBool32 VKAPI_CALL debugMessageFunc( vk::DebugUtilsMessageSeverityFlagBitsEXT       messageSeverity,
                                                  vk::DebugUtilsMessageTypeFlagsEXT              messageTypes,
                                                  vk::DebugUtilsMessengerCallbackDataEXT const * pCallbackData,
-                                                 void * /*pUserData*/ )
+                                                 VULKAN_HPP_MAYBE_UNUSED void * pUserData )
 {
+  VULKAN_HPP_UNUSED( pUserData );
   std::ostringstream message;
 
   message << vk::to_string( messageSeverity ) << ": " << vk::to_string( messageTypes ) << ":\n";
@@ -75,7 +76,7 @@ VKAPI_ATTR VkBool32 VKAPI_CALL debugMessageFunc( vk::DebugUtilsMessageSeverityFl
   return false;
 }
 
-int main( int /*argc*/, char ** /*argv*/ )
+int main()
 {
   try
   {

RAII_Samples/DebugUtilsObjectName/DebugUtilsObjectName.cpp

@@ -26,7 +26,7 @@ static char const * EngineName = "Vulkan.hpp";
 #  define NON_DISPATCHABLE_HANDLE_TO_UINT64_CAST( type, x ) reinterpret_cast<uint64_t>( static_cast<type>( x ) )
 #endif
 
-int main( int /*argc*/, char ** /*argv*/ )
+int main()
 {
   try
   {

RAII_Samples/DrawTexturedCube/DrawTexturedCube.cpp

@@ -27,7 +27,7 @@
 static char const * AppName    = "DrawTexturedCube";
 static char const * EngineName = "Vulkan.hpp";
 
-int main( int /*argc*/, char ** /*argv*/ )
+int main()
 {
   try
   {

RAII_Samples/DynamicUniform/DynamicUniform.cpp

@@ -31,7 +31,7 @@
 static char const * AppName    = "DynamicUniform";
 static char const * EngineName = "Vulkan.hpp";
 
-int main( int /*argc*/, char ** /*argv*/ )
+int main()
 {
   try
   {

RAII_Samples/EnableValidationWithCallback/EnableValidationWithCallback.cpp

@@ -55,8 +55,9 @@ VKAPI_ATTR void VKAPI_CALL vkDestroyDebugUtilsMessengerEXT( VkInstance instance,
 VKAPI_ATTR VkBool32 VKAPI_CALL debugMessageFunc( vk::DebugUtilsMessageSeverityFlagBitsEXT       messageSeverity,
                                                  vk::DebugUtilsMessageTypeFlagsEXT              messageTypes,
                                                  vk::DebugUtilsMessengerCallbackDataEXT const * pCallbackData,
-                                                 void * /*pUserData*/ )
+                                                 VULKAN_HPP_MAYBE_UNUSED void * pUserData )
 {
+  VULKAN_HPP_UNUSED( pUserData );
   std::string message;
 
   message += vk::to_string( messageSeverity ) + ": " + vk::to_string( messageTypes ) + ":\n";
@@ -115,7 +116,7 @@ bool checkLayers( std::vector<char const *> const & layers, std::vector<vk::Laye
                       } );
 }
 
-int main( int /*argc*/, char ** /*argv*/ )
+int main()
 {
   try
   {

RAII_Samples/EnumerateDevicesAdvanced/EnumerateDevicesAdvanced.cpp

@@ -24,7 +24,7 @@
 static char const * AppName    = "EnumerateDevicesAdvanced";
 static char const * EngineName = "Vulkan.hpp";
 
-int main( int /*argc*/, char ** /*argv*/ )
+int main()
 {
   try
   {

RAII_Samples/Events/Events.cpp

@@ -22,7 +22,7 @@
 static char const * AppName    = "Events";
 static char const * EngineName = "Vulkan.hpp";
 
-int main( int /*argc*/, char ** /*argv*/ )
+int main()
 {
   try
   {

RAII_Samples/ImmutableSampler/ImmutableSampler.cpp

@@ -39,7 +39,7 @@
 static char const * AppName    = "ImmutableSampler";
 static char const * EngineName = "Vulkan.hpp";
 
-int main( int /*argc*/, char ** /*argv*/ )
+int main()
 {
   try
   {

RAII_Samples/InitTexture/InitTexture.cpp

@@ -37,7 +37,7 @@
 static char const * AppName    = "InitTexture";
 static char const * EngineName = "Vulkan.hpp";
 
-int main( int /*argc*/, char ** /*argv*/ )
+int main()
 {
   try
   {

RAII_Samples/InputAttachment/InputAttachment.cpp

@@ -66,7 +66,7 @@ void main()
 }
 )";
 
-int main( int /*argc*/, char ** /*argv*/ )
+int main()
 {
   try
   {

RAII_Samples/InstanceExtensionProperties/InstanceExtensionProperties.cpp

@@ -21,7 +21,7 @@
 #include <iostream>
 #include <sstream>
 
-int main( int /*argc*/, char ** /*argv*/ )
+int main()
 {
   try
   {

RAII_Samples/InstanceLayerExtensionProperties/InstanceLayerExtensionProperties.cpp

@@ -31,7 +31,7 @@ struct PropertyData
   std::vector<vk::ExtensionProperties> extensionProperties;
 };
 
-int main( int /*argc*/, char ** /*argv*/ )
+int main()
 {
   try
   {