error consistency for copying images

Author: bashbaug

api/opencl_runtime_layer.asciidoc

@@ -1374,7 +1374,7 @@ Otherwise, it returns one of the following errors:
   * {CL_INVALID_CONTEXT}
     ** if the context associated with _command_queue_ and _src_buffer_ are not the same
     ** if the context associated with _command_queue_ and _dst_buffer_ are not the same
-    ** if the context associated with _command_queue_ and events in _event_wait_list_ are not the same.
+    ** if the context associated with _command_queue_ and events in _event_wait_list_ are not the same
   * {CL_INVALID_MEM_OBJECT}
     ** if _src_buffer_ is not a valid buffer object
     ** if _dst_buffer_ is not a valid buffer object
@@ -1512,7 +1512,7 @@ Otherwise, it returns one of the following errors:
   * {CL_INVALID_CONTEXT}
     ** if the context associated with _command_queue_ and _src_buffer_ are not the same
     ** if the context associated with _command_queue_ and _dst_buffer_ are not the same
-    ** if the context associated with _command_queue_ and events in _event_wait_list_ are not the same.
+    ** if the context associated with _command_queue_ and events in _event_wait_list_ are not the same
   * {CL_INVALID_MEM_OBJECT}
     ** if _src_buffer_ is not a valid buffer object
     ** if _dst_buffer_ is not a valid buffer object
@@ -3731,7 +3731,7 @@ Otherwise, it returns one of the following errors:
     ** if _origin_ is `NULL`
     ** if _region_ is `NULL`
     ** if the region being read or written specified by _origin_ and _region_ is out of bounds
-    ** if values in _origin_ and _region_ do not follow rules described in the argument description for _origin_ and _region_
+    ** if values in _origin_ and _region_ do not follow the rules described in the argument description for _origin_ and _region_
     ** if _image_ is a 1D or 2D image and _slice_pitch_ or _input_slice_pitch_ is not zero
     ** if _ptr_ is `NULL`
 ifdef::cl_khr_mipmap_image[]
@@ -3901,54 +3901,55 @@ argument value specified when _src_image_ or _dst_image_ is created is ignored b
 successfully.
 Otherwise, it returns one of the following errors:
 
-  * {CL_INVALID_COMMAND_QUEUE} if _command_queue_ is not a valid host
-    command-queue.
-  * {CL_INVALID_CONTEXT} if the context associated with _command_queue_,
-    _src_image_ and _dst_image_ are not the same or if the context
-    associated with _command_queue_ and events in _event_wait_list_ are not
-    the same.
-  * {CL_INVALID_MEM_OBJECT} if _src_image_ and _dst_image_ are not valid image
-    objects.
-  * {CL_IMAGE_FORMAT_MISMATCH} if _src_image_ and _dst_image_ do not use the
-    same image format.
-  * {CL_INVALID_VALUE} if _src_origin_, _dst_origin_, or _region_ is `NULL`.
-  * {CL_INVALID_VALUE} if the 2D or 3D rectangular region specified by
-    _src_origin_ and _src_origin_ {plus} _region_ refers to a region outside
-    _src_image_, or if the 2D or 3D rectangular region specified by
-    _dst_origin_ and _dst_origin_ {plus} _region_ refers to a region outside
-    _dst_image_.
-  * {CL_INVALID_VALUE} if values in _src_origin_, _dst_origin_ and _region_ do
-    not follow rules described in the argument description for _src_origin_,
-    _dst_origin_ and _region_.
-  * {CL_INVALID_EVENT_WAIT_LIST} if _event_wait_list_ is `NULL` and
-    _num_events_in_wait_list_ > 0, or _event_wait_list_ is not `NULL` and
-    _num_events_in_wait_list_ is 0, or if event objects in _event_wait_list_
-    are not valid events.
-  * {CL_INVALID_IMAGE_SIZE} if image dimensions (image width, height,
-    specified or compute row and/or slice pitch) for _src_image_ or
-    _dst_image_ are not supported by device associated with _queue_.
-  * {CL_IMAGE_FORMAT_NOT_SUPPORTED} if image format (image channel order and
-    data type) for _src_image_ or _dst_image_ are not supported by device
-    associated with _queue_.
-  * {CL_MEM_OBJECT_ALLOCATION_FAILURE} if there is a failure to allocate
-    memory for data store associated with _src_image_ or _dst_image_.
-  * {CL_OUT_OF_RESOURCES} if there is a failure to allocate resources required
-    by the OpenCL implementation on the device.
-  * {CL_OUT_OF_HOST_MEMORY} if there is a failure to allocate resources
-    required by the OpenCL implementation on the host.
-  * {CL_INVALID_OPERATION} if the device associated with _command_queue_ does
-    not support images (i.e. {CL_DEVICE_IMAGE_SUPPORT} specified in the
-    <<device-queries-table,Device Queries>> table is {CL_FALSE}).
-  * {CL_MEM_COPY_OVERLAP} if _src_image_ and _dst_image_ are the same image
-    object and the source and destination regions overlap.
+  * {CL_INVALID_COMMAND_QUEUE}
+    ** if _command_queue_ is not a valid host command-queue
+  * {CL_INVALID_CONTEXT}
+    ** if the context associated with _command_queue_ and _src_image_ are not the same
+    ** if the context associated with _command_queue_ and _dst_image_ are not the same
+    ** if the context associated with _command_queue_ and events in _event_wait_list_ are not the same
+  * {CL_INVALID_MEM_OBJECT}
+    ** if _src_image_ is not a valid image object
+    ** if _dst_image_ is not a valid image object
+  * {CL_IMAGE_FORMAT_MISMATCH}
+    ** if _src_image_ and _dst_image_ do not use the same image format
+  * {CL_INVALID_VALUE}
+    ** if _src_origin_ is `NULL`
+    ** if _dst_origin_ is `NULL`
+    ** if _region_ is `NULL`
+    ** if the 2D or 3D rectangular region specified by _src_origin_ and _region_ refers to a region outside _src_image_
+    ** if the 2D or 3D rectangular region specified by _dst_origin_ and _region_ refers to a region outside _dst_image_
+    ** if values in _src_origin_, _dst_origin_, and _region_  do not follow the rules described in the argument descriptions for _src_origin_, _dst_origin_ and _region_
 ifdef::cl_khr_mipmap_image[]
