diff --git a/sycl/doc/extensions/experimental/sycl_ext_oneapi_graph.asciidoc b/sycl/doc/extensions/experimental/sycl_ext_oneapi_graph.asciidoc index 2c0b930604a2..75e83b9f229e 100644 --- a/sycl/doc/extensions/experimental/sycl_ext_oneapi_graph.asciidoc +++ b/sycl/doc/extensions/experimental/sycl_ext_oneapi_graph.asciidoc @@ -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 @@ -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 @@ -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. + |===