[SYCL][Doc] Modify queue shortcuts extension (#2060)

Add generic lambda support description
Add range shortcuts description

Signed-off-by: Ruslan Arutyunyan <[email protected]>

Author: rarutyun

sycl/doc/extensions/QueueShortcuts/QueueShortcuts.adoc

@@ -19,3 +19,6 @@ Note: These simplifications do not depend on queue order properties.  They apply
 include::queue.hpp[]
 ----
 
+Overloads 4-12 shall support generic lambda as the kernel argument. For overloads 4-9 the generic argument is the `item` with the same dimensions that `range` argument has. For overloads 10-12 the generic argument is the `nd_item` with the same dimensions that `nd_range` argument has.
+
+Overloads 4-6 shall support number or `braced-init-list` as the `range` argument.

sycl/doc/extensions/QueueShortcuts/queue.hpp

@@ -1,50 +1,50 @@
 class queue {
 public:
-  ...
+  // ...
   template <typename KernelName, typename KernelType>
-  event single_task(KernelType KernelFunc);
+  event single_task(KernelType KernelFunc);                                   // (1)
 
   template <typename KernelName, typename KernelType>
-  event single_task(event DepEvent, KernelType KernelFunc);
+  event single_task(event DepEvent, KernelType KernelFunc);                   // (2)
 
   template <typename KernelName, typename KernelType>
   event single_task(const vector_class<event> &DepEvents,
-                    KernelType KernelFunc);
+                    KernelType KernelFunc);                                   // (3)
 
   template <typename KernelName, typename KernelType, int Dims>
-  event parallel_for(range<Dims> NumWorkItems, KernelType KernelFunc);
+  event parallel_for(range<Dims> NumWorkItems, KernelType KernelFunc);        // (4)
 
   template <typename KernelName, typename KernelType, int Dims>
   event parallel_for(range<Dims> NumWorkItems, event DepEvent,
-                     KernelType KernelFunc);
+                     KernelType KernelFunc);                                  // (5)
 
   template <typename KernelName, typename KernelType, int Dims>
   event parallel_for(range<Dims> NumWorkItems,
                      const vector_class<event> &DepEvents,
-                     KernelType KernelFunc);
+                     KernelType KernelFunc);                                  // (6)
 
   template <typename KernelName, typename KernelType, int Dims>
   event parallel_for(range<Dims> NumWorkItems, id<Dims> WorkItemOffset,
-                     KernelType KernelFunc);
+                     KernelType KernelFunc);                                  // (7)
 
   template <typename KernelName, typename KernelType, int Dims>
   event parallel_for(range<Dims> NumWorkItems, id<Dims> WorkItemOffset,
-                     event DepEvent, KernelType KernelFunc);
+                     event DepEvent, KernelType KernelFunc);                  // (8)
 
   template <typename KernelName, typename KernelType, int Dims>
   event parallel_for(range<Dims> NumWorkItems, id<Dims> WorkItemOffset,
                      const vector_class<event> &DepEvents,
-                     KernelType KernelFunc);
+                     KernelType KernelFunc);                                  // (9)
 
   template <typename KernelName, typename KernelType, int Dims>
-  event parallel_for(nd_range<Dims> ExecutionRange, KernelType KernelFunc);
+  event parallel_for(nd_range<Dims> ExecutionRange, KernelType KernelFunc);   // (10)
 
   template <typename KernelName, typename KernelType, int Dims>
   event parallel_for(nd_range<Dims> ExecutionRange, event DepEvent,
-                     KernelType KernelFunc);
+                     KernelType KernelFunc);                                  // (11)
 
   template <typename KernelName, typename KernelType, int Dims>
   event parallel_for(nd_range<Dims> ExecutionRange,
                      const vector_class<event> &DepEvents,
-                     KernelType KernelFunc);
+                     KernelType KernelFunc);                                  // (12)
 };