Change log for January 5, 2024 Vulkan 1.3.275 spec update:

Github Issues * Update `VK_EXT_image_compression_control` support query example (public PR 2285). * Fix markup issue in extension refpages (public issue 2288). Internal Issues * Add requirements for WIN32 multithreading behavior and HWND handling to flink:vkCreateWin32SurfaceKHR (internal issue 3402). * Link to the appropriate etext:Vk*FlagBits type to improve "`must: be a bit value`" terminology (internal issue 3728). * Editorial and XML dependency updates for apiext:VK_QCOM_render_pass_transform and apiext:VK_QCOM_rotated_copy_commands (internal MR 6353). * Add missing links to <<resources-image-views-identity-mappings,identity swizzle>> in a few places where the term is used (internal MR 6354). * Remove unreachable VU 07008 in flink:vkCmdEndQuery (internal MR 6356). * Fix XML dependencies for apiext:VK_KHR_maintenance6 (internal MR 6361). * Set XML `noautovalidity` attribute on all pipeline create flags (internal MR 6364). * Remove duplicate flink:vkCmdBindDescriptorSets VUID 06754 (internal MR 6364). * Remove shader object VU 08401 which was inconsistent with specification language (internal MR 6368). * Editorial fix to use 'must:' normative term in VUs (internal MR 6370). * Update buffer usage flag VUs to factor out common VUs to a new commonvalidity file, and fix typo in slink:VkDescriptorBufferBindingInfoEXT (internal MR 6371). * Add flink:vkGetPrivateData VU requiring pname:objectHandle to be valid (internal MR 6373). * Remove redundant VkGraphicsPipelineCreateInfo VU 06680 and re-word VU 06679 to combine them (internal MR 6376). * Fix field name typos for flink:vkGetDescriptorEXT VUs (internal MR 6378). * Set `noautovalidity` XML attribute on some slink:VkCudaLaunchInfoNV parameters (internal MR 6382).
KhronosGroup · Jan 5, 2024 · 9b94c27 · 9b94c27
1 parent 24e57ed
commit 9b94c27
Show file tree

Hide file tree

Showing 779 changed files with 1,121 additions and 1,010 deletions.
diff --git a/.gitattributes b/.gitattributes
@@ -1,4 +1,4 @@
-# Copyright 2015-2023 The Khronos Group Inc.
+# Copyright 2015-2024 The Khronos Group Inc.
 #
 # SPDX-License-Identifier: Apache-2.0
 

diff --git a/.github/ISSUE_TEMPLATE/roadmap-feedback.md b/.github/ISSUE_TEMPLATE/roadmap-feedback.md
@@ -8,7 +8,7 @@ assignees: ''
 ---
 
 <!--
-Copyright 2018-2023 The Khronos Group Inc.
+Copyright 2018-2024 The Khronos Group Inc.
 
 SPDX-License-Identifier: CC-BY-4.0
 -->

diff --git a/.github/ISSUE_TEMPLATE/template-for-release-task-list.md b/.github/ISSUE_TEMPLATE/template-for-release-task-list.md
@@ -9,7 +9,7 @@ assignees: ''
 ---
 
 <!--
-- Copyright 2019-2023 The Khronos Group Inc.
+- Copyright 2019-2024 The Khronos Group Inc.
 -
 - SPDX-License-Identifier: CC-BY-4.0
 -

diff --git a/.github/workflows/CI.yml b/.github/workflows/CI.yml
@@ -1,4 +1,4 @@
-# Copyright 2021-2023 The Khronos Group Inc.
+# Copyright 2021-2024 The Khronos Group Inc.
 # SPDX-License-Identifier: Apache-2.0
 
 # GitHub CI file for vulkan spec and header generation

diff --git a/.gitignore b/.gitignore
@@ -1,4 +1,4 @@
-# Copyright 2015-2023 The Khronos Group Inc.
+# Copyright 2015-2024 The Khronos Group Inc.
 #
 # SPDX-License-Identifier: Apache-2.0
 

diff --git a/.gitlab-ci.yml b/.gitlab-ci.yml
@@ -1,4 +1,4 @@
-# Copyright 2018-2023 The Khronos Group Inc.
+# Copyright 2018-2024 The Khronos Group Inc.
 #
 # SPDX-License-Identifier: Apache-2.0
 

