Merge branch 'main' into khr_addrspace_cast

Author: gmlueck

.clang-format

@@ -1,8 +1,19 @@
-Language: Cpp
-BasedOnStyle: LLVM
-AccessModifierOffset: -1
-BreakInheritanceList: BeforeComma
-BreakConstructorInitializers: BeforeComma
-Cpp11BracedListStyle: false
-PointerAlignment: Left
-SpaceBeforeCpp11BracedList: true
+---
+Language:        Cpp
+BasedOnStyle:  Google
+AlignTrailingComments: true
+AllowShortBlocksOnASingleLine: false
+AllowShortIfStatementsOnASingleLine: true
+AlwaysBreakAfterDefinitionReturnType: false
+AlwaysBreakTemplateDeclarations: true
+BreakConstructorInitializersBeforeComma: false
+ConstructorInitializerAllOnOneLineOrOnePerLine: true
+# Do not adapt pointer and reference alignment to the current style.
+# Just use PointerAlignment parameter unconditionally for consistency.
+DerivePointerAlignment: false
+Standard:        c++17
+SpacesInParentheses: false
+SpacesInAngles:  false
+SpaceInEmptyParentheses: false
+SpacesInCStyleCastParentheses: false
+SortIncludes:   true

.github/ISSUE_TEMPLATE/bug_report.yml

