error consistency for filling images

Author: bashbaug

api/opencl_runtime_layer.asciidoc

@@ -3726,7 +3726,7 @@ Otherwise, it returns one of the following errors:
     ** if the context associated with _command_queue_ and _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 _image_ is not a valid buffer object
+    ** if _image_ is not a valid image object
   * {CL_INVALID_VALUE}
     ** if _origin_ is `NULL`
     ** if _region_ is `NULL`
@@ -4038,42 +4038,46 @@ argument value specified when _image_ is created is ignored by
 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_ and
-    _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 _image_ is not a valid image object.
-  * {CL_INVALID_VALUE} if _fill_color_ is `NULL`.
-  * {CL_INVALID_VALUE} if _origin_ or _region_ is `NULL`.
-  * {CL_INVALID_VALUE} if the region being filled as specified by _origin_ and
-    _region_ is out of bounds.
-  * {CL_INVALID_VALUE} if values in _origin_ and _region_ do not follow rules
-    described in the argument description for _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 _image_ are not
-    supported by device associated with _queue_.
-  * {CL_IMAGE_FORMAT_NOT_SUPPORTED} if image format (image channel order and
-    data type) for _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 _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_COMMAND_QUEUE}
+    ** if _command_queue_ is not a valid host command-queue
+  * {CL_INVALID_CONTEXT}
+    ** if the context associated with _command_queue_ and _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 _image_ is not a valid image object
+  * {CL_INVALID_VALUE}
+    ** if _fill_color_ is `NULL`
+    ** if _origin_ is `NULL`
+    ** if _region_ is `NULL`
+    ** if the region being filled specified by _origin_ and _region_ is out of bounds
+    ** if values in _origin_ and _region_ do not follow the rules described in the argument description for _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 _origin_ is not a valid level
-    for _image_,
+  * {CL_INVALID_MIP_LEVEL}
+    ** if the {cl_khr_mipmap_image_EXT} extension is supported and the mip level specified in _origin_ is not a valid level for _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 _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 _image_, such as the image channel order or image
+    channel data type, are not supported by the device associated with
+    _command_queue_
+  * {CL_MEM_OBJECT_ALLOCATION_FAILURE}
+    ** if there is a failure to allocate memory for data store associated with _image_
 ifdef::cl_ext_immutable_memory_objects[]
-  * {CL_INVALID_OPERATION} if _image_ was created with {CL_MEM_IMMUTABLE_EXT}.
+  * {CL_INVALID_OPERATION}
+    ** if _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
 --