From a47ed5dc1ef7fb0591b89b5983bdde233503aa5d Mon Sep 17 00:00:00 2001
From: Jim Blandy <jimb@red-bean.com>
Date: Tue, 16 Jul 2024 18:01:44 -0700
Subject: [PATCH] [hal doc] Note `wgpu_hal::Queue::submit`'s expectations for
 `Fence`.

---
 wgpu-hal/src/lib.rs | 3 +++
 1 file changed, 3 insertions(+)

diff --git a/wgpu-hal/src/lib.rs b/wgpu-hal/src/lib.rs
index 6f470f4ddc..2dd09934df 100644
--- a/wgpu-hal/src/lib.rs
+++ b/wgpu-hal/src/lib.rs
@@ -955,6 +955,9 @@ pub trait Queue: WasmNotSendSync {
     /// - All calls to this function that include a given [`SurfaceTexture`][st]
     ///   in `surface_textures` must use the same [`Fence`].
     ///
+    /// - The [`Fence`] passed as `signal_fence.0` must remain alive until
+    ///   all submissions that will signal it have completed.
+    ///
     /// [`Fence`]: Api::Fence
     /// [cb]: Api::CommandBuffer
     /// [ce]: Api::CommandEncoder