diff --git a/pyopencl/__init__.py b/pyopencl/__init__.py index 59be64d1d8db45576bed722d2afe3cfd38eb78df..17ab8c52bb5ef1da3724566c2ee178591b5e722f 100644 --- a/pyopencl/__init__.py +++ b/pyopencl/__init__.py @@ -1529,10 +1529,17 @@ def enqueue_copy(queue, dest, src, **kwargs): :arg wait_for: (optional, default empty) :arg is_blocking: Wait for completion. Defaults to *True*. (Available on any copy involving host memory) - :return: A :class:`NannyEvent` if the transfer involved a host-side buffer, otherwise an :class:`Event`. + .. note:: + + Be aware that when the deletion of the :class:`NannyEvent` that is + returned by the function if the transfer involved a host-side buffer + will block until the transfer is complete, so be sure to keep a + reference to this :class:`Event` as long as necessary for the + transfer to complete. + .. note:: Two types of 'buffer' occur in the arguments to this function,