From 8396f7bf1b793e86e1122c87228d86bdd694f699 Mon Sep 17 00:00:00 2001 From: Ben Ashbaugh Date: Mon, 21 Oct 2024 22:22:54 -0700 Subject: [PATCH] initial change log for changes to 3.0.16 --- api/appendix_e.asciidoc | 41 +++++++++++++++++++++++++++++++++++++++-- c/appendix_a.asciidoc | 5 +++++ env/appendix_a.asciidoc | 6 ++++++ 3 files changed, 50 insertions(+), 2 deletions(-) diff --git a/api/appendix_e.asciidoc b/api/appendix_e.asciidoc index ba9534480..f96bd2ca9 100644 --- a/api/appendix_e.asciidoc +++ b/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,40 @@ 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]. + * 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]. + * Clarified that functionality will never be removed in minor OpenCL specification revisions, see {khronos-opencl-pr}/1265[#1265]. + * {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]. + ** 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}/1117[#1117]. + ** 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) diff --git a/c/appendix_a.asciidoc b/c/appendix_a.asciidoc index 2492e585d..6838a5543 100644 --- a/c/appendix_a.asciidoc +++ b/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]. diff --git a/env/appendix_a.asciidoc b/env/appendix_a.asciidoc index e385a0e45..e2a35212d 100644 --- a/env/appendix_a.asciidoc +++ b/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].