Skip to content
Open
Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
43 commits
Select commit Hold shift + click to select a range
46487a3
[KHR] Provide an alternative to <sycl/sycl.hpp>
AlexeySachkov Apr 18, 2025
2f70d45
Fix formatting
AlexeySachkov May 27, 2025
35394ca
Move `remove_decoration` into type traits header
AlexeySachkov May 27, 2025
ba0812d
Generalize guarantees about headers content
AlexeySachkov May 27, 2025
0963fdb
Split and remove runtime include
AlexeySachkov May 27, 2025
5214772
Fix section reference
AlexeySachkov Jun 3, 2025
b9d3fb6
Merge remote-tracking branch 'origin/main' into private/asachkov/spli…
AlexeySachkov Jun 3, 2025
736fe3e
Add .hpp extension to new headers
AlexeySachkov Jun 11, 2025
7e6881d
Resolve SYCL_SIMPLE_SWIZZLES issue
AlexeySachkov Jun 11, 2025
6aaa8df
WIP on unifying wording
AlexeySachkov Jun 17, 2025
bcc0d74
Switch to the new note syntax
AlexeySachkov Jun 17, 2025
0f59355
Use asterics instead of dash for bullet lists
AlexeySachkov Jun 17, 2025
e4233da
Apply some comments
AlexeySachkov Jun 30, 2025
a55dc24
Remove hardcoded section references
AlexeySachkov Jun 30, 2025
3b4e2a1
Document missing event info descriptors
AlexeySachkov Jun 30, 2025
d546d2f
Document missing accessor-related enumerations
AlexeySachkov Jun 30, 2025
497a2c9
Fix missing namespaces
AlexeySachkov Jun 30, 2025
0c47b34
Remove duplication in reduction.hpp description
AlexeySachkov Jun 30, 2025
a64a4ec
Move identity-related type traits into the dedicated header with othe…
AlexeySachkov Jun 30, 2025
3319528
Document missing kernel-device-specific info descriptors
AlexeySachkov Jun 30, 2025
f75f725
Drop memory_order_traits because it is exposition-only
AlexeySachkov Jun 30, 2025
b1daf3a
Drop submit.hpp header
AlexeySachkov Jun 30, 2025
792170e
Document SYCL_BACKEND_* macro
AlexeySachkov Jun 30, 2025
d7cce9f
Split groups.hpp header
AlexeySachkov Jun 30, 2025
73d713b
Put kernel_handler into its own header
AlexeySachkov Jul 18, 2025
0a191b0
Merge remote-tracking branch 'origin/main' into private/asachkov/spli…
AlexeySachkov Jul 18, 2025
cfaf79c
Split a single bullet into multiple
AlexeySachkov Jul 18, 2025
59b5e14
Outline all properties into distinct headers
AlexeySachkov Jul 22, 2025
7187f28
Clarify the content of reduction.hpp
AlexeySachkov Jul 22, 2025
58cea1d
Merge remote-tracking branch 'origin/main' into private/asachkov/spli…
AlexeySachkov Sep 9, 2025
f0578dd
Restore extra anchors lost during merge
AlexeySachkov Sep 9, 2025
bba9f81
Fix references to the core spec
AlexeySachkov Sep 9, 2025
fe64b69
Apply comments to the introduction sections of the extension
AlexeySachkov Sep 9, 2025
cdf04a3
Apply wording suggestions
AlexeySachkov Sep 10, 2025
cde0cd2
Fix some typos
AlexeySachkov Sep 10, 2025
c48866e
Reformat the extension overview table
AlexeySachkov Sep 10, 2025
5f0921c
Revert "Outline all properties into distinct headers"
AlexeySachkov Sep 10, 2025
53a7e46
Accept removal suggestions
AlexeySachkov Sep 10, 2025
b2a9e9c
Update code example about version.hpp
AlexeySachkov Sep 10, 2025
fd6e5aa
Fix a couple more spec links
AlexeySachkov Sep 10, 2025
4abdba6
Definitions defined by -> definitions from
AlexeySachkov Sep 30, 2025
b732547
Make the overview table normative
AlexeySachkov Sep 30, 2025
1296117
Update comments in the code snippet
AlexeySachkov Sep 30, 2025
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
1 change: 1 addition & 0 deletions adoc/chapters/architecture.adoc
Original file line number Diff line number Diff line change
Expand Up @@ -1774,6 +1774,7 @@ code as well as the <<device-image, device images>> for the
As in the <<smcp>> case, each <<device-image>> could either contain native
device ISA or an intermediate language.

[[subsec:library-only]]
=== Library-only implementation

It is also possible to implement SYCL purely as a library, using an
Expand Down
2 changes: 1 addition & 1 deletion adoc/chapters/device_compiler.adoc
Original file line number Diff line number Diff line change
Expand Up @@ -342,7 +342,7 @@ double
|====



