Deploying to master from @ gfx-rs/wgpu@c51fe57 🚀

Author: cwfitzgerald

doc/search.desc/wgpu/wgpu-desc-0-.js

@@ -600,7 +600,27 @@
 <a href="#599" id="599">599</a>
 <a href="#600" id="600">600</a>
 <a href="#601" id="601">601</a>
-<a href="#602" id="602">602</a></pre></div><pre class="rust"><code><span class="doccomment">//! Types for dealing with Instances
+<a href="#602" id="602">602</a>
+<a href="#603" id="603">603</a>
+<a href="#604" id="604">604</a>
+<a href="#605" id="605">605</a>
+<a href="#606" id="606">606</a>
+<a href="#607" id="607">607</a>
+<a href="#608" id="608">608</a>
+<a href="#609" id="609">609</a>
+<a href="#610" id="610">610</a>
+<a href="#611" id="611">611</a>
+<a href="#612" id="612">612</a>
+<a href="#613" id="613">613</a>
+<a href="#614" id="614">614</a>
+<a href="#615" id="615">615</a>
+<a href="#616" id="616">616</a>
+<a href="#617" id="617">617</a>
+<a href="#618" id="618">618</a>
+<a href="#619" id="619">619</a>
+<a href="#620" id="620">620</a>
+<a href="#621" id="621">621</a>
+<a href="#622" id="622">622</a></pre></div><pre class="rust"><code><span class="doccomment">//! Types for dealing with Instances
 
 </span><span class="kw">use </span>alloc::string::String;
 
@@ -672,9 +692,29 @@
         ///
         /// When `Self::from_env()` is used takes value from `WGPU_DEBUG` environment variable.
         </span><span class="kw">const </span>DEBUG = <span class="number">1 </span>&lt;&lt; <span class="number">0</span>;
-        <span class="doccomment">/// Enable validation, if possible.
+        <span class="doccomment">/// Enable validation in the backend API, if possible:
         ///
-        /// When `Self::from_env()` is used takes value from `WGPU_VALIDATION` environment variable.
+        /// - On the Direct3D `dx12` backend, this calls [`ID3D12Debug::EnableDebugLayer`][dx12].
+        ///
+        /// - On the Vulkan backend, this enables the [Vulkan Validation Layer][vvl].
+        ///
+        /// - On the `gles` backend driving Windows OpenGL, this enables [debug
+        ///   output][gl:do], effectively calling `glEnable(GL_DEBUG_OUTPUT)`.
+        ///
+        /// - On non-Windows `gles` backends, this calls
+        ///   [`eglDebugMessageControlKHR`][gl:dm] to enable all debugging messages.
+        ///   If the GLES implementation is ANGLE running on Vulkan, this also
+        ///   enables the Vulkan validation layers by setting
+        ///   [`EGL_PLATFORM_ANGLE_DEBUG_LAYERS_ENABLED`][gl:av].
+        ///
+        /// When `Self::from_env()` is used, this bit is set if the `WGPU_VALIDATION`
+        /// environment variable has any value but "0".
+        ///
+        /// [dx12]: https://learn.microsoft.com/en-us/windows/win32/api/d3d12sdklayers/nf-d3d12sdklayers-id3d12debug-enabledebuglayer
+        /// [vvl]: https://github.com/KhronosGroup/Vulkan-ValidationLayers
+        /// [gl:dm]: https://registry.khronos.org/EGL/extensions/KHR/EGL_KHR_debug.txt
+        /// [gl:do]: https://www.khronos.org/opengl/wiki/Debug_Output
+        /// [gl:av]: https://chromium.googlesource.com/angle/angle/+/HEAD/extensions/EGL_ANGLE_platform_angle.txt
         </span><span class="kw">const </span>VALIDATION = <span class="number">1 </span>&lt;&lt; <span class="number">1</span>;
         <span class="doccomment">/// Don't pass labels to wgpu-hal.
         ///