diff --git a/.gitlab/issue_templates/EXT_release_checklist.md b/.gitlab/issue_templates/EXT_release_checklist.md
@@ -1,5 +1,5 @@
 <!--
-Copyright 2018-2023 The Khronos Group Inc.
+Copyright 2018-2024 The Khronos Group Inc.
 
 SPDX-License-Identifier: CC-BY-4.0
 -->

diff --git a/.gitlab/issue_templates/KHR_release_checklist.md b/.gitlab/issue_templates/KHR_release_checklist.md
@@ -1,5 +1,5 @@
 <!--
-Copyright 2018-2023 The Khronos Group Inc.
+Copyright 2018-2024 The Khronos Group Inc.
 
 SPDX-License-Identifier: CC-BY-4.0
 -->

diff --git a/.mailmap b/.mailmap
@@ -1,4 +1,4 @@
-# Copyright 2023 The Khronos Group Inc.
+# Copyright 2023-2024 The Khronos Group Inc.
 # SPDX-License-Identifier: CC-BY-4.0
 
 Faith Ekstrand <[email protected]> <[email protected]>

diff --git a/.reuse/dep5 b/.reuse/dep5
@@ -3,7 +3,7 @@ Upstream-Name: Vulkan-Docs
 Source: https://github.com/KhronosGroup/Vulkan-Docs
 
 Files: images/*.svg config/chunkindex/custom.patch config/CI/contractions* config/CI/writing config/CI/txt-files-allowed config/*/docinfo-header.html build_tests/expectations/* build_tests/images/*.svg
-Copyright: 2015-2023 The Khronos Group Inc.
+Copyright: 2015-2024 The Khronos Group Inc.
 License: CC-BY-4.0
 
 Files: katex/*
@@ -32,11 +32,11 @@ Copyright: 1998-2006 MACS, Inc.
 License: MIT
 
 Files: *.json scripts/vuidCounts.py config/chunkindex/addscript.*
-Copyright: 2020-2023 The Khronos Group Inc.
+Copyright: 2020-2024 The Khronos Group Inc.
 License: Apache-2.0
 
 Files: config/copyright-spec.adoc
-Copyright: 2014-2023 The Khronos Group Inc
+Copyright: 2014-2024 The Khronos Group Inc
 License: LicenseRef-KhronosSpecCopyright
 
 Files: scripts/asciidoctor-chunker/*

diff --git a/BUILD.adoc b/BUILD.adoc
@@ -1,4 +1,4 @@
-// Copyright 2014-2023 The Khronos Group Inc.
+// Copyright 2014-2024 The Khronos Group Inc.
 // SPDX-License-Identifier: CC-BY-4.0
 
 = Vulkan^(R)^ Specification Build Instructions and Notes

diff --git a/CODE_OF_CONDUCT.adoc b/CODE_OF_CONDUCT.adoc
@@ -1,4 +1,4 @@
-// Copyright 2018-2023 The Khronos Group Inc.
+// Copyright 2018-2024 The Khronos Group Inc.
 // SPDX-License-Identifier: CC-BY-4.0
 
 = Code of Conduct

diff --git a/CONTRIBUTING.adoc b/CONTRIBUTING.adoc
@@ -1,4 +1,4 @@
-// Copyright 2020-2023 The Khronos Group Inc.
+// Copyright 2020-2024 The Khronos Group Inc.
 // SPDX-License-Identifier: CC-BY-4.0
 
 = Contributing

diff --git a/COPYING.adoc b/COPYING.adoc
@@ -1,4 +1,4 @@
-// Copyright 2020-2023 The Khronos Group Inc.
+// Copyright 2020-2024 The Khronos Group Inc.
 // SPDX-License-Identifier: CC-BY-4.0
 
 = COPYING File for the KhronosGroup/Vulkan-Docs Project

diff --git a/ChangeLog.adoc b/ChangeLog.adoc
@@ -1,4 +1,4 @@
-Copyright 2016-2023 The Khronos Group Inc.
+Copyright 2016-2024 The Khronos Group Inc.
 SPDX-License-Identifier: CC-BY-4.0
 
 Update Log for the Vulkan-Docs repository on GitHub. Updates are in reverse
@@ -12,6 +12,49 @@ public pull requests that have been accepted.
 "`VU`" as used below is an abbreviation for "`valid usage statement`", which
 appears frequently in the change log.
 
+-----------------------------------------------------
+
+Change log for January 5, 2024 Vulkan 1.3.275 spec update:
+
+Github Issues
+
+  * Update `VK_EXT_image_compression_control` support query example (public
+    PR 2285).
+  * Fix markup issue in extension refpages (public issue 2288).
+
+Internal Issues
+
+  * Add requirements for WIN32 multithreading behavior and HWND handling to
+    flink:vkCreateWin32SurfaceKHR (internal issue 3402).
+  * Link to the appropriate etext:Vk*FlagBits type to improve "`must: be a
+    bit value`" terminology (internal issue 3728).
+  * Editorial and XML dependency updates for
+    apiext:VK_QCOM_render_pass_transform and
+    apiext:VK_QCOM_rotated_copy_commands (internal MR 6353).
+  * Add missing links to <<resources-image-views-identity-mappings,identity
+    swizzle>> in a few places where the term is used (internal MR 6354).
+  * Remove unreachable VU 07008 in flink:vkCmdEndQuery (internal MR 6356).
+  * Fix XML dependencies for apiext:VK_KHR_maintenance6 (internal MR 6361).
+  * Set XML `noautovalidity` attribute on all pipeline create flags
+    (internal MR 6364).
+  * Remove duplicate flink:vkCmdBindDescriptorSets VUID 06754 (internal MR
+    6364).
+  * Remove shader object VU 08401 which was inconsistent with specification
+    language (internal MR 6368).
+  * Editorial fix to use 'must:' normative term in VUs (internal MR 6370).
+  * Update buffer usage flag VUs to factor out common VUs to a new
+    commonvalidity file, and fix typo in
+    slink:VkDescriptorBufferBindingInfoEXT (internal MR 6371).
+  * Add flink:vkGetPrivateData VU requiring pname:objectHandle to be valid
+    (internal MR 6373).
+  * Remove redundant VkGraphicsPipelineCreateInfo VU 06680 and re-word VU
+    06679 to combine them (internal MR 6376).
+  * Fix field name typos for flink:vkGetDescriptorEXT VUs (internal MR
+    6378).
+  * Set `noautovalidity` XML attribute on some slink:VkCudaLaunchInfoNV
+    parameters (internal MR 6382).
+
+
 -----------------------------------------------------
 
 Change log for December 19, 2023 Vulkan 1.3.274 spec update:

diff --git a/ChangeLogSC.adoc b/ChangeLogSC.adoc
@@ -1,4 +1,4 @@
-Copyright 2022-2023 The Khronos Group Inc.
+Copyright 2022-2024 The Khronos Group Inc.
 SPDX-License-Identifier: CC-BY-4.0
 
 Update Log for the VulkanSC-Docs repository on GitHub.
@@ -12,6 +12,24 @@ with any public pull requests that have been accepted.
 
 -----------------------------------------------------
 
+Change log for December 15, 2023 Vulkan SC 1.0.14 spec update:
+
+  * update release number to 14 for this update and reflow spec language
+
+Public issues:
+
+  * None
+
+Internal issues:
+
+  * Merge VK 1.3.269 tag to sc_main (!356)
+  * Remove unfulfillable vkDestroySurfaceKHR VU (01266) from SC (!355)
+  * VUID 05095 language clarification and script improvement (!358)
+  * Clarify shader module requirements (359)
+  * merge VK 1.3.272 tag to sc_main (!360)
+
+-----------------------------------------------------
+
 Change log for September 27, 2023 Vulkan SC 1.0.13 spec update:
 
   * update release number to 13 for this update
@@ -30,7 +48,6 @@ Internal issues:
   * Fix cast-qual warning in vulkan_json_parser.hpp (!335)
   * Make VkFaultCallbackInfo pNext pointer-to-const (!342)
   * Clarify vkEndCommandBuffer error behavior (#184/!346)
-
   * Merge Vulkan main branch into sc_main (#168/!310)
   * Merge the 1.3.235 - 1.3.240 Vulkan changes to sc_main (!332)
   * Remove superfluous lines from the XML that are causing problems with

diff --git a/LICENSE.adoc b/LICENSE.adoc
@@ -1,4 +1,4 @@
-// Copyright 2020-2023 The Khronos Group Inc.
+// Copyright 2020-2024 The Khronos Group Inc.
 // SPDX-License-Identifier: CC-BY-4.0
 
 = LICENSE File for the KhronosGroup/Vulkan-Docs Project

diff --git a/LICENSES/LicenseRef-KhronosSpecCopyright.adoc b/LICENSES/LicenseRef-KhronosSpecCopyright.adoc
@@ -1,4 +1,4 @@
-Copyright 2014-2023 The Khronos Group Inc.
+Copyright 2014-2024 The Khronos Group Inc.
 
 This Specification is protected by copyright laws and contains material
 proprietary to Khronos. Except as described by these terms, it or any

diff --git a/Makefile b/Makefile
@@ -1,4 +1,4 @@
-# Copyright 2014-2023 The Khronos Group Inc.
+# Copyright 2014-2024 The Khronos Group Inc.
 #
 # SPDX-License-Identifier: Apache-2.0
 
@@ -136,12 +136,12 @@ VERBOSE =
 # ADOCOPTS options for asciidoc->HTML5 output
 
 NOTEOPTS     = -a editing-notes -a implementation-guide
-PATCHVERSION = 274
+PATCHVERSION = 275
 BASEOPTS     =
 
 ifneq (,$(findstring VKSC_VERSION_1_0,$(VERSIONS)))
 VKSPECREVISION := 1.2.$(PATCHVERSION)
-SCPATCHVERSION = 13
+SCPATCHVERSION = 14
 SPECREVISION = 1.0.$(SCPATCHVERSION)
 BASEOPTS = -a baserevnumber="$(VKSPECREVISION)"
 else

diff --git a/README.adoc b/README.adoc
@@ -1,4 +1,4 @@
-// Copyright 2017-2023 The Khronos Group Inc.
+// Copyright 2017-2024 The Khronos Group Inc.
 // SPDX-License-Identifier: CC-BY-4.0
 
 ifdef::env-github[]

diff --git a/READMESC.adoc b/READMESC.adoc
@@ -1,4 +1,4 @@
-// Copyright 2017-2023 The Khronos Group Inc.
+// Copyright 2017-2024 The Khronos Group Inc.
 // SPDX-License-Identifier: CC-BY-4.0
 
 ifdef::env-github[]

diff --git a/READMEVK.adoc b/READMEVK.adoc
@@ -1,4 +1,4 @@
-// Copyright 2017-2023 The Khronos Group Inc.
+// Copyright 2017-2024 The Khronos Group Inc.
 // SPDX-License-Identifier: CC-BY-4.0
 
 ifdef::env-github[]

diff --git a/antora/Makefile b/antora/Makefile
@@ -1,4 +1,4 @@
-# Copyright 2014-2023 The Khronos Group Inc.
+# Copyright 2014-2024 The Khronos Group Inc.
 # SPDX-License-Identifier: Apache-2.0
 
 # Configure Vulkan spec Antora tree with generated files and transformed

diff --git a/antora/antora.yml b/antora/antora.yml
@@ -1,4 +1,4 @@
-# Copyright 2022-2023 The Khronos Group Inc.
+# Copyright 2022-2024 The Khronos Group Inc.
 # SPDX-License-Identifier: Apache-2.0
 
 name: spec

diff --git a/antora/modules/ROOT/nav.adoc b/antora/modules/ROOT/nav.adoc
@@ -1,4 +1,4 @@
-// Copyright 2022-2023 The Khronos Group Inc.
+// Copyright 2022-2024 The Khronos Group Inc.
 // SPDX-License-Identifier: CC-BY-4.0
 
 // Navigation page for Vulkan spec in Antora

diff --git a/antora/modules/ROOT/pages/index.adoc b/antora/modules/ROOT/pages/index.adoc
@@ -1,4 +1,4 @@
-// Copyright 2022-2023 The Khronos Group Inc.
+// Copyright 2022-2024 The Khronos Group Inc.
 // SPDX-License-Identifier: CC-BY-4.0
 
 = Vulkan Documentation

diff --git a/antora/modules/proposals/nav.adoc b/antora/modules/proposals/nav.adoc
@@ -1,4 +1,4 @@
-// Copyright 2022-2023 The Khronos Group Inc.
+// Copyright 2022-2024 The Khronos Group Inc.
 // SPDX-License-Identifier: CC-BY-4.0
 
 :chapters:

diff --git a/antora/modules/proposals/pages/index.adoc b/antora/modules/proposals/pages/index.adoc
@@ -1,4 +1,4 @@
-// Copyright 2022-2023 The Khronos Group Inc.
+// Copyright 2022-2024 The Khronos Group Inc.
 // SPDX-License-Identifier: CC-BY-4.0
 
 = Vulkan Proposals Start Page

diff --git a/antora/pageHeaders-spec.adoc b/antora/pageHeaders-spec.adoc
@@ -1,4 +1,4 @@
-// Copyright 2022-2023 The Khronos Group Inc.
+// Copyright 2022-2024 The Khronos Group Inc.
 // SPDX-License-Identifier: CC-BY-4.0
 
 // Boilerplate to include in spec pages.

diff --git a/antora/setup_vulkan b/antora/setup_vulkan
@@ -1,5 +1,5 @@
 #!/bin/bash
-# Copyright 2014-2023 The Khronos Group Inc.
+# Copyright 2014-2024 The Khronos Group Inc.
 # SPDX-License-Identifier: Apache-2.0
 
 # setup_vulkan - configure Vulkan spec antora tree with generated files

diff --git a/appendices/VK_AMDX_shader_enqueue.adoc b/appendices/VK_AMDX_shader_enqueue.adoc
@@ -1,4 +1,4 @@
-// Copyright 2017-2023 The Khronos Group, Inc.
+// Copyright 2017-2024 The Khronos Group Inc.
 //
 // SPDX-License-Identifier: CC-BY-4.0
 

diff --git a/appendices/VK_ANDROID_external_format_resolve.adoc b/appendices/VK_ANDROID_external_format_resolve.adoc
@@ -1,4 +1,4 @@
-// Copyright 2023 The Khronos Group Inc.
+// Copyright 2023-2024 The Khronos Group Inc.
 //
 // SPDX-License-Identifier: CC-BY-4.0
 

diff --git a/appendices/VK_ARM_rasterization_order_attachment_access.adoc b/appendices/VK_ARM_rasterization_order_attachment_access.adoc
@@ -1,4 +1,4 @@
-// Copyright 2021-2023 The Khronos Group Inc.
+// Copyright 2021-2024 The Khronos Group Inc.
 //
 // SPDX-License-Identifier: CC-BY-4.0
 

diff --git a/appendices/VK_EXT_4444_formats.adoc b/appendices/VK_EXT_4444_formats.adoc
@@ -1,4 +1,4 @@
-// Copyright 2020-2023 The Khronos Group Inc.
+// Copyright 2020-2024 The Khronos Group Inc.
 //
 // SPDX-License-Identifier: CC-BY-4.0
 

diff --git a/appendices/VK_EXT_acquire_drm_display.adoc b/appendices/VK_EXT_acquire_drm_display.adoc
@@ -1,4 +1,4 @@
-// Copyright 2018-2023 The Khronos Group Inc.
+// Copyright 2018-2024 The Khronos Group Inc.
 //
 // SPDX-License-Identifier: CC-BY-4.0
 

diff --git a/appendices/VK_EXT_acquire_xlib_display.adoc b/appendices/VK_EXT_acquire_xlib_display.adoc
@@ -1,4 +1,4 @@
-// Copyright 2018-2023 The Khronos Group Inc.
+// Copyright 2018-2024 The Khronos Group Inc.
 //
 // SPDX-License-Identifier: CC-BY-4.0
 

diff --git a/appendices/VK_EXT_astc_decode_mode.adoc b/appendices/VK_EXT_astc_decode_mode.adoc
@@ -1,4 +1,4 @@
-// Copyright 2018-2023 The Khronos Group Inc.
+// Copyright 2018-2024 The Khronos Group Inc.
 //
 // SPDX-License-Identifier: CC-BY-4.0
 

diff --git a/appendices/VK_EXT_attachment_feedback_loop_dynamic_state.adoc b/appendices/VK_EXT_attachment_feedback_loop_dynamic_state.adoc
@@ -1,4 +1,4 @@
-// Copyright 2023 The Khronos Group Inc.
+// Copyright 2023-2024 The Khronos Group Inc.
 //
 // SPDX-License-Identifier: CC-BY-4.0
 

diff --git a/appendices/VK_EXT_attachment_feedback_loop_layout.adoc b/appendices/VK_EXT_attachment_feedback_loop_layout.adoc
@@ -1,4 +1,4 @@
-// Copyright 2020-2023 The Khronos Group Inc.
+// Copyright 2020-2024 The Khronos Group Inc.
 //
 // SPDX-License-Identifier: CC-BY-4.0
 

diff --git a/appendices/VK_EXT_blend_operation_advanced.adoc b/appendices/VK_EXT_blend_operation_advanced.adoc
@@ -1,4 +1,4 @@
-// Copyright 2017-2023 The Khronos Group Inc.
+// Copyright 2017-2024 The Khronos Group Inc.
 //
 // SPDX-License-Identifier: CC-BY-4.0
 

diff --git a/appendices/VK_EXT_border_color_swizzle.adoc b/appendices/VK_EXT_border_color_swizzle.adoc
@@ -1,4 +1,4 @@
-// Copyright 2021-2023 The Khronos Group Inc.
+// Copyright 2021-2024 The Khronos Group Inc.
 //
 // SPDX-License-Identifier: CC-BY-4.0
 

diff --git a/appendices/VK_EXT_buffer_device_address.adoc b/appendices/VK_EXT_buffer_device_address.adoc
@@ -1,4 +1,4 @@
-// Copyright 2018-2023 The Khronos Group Inc.
+// Copyright 2018-2024 The Khronos Group Inc.
 //
 // SPDX-License-Identifier: CC-BY-4.0
 

diff --git a/appendices/VK_EXT_calibrated_timestamps.adoc b/appendices/VK_EXT_calibrated_timestamps.adoc
@@ -1,4 +1,4 @@
-// Copyright 2018-2023 The Khronos Group Inc.
+// Copyright 2018-2024 The Khronos Group Inc.
 //
 // SPDX-License-Identifier: CC-BY-4.0
 

diff --git a/appendices/VK_EXT_color_write_enable.adoc b/appendices/VK_EXT_color_write_enable.adoc
@@ -1,4 +1,4 @@
-// Copyright 2020-2023 The Khronos Group Inc.
+// Copyright 2020-2024 The Khronos Group Inc.
 //
 // SPDX-License-Identifier: CC-BY-4.0
 

diff --git a/appendices/VK_EXT_conditional_rendering.adoc b/appendices/VK_EXT_conditional_rendering.adoc
@@ -1,4 +1,4 @@
-// Copyright 2018-2023 The Khronos Group Inc.
+// Copyright 2018-2024 The Khronos Group Inc.
 //
 // SPDX-License-Identifier: CC-BY-4.0
 

diff --git a/appendices/VK_EXT_conservative_rasterization.adoc b/appendices/VK_EXT_conservative_rasterization.adoc
@@ -1,4 +1,4 @@
-// Copyright 2017-2023 The Khronos Group Inc.
+// Copyright 2017-2024 The Khronos Group Inc.
 //
 // SPDX-License-Identifier: CC-BY-4.0
-Original file line number
+Diff line change
@@ Expand Up / @@ -8,7 +8,7 @@ assignees: '' @@
     ---
     <!--
-    Copyright 2018-2023 The Khronos Group Inc.
+    Copyright 2018-2024 The Khronos Group Inc.
     SPDX-License-Identifier: CC-BY-4.0
     -->
@@ Expand Down @@