Skip to content

Commit

Permalink
Minor wording changes
Browse files Browse the repository at this point in the history
  • Loading branch information
Bensuo committed May 27, 2024
1 parent 8fd7793 commit bf63d3c
Showing 1 changed file with 12 additions and 5 deletions.
17 changes: 12 additions & 5 deletions sycl/doc/extensions/experimental/sycl_ext_oneapi_graph.asciidoc
Original file line number Diff line number Diff line change
Expand Up @@ -1636,9 +1636,10 @@ namespace ext::oneapi::experimental {
----

Dynamic events represent SYCL events from outside of a given `command_graph`
(either obtained from normal SYCL operations or from another `command_graph`)
that nodes in that graph may depend on. The `dynamic_event` object enables these
dependent events to be updated between graph executions.
which nodes in that graph may depend on. These events are either obtained from
normal SYCL operations or from another `command_graph` via `get_event()`. The
`dynamic_event` object enables these dependent events to be updated between
graph executions.

Dynamic events can be used to add dependencies to a graph node in the same way
that regular SYCL events can, by passing them as parameters to
Expand All @@ -1659,8 +1660,8 @@ Graph.add([&](handler& CGH){
});
----
Dynamic events created with an event from a `command_graph` cannot then be
associated with other nodes in that same graph as this would change the shape of
the graph. Attempting to call `handler::depends_on()` with such a
associated with other nodes in that same graph as this could be used change the
topology of the graph. Attempting to call `handler::depends_on()` with such a
`dynamic_event` in that situation will result in an error.

Dynamic events can be created with no event but must be updated with a valid
Expand Down Expand Up @@ -1709,6 +1710,12 @@ Parameters:

* `syclEvent` - The new SYCL event to update this `dynamic_event` with.

Exceptions:

* Throws synchronously with error code `invalid` if `syclEvent` is an event
obtained from a queue submission which was recorded to the same graph any of the
`node`s associated with this `dynamic_event` are from.


|===

Expand Down

0 comments on commit bf63d3c

Please sign in to comment.