Merge branch 'main' into error-code-consistency

Author: bashbaug

OpenCL_C.txt

@@ -6624,7 +6624,7 @@ ifdef::cl_khr_fp16[half *length*(gentypeh _p_)]
 ifdef::cl_khr_fp16[gentypeh *normalize*(gentypeh _p_)]
     | Returns a vector in the same direction as _p_ but with a length of 1.
 | |
-| float *fast_distance*(float _p0_, float__n__ _p1_)
+| float *fast_distance*(float__n__ _p0_, float__n__ _p1_)
     | Returns *fast_length*(_p0_ - _p1_).
 | float *fast_length*(float__n__ _p_)
     | Returns the length of vector _p_ computed as:
@@ -16288,7 +16288,7 @@ is the infinitely precise result.
 | *sinpi*           | {leq} 4 ulp
 | *smoothstep*      | Implementation-defined
 | *step*            | 0 ulp
-| *fsqrt*           | Correctly rounded
+| *sqrt*            | Correctly rounded
 | *tan*             | {leq} 5 ulp
 | *tanh*            | {leq} 5 ulp
 | *tanpi*           | {leq} 6 ulp
@@ -16438,7 +16438,7 @@ is the infinitely precise result.
 | *sinh*        | \<= 2 ulp                     | \<= 3 ulp
 | *sinpi*       | \<= 2 ulp                     | \<= 2 ulp
 | *smoothstep*  | Implementation-defined        | Implementation-defined
-| *sqrt*        | Correctly rounded             | \<= 1 ulp
+| *sqrt*        | \<= 1.5 ulp                   | \<= 1.5 ulp
 | *step*        | 0 ulp                         | 0 ulp
 | *tan*         | \<= 2 ulp                     | \<= 3 ulp
 | *tanh*        | \<= 2 ulp                     | \<= 3 ulp

api/appendix_e.asciidoc

@@ -459,7 +459,7 @@ conformance process:
 
 == Summary of Changes from OpenCL 3.0
 
-The first non-provisional version of the OpenCL 3.0 specifications was *v3.0.5*.
+The first non-experimental version of the OpenCL 3.0 specifications was *v3.0.5*.
 
 Changes from *v3.0.5*:
 