@@ -0,0 +1,43 @@
+name: 🐛 Bug report
+description: Report something broken in the specification.
+labels: ["bug"]
+body:
+  - type: markdown
+    attributes:
+      value: |
+        Thank you for taking the time to report a bug!
+
+        Please remember that this GitHub repository is for the SYCL *specification*; if you have found a bug in a SYCL *implementation*, you should contact the developers of that implementation instead.
+
+  - type: dropdown
+    id: specification-version
+    attributes:
+      label: Specification Version
+      description: |
+        What version of the specification contains the bug?
+      options:
+        - SYCL 2020 (Revision 10)
+        - SYCL 2020 (Revision 9)
+        - SYCL 2020 (Source)
+        - SYCL Next (Source)
+      default: 0
+    validations:
+      required: true
+
+  - type: textarea
+    id: section-numbers
+    attributes:
+      label: Section Number(s)
+      description: List out the section(s) containing the bug, including a link if you are viewing the HTML source (e.g., Section 5.6. Preprocessor directives and macros, https://registry.khronos.org/SYCL/specs/sycl-2020/html/sycl-2020.html#_preprocessor_directives_and_macros).
+    validations:
+      required: true
+
+  - type: textarea
+    id: bug-description
+    attributes:
+      label: Bug Description
+      description: |
+        Explain why the specification is wrong.
+        Please be as detailed as possible, and quote the specification text.
+    validations:
+      required: true

.github/ISSUE_TEMPLATE/clarification_request.yml

@@ -0,0 +1,51 @@
+name: ❓ Clarification request
+description: Highlight an inconsistency or unclear description.
+labels: ["clarification"]
+body:
+  - type: markdown
+    attributes:
+      value: |
+        Thank you for taking the time to improve the SYCL specification.
+
+  - type: dropdown
+    id: specification-version
+    attributes:
+      label: Specification Version
+      description: |
+        What version of the specification is unclear?
+      options:
+        - SYCL 2020 (Revision 10)
+        - SYCL 2020 (Revision 9)
+        - SYCL 2020 (Source)
+        - SYCL Next (Source)
+      default: 0
+    validations:
+      required: true
+
+  - type: textarea
+    id: section-numbers
+    attributes:
+      label: Section Number(s)
+      description: List out the section(s) that are unclear, including a link if you are viewing the HTML source (e.g., Section 5.6. Preprocessor directives and macros, https://registry.khronos.org/SYCL/specs/sycl-2020/html/sycl-2020.html#_preprocessor_directives_and_macros).
+    validations:
+      required: true
+
+  - type: textarea
+    id: issue-description
+    attributes:
+      label: Issue Description
+      description: |
+        Explain why you think the specification is unclear.
+        Please be as detailed as possible, and quote the specification text.
+    validations:
+      required: true
+
+  - type: textarea
+    id: code-example
+    attributes:
+      label: Code Example (Optional)
+      description: |
+        Provide one or more SYCL examples to demonstrate the issue.
+        This is not required, but may help others to understand the issue.
+    validations:
+      required: false

.github/ISSUE_TEMPLATE/config.yml

@@ -0,0 +1,2 @@
+blank_issues_enabled: true
+contact_links: []

.github/ISSUE_TEMPLATE/feature_request.yml

@@ -0,0 +1,62 @@
+name: 🚀 Feature request
+description: Request a new SYCL feature or extension.
+labels: ["enhancement"]
+body:
+  - type: markdown
+    attributes:
+      value: |
+        Thank you for taking the time to improve the SYCL specification.
+
+  - type: dropdown
+    id: extension-type
+    attributes:
+      label: Extension Type
+      description: |
+        Is this an improvement to an existing SYCL feature, or a brand new feature?
+      options:
+        - "Improvement"
+        - "New Feature"
+      default: 1
+    validations:
+      required: true
+
+  - type: textarea
+    id: feature-description
+    attributes:
+      label: Feature Description
+      description: |
+        Describe the desired feature in as much detail as possible.
+        Be sure to explain why existing features are insufficient.
+    validations:
+      required: true
+
+  - type: textarea
+    id: cpp-features
+    attributes:
+      label: Related Functionality in C++
+      description: |
+        If related functionality already exists in C++, please provide
+        details. 
+    validations:
+      required: false
+
+  - type: textarea
+    id: similar-features
+    attributes:
+      label: Related Functionality in Other Languages
+      description: |
+        If related functionality already exists in other languages (e.g.,
+        OpenCL, CUDA, OpenMP), please provide details.
+    validations:
+      required: false
+
+  - type: textarea
+    id: existing-extensions
+    attributes:
+      label: Related SYCL Extensions
+      description: |
+        If related functionality already exists in the form of a SYCL
+        extension, please provide a link to that extension.
+    validations:
+      required: false
+

.github/workflows/CI.yml

@@ -1,4 +1,4 @@
-# Copyright 2021-2024 The Khronos Group, Inc.
+# Copyright 2021-2025 The Khronos Group, Inc.
 # SPDX-License-Identifier: Apache-2.0
 
 # CI to build asciidoctor spec targets, on push or manually
@@ -28,8 +28,8 @@ jobs:
     # Use the Khronos container with the asciidoctor toolchain preinstalled.  We
     # reference the image by its SHA rather than its tag because they sometimes
     # overwrite a tag with a different image (which has a different SHA).  This
-    # SHA corresponds to tag "asciidoctor-spec.20240727".
-    container: khronosgroup/docker-images@sha256:089687083ceb36483a3917389e4278718ab19c594099634f5dd80e22540c960f
+    # SHA corresponds to tag "asciidoctor-spec.20250629".
+    container: khronosgroup/docker-images@sha256:0f91e60e1af2bdd889783af3907f63279c08f573f2eccbc31094e348d1a32a4f
 
     steps:
       # Checks-out your repository under $GITHUB_WORKSPACE, so your job can access it
@@ -52,3 +52,18 @@ jobs:
           name: spec-outputs
           path: |
             /tmp/out
+
+  check-clang-format:
+    if: github.event_name == 'pull_request'
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v4
+        with:
+          fetch-depth: 0 # Need to check out base branch as well
+      - name: Install clang-format
+        run: sudo apt update; sudo apt install -y clang-format-18
+      # Inspired by SYCL-CTS
+      - name: Run clang-format on changed files from adoc/code/
+        run: |
+          git diff -U0 --no-color ${{ github.event.pull_request.base.sha }} ./adoc/code/ | ./adoc/scripts/clang-format-diff.py -p1

.github/workflows/open_cts_issue.yml

@@ -10,6 +10,9 @@ on:
     types: opened
     paths:
       - 'adoc/**'
+    # We don't want to create issues for cherry-picks into older spec revisions
+    branches:
+      - main
 jobs:
   create-issue:
     runs-on: ubuntu-latest

COPYRIGHT.txt

@@ -1,4 +1,4 @@
-Copyright (c) 2011-2024 The Khronos Group, Inc.
+Copyright (c) 2011-2025 The Khronos Group, Inc.
 
 This specification is protected by copyright laws and contains material proprietary
 to Khronos. Except as described by these terms, it or any components

LICENSE.txt

@@ -1,4 +1,4 @@
-Copyright (c) 2011-2024 The Khronos Group, Inc.
+Copyright (c) 2011-2025 The Khronos Group, Inc.
 
 The files in, and generated output documents from this SYCL-Docs project are
 under a mix of copyright and license statements. Refer to the individual files

README.md

@@ -2,8 +2,8 @@
 
 <!-- to update to newer CI when going public ![Build Status](https://api.travis-ci.com/KhronosGroup/SYCL-Docs.svg?branch=master) -->
 <!-- to update to newer CI when going public [![SPEC master](https://img.shields.io/badge/SPEC-master-red.svg?logo=adobe-acrobat-reader)](https://khronosgroup.github.io/SYCL-Docs/sycl/sycl.pdf) -->
-[![SPEC 2020-9](https://img.shields.io/badge/SPEC-2020--9-orange.svg?logo=adobe-acrobat-reader)](https://www.khronos.org/registry/SYCL/specs/sycl-2020/pdf/sycl-2020.pdf)
-[![SPEC 2020-9](https://img.shields.io/badge/SPEC-2020--9-orange.svg?logo=HTML5)](https://www.khronos.org/registry/SYCL/specs/sycl-2020/html/sycl-2020.html)
+[![SPEC 2020-10](https://img.shields.io/badge/SPEC-2020--10-orange.svg?logo=adobe-acrobat-reader)](https://www.khronos.org/registry/SYCL/specs/sycl-2020/pdf/sycl-2020.pdf)
+[![SPEC 2020-10](https://img.shields.io/badge/SPEC-2020--10-orange.svg?logo=HTML5)](https://www.khronos.org/registry/SYCL/specs/sycl-2020/html/sycl-2020.html)
 [![SPEC latest](https://img.shields.io/badge/SPEC-latest-red.svg?logo=adobe-acrobat-reader)](https://github.com/KhronosGroup/SYCL-Docs/actions?query=branch%3ASYCL-2020%2Fmaster+is%3Asuccess)
 [![Join the Slack group](https://img.shields.io/badge/chat-on%20slack-blue.svg?logo=slack)](https://khr.io/slack)