Change log for February 16, 2023 Vulkan 1.3.241 spec update:

Github Issues: * Clarify apiext:VK_EXT_debug_utils object support (public issue 1668, public pull request 2034). * Fix capitalization typos in a few VUs (public pull request 2050). * Parameterize asciidoc includes of asciidoc files from `vkspec.adoc` using `{chapters}` attribute (public pull request 2051). Internal XML Schema Issues: Several needed XML schema changes are introduced in this update which may impact downstream XML users who are doing their own parsing. Users of our Python generator framework are unlikely to be impacted. If you have difficulty adapting to these changes, please open an issue on the Vulkan-Docs Github repository. * Introduce a new `depends` attribute to the XML schema, replacing the `requires` and `requiresCore` attributes of `<extension>` tags, and the `features` and `extension` attributes of `<require>` tags. This is an intentional and unavoidable breaking change, allowing us to correctly express more complex dependencies. XML users doing their own XML parsing and needing this information must treat the `depends` attribute as a boolean expression. This change also adds a description of the different interpretation of device and instance extension dependencies in a single place in the new <<extensions, "`Extension Dependencies`">> section at the start of the extensions appendix, rather than including a boilerplate comment about "`device-level extensions`" with each relevant extension dependency described later in the appendix (internal issue 2883). * Import XML, script, and config file changes from the Vulkan SC spec repository. This change uses the `api` XML attribute to specialize some tags for the Vulkan and Vulkan SC APIs. While this is not a new attribute, it has not been extensively used in this fashion previously in this repository. XML users doing their own XML parsing must now filter out tags with `api` attributes not matching the API they are generating, and must also filter out `<extension>` tags whose `supported` attribute does not include that API (internal issue 3348). * Remove some redundancies from refactored XML dependencies (internal merge request 5713). * Express correct XML dependencies of apiext:VK_KHR_buffer_device_address, now that the new `depends` schema supports that (internal merge request 5721). * Add a new `deprecated` attribute to several tags in XML schema which provides some guidance as to why an API was deprecated. Remove `comment` text which some downstream XML parsers were using to infer deprecation, which was never an intended or supported purpose of the comments (public ash-rs/ash issue 670, internal merge request 5537). Other Internal Issues * Expand the definition of <<fundamentals-validusage-enums, "`valid enumerant value`">> to include whether the extension or core version defining that enumerant is enabled or supported. This has a global effect on corresponding VU statements, and the Vulkan Validation Layer is being updated accordingly (internal issue 2912). * Update the <<synchronization>> chapter in several places to clarify that pipeline barriers work only within a single queue (internal issue 3365). * Add ename:VK_PIPELINE_STAGE_2_ACCELERATION_STRUCTURE_COPY_BIT_KHR in a few places it was missing, and update description for copy commands to specify where it should be used with apiextVK_KHR_synchronization2 rather than ename:VK_PIPELINE_STAGE_2_ACCELERATION_STRUCTURE_BUILD_BIT_KHR (internal merge request 5604). * Fix typos in `proposals/VK_KHR_video_decode_queue.adoc` (internal merge request 5646). * Add dynamic state to apiext:VK_EXT_discard_rectangles (ename:VK_DYNAMIC_STATE_DISCARD_RECTANGLE_ENABLE_EXT and ename:VK_DYNAMIC_STATE_DISCARD_RECTANGLE_MODE_EXT) and for apiext:VK_NV_scissor_exclusive (ename:VK_DYNAMIC_STATE_EXCLUSIVE_SCISSOR_ENABLE_NV) that was overlooked in apiext:VK_EXT_extended_dynamic_state3. While this is adding functionality to existing extensions, the implementers of these extensions have all signed off on this change (internal merge request 5671). * Disallow ename:VK_DESCRIPTOR_TYPE_INLINE_UNIFORM_BLOCK in slink:VkDescriptorGetInfoEXT VU 08018 (internal merge request 5681). * Rearrange some language in flink:vkGetRayTracingShaderGroupHandlesKHR and flink:vkGetRayTracingCaptureReplayShaderGroupHandlesKHR to follow the style guide (internal merge request 5683). * Update to new Docker image SHA for CI and building specs (internal merge request 5688). * Add `SPV_EXT_fragment_fully_covered` to XML `<spirvextensions>` section (internal merge request 5689). * Add missing pname:pNext description to slink:VkVideoDecodeH264DpbSlotInfoKHR (internal merge request 5701). * Add missing internal links for the term <<pipelines-graphics-subsets-fragment-shader, fragment shader state>> (internal merge request 5704). * Move ename:VK_DYNAMIC_STATE_PRIMITIVE_TOPOLOGY VU common draw vertex binding VUs, and word VUs 03420 and 07500 the same, minus the reference to pname:dynamicPrimitiveTopologyUnrestricted (internal merge request 5708). * Ban some advanced blend modes from slink:VkColorBlendEquationEXT that must be set using a different mechanism (internal merge request 5705). * Update copyright dates to 2023, and add CI check for Khronos-copyright files (internal merge request 5716). * Add clarifying NOTE and typo fixes for apiext:VK_HUAWEI_cluster_culling_shader (internal merge request 5718). * Add missing XML dependencies on apiext:VK_KHR_get_physical_device_properties2 to several extensions (internal merge request 5719). * Remove flink:vkCmdResolveImage VUs where pname:srcImage is of type ename:VK_IMAGE_TYPE_3D (internal vulkansc issue 178). New Extensions: * apiext:VK_EXT_image_sliced_view_of_3d * apiext:VK_ARM_shader_core_properties * apiext:VK_QCOM_multiview_per_view_render_areas
KhronosGroup · Feb 16, 2023 · 1b1c4dd · 1b1c4dd
1 parent c79a577
commit 1b1c4dd
Show file tree

