[clang] [clang][doc][SYCL] Expand SYCL driver release notes (PR #200449)
Srividya Sundaram via cfe-commits
cfe-commits at lists.llvm.org
Wed Jun 3 18:01:05 PDT 2026
https://github.com/srividya-sundaram updated https://github.com/llvm/llvm-project/pull/200449
>From e173d307b3d4572499bd3f046a2fd7860046c1ce Mon Sep 17 00:00:00 2001
From: srividya sundaram <srividya.sundaram at intel.com>
Date: Fri, 29 May 2026 09:27:23 -0700
Subject: [PATCH 1/4] [clang][doc][SYCL] Expand SYCL driver release notes
Add driver-level entries to the SYCL Support section covering notable
changes since the initial upstream driver work: -fsycl/-fsycl-device-only/
-fsycl-host-only flag introduction, C++17 default enforcement, runtime
library rename (libsycl.so -> libLLVMSYCL.so), automatic runtime library
path and header injection, Windows SYCL runtime linking support, and the
-nolibsycl / spurious spirv-link flag fixes.
---
clang/docs/ReleaseNotes.rst | 29 +++++++++++++++++++++++++++++
1 file changed, 29 insertions(+)
diff --git a/clang/docs/ReleaseNotes.rst b/clang/docs/ReleaseNotes.rst
index d89e0358cba41..c280b37185aa6 100644
--- a/clang/docs/ReleaseNotes.rst
+++ b/clang/docs/ReleaseNotes.rst
@@ -945,10 +945,39 @@ OpenMP Support
SYCL Support
------------
+- Initial SYCL offload compilation support has been added to the driver. The
+ new ``-fsycl`` flag enables SYCL offloading, producing a SPIR-V device image
+ packaged into the host object. ``-fsycl-device-only`` and
+ ``-fsycl-host-only`` restrict compilation to the device or host side
+ respectively. (#GH117268)
+
+- SYCL compilations now default to ``-std=c++17`` when no explicit language
+ standard is specified. Standards below C++17 are rejected with a diagnostic.
+ (#GH194014)
+
- Clang now assumes default target for SYCL device compilation is 64-bit SPIR-V
and it now diagnoses if a non-supporting target is specified via command line.
(#GH167358)
+- The SYCL runtime shared library has been renamed from ``libsycl.so`` to
+ ``libLLVMSYCL.so`` (``LLVMSYCL.lib`` / ``LLVMSYCLd.lib`` on Windows) to
+ align with LLVM naming conventions. The driver now passes the runtime library
+ path to ``clang-linker-wrapper`` and adds SYCL header include paths
+ automatically for both host and device compilations. (#GH188770, #GH174877)
+
+- SYCL runtime library linking is now supported on Windows. When ``-fsycl`` is
+ specified, the driver automatically adds ``/MD`` if no explicit CRT flag is
+ present, links the appropriate debug (``LLVMSYCLd.lib``) or release
+ (``LLVMSYCL.lib``) library, and rejects static CRT flags (``/MT``,
+ ``/MTd``) with a diagnostic. Use ``-nolibsycl`` to suppress automatic
+ library linking. (#GH194744)
+
+- Fixed ``-nolibsycl`` being silently ignored on Linux: the SYCL runtime
+ library was unconditionally added to the link line even when the flag was
+ passed. Fixed ``--allow-partial-linkage`` and ``--create-library`` flags
+ being incorrectly forwarded to ``clang-sycl-linker`` for SYCL offload
+ targets, causing link failures. (#GH200252)
+
Improvements
^^^^^^^^^^^^
- Improved substitution performance in concept checking. (#GH172266)
>From ec0b6f8c98f2eea6d3308a5d2fde06b496d459c4 Mon Sep 17 00:00:00 2001
From: srividya sundaram <srividya.sundaram at intel.com>
Date: Fri, 29 May 2026 14:40:30 -0700
Subject: [PATCH 2/4] [clang][doc][SYCL] Update SYCL Support section with
notable driver changes.
---
clang/docs/ReleaseNotes.rst | 7 ++-----
1 file changed, 2 insertions(+), 5 deletions(-)
diff --git a/clang/docs/ReleaseNotes.rst b/clang/docs/ReleaseNotes.rst
index c280b37185aa6..b82101249b093 100644
--- a/clang/docs/ReleaseNotes.rst
+++ b/clang/docs/ReleaseNotes.rst
@@ -961,8 +961,7 @@ SYCL Support
- The SYCL runtime shared library has been renamed from ``libsycl.so`` to
``libLLVMSYCL.so`` (``LLVMSYCL.lib`` / ``LLVMSYCLd.lib`` on Windows) to
- align with LLVM naming conventions. The driver now passes the runtime library
- path to ``clang-linker-wrapper`` and adds SYCL header include paths
+ align with LLVM naming conventions. SYCL header include paths are now added
automatically for both host and device compilations. (#GH188770, #GH174877)
- SYCL runtime library linking is now supported on Windows. When ``-fsycl`` is
@@ -974,9 +973,7 @@ SYCL Support
- Fixed ``-nolibsycl`` being silently ignored on Linux: the SYCL runtime
library was unconditionally added to the link line even when the flag was
- passed. Fixed ``--allow-partial-linkage`` and ``--create-library`` flags
- being incorrectly forwarded to ``clang-sycl-linker`` for SYCL offload
- targets, causing link failures. (#GH200252)
+ passed. (#GH200252)
Improvements
^^^^^^^^^^^^
>From 979a34289b6e35943e84d2e328904832ab5b17ec Mon Sep 17 00:00:00 2001
From: srividya sundaram <srividya.sundaram at intel.com>
Date: Fri, 29 May 2026 14:44:03 -0700
Subject: [PATCH 3/4] Driver to Clang text change.
---
clang/docs/ReleaseNotes.rst | 2 +-
1 file changed, 1 insertion(+), 1 deletion(-)
diff --git a/clang/docs/ReleaseNotes.rst b/clang/docs/ReleaseNotes.rst
index b82101249b093..6d01ae4650a7b 100644
--- a/clang/docs/ReleaseNotes.rst
+++ b/clang/docs/ReleaseNotes.rst
@@ -945,7 +945,7 @@ OpenMP Support
SYCL Support
------------
-- Initial SYCL offload compilation support has been added to the driver. The
+- Initial SYCL offload compilation support has been added to Clang. The
new ``-fsycl`` flag enables SYCL offloading, producing a SPIR-V device image
packaged into the host object. ``-fsycl-device-only`` and
``-fsycl-host-only`` restrict compilation to the device or host side
>From b584e0c0f15b5465928e6ad908f8e9d2a7e354a6 Mon Sep 17 00:00:00 2001
From: srividya sundaram <srividya.sundaram at intel.com>
Date: Wed, 3 Jun 2026 18:00:11 -0700
Subject: [PATCH 4/4] Remove #GH entries pointing to PRs and 1 old SYCL update.
---
clang/docs/ReleaseNotes.rst | 13 +++----------
1 file changed, 3 insertions(+), 10 deletions(-)
diff --git a/clang/docs/ReleaseNotes.rst b/clang/docs/ReleaseNotes.rst
index 6d01ae4650a7b..de5b505e19a03 100644
--- a/clang/docs/ReleaseNotes.rst
+++ b/clang/docs/ReleaseNotes.rst
@@ -945,15 +945,8 @@ OpenMP Support
SYCL Support
------------
-- Initial SYCL offload compilation support has been added to Clang. The
- new ``-fsycl`` flag enables SYCL offloading, producing a SPIR-V device image
- packaged into the host object. ``-fsycl-device-only`` and
- ``-fsycl-host-only`` restrict compilation to the device or host side
- respectively. (#GH117268)
-
- SYCL compilations now default to ``-std=c++17`` when no explicit language
standard is specified. Standards below C++17 are rejected with a diagnostic.
- (#GH194014)
- Clang now assumes default target for SYCL device compilation is 64-bit SPIR-V
and it now diagnoses if a non-supporting target is specified via command line.
@@ -962,18 +955,18 @@ SYCL Support
- The SYCL runtime shared library has been renamed from ``libsycl.so`` to
``libLLVMSYCL.so`` (``LLVMSYCL.lib`` / ``LLVMSYCLd.lib`` on Windows) to
align with LLVM naming conventions. SYCL header include paths are now added
- automatically for both host and device compilations. (#GH188770, #GH174877)
+ automatically for both host and device compilations.
- SYCL runtime library linking is now supported on Windows. When ``-fsycl`` is
specified, the driver automatically adds ``/MD`` if no explicit CRT flag is
present, links the appropriate debug (``LLVMSYCLd.lib``) or release
(``LLVMSYCL.lib``) library, and rejects static CRT flags (``/MT``,
``/MTd``) with a diagnostic. Use ``-nolibsycl`` to suppress automatic
- library linking. (#GH194744)
+ library linking.
- Fixed ``-nolibsycl`` being silently ignored on Linux: the SYCL runtime
library was unconditionally added to the link line even when the flag was
- passed. (#GH200252)
+ passed.
Improvements
^^^^^^^^^^^^
More information about the cfe-commits
mailing list