Added comments, and updated README.md

Author: oleksandr-pavlyk

examples/pybind11/use_dpctl_sycl_kernel/README.md

@@ -3,8 +3,8 @@
 ## Description
 
 This extension demonstrates how you can use dpctl Python types,
-such as ``dpctl.SyclQueue``, in Pybind11
-extensions.
+such as ``dpctl.SyclQueue`` and ``dpctl.program.SyclKernel``, in
+Pybind11 extensions.
 
 
 ## Building
@@ -20,10 +20,6 @@ python example.py
 # Sample output
 
 ```
-(idp) [17:25:27 ansatnuc04 use_dpctl_syclqueue]$ python example.py
-EU count returned by Pybind11 extension 24
-EU count computed by dpctl 24
-
-Computing modular reduction using SYCL on a NumPy array
-Offloaded result agrees with reference one computed by NumPy
+(dpctl) [17:25:27 ubuntu_vm use_dpctl_syclkernel]$ python example.py
+[ 0  2  4  6  8 10 12 14 16 18 20 22 24]
 ```

examples/pybind11/use_dpctl_sycl_kernel/example.py

@@ -22,20 +22,26 @@
 import dpctl.program as dppr
 import dpctl.tensor as dpt
 
+# create execution queue, targeting default selected device
 q = dpctl.SyclQueue()
 
+# read SPIR-V: a program in Khronos standardized intermediate form
 with open("resource/double_it.spv", "br") as fh:
     il = fh.read()
 
+# Build the program for the selected device
 pr = dppr.create_program_from_spirv(q, il, "")
 assert pr.has_sycl_kernel("double_it")
 
+# Retrieve the kernel from the problem
 krn = pr.get_sycl_kernel("double_it")
 assert krn.num_args == 2
 
+# Construct the argument, and allocate memory for the result
 x = dpt.arange(0, stop=13, step=1, dtype="i4", sycl_queue=q)
 y = dpt.empty_like(x)
 
-eg.submit_custom_kernel(q, krn, x, y)
+eg.submit_custom_kernel(q, krn, src=x, dst=y)
 
+# output the result
 print(dpt.asnumpy(y))