Hide file tree

Showing 602 changed files with 6,924 additions and 1,483 deletions.
diff --git a/.gitattributes b/.gitattributes
@@ -1,4 +1,4 @@
-# Copyright 2015-2022 The Khronos Group Inc.
+# Copyright 2015-2023 The Khronos Group Inc.
 #
 # SPDX-License-Identifier: Apache-2.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-2022 The Khronos Group Inc.
+- Copyright 2019-2023 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-2022 The Khronos Group Inc.
+# Copyright 2021-2023 The Khronos Group Inc.
 # SPDX-License-Identifier: Apache-2.0
 
 # Github CI file for vulkan spec and header generation
@@ -22,7 +22,7 @@ jobs:
     # We now refer to the container by its SHA instead of the name, to prevent
     # caching problems when updating the image.
     # container: khronosgroup/docker-images:asciidoctor-spec
-    container: khronosgroup/docker-images@sha256:9cfd1add08df752a6b07156b1f67ba203b88b2f520f75f0f042d77efdff318a0
+    container: khronosgroup/docker-images@sha256:42123ba13792c4e809d037b69152c2230ad97fbf43b677338075ab9c928ab6ed
 
     steps:
       - uses: actions/checkout@v3
@@ -32,7 +32,7 @@ jobs:
   terminology-check:
     name: Run various checker scripts on the spec and XML sources
     runs-on: ubuntu-latest
-    container: khronosgroup/docker-images@sha256:9cfd1add08df752a6b07156b1f67ba203b88b2f520f75f0f042d77efdff318a0
+    container: khronosgroup/docker-images@sha256:42123ba13792c4e809d037b69152c2230ad97fbf43b677338075ab9c928ab6ed
 
     steps:
       - uses: actions/checkout@v3
@@ -48,7 +48,7 @@ jobs:
   spec-core:
     name: Build the core-only spec, to try and catch ifdef errors in extension markup
     runs-on: ubuntu-latest
-    container: khronosgroup/docker-images@sha256:9cfd1add08df752a6b07156b1f67ba203b88b2f520f75f0f042d77efdff318a0
+    container: khronosgroup/docker-images@sha256:42123ba13792c4e809d037b69152c2230ad97fbf43b677338075ab9c928ab6ed
 
     steps:
       - uses: actions/checkout@v3
