change log with changes from v3.0.16 (#1274)

* initial change log for changes to 3.0.16

* update with last-minute changes

* add named NT handles to external memory in addition to semaphores

Author: bashbaug

api/appendix_e.asciidoc

@@ -504,13 +504,13 @@ Changes from *v3.0.8*:
       ** {cl_khr_integer_dot_product_EXT} (version 2)
       ** {cl_khr_semaphore_EXT} (provisional)
       ** {cl_khr_external_semaphore_EXT} (provisional)
-      ** {cl_khr_external_semaphore_dx_fence_EXT} (provisional)
+      ** `cl_khr_external_semaphore_dx_fence` (provisional)
       ** {cl_khr_external_semaphore_opaque_fd_EXT} (provisional)
       ** {cl_khr_external_semaphore_sync_fd_EXT} (provisional)
       ** {cl_khr_external_semaphore_win32_EXT} (provisional)
       ** {cl_khr_external_memory_EXT} (provisional)
       ** {cl_khr_external_memory_dma_buf_EXT} (provisional)
-      ** {cl_khr_external_memory_dx_EXT} (provisional)
+      ** `cl_khr_external_memory_dx` (provisional)
       ** {cl_khr_external_memory_opaque_fd_EXT} (provisional)
       ** {cl_khr_external_memory_win32_EXT} (provisional)
 
@@ -622,3 +622,43 @@ Changes from *v3.0.15*:
       ** {cl_khr_external_memory_win32_EXT}
   * Added new extension:
       ** {cl_khr_kernel_clock_EXT} (provisional)
+
+Changes from *v3.0.16*:
+
+  * Clarified the definition of command prerequisites, see {khronos-opencl-pr}/923[#923].
+  * Clarified the behavior of {CL_DEVICE_TYPE_DEFAULT} and {CL_DEVICE_TYPE_ALL} for custom devices, see {khronos-opencl-pr}/1117[#1117].
+  * Clarified how {CL_DEVICE_ATOMIC_SCOPE_ALL_DEVICES} behaves for devices that do not support {CL_DEVICE_SVM_ATOMICS}, see {khronos-opencl-pr}/1171[#1171].
+  * Fixed links to extension API functions, see {khronos-opencl-pr}/1179[#1179].
+  * Further clarified an error condition for {clCreateBuffer} with {CL_MEM_COPY_HOST_PTR} and an SVM pointer that is too small, see {khronos-opencl-pr}/1189[#1189].
+  * Fixed a minor typo in the {clCreateProgramWithSource} introduction, see {khronos-opencl-pr}/1204[#1204].
+  * Clarified how to properly use and modify OpenCL objects across multiple command-queues, see {khronos-opencl-pr}/1243[#1243].
+  * Clarified and corrected many parts of {clSetKernelExecInfo}, see {khronos-opencl-pr}/1245[#1245].
+  * Improved wording consistency for _param_value_size_ parameters, see {khronos-opencl-pr}/1254[#1254].
+  * Clarified the meaning of _num_mip_levels_ in {cl_image_desc_TYPE}, see {khronos-opencl-pr}/1255[#1255] and {khronos-opencl-pr}/1272[#1272].
+  * Clarified that functionality will never be removed in minor OpenCL specification revisions, see {khronos-opencl-pr}/1265[#1265].
+  * Clarified that the minimum value for {CL_DEVICE_HALF_FP_CONFIG} applies to all OpenCL versions, see {khronos-opencl-pr}/1273[#1273].
+  * {cl_khr_command_buffer_EXT} (provisional):
+      ** Added multi-device wording to {clCommandBarrierWithWaitListKHR}, see {khronos-opencl-pr}/1146[#1146].
+      ** Fixed {CL_INVALID_CONTEXT} command-buffer error definitions, see {khronos-opencl-pr}/1149[#1149].
+      ** Added a _properties_ parameter to all command-buffer commands to improve extensibility, see {khronos-opencl-pr}/1215[#1215].
+  * {cl_khr_command_buffer_mutable_dispatch_EXT} (provisional):
+      ** Modified the extension to pass update configs as arrays, rather than linked lists, see {khronos-opencl-pr}/1045[#1045].
+  * {cl_khr_external_memory_EXT}:
+      ** Clarified acquire and release behavior, see {khronos-opencl-pr}/1176[#1176].
+      ** Added a mechanism to import NT handles by name, see {khronos-opencl-pr}/1177[#1177].
+      ** Documented which error condition should be returned when attempting to create a memory object with more than one external handle, see {khronos-opencl-pr}/1249[#1249].
+  * {cl_khr_external_semaphore_EXT}:
+      ** Added a mechanism to import NT handles by name, see {khronos-opencl-pr}/1177[#1177].
+      ** Fixed a typo in the description of {clGetSemaphoreHandleForTypeKHR}, see {khronos-opencl-pr}/1220[#1220].
+      ** Clarified that there are no implicit dependencies when waiting on or signaling semaphores using out-of-order queues, see {khronos-opencl-pr}/1231[#1231].
+      ** Documented which error condition should be returned when attempting to create a semaphore with more than one external handle, see {khronos-opencl-pr}/1249[#1249].
+      ** Unified the {CL_INVALID_COMMAND_QUEUE} behavior for semaphore signals and waits, see {khronos-opencl-pr}/1256[#1256].
+      ** Clarified that {clGetSemaphoreHandleForTypeKHR} is part of {cl_khr_external_semaphore_EXT} and not {cl_khr_external_semaphore_sync_fd_EXT}, see {khronos-opencl-pr}/1257[#1257].
+  * {cl_khr_external_semaphore_sync_fd_EXT}:
+      ** Fixed typos in the description of {clReImportSemaphoreSyncFdKHR}, see {khronos-opencl-pr}/1208[#1208].
+      ** Clarified which re-import properties are accepted by {clReImportSemaphoreSyncFdKHR}, see {khronos-opencl-pr}/1219[#1219].
+  * {cl_khr_semaphore_EXT}:
+      ** Clarified external semaphore behavior, removing references to permanence, see {khronos-opencl-pr}/938[#938].
+  * Removed provisional extensions due to lack of implementations and tests, see {khronos-opencl-pr}/1160[#1160].
+      ** `cl_khr_external_semaphore_dx_fence` (provisional)
+      ** `cl_khr_external_memory_dx` (provisional)

c/appendix_a.asciidoc

@@ -52,3 +52,8 @@ Changes from *v3.0.15*:
   * Removed an incorrect statement about geometric functions operating component-wise, see {khronos-opencl-pr}/1137[#1137].
   * Added new extension:
       ** {cl_khr_kernel_clock_EXT} (provisional)
+
+Changes from *v3.0.16*:
+
+  * Documented the error bounds for a non-derived `atan2` implementation with unsafe math optimizations, see {khronos-opencl-pr}/1073[#1073].
+  * Fixed a typo affecting `EPSILON` macros, see {khronos-opencl-pr}/1225[#1225].

env/appendix_a.asciidoc

@@ -50,3 +50,9 @@ Changes from *v3.0.15*:
   * Adds the numerical value of the image channel order and image channel data type to several tables, see {khronos-opencl-pr}/1050[#1050].
   * Added new extension:
       ** {cl_khr_kernel_clock_EXT} (provisional)
+
+Changes from *v3.0.16*:
+
+  * Documented the error bounds for a non-derived `atan2` implementation with unsafe math optimizations, see {khronos-opencl-pr}/1073[#1073].
+  * Documented supported `printf` operand types, see {khronos-opencl-pr}/1236[#1236].
+  * Documented valid coordinate types when reading from or writing to images, see {khronos-opencl-pr}/1242[#1242].