Change log for January 25, 2022 Vulkan 1.3.204 spec update:

  * Vulkan 1.3 initial release. Update release number to 204 for this
    update. The patch number will be used for all Vulkan 1.x spec updates,
    and continue to increment continuously from the previous Vulkan 1.2.203
    update.

Github Issues:

  * Reserve driver ID ename:VK_DRIVER_ID_MESA_VENUS (public merge request
    1733).

Internal Issues:

  * Update scripts and registry schema document to support multiple API
    names in the `api` and `supported` attributes, to allow specializing API
    definitions (internal issue 2809).
  * Minor updates - update copyright dates to 2022, update release scripts
    to generate artifacts for 1.3 as well as earlier specification versions
    (internal issue 2969).

New Features:

  * apiext:VK_KHR_global_priority (internal merge request 4869).
  * <<roadmap-2022, `VK_KHR_roadmap_2022`>> ("`Roadmap 2022`") profile
    (internal merge request 4797).

.gitattributes

@@ -1,4 +1,4 @@
-# Copyright 2015-2021 The Khronos Group, Inc.
+# Copyright 2015-2022 The Khronos Group Inc.
 #
 # SPDX-License-Identifier: Apache-2.0
 

.github/ISSUE_TEMPLATE/template-for-release-task-list.md

@@ -9,7 +9,7 @@ assignees: ''
 ---
 
 <!--
-- Copyright (c) 2019-2021, The Khronos Group Inc.
+- Copyright 2019-2022 The Khronos Group Inc.
 -
 - SPDX-License-Identifier: CC-BY-4.0
 -

.github/workflows/CI.yml

@@ -1,4 +1,4 @@
-# Copyright 2021 The Khronos Group, Inc.
+# Copyright 2021-2022 The Khronos Group Inc.
 # SPDX-License-Identifier: Apache-2.0
 
 # Github CI file for vulkan spec and header generation

.gitignore

@@ -1,4 +1,4 @@
-# Copyright 2015-2021 The Khronos Group, Inc.
+# Copyright 2015-2022 The Khronos Group Inc.
 #
 # SPDX-License-Identifier: Apache-2.0
 

.gitlab-ci.yml

@@ -1,4 +1,4 @@
-# Copyright 2018-2021 The Khronos Group Inc.
+# Copyright 2018-2022 The Khronos Group Inc.
 #
 # SPDX-License-Identifier: Apache-2.0
 

.gitlab/issue_templates/EXT_release_checklist.md

@@ -1,5 +1,5 @@
 <!--
-Copyright 2018-2021 The Khronos Group Inc.
+Copyright 2018-2022 The Khronos Group Inc.
 
 SPDX-License-Identifier: CC-BY-4.0
 -->

.gitlab/issue_templates/KHR_release_checklist.md

@@ -1,5 +1,5 @@
 <!--
-Copyright 2018-2021 The Khronos Group Inc.
+Copyright 2018-2022 The Khronos Group Inc.
 
 SPDX-License-Identifier: CC-BY-4.0
 -->

