[KHRGA-123] Updated additions of handler (#153)

* Updated additions of handler

Issue: KHRGA-123

source/conf.py

@@ -344,6 +344,11 @@ def make_ref(ref_str, ref_view, ref_sufix):
         "#subsec:interfaces.hosttasks",
     )
     + make_ref("SYCL_SPEC_MATH_ARRAY", "Section 4.14.3", "#sec:marray.type")
+    + make_ref(
+        "SYCL_SPEC_ADDITION_TO_HANDLER",
+        "Section 4.10.3",
+        "#subsec:interfaces.hosttask.handler",
+    )
     + make_ref(
         "SYCL_SPEC_INT_W_HOST_CODE",
         "Section 4.15.5",

source/iface/host-task-add-to-handler.rst

@@ -5,3 +5,34 @@
 **********************************
 Additions to the ``sycl::handler``
 **********************************
+
+This section describes member functions in the command group handler
+class that are used with host tasks.
+
+::
+
+  class handler {
+    ...
+
+        public:
+          template <typename T>
+          void host_task(T&& hostTaskCallable); // (1)
+
+    ...
+  };
+
+Effects: Enqueues an implementation-defined command to the SYCL runtime
+to invoke ``hostTaskCallable`` exactly once. The scheduling of the
+invocation of ``hostTaskCallable`` in relation to other commands
+enqueued to the SYCL runtime must be in accordance with the dependency
+model described in |SYCL_SPEC_MEM_MODEL|. Initializes an
+``interop_handle`` object and passes it to ``hostTaskCallable``
+when it is invoked if ``std::is_invocable_v<T, interop_handle>``
+evaluates to true, otherwise invokes ``hostTaskCallable``
+as a nullary function.
+
+.. seealso::
+
+  |SYCL_SPEC_ADDITION_TO_HANDLER|
+
+  :ref:`handler`

source/spelling_wordlist.txt

@@ -32,6 +32,7 @@ moveable
 USM
 Namespaces
 namespace
+nullary
 instantiations
 interoperation
 interoperating