diff --git a/doc/source/runtime.rst b/doc/source/runtime.rst
index 14b35f464ba3731fc80e741f7ed47d5980ecc9fc..538ae09dbe35af35134f19015f0a3fa93c1ff344 100644
--- a/doc/source/runtime.rst
+++ b/doc/source/runtime.rst
@@ -707,7 +707,7 @@ Programs and Kernels
 
         Returns a list of all :class:`Kernel` objects in the :class:`Program`.
 
-.. function:: unload_compiler()
+
 
 .. class:: Kernel(program, name)
 
@@ -770,6 +770,18 @@ Programs and Kernels
         most suitable number types will automatically be
         cast to the right type for kernel invocation.
 
+        .. note :: 
+
+            The information set by this rountine is attached to a single kernel
+            instance. A new kernel instance is created every time you use
+            `program.kernel` attribute access. The following will therefore not
+            work::
+
+               prg = cl.Program(...).build()
+               prg.kernel.set_scalar_arg_dtypes(...)
+               prg.kernel(queue, n_globals, None, args)
+
+
     .. method:: __call__(queue, global_size, local_size, *args, global_offset=None, wait_for=None)
 
         Use :func:`enqueue_nd_range_kernel` to enqueue a kernel execution, after using