Skip to content

Commit

Permalink
Incorporate Wumpf's suggestions.
Browse files Browse the repository at this point in the history
  • Loading branch information
jimblandy committed May 23, 2024
1 parent ab509fb commit 4cf108c
Showing 1 changed file with 17 additions and 13 deletions.
30 changes: 17 additions & 13 deletions wgpu-hal/src/lib.rs
Original file line number Diff line number Diff line change
Expand Up @@ -819,19 +819,23 @@ pub trait Queue: WasmNotSendSync {

/// Submit `command_buffers` for execution on GPU.
///
/// If `signal_fence` is `(fence, value)`, update `fence` to `value`
/// when the operation is complete. See [`Fence`] for details.
///
/// If two calls to `submit` on a single `Queue` occur in a particular order
/// (that is, they happen on the same thread, or on two threads that have
/// synchronized to establish an ordering), then the first submission's
/// commands all complete execution before any of the second submission's
/// commands begin. All results produced by one submission are visible to
/// the next.
///
/// Within a submission, command buffers execute in the order in which they
/// appear in `command_buffers`. All results produced by one buffer are
/// visible to the next.
/// Update `fence` to `value` when the operation is complete. See
/// [`Fence`] for details.
///
/// A `wgpu_hal` queue is "single threaded": all command buffers are
/// executed in the order they're submitted, with each buffer able to see
/// previous buffers' results. Specifically:
///
/// - If two calls to `submit` on a single `Queue` occur in a particular
/// order (that is, they happen on the same thread, or on two threads that
/// have synchronized to establish an ordering), then the first
/// submission's commands all complete execution before any of the second
/// submission's commands begin. All results produced by one submission
/// are visible to the next.
///
/// - Within a submission, command buffers execute in the order in which they
/// appear in `command_buffers`. All results produced by one buffer are
/// visible to the next.
///
/// If two calls to `submit` on a single `Queue` from different threads are
/// not synchronized to occur in a particular order, they must pass distinct
Expand Down

0 comments on commit 4cf108c

Please sign in to comment.