@@ -502,17 +502,17 @@ Changes from *v3.0.8*:
   * Clarified the behavior of ballot operations for remainder sub-groups.
   * Added new extensions:
       ** {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` (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` (provisional)
-      ** {cl_khr_external_memory_opaque_fd_EXT} (provisional)
-      ** {cl_khr_external_memory_win32_EXT} (provisional)
+      ** {cl_khr_semaphore_EXT} (experimental)
+      ** {cl_khr_external_semaphore_EXT} (experimental)
+      ** `cl_khr_external_semaphore_dx_fence` (experimental)
+      ** {cl_khr_external_semaphore_opaque_fd_EXT} (experimental)
+      ** {cl_khr_external_semaphore_sync_fd_EXT} (experimental)
+      ** {cl_khr_external_semaphore_win32_EXT} (experimental)
+      ** {cl_khr_external_memory_EXT} (experimental)
+      ** {cl_khr_external_memory_dma_buf_EXT} (experimental)
+      ** `cl_khr_external_memory_dx` (experimental)
+      ** {cl_khr_external_memory_opaque_fd_EXT} (experimental)
+      ** {cl_khr_external_memory_win32_EXT} (experimental)
 
 Changes from *v3.0.9*:
 
@@ -524,7 +524,7 @@ Changes from *v3.0.9*:
       ** {cl_khr_async_work_group_copy_fence_EXT} (final)
       ** {cl_khr_extended_async_copies_EXT} (final)
       ** {cl_khr_expect_assume_EXT}
-      ** {cl_khr_command_buffer_EXT} (provisional)
+      ** {cl_khr_command_buffer_EXT} (experimental)
 
 Changes from *v3.0.10*:
 
@@ -549,7 +549,7 @@ Changes from *v3.0.11*:
   * Clarified {cl_khr_command_buffer_EXT} interactions with other extensions.
   * Specified error behavior when a command buffer is finalized multiple times.
   * Added new extension:
-      ** {cl_khr_command_buffer_mutable_dispatch_EXT} (provisional)
+      ** {cl_khr_command_buffer_mutable_dispatch_EXT} (experimental)
 
 Changes from *v3.0.12*:
 
@@ -568,7 +568,7 @@ Changes from *v3.0.13*:
   * Updated the semaphore wait and signal rules for binary semaphores in {cl_khr_semaphore_EXT}, see {khronos-opencl-pr}/882[#882].
   * Removed redundant error conditions from {cl_khr_external_semaphore_EXT} and {cl_khr_external_memory_EXT}, see {khronos-opencl-pr}/903[#903] and {khronos-opencl-pr}/904[#904].
   * Added new extension:
-      ** {cl_khr_command_buffer_multi_device_EXT} (provisional)
+      ** {cl_khr_command_buffer_multi_device_EXT} (experimental)
 
 Changes from *v3.0.14*:
 
@@ -578,22 +578,22 @@ Changes from *v3.0.14*:
   * Clarified that {clSetCommandQueueProperty} is only required for OpenCL 1.0 devices and may return an error otherwise, see {khronos-opencl-pr}/980[#980].
   * Clarified that the application must ensure the free function passed to {clEnqueueSVMFree} is thread safe, see {khronos-opencl-pr}/1016[#1016].
   * Clarified that the application must ensure the user function passed to {clEnqueueNativeKernel} is thread safe, see {khronos-opencl-pr}/1026[#1026].
-  * {cl_khr_command_buffer_EXT} (provisional):
+  * {cl_khr_command_buffer_EXT} (experimental):
       ** Removed the "invalid" command buffer state, see {khronos-opencl-pr}/885[#885].
       ** Added support for recording SVM memory copies and memory fills in a command buffer, see {khronos-opencl-pr}/915[#915].
-  * {cl_khr_command_buffer_multi_device_EXT} (provisional):
+  * {cl_khr_command_buffer_multi_device_EXT} (experimental):
       ** Clarified that the sync devices query should only return root devices, see {khronos-opencl-pr}/925[#925].
-  * {cl_khr_external_memory_EXT} (provisional):
+  * {cl_khr_external_memory_EXT} (experimental):
       ** Disallowed specifying a device handle list without also specifying an external memory handle, see {khronos-opencl-pr}/922[#922].
       ** Added a query to determine the handle types an implementation will assume have a linear memory layout, see {khronos-opencl-pr}/940[#940].
       ** Added an external memory-specific device handle list enum, see {khronos-opencl-pr}/956[#956].
       ** Clarified that implementations may acquire information about an image from an external memory handle when the image is created, see {khronos-opencl-pr}/970[#970].
-  * {cl_khr_external_semaphore_EXT} (provisional):
+  * {cl_khr_external_semaphore_EXT} (experimental):
       ** Added the ability to re-import "sync fd" handles into an existing semaphore, see {khronos-opencl-pr}/939[#939].
       ** Clarified that a semaphore may only export one handle type, and that a semaphore created from an external handle cannot also export a handle, see {khronos-opencl-pr}/975[#975].
       ** Clarified that {cl_khr_external_semaphore_EXT} requires support for {cl_khr_semaphore_EXT}, see {khronos-opencl-pr}/976[#976].
       ** Added a query to determine if a semaphore may export an external handle, see {khronos-opencl-pr}/997[#997].
-  * {cl_khr_semaphore_EXT} (provisional):
+  * {cl_khr_semaphore_EXT} (experimental):
       ** Added an semaphore-specific device handle list enum, see {khronos-opencl-pr}/956[#956].
       ** Restricted semaphores to a single associated device, see {khronos-opencl-pr}/996[#996].
   * {cl_khr_subgroup_rotate_EXT}:
@@ -607,11 +607,11 @@ Changes from *v3.0.15*:
   * Strengthened requirements for the {CL_DEVICE_TYPE} query, see  {khronos-opencl-pr}/1069[#1069].
   * Clarified {clSetEventCallback} behavior for command errors, see {khronos-opencl-pr}/1071[#1071].
   * Moved footnote text for {CL_KERNEL_ARG_TYPE_QUALIFIER} into the main spec, see {khronos-opencl-pr}/1097[#1097].
-  * {cl_khr_command_buffer_mutable_dispatch_EXT} (provisional):
+  * {cl_khr_command_buffer_mutable_dispatch_EXT} (experimental):
       ** Added {CL_MUTABLE_DISPATCH_ASSERTS_KHR}, see {khronos-opencl-pr}/992[#992].
   * {cl_khr_semaphore_EXT}:
       ** Removed a redundant error condition, see {khronos-opencl-pr}/1052[#1052]
-  * The following extensions have been finalized and are no longer provisional:
+  * The following extensions have been finalized and are no longer experimental:
       ** {cl_khr_semaphore_EXT}
       ** {cl_khr_external_semaphore_EXT}
       ** {cl_khr_external_semaphore_opaque_fd_EXT}
@@ -621,7 +621,7 @@ Changes from *v3.0.15*:
       ** {cl_khr_external_memory_opaque_fd_EXT}
       ** {cl_khr_external_memory_win32_EXT}
   * Added new extension:
-      ** {cl_khr_kernel_clock_EXT} (provisional)
+      ** {cl_khr_kernel_clock_EXT} (experimental)
 
 Changes from *v3.0.16*:
 
@@ -637,11 +637,11 @@ Changes from *v3.0.16*:
   * 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):
+  * {cl_khr_command_buffer_EXT} (experimental):
       ** 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):
+  * {cl_khr_command_buffer_mutable_dispatch_EXT} (experimental):
       ** 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].
@@ -659,9 +659,9 @@ Changes from *v3.0.16*:
       ** 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)
+  * Removed experimental extensions due to lack of implementations and tests, see {khronos-opencl-pr}/1160[#1160].
+      ** `cl_khr_external_semaphore_dx_fence` (experimental)
+      ** `cl_khr_external_memory_dx` (experimental)
 
 Changes from *v3.0.17*:
 
@@ -676,12 +676,12 @@ Changes from *v3.0.17*:
   * Clarified an error condition for Direct3D 10 and Direct3D 11 3D textures, see {khronos-opencl-pr}/1342[#1342].
   * Clarified {CL_INVALID_IMAGE_SIZE} error conditions, see {khronos-opencl-pr}/1343[#1343].
   * Added a section describing document conventions, see {khronos-opencl-pr}/1347[#1347].
-  * {cl_khr_command_buffer_EXT} (provisional):
+  * {cl_khr_command_buffer_EXT} (experimental):
       ** Refactored the command-buffer query for supported queue properties, see {khronos-opencl-pr}/850[#850].
       ** Documented behavior when the command-buffer capacity is reached, see {khronos-opencl-pr}/1286[#1286].
       ** Refactored command-buffer queue compatibility, see {khronos-opencl-pr}/1292[#1292].
       ** Documented that {clFinalizeCommandBufferKHR} is not thread-safe, see {khronos-opencl-pr}/1345[#1345].
-  * {cl_khr_command_buffer_mutable_dispatch_EXT} (provisional):
+  * {cl_khr_command_buffer_mutable_dispatch_EXT} (experimental):
       ** Clarified how implementations may defer updates to the command-buffer, see {khronos-opencl-pr}/1315[#1315].
       ** Documented that {clUpdateMutableCommandsKHR} is not thread-safe, see {khronos-opencl-pr}/1345[#1345].
   * {cl_khr_external_memory_EXT}:

api/appendix_extensions.asciidoc

@@ -26,21 +26,24 @@ Within each group, extensions are listed in alphabetical order by their
 names.
 
 
-[[boilerplate-provisional-header]]
-== Provisional Extensions
+[[boilerplate-experimental-header]]
+== Experimental Extensions
 
-_Provisional_ OpenCL extensions described in this appendix have been
-Ratified under the Khronos Intellectual Property Framework.
-They are being made publicly available as provisional extensions to enable
-review and feedback from the community.
-While an extension is provisional, features may be added, removed, or
-changed in non-backward compatible ways.
+_Experimental_ OpenCL extensions described in this appendix are being made
+publicly available to enable review and feedback
+from the community. While an extension is experimental, features may be
+added, removed, or changed in non-backward compatible ways.
 
-If you have feedback on a provisional extension, please create an issue on
+[NOTE]
+====
+Previous revisions of this specification used the term _provisional_ to denote
+ratified extensions with an experimental status.
+====
+
+If you have feedback on an experimental extension, please create an issue on
 the link:https://github.com/KhronosGroup/OpenCL-Docs/[OpenCL-Docs
 repository].
 
-
 == Extension Dependencies
 
 Extensions which have dependencies on specific core versions or on other
@@ -49,5 +52,5 @@ extensions will list such dependencies.
 All extensions implicitly require support for OpenCL 1.0.
 
 include::{generated}/meta/current_extensions_appendix.txt[]
-include::{generated}/meta/provisional_extensions_appendix.txt[]
+include::{generated}/meta/experimental_extensions_appendix.txt[]
 include::{generated}/meta/deprecated_extensions_appendix.txt[]

api/cl_khr_async_work_group_copy_fence.asciidoc

@@ -22,6 +22,6 @@ information.
 === Version History
 
   * Revision 0.9.0, 2020-04-21
-  ** First assigned version (provisional).
+  ** First assigned version (experimental).
   * Revision 1.0.0, 2021-11-10
-  ** First non-provisional version.
+  ** First non-experimental version.

api/cl_khr_command_buffer.asciidoc

@@ -147,7 +147,7 @@ functionality expanding on this is provided as layered extensions on top of
 Having {cl_khr_command_buffer_EXT} as a minimal base specification means that the
 API defines mechanisms for functionality that is not enabled by this extension,
 these are described in the following sub-sections. {cl_khr_command_buffer_EXT} will
-retain its provisional extension status until other layered extensions are
+retain its experimental extension status until other layered extensions are
 released, as these may reveal modifications needed to the base specification to
 support their intended use cases.
 
@@ -451,22 +451,22 @@ features:
 === Version History
 
   * Revision 0.9.0, 2021-11-10
-  ** First assigned version (provisional).
+  ** First assigned version (experimental).
   * 0.9.1, 2022-08-24
   ** Specify an error if a command-buffer is finalized multiple times
-     (provisional).
+     (experimental).
   * 0.9.2, 2023-03-31
-  ** Introduce context query {CL_COMMAND_BUFFER_CONTEXT_KHR} (provisional).
+  ** Introduce context query {CL_COMMAND_BUFFER_CONTEXT_KHR} (experimental).
   * 0.9.3, 2023-04-04
-  ** Remove Invalid command-buffer state (provisional).
+  ** Remove Invalid command-buffer state (experimental).
   * 0.9.4, 2023-05-11
   ** Add clCommandSVMMemcpyKHR and clCommandSVMMemFillKHR command entries
-     (provisional).
+     (experimental).
   * 0.9.5, 2024-07-24
   ** Add a properties parameter to all command recording entry-points
-     (provisional).
+     (experimental).
   * 0.9.6, 2024-10-02
-  ** Add device query for supported queue properties (provisional).
+  ** Add device query for supported queue properties (experimental).
   * 0.9.7, 2024-12-13
   ** Refactor queue compatability between command-buffer creation and enqueue
-     (provisional).
+     (experimental).

api/cl_khr_command_buffer_multi_device.asciidoc

@@ -308,10 +308,10 @@ require it.
 === Version History
 
   * Revision 0.9.0, 2023-04-14
-  ** First assigned version (provisional).
+  ** First assigned version (experimental).
   * Revision 0.9.1, 2023-04-30
   ** Added clCommandSVMMemcpyKHR and clCommandSVMMemFillKHR as affected
-     functions (provisional).
+     functions (experimental).
   * Revision 0.9.2, 2024-12-13
   ** Update clRemapCommandBufferKHR behavior to match cl_khr_command_buffer
-     version 0.9.7 (provisional).
+     version 0.9.7 (experimental).

api/cl_khr_command_buffer_mutable_dispatch.asciidoc

@@ -353,13 +353,13 @@ may be a introduced as a stand alone extension.
 === Version History
 
   * Revision 0.9.0, 2022-08-31
-  ** First assigned version (provisional).
+  ** First assigned version (experimental).
   * Revision 0.9.1, 2023-11-07
   ** Add type {cl_mutable_dispatch_asserts_khr_TYPE} and its possible values
-     (provisional).
+     (experimental).
   * Revision 0.9.2, 2024-06-19
   ** Change {clUpdateMutableCommandsKHR} API to pass configs as an array rather
-     than linked list (provisional).
+     than linked list (experimental).
   * Revision 0.9.3, 2024-09-05
   ** Rename `CL_MUTABLE_DISPATCH_PROPERTIES_ARRAY_KHR` to
-     `CL_MUTABLE_COMMAND_PROPERTIES_ARRAY_KHR` (provisional).
+     `CL_MUTABLE_COMMAND_PROPERTIES_ARRAY_KHR` (experimental).

api/cl_khr_extended_async_copies.asciidoc

@@ -24,8 +24,8 @@ Copy Functions] section of the OpenCL C specification for more information.
 === Version History
 
   * Revision 0.9.0, 2020-04-21
-  ** First assigned version (provisional).
+  ** First assigned version (experimental).
   * Revision 0.9.1, 2021-09-06
   ** Elements-based proposal update.
   * Revision 1.0.0, 2021-11-10
-  ** First non-provisional version.
+  ** First non-experimental version.

api/cl_khr_external_memory.asciidoc

@@ -277,19 +277,19 @@ while (true) {
 === Version History
 
   * Revision 0.9.0, 2021-09-10
-  ** Initial version (provisional).
+  ** Initial version (experimental).
   * Revision 0.9.1, 2023-05-04
   ** Clarified device handle list enum cannot be specified without an
-     external memory handle (provisional).
+     external memory handle (experimental).
   * Revision 0.9.2, 2023-08-01
   ** Changed device handle list enum to the memory-specific
-     {CL_MEM_DEVICE_HANDLE_LIST_KHR} (provisional).
+     {CL_MEM_DEVICE_HANDLE_LIST_KHR} (experimental).
   * Revision 0.9.3, 2023-08-29
   ** Added query for
      {CL_DEVICE_EXTERNAL_MEMORY_IMPORT_ASSUME_LINEAR_IMAGES_HANDLE_TYPES_KHR}
-     (provisional).
+     (experimental).
   * Revision 1.0.0, 2024-03-15
-  ** First non-provisional version.
+  ** First non-experimental version.
   * Revision 1.0.1, 2024-09-03
   ** Return {CL_INVALID_PROPERTY} when multiple external handles are provided
      when creating a memory object.

api/cl_khr_external_memory_dma_buf.asciidoc

@@ -43,16 +43,16 @@ image memory object.
 === Version History
 
   * Revision 0.9.0, 2021-09-10
-  ** Initial version (provisional).
+  ** Initial version (experimental).
   * Revision 0.9.1, 2023-05-04
   ** Clarified device handle list enum cannot be specified without an
-     external memory handle (provisional).
+     external memory handle (experimental).
   * Revision 0.9.2, 2023-08-01
   ** Changed device handle list enum to the memory-specific
-     {CL_MEM_DEVICE_HANDLE_LIST_KHR} (provisional).
+     {CL_MEM_DEVICE_HANDLE_LIST_KHR} (experimental).
   * Revision 0.9.3, 2023-08-29
   ** Added query for
      {CL_DEVICE_EXTERNAL_MEMORY_IMPORT_ASSUME_LINEAR_IMAGES_HANDLE_TYPES_KHR}
-     (provisional).
+     (experimental).
   * Revision 1.0.0, 2024-03-15
-  ** First non-provisional version.
+  ** First non-experimental version.