Add sycl_khr_free_function_commands extension

adoc/chapters/architecture.adoc

@@ -1901,6 +1901,7 @@ always matches the byte order of the devices.
 This allows data to be copied between the host and the devices without any byte
 swapping.
 
+[[subsec:example.sycl.application]]
 == Example SYCL application
 
 Below is a more complex example application, combining some of the features

adoc/config/rouge/lib/rouge/lexers/sycl.rb

@@ -436,6 +436,14 @@ class Sycl < Cpp
         replace_me  # Replace with list of actual keywords
       )
 
+      # Exposition-only identifiers
+      sycl_exposition_only = %w(
+        register-events
+        register-accessors
+        register-kernel-bundle
+        has-tracking
+      )
+
       # Here are some interesting tokens
       # https://pygments.org/docs/tokens/ unused in C++ we can reuse
       # in SYCL mode:
@@ -466,6 +474,8 @@ class Sycl < Cpp
       # Insert some specific rules at the beginning of the statement
       # rule of the C++ lexer
       prepend :statements do
+        rule %r/(?:#{sycl_exposition_only.join('|')})\b/,
+             Generic::Emph
         rule %r/(?:#{sycl_data_types.join('|')})\b/,
              Keyword::Pseudo
         rule %r/(?:#{sycl_functions.join('|')})\b/,

adoc/config/rouge/lib/rouge/themes/sycl_spec.rb

@@ -33,7 +33,8 @@ class SYCLspec < Github
       style Comment::Single,                  :fg => '#9acd32'
       # Use a clearer white background
       style Text,                             :bg => '#ffffff'
-
+      # Render exposition-only functions in italics to match ISO C++
+      style Generic::Emph,                    :fg => '#000000', :italic => true
     end
   end
 end

adoc/extensions/index.adoc

@@ -16,3 +16,4 @@ 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_work_item_queries.adoc[leveloffset=2]
+include::sycl_khr_free_function_commands.adoc[leveloffset=2]