Deploying to master from @ bec26b79ec27b98838f589eff4d20c4b86780be9 🚀

Author: jimblandy

doc/search-index.js

@@ -2481,11 +2481,11 @@
         ))
     }
 
-    <span class="kw">pub unsafe fn </span>instance_as_hal&lt;A: wgc::hub::HalApi, F: FnOnce(<span class="prelude-ty">Option</span>&lt;<span class="kw-2">&amp;</span>A::Instance&gt;) -&gt; R, R&gt;(
-        <span class="kw-2">&amp;</span><span class="self">self</span>,
-        hal_instance_callback: F,
-    ) -&gt; R {
-        <span class="self">self</span>.<span class="number">0</span>.instance_as_hal::&lt;A, F, R&gt;(hal_instance_callback)
+    <span class="doccomment">/// # Safety
+    ///
+    /// - The raw instance handle returned must not be manually destroyed.
+    </span><span class="kw">pub unsafe fn </span>instance_as_hal&lt;A: wgc::hub::HalApi&gt;(<span class="kw-2">&amp;</span><span class="self">self</span>) -&gt; <span class="prelude-ty">Option</span>&lt;<span class="kw-2">&amp;</span>A::Instance&gt; {
+        <span class="self">self</span>.<span class="number">0</span>.instance_as_hal::&lt;A&gt;()
     }
 
     <span class="kw">pub unsafe fn </span>from_core_instance(core_instance: wgc::instance::Instance) -&gt; <span class="self">Self </span>{

doc/src/wgpu/backend/direct.rs.html

@@ -5344,19 +5344,19 @@
         }
     }
 
-    <span class="doccomment">/// Returns the inner hal Instance using a callback. The hal instance will be `None` if the
-    /// backend type argument does not match with this wgpu Instance
+    <span class="doccomment">/// Return a reference to a specific backend instance, if available.
+    ///
+    /// If this `Instance` has a wgpu-hal [`Instance`] for backend
+    /// `A`, return a reference to it. Otherwise, return `None`.
     ///
     /// # Safety
     ///
-    /// - The raw handle obtained from the hal Instance must not be manually destroyed
+    /// - The raw instance handle returned must not be manually destroyed.
+    ///
+    /// [`Instance`]: hal::Api::Instance
     </span><span class="attribute">#[cfg(any(not(target_arch = <span class="string">&quot;wasm32&quot;</span>), feature = <span class="string">&quot;webgl&quot;</span>))]
-    </span><span class="kw">pub unsafe fn </span>as_hal&lt;A: wgc::hub::HalApi, F: FnOnce(<span class="prelude-ty">Option</span>&lt;<span class="kw-2">&amp;</span>A::Instance&gt;) -&gt; R, R&gt;(
-        <span class="kw-2">&amp;</span><span class="self">self</span>,
-        hal_instance_callback: F,
-    ) -&gt; R {
-        <span class="self">self</span>.context
-            .instance_as_hal::&lt;A, F, R&gt;(hal_instance_callback)
+    </span><span class="kw">pub unsafe fn </span>as_hal&lt;A: wgc::hub::HalApi&gt;(<span class="kw-2">&amp;</span><span class="self">self</span>) -&gt; <span class="prelude-ty">Option</span>&lt;<span class="kw-2">&amp;</span>A::Instance&gt; {
+        <span class="self">self</span>.context.instance_as_hal::&lt;A&gt;()
     }
 
     <span class="doccomment">/// Create an new instance of wgpu from a wgpu-core instance.

doc/src/wgpu/lib.rs.html

@@ -18,11 +18,12 @@ <h5 id="arguments-1"><a href="#arguments-1">Arguments</a></h5>
 </ul>
 <h5 id="safety"><a href="#safety">Safety</a></h5>
 <p>Refer to the creation of wgpu-hal Instance for every backend.</p>
-</div></details><details class="rustdoc-toggle method-toggle" open><summary><section id="method.as_hal" class="method has-srclink"><a class="srclink rightside" href="../src/wgpu/lib.rs.html#1681-1687">source</a><h4 class="code-header">pub unsafe fn <a href="#method.as_hal" class="fnname">as_hal</a>&lt;A:&nbsp;HalApi, F:&nbsp;<a class="trait" href="https://doc.rust-lang.org/nightly/core/ops/function/trait.FnOnce.html" title="trait core::ops::function::FnOnce">FnOnce</a>(<a class="enum" href="https://doc.rust-lang.org/nightly/core/option/enum.Option.html" title="enum core::option::Option">Option</a>&lt;&amp;A::<a class="associatedtype" href="../wgpu_hal/trait.Api.html#associatedtype.Instance" title="type wgpu_hal::Api::Instance">Instance</a>&gt;) -&gt; R, R&gt;(<br>&nbsp;&nbsp;&nbsp;&nbsp;&amp;self,<br>&nbsp;&nbsp;&nbsp;&nbsp;hal_instance_callback: F<br>) -&gt; R</h4></section></summary><div class="docblock"><p>Returns the inner hal Instance using a callback. The hal instance will be <code>None</code> if the
-backend type argument does not match with this wgpu Instance</p>
+</div></details><details class="rustdoc-toggle method-toggle" open><summary><section id="method.as_hal" class="method has-srclink"><a class="srclink rightside" href="../src/wgpu/lib.rs.html#1685-1687">source</a><h4 class="code-header">pub unsafe fn <a href="#method.as_hal" class="fnname">as_hal</a>&lt;A:&nbsp;HalApi&gt;(&amp;self) -&gt; <a class="enum" href="https://doc.rust-lang.org/nightly/core/option/enum.Option.html" title="enum core::option::Option">Option</a>&lt;&amp;A::<a class="associatedtype" href="../wgpu_hal/trait.Api.html#associatedtype.Instance" title="type wgpu_hal::Api::Instance">Instance</a>&gt;</h4></section></summary><div class="docblock"><p>Return a reference to a specific backend instance, if available.</p>
+<p>If this <code>Instance</code> has a wgpu-hal <a href="../wgpu_hal/trait.Api.html#associatedtype.Instance"><code>Instance</code></a> for backend
+<code>A</code>, return a reference to it. Otherwise, return <code>None</code>.</p>
 <h5 id="safety-1"><a href="#safety-1">Safety</a></h5>
 <ul>
-<li>The raw handle obtained from the hal Instance must not be manually destroyed</li>
+<li>The raw instance handle returned must not be manually destroyed.</li>
 </ul>
 </div></details><details class="rustdoc-toggle method-toggle" open><summary><section id="method.from_core" class="method has-srclink"><a class="srclink rightside" href="../src/wgpu/lib.rs.html#1699-1703">source</a><h4 class="code-header">pub unsafe fn <a href="#method.from_core" class="fnname">from_core</a>(core_instance: Instance) -&gt; Self</h4></section></summary><div class="docblock"><p>Create an new instance of wgpu from a wgpu-core instance.</p>
 <h5 id="arguments-2"><a href="#arguments-2">Arguments</a></h5>