@@ -57,7 +57,7 @@ jobs:
   spec-generate:
     name: Build the vulkan specification and generate any associated files (such as vulkan.h)
     runs-on: ubuntu-latest
-    container: khronosgroup/docker-images@sha256:9cfd1add08df752a6b07156b1f67ba203b88b2f520f75f0f042d77efdff318a0
+    container: khronosgroup/docker-images@sha256:42123ba13792c4e809d037b69152c2230ad97fbf43b677338075ab9c928ab6ed
 
     steps:
       - uses: actions/checkout@v3

diff --git a/.gitignore b/.gitignore
@@ -1,4 +1,4 @@
-# Copyright 2015-2022 The Khronos Group Inc.
+# Copyright 2015-2023 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-2022 The Khronos Group Inc.
+# Copyright 2018-2023 The Khronos Group Inc.
 #
 # SPDX-License-Identifier: Apache-2.0
 
@@ -8,7 +8,7 @@
 # We now refer to the container by its SHA instead of the name, to prevent
 # caching problems when updating the image.
 # image: khronosgroup/docker-images:asciidoctor-spec
-image: khronosgroup/docker-images@sha256:9cfd1add08df752a6b07156b1f67ba203b88b2f520f75f0f042d77efdff318a0
+image: khronosgroup/docker-images@sha256:42123ba13792c4e809d037b69152c2230ad97fbf43b677338075ab9c928ab6ed
 
 # Verify repository license compliance
 license-check:
@@ -158,6 +158,7 @@ cts-framework-tests:
     - python3 external/vulkancts/scripts/gen_framework_c.py
     - python3 external/vulkancts/scripts/gen_framework.py --api SC
     - python3 external/vulkancts/scripts/gen_framework_c.py --api SC
+  allow_failure: true
 
 # Compile a simple test program that uses vulkan.h
 # The fake platform headers in tests/ allow compiling with all Vulkan

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

diff --git a/.reuse/dep5 b/.reuse/dep5
@@ -2,8 +2,8 @@ Format: https://www.debian.org/doc/packaging-manuals/copyright-format/1.0/
 Upstream-Name: Vulkan-Docs
 Source: https://github.com/KhronosGroup/Vulkan-Docs
 
