[clang] [SYCL] SYCL host kernel launch support for the sycl_kernel_entry_point attribute. (PR #152403)

[Mariya Podchishchaeva via cfe-commits]

================
@@ -683,24 +696,55 @@ There are a few items worthy of note:
    or more parameters depending on how the SYCL library implementation defines
    these types.
 
-#. The call to ``kernel_entry_point()`` has no effect other than to trigger
-   emission of the entry point function. The statments that make up the body
-   of the function are not executed when the function is called; they are
-   only used in the generation of the entry point function.
+The call to ``kernel_entry_point()`` by ``single_task()`` is effectively
+replaced with synthesized code that looks approximately as follows.
+
+.. code-block:: c++
+
+  sycl::stream sout = Kernel.sout;
----------------
Fznamznon wrote:

Could you please in this sample define what `Kernel` is?
Also, I'm not a fan of stream class choice. IMO this is not a popular class. I understand this is just a documentation example. Still something closer to real life like a usm pointer or an accessor would be better IMO.


https://github.com/llvm/llvm-project/pull/152403