Put placeholder for loader version
authorMark Young <marky@lunarg.com>
Wed, 7 Sep 2022 18:57:35 +0000 (12:57 -0600)
committerCharles Giessen <46324611+charles-lunarg@users.noreply.github.com>
Fri, 4 Nov 2022 20:08:39 +0000 (14:08 -0600)
TODO: Replace all 1.3.yyyy with appropriate header version after
approval.

docs/LoaderDebugging.md
docs/LoaderDriverInterface.md
docs/LoaderInterfaceArchitecture.md
docs/LoaderLayerInterface.md
loader/vk_loader_platform.h

index e404fe791b0e741acdd9fbd871d9ea40950cde28..c8ebbc38e8b920241d6ba042a97b26ca66f86baf 100644 (file)
@@ -165,6 +165,9 @@ which indicates that it was likely enabled by the application.
 
 ### Disable Layers
 
+**NOTE:** This functionality is only available with Loaders built with version
+1.3.yyyy of the Vulkan headers and later.
+
 Sometimes, implicit layers can cause issues with an application.
 Because of this, the next step is to try to disable one or more of the listed
 implicit layers.
@@ -189,6 +192,9 @@ WARNING | LAYER:  Implicit layer "VK_LAYER_Twitch_Overlay" forced disabled becau
 
 ### Selectively Re-enable Layers
 
+**NOTE:** This functionality is only available with Loaders built with version
+1.3.yyyy of the Vulkan headers and later.
+
 When trying to diagnose problems caused by layers, it is useful to first disable
 all layers and re-enable each layer individually.
 If the problem reappears, then it is immediately clear which layer is the source
@@ -225,6 +231,9 @@ For more info on how to use the filtering environment variables, refer to the
 
 ### Enable Driver Logging
 
+**NOTE:** This functionality is only available with Loaders built with version
+1.3.yyyy of the Vulkan headers and later.
+
 If you suspect a driver issue, set the loader logging to specifically output
 driver messages:
 
@@ -291,6 +300,9 @@ DRIVER:        Using "Intel(R) UHD Graphics 630 (CFL GT2)" with driver: "/usr/li
 
 ### Selectively Enable Specific Drivers
 
+**NOTE:** This functionality is only available with Loaders built with version
+1.3.yyyy of the Vulkan headers and later.
+
 You can now use the filtering environment variables
 (`VK_LOADER_DRIVERS_SELECT` and `VK_LOADER_DRIVERS_DISABLE`) to selectively
 select or disable various drivers.
index e82d7ab68f64e7b8fe9971ff5de90bb7288e5f02..5fd146e3e648df7515de0510682f0febc0e31000 100644 (file)
@@ -142,6 +142,9 @@ ignored.
 
 ### Driver Filtering
 
+**NOTE:** This functionality is only available with Loaders built with version
+1.3.yyyy of the Vulkan headers and later.
+
 The driver select environment variable `VK_LOADER_DRIVERS_SELECT` is a
 comma-delimited list of globs to search for in known drivers.
 Since drivers don’t have a name like layers, this substring is used to compare
index 22b4518fbdd9aa81d693dbb93b5e2d08d9d77637..1e4a98b9fe92c6b4fe656711a46f456a895e44a1 100644 (file)
@@ -709,6 +709,8 @@ discovery.
         variables (like <i>VK_ICD_FILENAMES</i> or <i>VK_ADD_DRIVER_FILES</i>).
     </small></td>
     <td><small>
+        This functionality is only available with Loaders built with version
+        1.3.yyyy of the Vulkan headers and later.<br/>
         If no drivers are found with a manifest filename that matches any of the
         provided globs, then no driver is enabled and it <b>may</b> result
         in Vulkan applications failing to run properly.
@@ -738,6 +740,8 @@ discovery.
         variables (like <i>VK_ICD_FILENAMES</i> or <i>VK_ADD_DRIVER_FILES</i>).
     </small></td>
     <td><small>
+        This functionality is only available with Loaders built with version
+        1.3.yyyy of the Vulkan headers and later.<br/>
         If all available drivers are disabled using this environment variable,
         then no drivers will be found by the loader and <b>will</b> result
         in Vulkan applications failing to run properly.<br/>
@@ -772,7 +776,8 @@ discovery.
         <i>VK_INSTANCE_LAYERS</i>
     </small></td>
     <td><small>
-        None
+        This functionality is only available with Loaders built with version
+        1.3.yyyy of the Vulkan headers and later.
     </small></td>
     <td><small>
         export<br/>
@@ -798,6 +803,8 @@ discovery.
         (like <i>VK_LAYER_PATH</i>).
     </small></td>
     <td><small>
+        This functionality is only available with Loaders built with version
+        1.3.yyyy of the Vulkan headers and later.<br/>
         Disabling a layer that an application intentionally enables as an
         explicit layer <b>may</b> cause the application to not function
         properly.<br/>
index 638e6a5890154a0aa2b8692723d832aadd631c33..91c9fc1a0b9c9955ee172392fed36263f2ab4cd9 100644 (file)
@@ -421,6 +421,9 @@ following:
 
 ### Layer Filtering
 
+**NOTE:** This functionality is only available with Loaders built with version
+1.3.yyyy of the Vulkan headers and later.
+
 The layer enable environment variable `VK_LOADER_LAYERS_ENABLE` is a
 comma-delimited list of globs to search for in known layers.
 Known layers are those that are already found by the loader taking into account
index cfdc6660e23a798425ef3b3e7d9d6073f7c42df1..6f01c653d63985d626a8f5cac1ec0ccc9d875400 100644 (file)
@@ -92,7 +92,7 @@
 // Support added in v1.3.207 loader
 #define VK_ADDITIONAL_DRIVER_FILES_ENV_VAR "VK_ADD_DRIVER_FILES"
 #define VK_ADDITIONAL_LAYER_PATH_ENV_VAR "VK_ADD_LAYER_PATH"
-// Support added in v1.3.217 loader
+// Support added in v1.3.yyyy loader
 #define VK_LAYERS_ENABLE_ENV_VAR "VK_LOADER_LAYERS_ENABLE"
 #define VK_LAYERS_DISABLE_ENV_VAR "VK_LOADER_LAYERS_DISABLE"
 #define VK_DRIVERS_SELECT_ENV_VAR "VK_LOADER_DRIVERS_SELECT"