Skip to content

Commit

Permalink
Remove deprecation notices in text not describing the affected API.
Browse files Browse the repository at this point in the history
  • Loading branch information
VerenaBeckham authored and gmlueck committed Sep 8, 2024
1 parent 3112b1e commit 1162d24
Show file tree
Hide file tree
Showing 2 changed files with 14 additions and 21 deletions.
4 changes: 1 addition & 3 deletions adoc/chapters/device_compiler.adoc
Original file line number Diff line number Diff line change
Expand Up @@ -406,7 +406,6 @@ supported by both the primary queue's device and the secondary queue's device.
If an application fails to do this, the implementation must throw a synchronous
exception with the [code]#errc::kernel_not_supported# error code from the
<<kernel-invocation-command>> (e.g. [code]#parallel_for()#).
The secondary queue feature is deprecated in SYCL NEXT.

It is legal for a SYCL application to define several kernels in the same
translation unit even if they use different optional features, as shown in the
Expand Down Expand Up @@ -606,8 +605,7 @@ Specifying this attribute on a kernel has two effects. First, it causes the
[code]#errc::kernel_not_supported# error code if the kernel is submitted to a
device that does not have one of the listed aspects. (This includes the device
associated with the secondary queue if the kernel is submitted from a
<<command-group>> that has a secondary queue, which is deprecated in SYCL NEXT.)
Second, it causes the compiler
<<command-group>> that has a secondary queue.) Second, it causes the compiler
to issue a diagnostic if the kernel (or any of the functions it calls) uses an
optional feature that is associated with an aspect that is not listed in the
attribute.
Expand Down
31 changes: 13 additions & 18 deletions adoc/chapters/programming_interface.adoc
Original file line number Diff line number Diff line change
Expand Up @@ -4631,8 +4631,7 @@ the implementation to throw an [code]#exception# with the [code]#errc::invalid#
error code from the [code]#accessor# constructor (if the accessor is not a
placeholder) or from [code]#handler::require()# (if the accessor is a
placeholder). If the accessor is bound to a <<command-group>> with a secondary
queue (deprecated in SYCL NEXT), the sub-buffer's alignment must be
compatible with both the primary
queue, the sub-buffer's alignment must be compatible with both the primary
queue's device and the secondary queue's device, otherwise this exception is
thrown.

Expand Down Expand Up @@ -13690,8 +13689,7 @@ implicitly uses the kernel bundle that contains the [code]#kernelObject#.
Throws an [code]#exception# with the [code]#errc::kernel_not_supported# error
code if the [code]#kernelObject# is not compatible with either the device
associated with the primary queue of the <<command-group>> or with the device
associated with the secondary queue (if specified - this feature is deprecated
in SYCL NEXT).
associated with the secondary queue (if specified).

a@
[source]
Expand All @@ -13713,8 +13711,7 @@ implicitly uses the kernel bundle that contains the [code]#kernelObject#.
Throws an [code]#exception# with the [code]#errc::kernel_not_supported# error
code if the [code]#kernelObject# is not compatible with either the device
associated with the primary queue of the <<command-group>> or with the device
associated with the secondary queue (if specified - this feature is deprecated
in SYCL NEXT).
associated with the secondary queue (if specified).

a@
[source]
Expand All @@ -13741,8 +13738,7 @@ implicitly uses the kernel bundle that contains the [code]#kernelObject#.
Throws an [code]#exception# with the [code]#errc::kernel_not_supported# error
code if the [code]#kernelObject# is not compatible with either the device
associated with the primary queue of the <<command-group>> or with the device
associated with the secondary queue (if specified - this feature is deprecated
in SYCL NEXT).
associated with the secondary queue (if specified).

|====

Expand Down Expand Up @@ -14370,10 +14366,10 @@ If the <<command-group>> attempts to invoke a kernel that is not contained by a
compatible device image in [code]#execBundle#, the <<kernel-invocation-command>>
throws a synchronous [code]#exception# with the
[code]#errc::kernel_not_supported# error code.
If the <<command-group>> has a secondary queue (feature deprecated in SYCL
NEXT), then the [code]#execBundle# must contain a kernel that is compatible with
both the primary queue's device and the secondary queue's device, otherwise the
<<kernel-invocation-command>> throws this exception.
If the <<command-group>> has a secondary queue, then the [code]#execBundle# must
contain a kernel that is compatible with both the primary queue's device and the
secondary queue's device, otherwise the <<kernel-invocation-command>> throws
this exception.

Since the handler method for setting specialization constants is incompatible
with the kernel bundle method, applications should not call this function if
Expand All @@ -14385,9 +14381,8 @@ _Throws:_
* An [code]#exception# with the [code]#errc::invalid# error code if the
<<context>> associated with the <<handler>> via its associated primary
<<queue>> or the <<context>> associated with the secondary <<queue>> (if
provided - this feature is deprecated in SYCL NEXT) is different from the
<<context>> associated with the <<kernel-bundle>> specified by
[code]#execBundle#.
provided) is different from the <<context>> associated with the
<<kernel-bundle>> specified by [code]#execBundle#.

* An [code]#exception# with the [code]#errc::invalid# error code if
[code]#handler::set_specialization_constant()# has been called for this
Expand Down Expand Up @@ -14818,9 +14813,9 @@ code if [code]#Backend != get_backend()#.
--
_Returns:_ The <<native-backend-object>> associated with the <<queue>> that the
<<host-task>> was submitted to.
If the <<command-group>> was submitted with a secondary <<queue>> (feature
deprecated in SYCL NEXT) and the fall-back was triggered, the <<queue>> that is
associated with the [code]#interop_handle# must be the fall-back <<queue>>.
If the <<command-group>> was submitted with a secondary <<queue>> and the
fall-back was triggered, the <<queue>> that is associated with the
[code]#interop_handle# must be the fall-back <<queue>>.
The <<native-backend-object>> returned must be in a state where it is capable of
being used in a way appropriate for the associated <<backend>>.
It is undefined behavior to use the <<native-backend-object>> outside of the
Expand Down

0 comments on commit 1162d24

Please sign in to comment.