-  * {CL_INVALID_MIP_LEVEL} if the {cl_khr_mipmap_image_EXT} extension is
-    supported, and the mip level specified in _src_origin_ or _dst_origin_
-    is not a valid level for the corresponding _src_image_ or _dst_image_,
+  * {CL_INVALID_MIP_LEVEL}
+    ** if the {cl_khr_mipmap_image_EXT} extension is supported and the mip level specified in _src_origin_ is not a valid level for _src_image_
+    ** if the {cl_khr_mipmap_image_EXT} extension is supported and the mip level specified in _dst_origin_ is not a valid level for _dst_image_
 endif::cl_khr_mipmap_image[]
+  * {CL_INVALID_EVENT_WAIT_LIST}
+    ** if _event_wait_list_ is `NULL` and _num_events_in_wait_list_ greater than zero
+    ** if _event_wait_list_ is not `NULL` and _num_events_in_wait_list_ is zero
+    ** if event objects in _event_wait_list_ are not valid events
+  * {CL_INVALID_IMAGE_SIZE}
+    ** if the dimensions for _src_image_ or _dst_image_, such as the image width or image height,
+    are not supported by the device associated with _command_queue_
+  * {CL_IMAGE_FORMAT_NOT_SUPPORTED}
+    ** if the format for _src_image_ or _dst_image_, such as the image channel order or image
+    channel data type, are not supported by the device associated with
+    _command_queue_
+  * {CL_MEM_COPY_OVERLAP}
+    ** if _src_image_ and _dst_image_ are the same image object and the source and destination regions overlap
+  * {CL_MEM_OBJECT_ALLOCATION_FAILURE}
+    ** if there is a failure to allocate memory for data store associated with _src_image_ or _dst_image_
+  * {CL_INVALID_OPERATION}
+    ** if the device associated with _command_queue_ does not support images (the query for {CL_DEVICE_IMAGE_SUPPORT} returns {CL_FALSE})
 ifdef::cl_ext_immutable_memory_objects[]
-  * {CL_INVALID_OPERATION} if _dst_image_ was created with {CL_MEM_IMMUTABLE_EXT}.
+    ** if _dst_image_ was created with {CL_MEM_IMMUTABLE_EXT}
 endif::cl_ext_immutable_memory_objects[]
+  * {CL_OUT_OF_RESOURCES}
+    ** if there is a failure to allocate resources required by the OpenCL
+    implementation on the device
+  * {CL_OUT_OF_HOST_MEMORY}
+    ** if there is a failure to allocate resources required by the OpenCL
+    implementation on the host
 --