-Files: images/*.svg config/chunkindex/custom.patch config/CI/contractions* config/CI/txt-files-allowed config/docinfo-header.html
-Copyright: 2015-2022 The Khronos Group Inc.
+Files: images/*.svg config/chunkindex/custom.patch config/CI/contractions* config/CI/txt-files-allowed config/*/docinfo-header.html
+Copyright: 2015-2023 The Khronos Group Inc.
 License: CC-BY-4.0
 
 Files: katex/*
@@ -28,15 +28,15 @@ License: LicenseRef-MPLUS
 
 Files: scripts/htmldiff/htmldiff.pl
 Copyright: 1998-2006 MACS, Inc.
-Copyright: 2007 SiSco, Inc.
+           2007 SiSco, Inc.
 License: MIT
 
 Files: *.json scripts/vuidCounts.py config/chunkindex/addscript.*
-Copyright: 2020-2022 The Khronos Group Inc.
+Copyright: 2020-2023 The Khronos Group Inc.
 License: Apache-2.0
 
 Files: config/copyright-spec.adoc
-Copyright: 2014-2022 The Khronos Group Inc
+Copyright: 2014-2023 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-2022 The Khronos Group Inc.
+// Copyright 2014-2023 The Khronos Group Inc.
 // SPDX-License-Identifier: CC-BY-4.0
 
 = Vulkan^(R)^ Specification Build Instructions and Notes
@@ -384,7 +384,7 @@ image name. The SHA256 can be determined from
 
 which will print a line like
 
-    image: khronosgroup/docker-images@sha256:9cfd1add08df752a6b07156b1f67ba203b88b2f520f75f0f042d77efdff318a0
+    image: khronosgroup/docker-images@sha256:42123ba13792c4e809d037b69152c2230ad97fbf43b677338075ab9c928ab6ed
 
 Everything following `image: ` is the <imagename> to use. The first time you
 try to run Docker with this <imagename>, as is done by the `runDocker`

diff --git a/CODE_OF_CONDUCT.adoc b/CODE_OF_CONDUCT.adoc
@@ -1,4 +1,4 @@
-// Copyright 2018-2022 The Khronos Group Inc.
+// Copyright 2018-2023 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-2022 The Khronos Group Inc.
+// Copyright 2020-2023 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-2022 The Khronos Group Inc.
+// Copyright 2020-2023 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-2022 The Khronos Group Inc.
+Copyright 2016-2023 The Khronos Group Inc.
 SPDX-License-Identifier: CC-BY-4.0
 
 Update Log for the Vulkan-Docs repository on GitHub. Updates are in reverse
@@ -14,6 +14,120 @@ appears frequently in the change log.
 
 -----------------------------------------------------
 
+Change log for February 16, 2023 Vulkan 1.3.241 spec update:
+
+Github Issues:
+
+  * Clarify apiext:VK_EXT_debug_utils object support (public issue 1668,
+    public pull request 2034).
+  * Fix capitalization typos in a few VUs (public pull request 2050).
+  * Parameterize asciidoc includes of asciidoc files from `vkspec.adoc`
+    using `{chapters}` attribute (public pull request 2051).
+
+Internal XML Schema Issues:
+
+Several needed XML schema changes are introduced in this update which may
+impact downstream XML users who are doing their own parsing. Users of our
+Python generator framework are unlikely to be impacted. If you have
+difficulty adapting to these changes, please open an issue on the
+Vulkan-Docs Github repository.
+
+  * Introduce a new `depends` attribute to the XML schema, replacing the
+    `requires` and `requiresCore` attributes of `<extension>` tags, and the
+    `features` and `extension` attributes of `<require>` tags. This is an
+    intentional and unavoidable breaking change, allowing us to correctly
+    express more complex dependencies. XML users doing their own XML parsing
+    and needing this information must treat the `depends` attribute as a
+    boolean expression. This change also adds a description of the different
+    interpretation of device and instance extension dependencies in a single
+    place in the new <<extensions, "`Extension Dependencies`">> section at
+    the start of the extensions appendix, rather than including a
+    boilerplate comment about "`device-level extensions`" with each relevant
+    extension dependency described later in the appendix (internal issue
+    2883).
+  * Import XML, script, and config file changes from the Vulkan SC spec
+    repository. This change uses the `api` XML attribute to specialize some
+    tags for the Vulkan and Vulkan SC APIs. While this is not a new
+    attribute, it has not been extensively used in this fashion previously
+    in this repository. XML users doing their own XML parsing must now
+    filter out tags with `api` attributes not matching the API they are
+    generating, and must also filter out `<extension>` tags whose
+    `supported` attribute does not include that API (internal issue 3348).
+  * Remove some redundancies from refactored XML dependencies (internal
+    merge request 5713).
+  * Express correct XML dependencies of apiext:VK_KHR_buffer_device_address,
+    now that the new `depends` schema supports that (internal merge request
+    5721).
+  * Add a new `deprecated` attribute to several tags in XML schema which
+    provides some guidance as to why an API was deprecated. Remove `comment`
+    text which some downstream XML parsers were using to infer deprecation,
+    which was never an intended or supported purpose of the comments (public
+    ash-rs/ash issue 670, internal merge request 5537).
+
+Other Internal Issues
+
+  * Expand the definition of <<fundamentals-validusage-enums, "`valid
+    enumerant value`">> to include whether the extension or core version
+    defining that enumerant is enabled or supported. This has a global
+    effect on corresponding VU statements, and the Vulkan Validation Layer
+    is being updated accordingly (internal issue 2912).
+  * Update the <<synchronization>> chapter in several places to clarify that
+    pipeline barriers work only within a single queue (internal issue 3365).
+  * Add ename:VK_PIPELINE_STAGE_2_ACCELERATION_STRUCTURE_COPY_BIT_KHR in a
+    few places it was missing, and update description for copy commands to
+    specify where it should be used with apiextVK_KHR_synchronization2
+    rather than
+    ename:VK_PIPELINE_STAGE_2_ACCELERATION_STRUCTURE_BUILD_BIT_KHR (internal
+    merge request 5604).
+  * Fix typos in `proposals/VK_KHR_video_decode_queue.adoc` (internal merge
+    request 5646).
+  * Add dynamic state to apiext:VK_EXT_discard_rectangles
+    (ename:VK_DYNAMIC_STATE_DISCARD_RECTANGLE_ENABLE_EXT and
+    ename:VK_DYNAMIC_STATE_DISCARD_RECTANGLE_MODE_EXT) and for
+    apiext:VK_NV_scissor_exclusive
+    (ename:VK_DYNAMIC_STATE_EXCLUSIVE_SCISSOR_ENABLE_NV) that was overlooked
+    in apiext:VK_EXT_extended_dynamic_state3. While this is adding
+    functionality to existing extensions, the implementers of these
+    extensions have all signed off on this change (internal merge request
+    5671).
+  * Disallow ename:VK_DESCRIPTOR_TYPE_INLINE_UNIFORM_BLOCK in
+    slink:VkDescriptorGetInfoEXT VU 08018 (internal merge request 5681).
+  * Rearrange some language in flink:vkGetRayTracingShaderGroupHandlesKHR
+    and flink:vkGetRayTracingCaptureReplayShaderGroupHandlesKHR to follow
+    the style guide (internal merge request 5683).
+  * Update to new Docker image SHA for CI and building specs (internal merge
+    request 5688).
+  * Add `SPV_EXT_fragment_fully_covered` to XML `<spirvextensions>` section
+    (internal merge request 5689).
+  * Add missing pname:pNext description to
+    slink:VkVideoDecodeH264DpbSlotInfoKHR (internal merge request 5701).
+  * Add missing internal links for the term
+    <<pipelines-graphics-subsets-fragment-shader, fragment shader state>>
+    (internal merge request 5704).
+  * Move ename:VK_DYNAMIC_STATE_PRIMITIVE_TOPOLOGY VU common draw vertex
+    binding VUs, and word VUs 03420 and 07500 the same, minus the reference
+    to pname:dynamicPrimitiveTopologyUnrestricted (internal merge request
+    5708).
+  * Ban some advanced blend modes from slink:VkColorBlendEquationEXT that
+    must be set using a different mechanism (internal merge request 5705).
+  * Update copyright dates to 2023, and add CI check for Khronos-copyright
+    files (internal merge request 5716).
+  * Add clarifying NOTE and typo fixes for
+    apiext:VK_HUAWEI_cluster_culling_shader (internal merge request 5718).
+  * Add missing XML dependencies on
+    apiext:VK_KHR_get_physical_device_properties2 to several extensions
+    (internal merge request 5719).
+  * Remove flink:vkCmdResolveImage VUs where pname:srcImage is of type
+    ename:VK_IMAGE_TYPE_3D (internal vulkansc issue 178).
+
+New Extensions:
+
+  * apiext:VK_EXT_image_sliced_view_of_3d
+  * apiext:VK_ARM_shader_core_properties
+  * apiext:VK_QCOM_multiview_per_view_render_areas
+
+-----------------------------------------------------
+
 Change log for January 26, 2023 Vulkan 1.3.240 spec update:
 
 Github Issues:

diff --git a/LICENSE.adoc b/LICENSE.adoc
@@ -1,4 +1,4 @@
-// Copyright 2020-2022 The Khronos Group Inc.
+// Copyright 2020-2023 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-2022 The Khronos Group Inc.
+Copyright 2014-2023 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-2022 The Khronos Group Inc.
+# Copyright 2014-2023 The Khronos Group Inc.
 #
 # SPDX-License-Identifier: Apache-2.0
 
@@ -59,7 +59,7 @@ allman: manhtmlpages
 # Invokes all the automated checks, but CHECK_XREFS can be set to empty
 # on the command line to avoid building an HTML spec target.
 CHECK_XREFS = check-xrefs
-allchecks: check-contractions check-spelling check-bullets check-reflow check-links check-consistency check-undefined check-txtfiles $(CHECK_XREFS)
+allchecks: check-copyright-dates check-contractions check-spelling check-bullets check-reflow check-links check-consistency check-undefined check-txtfiles $(CHECK_XREFS)
 
 QUIET	 ?= @
 VERYQUIET?= @
@@ -104,7 +104,7 @@ VERBOSE =
 # ADOCOPTS options for asciidoc->HTML5 output
 
 NOTEOPTS     = -a editing-notes -a implementation-guide
-PATCHVERSION = 240
+PATCHVERSION = 241
 
 ifneq (,$(findstring VK_VERSION_1_3,$(VERSIONS)))
 SPECMINOR = 3
@@ -384,7 +384,7 @@ check-contractions:
 	fi
 
 # Look for typos and suggest fixes
-CODESPELL = codespell --config config/CI/codespellrc -S '*.js' -S './antora*/*' -S 'ERRS*'
+CODESPELL = codespell --config config/CI/codespellrc -S '*.js' -S './antora*/*' -S 'ERRS*,*.pdf'
 check-spelling:
 	if ! $(CODESPELL) > /dev/null ; then \
 	    echo "Found probable misspellings. Corrections can be added to config/CI/codespell-allowed:" ; \