[[sec:preprocessor-directives-and-macros]]
== Preprocessor directives and macros

The standard {cpp} preprocessing directives and macros are supported.
Expand Down
13 changes: 13 additions & 0 deletions adoc/chapters/programming_interface.adoc
Original file line number Diff line number Diff line change
Expand Up @@ -606,6 +606,7 @@ A SYCL implementation or a <<backend>> may provide additional properties other
than those defined here, provided they are defined in accordance with the
requirements described in <<sec:headers-and-namespaces>>.

[[subsec:properties-interface]]
==== Properties interface

Each of the runtime classes mentioned above must provide a common interface of
Expand Down Expand Up @@ -7216,6 +7217,7 @@ access_mode::read_write
|====


[[subsec:accessor-deduction-tags]]
==== Deduction tags

Some accessor constructors take a [code]#DeductionTagT# parameter, which is used
Expand All @@ -7236,6 +7238,7 @@ being constructed, so they are described more fully below in the section that
pertains to each of the accessor types.


[[sec:accessor-properties]]
==== Properties

All accessor constructors accept a [code]#property_list# parameter, which
Expand Down Expand Up @@ -11136,6 +11139,7 @@ Users may query the device to determine if system allocations are supported for
use on the device, through [code]#aspect::usm_system_allocations#.


[[sec:usm-allocations]]
=== USM allocations

USM provides several allocation functions.
Expand Down Expand Up @@ -11850,6 +11854,7 @@ _Effects_: Equivalent to [code]#return free(ptr, q.get_context());#.
submit a "free" <<command>> to the device; the [code]#queue# argument is only
used to determine the [code]#context# associated with [code]#ptr#.{endnote}

[[subsec:usm-mem-ptr-queries]]
=== Unified shared memory pointer queries

Since USM pointers look like raw {cpp} pointers, users cannot deduce what kind
Expand Down Expand Up @@ -16978,6 +16983,7 @@ _Throws:_
the <<backend>> that corresponds with [code]#Param# is different from the
<<backend>> that is associated with this kernel bundle.

[[sec:kernel-info-descriptors]]
==== Kernel information descriptors

A <<kernel>> can be queried for information using the [code]#get_info()# member
Expand Down Expand Up @@ -17305,6 +17311,7 @@ declarable ([code]#std::complex#).
include::{code_dir}/lambdaNameExamples.cpp[lines=4..-1]
----

[[subsec:is-device-copyable-type-trait]]
=== [code]#is_device_copyable# type trait

....
Expand Down Expand Up @@ -18786,6 +18793,7 @@ defined integer type.
|====


[[subsec:vec-aliases]]
==== Aliases

The SYCL programming API provides all permutations of the type alias:
Expand Down Expand Up @@ -20196,6 +20204,7 @@ marray<bool, NumElements> operator!(const marray& v)



[[subsec:marray-aliases]]
==== Aliases

The SYCL programming API provides all permutations of the type alias:
Expand Down Expand Up @@ -21912,6 +21921,7 @@ described in <<sec:kernel.query>>.
It is undefined behavior for any group function to be invoked within a
[code]#parallel_for_work_group# or [code]#parallel_for_work_item# context.

[[subsec:group-type-traits]]
==== Group type trait

[source,,linenums]
Expand Down Expand Up @@ -25436,6 +25446,7 @@ The return type is [code]#NonScalar# unless [code]#NonScalar# is the
'''


[[sec:native-precision-math-functions]]
=== Native precision math functions

This section describes the native precision math functions that are available in
Expand Down Expand Up @@ -25874,6 +25885,7 @@ The return type is [code]#NonScalar# unless [code]#NonScalar# is the
'''


[[sec:half-precision-math-functions]]
=== Half precision math functions (deprecated)

This section describes the half precision math functions that are available in
Expand Down Expand Up @@ -27137,6 +27149,7 @@ The return type is [code]#Int32Bit1# unless [code]#Int32Bit1# is the
'''


[[sec:common-functions]]
=== Common functions

This section describes the common functions that are available in the
Expand Down
3 changes: 2 additions & 1 deletion adoc/extensions/index.adoc
Original file line number Diff line number Diff line change
Expand Up @@ -14,4 +14,5 @@ include::sycl_khr_default_context.adoc[leveloffset=2]
include::sycl_khr_queue_empty_query.adoc[leveloffset=2]
include::sycl_khr_group_interface.adoc[leveloffset=2]
include::sycl_khr_max_work_group_queries.adoc[leveloffset=2]
include::sycl_khr_queue_flush.adoc[leveloffset=2]
include::sycl_khr_queue_flush.adoc[leveloffset=2]
include::sycl_khr_includes.adoc[leveloffset=2]
Loading
Loading