.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*
-Copyright: 2015-2021 The Khronos Group, Inc.
+Copyright: 2015-2022 The Khronos Group Inc.
 License: CC-BY-4.0
 
 Files: katex/*
@@ -32,11 +32,11 @@ Copyright: 2007 SiSco, Inc.
 License: MIT
 
 Files: *.json scripts/vuidCounts.py config/chunkindex/addscript.*
-Copyright: 2020 The Khronos Group, Inc.
+Copyright: 2020-2022 The Khronos Group Inc.
 License: Apache-2.0
 
 Files: copyright-spec.txt
-Copyright: 2014-2021 The Khronos Group, Inc
+Copyright: 2014-2022 The Khronos Group, Inc
 License: LicenseRef-KhronosSpecCopyright
 
 Files: scripts/asciidoctor-chunker/*

BUILD.adoc

@@ -1,4 +1,4 @@
-// Copyright 2014-2021 The Khronos Group Inc.
+// Copyright 2014-2022 The Khronos Group Inc.
 // SPDX-License-Identifier: CC-BY-4.0
 
 = Vulkan^(R)^ Specification Build Instructions and Notes
@@ -45,7 +45,7 @@ Then in the running image,
     $ cd /vulkan
     $ ./makeSpec -spec core html
 
-which builds an HTML5 specification output for the core Vulkan 1.2
+which builds an HTML5 specification output for the core Vulkan 1.3
 specification, with no extensions included, or
 
     $ ./makeSpec -spec all all
@@ -76,7 +76,7 @@ commands there.
     are irrelevant for most users.
     The `html` target just generates the HTML output, which is often all
     that is needed for spec bugfixes not involving extensions.
-  * The default `make` options build a Vulkan 1.2 specification with no
+  * The default `make` options build a Vulkan 1.3 specification with no
     optional extensions.
   * The `validusage` target is not built as part of the `all` target, due to
     it needing to be built with all extensions enabled (`-spec all`).
@@ -122,7 +122,7 @@ If you encounter problems refer to the <<troubleshooting>> section.
 [[building-versions]]
 === Building Specifications For Different API Versions
 
-The `Makefile` defaults to building a Vulkan 1.2 specification.
+The `Makefile` defaults to building a Vulkan 1.3 specification.
 This is controlled by Asciidoctor attributes passed in the Makefile variable
 `$(VERSIONS)`
 To instead build a Vulkan 1.1 specification, pass

CODE_OF_CONDUCT.adoc

@@ -1,4 +1,4 @@
-// Copyright 2018-2021 The Khronos Group Inc.
+// Copyright 2018-2022 The Khronos Group Inc.
 // SPDX-License-Identifier: CC-BY-4.0
 
 = Code of Conduct

CONTRIBUTING.adoc

@@ -1,4 +1,4 @@
-// Copyright 2020-2021 The Khronos Group Inc.
+// Copyright 2020-2022 The Khronos Group Inc.
 // SPDX-License-Identifier: CC-BY-4.0
 
 = Contributing

COPYING.adoc

@@ -1,4 +1,4 @@
-// Copyright 2020-2021 The Khronos Group Inc.
+// Copyright 2020-2022 The Khronos Group Inc.
 // SPDX-License-Identifier: CC-BY-4.0
 
 = COPYING file for the KhronosGroup/Vulkan-Docs project

ChangeLog.txt

@@ -1,4 +1,4 @@
-Copyright 2016-2021 The Khronos Group Inc.
+Copyright 2016-2022 The Khronos Group Inc.
 SPDX-License-Identifier: CC-BY-4.0
 
 Update Log for the Vulkan-Docs repository on Github. Updates are in reverse
@@ -11,6 +11,35 @@ public pull requests that have been accepted.
 
 -----------------------------------------------------
 
+Change log for January 25, 2022 Vulkan 1.3.204 spec update:
+
+  * Vulkan 1.3 initial release. Update release number to 204 for this
+    update. The patch number will be used for all Vulkan 1.x spec updates,
+    and continue to increment continuously from the previous Vulkan 1.2.203
+    update.
+
+Github Issues:
+
+  * Reserve driver ID ename:VK_DRIVER_ID_MESA_VENUS (public merge request
+    1733).
+
+Internal Issues:
+
+  * Update scripts and registry schema document to support multiple API
+    names in the `api` and `supported` attributes, to allow specializing API
+    definitions (internal issue 2809).
+  * Minor updates - update copyright dates to 2022, update release scripts
+    to generate artifacts for 1.3 as well as earlier specification versions
+    (internal issue 2969).
+
+New Features:
+
+  * apiext:VK_KHR_global_priority (internal merge request 4869).
+  * <<roadmap-2022, `VK_KHR_roadmap_2022`>> ("`Roadmap 2022`") profile
+    (internal merge request 4797).
+
+-----------------------------------------------------
+
 Change log for December 20, 2021 Vulkan 1.2.203 spec update:
 
   * Update release number to 203 for this update.

LICENSE.adoc

@@ -1,4 +1,4 @@
-// Copyright 2020-2021 The Khronos Group Inc.
+// Copyright 2020-2022 The Khronos Group Inc.
 // SPDX-License-Identifier: CC-BY-4.0
 
 = LICENSE file for the KhronosGroup/Vulkan-Docs project

LICENSES/LicenseRef-KhronosSpecCopyright.txt

@@ -1,4 +1,4 @@
-Copyright 2014-2021 The Khronos Group Inc.
+Copyright 2014-2022 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

Makefile

@@ -1,12 +1,12 @@
-# Copyright 2014-2021 The Khronos Group Inc.
+# Copyright 2014-2022 The Khronos Group Inc.
 #
 # SPDX-License-Identifier: Apache-2.0
 
 # Vulkan Specification makefile
 #
 # To build the spec with a specific version included, set the
 # $(VERSIONS) variable on the make command line to a space-separated
-# list of version names (e.g. VK_VERSION_1_2) *including all previous
+# list of version names (e.g. VK_VERSION_1_3) *including all previous
 # versions of the API* (e.g. VK_VERSION_1_1 must also include
 # VK_VERSION_1_0). $(VERSIONS) is converted into asciidoc and generator
 # script arguments $(VERSIONATTRIBS) and $(VERSIONOPTIONS)
@@ -22,7 +22,7 @@
 # runs of `make`.
 .DELETE_ON_ERROR:
 
-VERSIONS := VK_VERSION_1_0 VK_VERSION_1_1 VK_VERSION_1_2
+VERSIONS := VK_VERSION_1_0 VK_VERSION_1_1 VK_VERSION_1_2 VK_VERSION_1_3
 VERSIONATTRIBS := $(foreach version,$(VERSIONS),-a $(version))
 VERSIONOPTIONS := $(foreach version,$(VERSIONS),-feature $(version))
 
@@ -128,8 +128,11 @@ VERBOSE =
 # ADOCOPTS options for asciidoc->HTML5 output
 
 NOTEOPTS     = -a editing-notes -a implementation-guide
-PATCHVERSION = 203
+PATCHVERSION = 204
 
+ifneq (,$(findstring VK_VERSION_1_3,$(VERSIONS)))
+SPECMINOR = 3
+else
 ifneq (,$(findstring VK_VERSION_1_2,$(VERSIONS)))
 SPECMINOR = 2
 else
@@ -139,6 +142,7 @@ else
 SPECMINOR = 0
 endif
 endif
+endif
 
 SPECREVISION = 1.$(SPECMINOR).$(PATCHVERSION)
 

README.adoc

@@ -1,4 +1,4 @@
-// Copyright 2017-2021 The Khronos Group Inc.
+// Copyright 2017-2022 The Khronos Group Inc.
 // SPDX-License-Identifier: CC-BY-4.0
 
 ifdef::env-github[]
@@ -47,15 +47,15 @@ Group to review in a timely fashion.
 The current Specification is maintained in the default branch (currently
 `main`) of the repository.
 From this branch it is possible to generate Specifications for any published
-version of Vulkan (1.2, 1.1, and 1.0), and incorporating any desired set of
+version of Vulkan (1.3, 1.2, 1.1, and 1.0), and incorporating any desired set of
 extensions.
-Each published update is tagged in the form `1.2.*release*` where *release*
-is a constantly incrementing release number and `1.2` is the latest
+Each published update is tagged in the form `1.3.*release*` where *release*
+is a constantly incrementing release number and `1.3` is the latest
 published version of the API.
-The last public spec update prior to Vulkan 1.2 is tagged `v1.1.130`.
+The last public spec update prior to Vulkan 1.3 is tagged `v1.2.???`.
 
 The last state of the default branch in Khronos' internal gitlab server,
-before 1.2 content was merged into it, is tagged `1.1-archive` (this tag is
+before 1.3 content was merged into it, is tagged `1.2-archive` (this tag is
 not in github).
 
 

appendices/VK_ARM_rasterization_order_attachment_access.txt

@@ -1,4 +1,4 @@
-// Copyright (c) 2021 The Khronos Group Inc.
+// Copyright 2021-2022 The Khronos Group Inc.
 //
 // SPDX-License-Identifier: CC-BY-4.0
 

appendices/VK_EXT_4444_formats.txt

@@ -1,4 +1,4 @@
-// Copyright 2020-2021 The Khronos Group Inc.
+// Copyright 2020-2022 The Khronos Group Inc.
 //
 // SPDX-License-Identifier: CC-BY-4.0
 
@@ -8,6 +8,8 @@ include::{generated}/meta/{refprefix}VK_EXT_4444_formats.txt[]
 
 *Last Modified Date*::
     2020-07-28
+*Interactions and External Dependencies*::
+  - Promoted to Vulkan 1.3 Core
 *IP Status*::
     No known IP claims.
 *Contributors*::
@@ -30,6 +32,17 @@ VK_FORMAT_B4G4R4A4_UNORM_PACK16.
 
 include::{generated}/interfaces/VK_EXT_4444_formats.txt[]
 
+=== Promotion to Vulkan 1.3
+
+This extension has been partially promoted.
+The format enumerants introduced by the extension are included in core
+Vulkan 1.3, with the EXT suffix omitted.
+However, runtime support for these formats is optional in core Vulkan 1.3,
+while if this extension is supported, runtime support is mandatory.
+The feature structure is not promoted.
+The original enum names are still available as aliases of the core
+functionality.
+
 === Version History
 
  * Revision 1, 2020-07-04 (Joshua Ashton)

appendices/VK_EXT_acquire_drm_display.txt

@@ -1,4 +1,4 @@
-// Copyright 2018-2021 The Khronos Group, Inc.
+// Copyright 2018-2022 The Khronos Group Inc.
 //
 // SPDX-License-Identifier: CC-BY-4.0
 

appendices/VK_EXT_acquire_xlib_display.txt

@@ -1,4 +1,4 @@
-// Copyright 2018-2021 The Khronos Group Inc.
+// Copyright 2018-2022 The Khronos Group Inc.
 //
 // SPDX-License-Identifier: CC-BY-4.0
 

appendices/VK_EXT_astc_decode_mode.txt

@@ -1,4 +1,4 @@
-// Copyright 2018-2021 The Khronos Group, Inc.
+// Copyright 2018-2022 The Khronos Group Inc.
 //
 // SPDX-License-Identifier: CC-BY-4.0
 

appendices/VK_EXT_blend_operation_advanced.txt

@@ -1,4 +1,4 @@
-// Copyright 2017-2021 The Khronos Group Inc.
+// Copyright 2017-2022 The Khronos Group Inc.
 //
 // SPDX-License-Identifier: CC-BY-4.0
 

appendices/VK_EXT_border_color_swizzle.txt

@@ -1,4 +1,4 @@
-// Copyright 2021 The Khronos Group Inc.
+// Copyright 2021-2022 The Khronos Group Inc.
 //
 // SPDX-License-Identifier: CC-BY-4.0
 

appendices/VK_EXT_buffer_device_address.txt

@@ -1,4 +1,4 @@
-// Copyright 2018-2021 The Khronos Group Inc.
+// Copyright 2018-2022 The Khronos Group Inc.
 //
 // SPDX-License-Identifier: CC-BY-4.0
 

appendices/VK_EXT_calibrated_timestamps.txt

@@ -1,4 +1,4 @@
-// Copyright 2018-2021 The Khronos Group Inc.
+// Copyright 2018-2022 The Khronos Group Inc.
 //
 // SPDX-License-Identifier: CC-BY-4.0
 

appendices/VK_EXT_color_write_enable.txt

@@ -1,4 +1,4 @@
-// Copyright (c) 2020 The Khronos Group Inc.
+// Copyright 2020 The Khronos Group Inc.
 //
 // SPDX-License-Identifier: CC-BY-4.0
 

appendices/VK_EXT_conditional_rendering.txt

@@ -1,4 +1,4 @@
-// Copyright 2018-2021 The Khronos Group Inc.
+// Copyright 2018-2022 The Khronos Group Inc.
 //
 // SPDX-License-Identifier: CC-BY-4.0
 

appendices/VK_EXT_conservative_rasterization.txt

@@ -1,4 +1,4 @@
-// Copyright 2017-2021 The Khronos Group Inc.
+// Copyright 2017-2022 The Khronos Group Inc.
 //
 // SPDX-License-Identifier: CC-BY-4.0
 

appendices/VK_EXT_custom_border_color.txt

@@ -1,4 +1,4 @@
-// Copyright 2019-2021 The Khronos Group Inc.
+// Copyright 2019-2022 The Khronos Group Inc.
 //
 // SPDX-License-Identifier: CC-BY-4.0
 

appendices/VK_EXT_debug_marker.txt

@@ -1,4 +1,4 @@
-// Copyright 2016-2021 The Khronos Group Inc.
+// Copyright 2016-2022 The Khronos Group Inc.
 //
 // SPDX-License-Identifier: CC-BY-4.0
 

appendices/VK_EXT_debug_report.txt

@@ -1,4 +1,4 @@
-// Copyright 2015-2021 The Khronos Group Inc.
+// Copyright 2015-2022 The Khronos Group Inc.
 //
 // SPDX-License-Identifier: CC-BY-4.0
 

appendices/VK_EXT_debug_utils.txt

@@ -1,4 +1,4 @@
-// Copyright 2017-2021 The Khronos Group Inc.
+// Copyright 2017-2022 The Khronos Group Inc.
 //
 // SPDX-License-Identifier: CC-BY-4.0
 

appendices/VK_EXT_depth_clip_control.txt

@@ -1,4 +1,4 @@
-// Copyright (c) 2021 The Khronos Group Inc.
+// Copyright 2021-2022 The Khronos Group Inc.
 //
 // SPDX-License-Identifier: CC-BY-4.0
 

appendices/VK_EXT_depth_clip_enable.txt

@@ -1,4 +1,4 @@
-// Copyright 2018-2021 The Khronos Group Inc.
+// Copyright 2018-2022 The Khronos Group Inc.
 //
 // SPDX-License-Identifier: CC-BY-4.0
 

appendices/VK_EXT_depth_range_unrestricted.txt

@@ -1,4 +1,4 @@
-// Copyright 2017-2021 The Khronos Group Inc.
+// Copyright 2017-2022 The Khronos Group Inc.
 //
 // SPDX-License-Identifier: CC-BY-4.0
 

appendices/VK_EXT_descriptor_indexing.txt

@@ -1,4 +1,4 @@
-// Copyright 2017-2021 The Khronos Group Inc.
+// Copyright 2017-2022 The Khronos Group Inc.
 //
 // SPDX-License-Identifier: CC-BY-4.0
 

appendices/VK_EXT_device_memory_report.txt

@@ -1,4 +1,4 @@
-// Copyright 2020-2021 The Khronos Group Inc.
+// Copyright 2020-2022 The Khronos Group Inc.
 //
 // SPDX-License-Identifier: CC-BY-4.0