@@ -406,6 +406,17 @@ check-bullets:
 check-reflow:
 	$(PYTHON) $(SCRIPTS)/reflow.py -nowrite -noflow -check FAIL -checkVUID FAIL $(SPECFILES)
 
+# Look for files whose Khronos copyright has not been updated to the
+# current year
+DATE_YEAR = $(shell date +%Y)
+CHECK_DATES = git grep -l 'Copyright.*The Khronos' | xargs git grep -L 'Copyright.*$(DATE_YEAR).*The Khronos'
+check-copyright-dates:
+	if test `$(CHECK_DATES) | wc -l` != 0 ; then \
+	    echo "Files with out-of-date Khronos copyrights (must be updated to $(DATE_YEAR):" ; \
+	    $(CHECK_DATES) ; \
+	    exit 1 ; \
+	 fi
+
 # Look for proper use of custom markup macros
 #   --ignore_count 0 can be incremented if there are unfixable errors
 check-links:

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

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-2022 The Khronos Group Inc.
+// Copyright 2021-2023 The Khronos Group Inc.
 //
 // SPDX-License-Identifier: CC-BY-4.0
 

diff --git a/appendices/VK_ARM_shader_core_properties.adoc b/appendices/VK_ARM_shader_core_properties.adoc
@@ -0,0 +1,32 @@
+// Copyright (c) 2023 Arm Ltd.
+//
+// SPDX-License-Identifier: CC-BY-4.0
+
+include::{generated}/meta/{refprefix}VK_ARM_shader_core_properties.adoc[]
+
+=== Other Extension Metadata
+
+*Last Modified Date*::
+    2023-02-07
+*IP Status*::
+    No known IP claims.
+*Contributors*::
+  - Jan-Harald Fredriksen, Arm Ltd.
+
+=== Description
+
+This extension provides the ability to determine device-specific performance
+properties of Arm GPUs.
+
+It exposes properties for the number of texel, pixel, and fused multiply-add
+operations per clock per shader core.
+This can be used in combination with the
+`apiext:VK_ARM_shader_core_builtins` extension that provides the ability to
+query the number of shader cores on the physical device.
+
+include::{generated}/interfaces/VK_ARM_shader_core_properties.adoc[]
+
+=== Version History
+
+  * Revision 1, 2023-02-07 (Jan-Harald Fredriksen)
+  ** Initial draft.
-Original file line number
+Diff line change
@@ Expand Up / @@ -9,7 +9,7 @@ assignees: '' @@
     ---
     <!--
-    - Copyright 2019-2022 The Khronos Group Inc.
+    - Copyright 2019-2023 The Khronos Group Inc.
     -
     - SPDX-License-Identifier: CC-BY-4.0
     -
@@ Expand Down @@