Tighten the definition of CL_IMAGE_{ROW,SLICE}_PITCH queries (#777)

* Tighten the definition of CL_IMAGE_{ROW,SLICE}_PITCH queries

Fixes #763

Signed-off-by: Kevin Petit <kevin.petit@arm.com>
Change-Id: I50875d6aa1ffdf6152832c68ac6cf6bdcb434304

* Update api/opencl_runtime_layer.asciidoc

Co-authored-by: Ben Ashbaugh <ben.ashbaugh@intel.com>

* Remove mention of linear tiling

Change-Id: I4ecd773019f56af391f00333b58ceb8221ca9f0c

Co-authored-by: Ben Ashbaugh <ben.ashbaugh@intel.com>

Author: kpet

api/opencl_runtime_layer.asciidoc

@@ -3430,15 +3430,25 @@ include::{generated}/api/version-notes/CL_IMAGE_ELEMENT_SIZE.asciidoc[]
 
 include::{generated}/api/version-notes/CL_IMAGE_ROW_PITCH.asciidoc[]
   | {size_t_TYPE}
-      | Return calculated row pitch in bytes of a row of elements of the
-        image object given by _image_.
+      | Returns the row pitch in bytes of a row of elements of the
+        image object given by _image_. +
+        If _image_ was created with a non-zero value for `image_row_pitch`,
+        then the value provided for `image_row_pitch` by the application is
+        returned, otherwise the returned value is calculated as
+        {CL_IMAGE_WIDTH} {times} {CL_IMAGE_ELEMENT_SIZE}.
 | {CL_IMAGE_SLICE_PITCH_anchor}
 
 include::{generated}/api/version-notes/CL_IMAGE_SLICE_PITCH.asciidoc[]
   | {size_t_TYPE}
-      | Return calculated slice pitch in bytes of a 2D slice for the 3D
+      | Returns the slice pitch in bytes of a 2D slice for the 3D
         image object or size of each image in a 1D or 2D image array given
-        by _image_.
+        by _image_. +
+        If _image_ was created with a non-zero value for `image_slice_pitch`
+        then the value provided for `image_slice_pitch` by the application
+        is returned, otherwise the returned value is calculated as: +
+         - {CL_IMAGE_ROW_PITCH} for 1D image arrays. +
+         - {CL_IMAGE_HEIGHT} {times} {CL_IMAGE_ROW_PITCH} for 3D images and
+           2D image arrays. +
         For a 1D image, 1D image buffer and 2D image object return 0.
 | {CL_IMAGE_WIDTH_anchor}