more error consistency for memory objects

Author: bashbaug

api/opencl_runtime_layer.asciidoc

@@ -486,7 +486,7 @@ Otherwise, it returns one of the following errors:
     ** if _command_queue_ is not a valid command-queue for _param_name_
   * {CL_INVALID_VALUE}
     ** if _param_name_ is not one of the supported values
-    ** if the size in bytes specified by _param_value_size_ is less than size of
+    ** if the size in bytes specified by _param_value_size_ is less than the size of
     the return type specified in the
     <<command-queue-info-table, Command-Queue Queries>>
     table and _param_value_ is not `NULL`
@@ -4713,7 +4713,7 @@ Otherwise, it returns one of the following errors:
     ** if _image_ is a not a valid image object
   * {CL_INVALID_VALUE}
     ** if _param_name_ is not one of the supported values
-    ** if the size in bytes specified by _param_value_size_ is less than size of
+    ** if the size in bytes specified by _param_value_size_ is less than the size of
     the return type specified in the
     <<image-info-table, Image Object Queries>>
     table and _param_value_ is not `NULL`
@@ -5647,23 +5647,30 @@ endif::cl_ext_image_from_buffer[]
 successfully.
 Otherwise, it returns one of the following errors:
 
-  * {CL_INVALID_CONTEXT} if _context_ if not a valid context.
-  * {CL_INVALID_PROPERTY} if a property name in properties is not a supported
-    property name, if the value specified for a supported property name is not
-    valid, or if the same property name is specified more than once.
-  * {CL_INVALID_VALUE} if values specified in _flags_ are not valid.
-  * {CL_INVALID_IMAGE_FORMAT_DESCRIPTOR} if values specified in _image_format_
-    are not valid.
-  * {CL_INVALID_IMAGE_DESCRIPTOR} if values specified in _image_desc_
-    are not valid.
-  * {CL_INVALID_VALUE} if _param_name_ is not valid, or if size in bytes
-    specified by _param_value_size_ is < size of return type as described in
-    the <<image-requirements-info-table,Image Requirements Queries>> table and
-    _param_value_ is not `NULL`.
-  * {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_CONTEXT}
+    ** if _context_ if not a valid context
+  * {CL_INVALID_PROPERTY}
+    ** if a property name in _properties_ is not a supported property name
+    ** if the value specified for a supported property name is not valid
+    ** if the same property name is specified more than once
+  * {CL_INVALID_VALUE}
+    ** if values specified in _flags_ are not valid
+  * {CL_INVALID_IMAGE_FORMAT_DESCRIPTOR}
+    ** if values specified in _image_format_ are not valid
+  * {CL_INVALID_IMAGE_DESCRIPTOR}
+    ** if values specified in _image_desc_ are not valid
+  * {CL_INVALID_VALUE}
+    ** if _param_name_ is not valid
+    ** if size in bytes specified by _param_value_size_ is less than the size of
+    the return type specified in the
+    <<image-requirements-info-table,Image Requirements Queries>>
+    table and _param_value_ is not `NULL`
+  * {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
 --
 endif::cl_ext_image_requirements_info[]
 
@@ -5852,12 +5859,14 @@ The _memobj_ reference count is incremented.
 successfully.
 Otherwise, it returns one of the following errors:
 
-  * {CL_INVALID_MEM_OBJECT} if _memobj_ is not a valid memory object (buffer
-    or image object).
-  * {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_MEM_OBJECT}
+    ** if _memobj_ is not a valid memory object
+  * {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
 
 {clCreateBuffer}, {clCreateBufferWithProperties}, {clCreateSubBuffer},
 {clCreateImage}, {clCreateImageWithProperties}, {clCreateImage2D},
@@ -5881,11 +5890,14 @@ The _memobj_ reference count is decremented.
 successfully.
 Otherwise, it returns one of the following errors:
 
-  * {CL_INVALID_MEM_OBJECT} if _memobj_ is not a valid memory object.
-  * {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_MEM_OBJECT}
+    ** if _memobj_ is not a valid memory object
+  * {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
 
 After the _memobj_ reference count becomes zero and commands queued for
 execution on a command-queue(s) that use _memobj_ have finished, the memory
@@ -5936,12 +5948,16 @@ _memobj_ was created and used as the storage bits for the memory object.
 executed successfully.
 Otherwise, it returns one of the following errors:
 
-  * {CL_INVALID_MEM_OBJECT} if _memobj_ is not a valid memory object.
-  * {CL_INVALID_VALUE} if _pfn_notify_ is `NULL`.
-  * {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_MEM_OBJECT}
+    ** if _memobj_ is not a valid memory object
+  * {CL_INVALID_VALUE}
+    ** if _pfn_notify_ is `NULL`
+  * {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
 
 [[callback-functions]]
 [NOTE]