Change log for December 7, 2021 Vulkan 1.2.202 spec update:

* Update release number to 202 for this update. Github Issues: * Split some valid usage statements for slink:VkAttachmentDescription so they can have appropriate conditional protection (public pull request 1698). * Clean up links to GLSL and SPIR-V extension documents (public pull request 1705). * Fix markup for <<primsrast-polygon-barycentrics, perspective interpolation>> math (public pull request 1711). Internal Issues: * Clarify valid usage statements for flink:vkCmdWriteTimestamp2KHR::pname:stage to accomodate ename:VK_PIPELINE_STAGE_2_NONE_KHR (internal issue 2867). * Disallow descriptorset decorations on non-descriptor ray tracing variables in the <<spirvenv-module-validation-standalone, Standalone SPIR-V Validation>> section (internal issue 2881). * Fix sentence describing behavior when slink:VkRenderingFragmentDensityMapAttachmentInfoEXT is not present in the slink:VkRenderingInfoKHR::pname:pNext chain (internal issue 2881). * Require that slink:VkPhysicalDeviceRayTracingPipelinePropertiesKHR::pname:shaderGroupHandleAlignment be a power of two (internal merge request 4943). * Add a new ename:VK_IMAGE_ASPECT_NONE_KHR=0 enum to slink:VkImageAspectFlagBits in the apiext:VK_KHR_maintenance4 extension so that pname:planeAspect can be set to zero without having to use a cast, and fix some typos (internal merge request 4961). * Add "`must: be a power of two`" to all alignment limits (internal issue 2939). * Make all limit anchors follow the `[[limit-NAME]]` style (internal merge request 4969). * Require render pass to be valid and add missing state subset dependencies to slink:VkGraphicsPipelineCreateInfo valid usage statements for apiext:VK_ARM_rasterization_order_attachment_access (internal merge request 4970). * Parameterize OpenGL and GLSL extension registry URLs via asciidoctor attributes in `config/attribs.txt`, and move the existing SPIR-V extension registry URL from the Makefile into that file. Use `https:` prefixes on URLs instead of `http:` where possible.
KhronosGroup · Dec 7, 2021 · 48b7669 · 48b7669
1 parent b1c3dab
commit 48b7669
Show file tree

Hide file tree

Showing 82 changed files with 284 additions and 170 deletions.
diff --git a/BUILD.adoc b/BUILD.adoc
@@ -139,7 +139,7 @@ on the `makeSpec` command line.
 
 Extensions are defined in the same source as the core Specification, but
 are only conditionally included in the output.
-http://asciidoctor.org/docs/user-manual/#attributes[Asciidoctor attributes]
+https://asciidoctor.org/docs/user-manual/#attributes[Asciidoctor attributes]
 of the same name as the extension are used to define whether the extension
 is included or not -- defining such an attribute will cause the output to
 include the text for that extension.
@@ -265,7 +265,7 @@ gitlab repository.
 
 We use many custom Ruby macros in the reference pages and API spec
 Asciidoctor sources.
-The validator scripts rely on these macros as part of their sanity checks,
+The validator scripts rely on these macros as part of their checks.
 and you should use the macros whenever referring to an API command, struct,
 token, or enum name, so the documents are semantically tagged and more
 easily verifiable.
@@ -322,7 +322,7 @@ created.
 == Our stylesheets
 
 We use an HTML stylesheet `config/khronos.css` derived from the
-http://asciidoctor.org/docs/produce-custom-themes-using-asciidoctor-stylesheet-factory/[Asciidoctor
+https://asciidoctor.org/docs/produce-custom-themes-using-asciidoctor-stylesheet-factory/[Asciidoctor
 stylesheet factory] "`colony`" theme, with the default Arial font family
 replaced by the sans-serif https://en.wikipedia.org/wiki/Noto_fonts[Noto
 font family].

diff --git a/ChangeLog.txt b/ChangeLog.txt
@@ -11,6 +11,53 @@ public pull requests that have been accepted.
 
 -----------------------------------------------------
 
+Change log for December 7, 2021 Vulkan 1.2.202 spec update:
+
+  * Update release number to 202 for this update.
+
+Github Issues:
+
+  * Split some valid usage statements for slink:VkAttachmentDescription
+    so they can have appropriate conditional protection
+    (public pull request 1698).
+  * Clean up links to GLSL and SPIR-V extension documents (public pull
+    request 1705).
+  * Fix markup for <<primsrast-polygon-barycentrics, perspective
+    interpolation>> math (public pull request 1711).
+
+Internal Issues:
+
+  * Clarify valid usage statements for
+    flink:vkCmdWriteTimestamp2KHR::pname:stage to accomodate
+    ename:VK_PIPELINE_STAGE_2_NONE_KHR (internal issue 2867).
+  * Disallow descriptorset decorations on non-descriptor ray tracing
+    variables in the <<spirvenv-module-validation-standalone, Standalone
+    SPIR-V Validation>> section (internal issue 2881).
+  * Fix sentence describing behavior when
+    slink:VkRenderingFragmentDensityMapAttachmentInfoEXT is not present in
+    the slink:VkRenderingInfoKHR::pname:pNext chain (internal issue 2881).
+  * Require that
+    slink:VkPhysicalDeviceRayTracingPipelinePropertiesKHR::pname:shaderGroupHandleAlignment
+    be a power of two (internal merge request 4943).
+  * Add a new ename:VK_IMAGE_ASPECT_NONE_KHR=0 enum to
+    slink:VkImageAspectFlagBits in the apiext:VK_KHR_maintenance4 extension
+    so that pname:planeAspect can be set to zero without having to use a
+    cast, and fix some typos (internal merge request 4961).
+  * Add "`must: be a power of two`" to all alignment limits (internal issue
+    2939).
+  * Make all limit anchors follow the `[[limit-NAME]]` style (internal merge
+    request 4969).
+  * Require render pass to be valid and add missing state subset
+    dependencies to slink:VkGraphicsPipelineCreateInfo valid usage
+    statements for apiext:VK_ARM_rasterization_order_attachment_access
+    (internal merge request 4970).
+  * Parameterize OpenGL and GLSL extension registry URLs via asciidoctor
+    attributes in `config/attribs.txt`, and move the existing SPIR-V
+    extension registry URL from the Makefile into that file. Use `https:`
+    prefixes on URLs instead of `http:` where possible.
+
+-----------------------------------------------------
+
 Change log for November 30, 2021 Vulkan 1.2.201 spec update:
 
   * Update release number to 201 for this update.

diff --git a/Makefile b/Makefile
@@ -47,7 +47,8 @@ IMAGEOPTS = inline
 #  manhtml - HTML5 single-page reference guide - NOT SUPPORTED
 #  manpdf - PDF reference guide - NOT SUPPORTED
 #  manhtmlpages - HTML5 separate per-feature refpages
-#  allchecks - Python sanity checker for script markup and macro use
+#  allchecks - checks for style guide compliance, XML consistency, and
+#   other easy to catch errors
 
 all: alldocs allchecks
 
@@ -58,14 +59,15 @@ allspecs: html pdf styleguide registry
 allman: manhtmlpages
 
 # CHECK_CONTRACTIONS looks for disallowed contractions
+# reflow.py looks for asciidoctor conditionals inside VU statements;
+#   and for duplicated VUID numbers, but only in spec sources.
 # check_spec_links.py looks for proper use of custom markup macros
 #   --ignore_count 0 can be incremented if there are unfixable errors
 # xml_consistency.py performs various XML consistency checks
 # check_undefined looks for untagged use of 'undefined' in spec sources
-# reflow.py looks for asciidoctor conditionals inside VU statements;
-#   and for duplicated VUID numbers, but only in spec sources.
 CHECK_CONTRACTIONS = git grep -i -F -f config/CI/contractions | egrep -v -E -f config/CI/contractions-allowed
 allchecks:
+	$(PYTHON) $(SCRIPTS)/reflow.py -nowrite -noflow -check FAIL -checkVUID FAIL $(SPECFILES)
 	if test `$(CHECK_CONTRACTIONS) | wc -l` != 0 ; then \
 	    echo "Contractions found that are not allowed:" ; \
 	    $(CHECK_CONTRACTIONS) ; \
@@ -74,7 +76,6 @@ allchecks:
 	$(PYTHON) $(SCRIPTS)/check_spec_links.py -Werror --ignore_count 0
 	$(PYTHON) $(SCRIPTS)/xml_consistency.py
 	$(SCRIPTS)/ci/check_undefined
-	$(PYTHON) $(SCRIPTS)/reflow.py -nowrite -noflow -check FAIL -checkVUID FAIL $(SPECFILES)
 
 # Note that the := assignments below are immediate, not deferred, and
 # are therefore order-dependent in the Makefile
@@ -127,7 +128,7 @@ VERBOSE =
 # ADOCOPTS options for asciidoc->HTML5 output
 
 NOTEOPTS     = -a editing-notes -a implementation-guide
-PATCHVERSION = 201
+PATCHVERSION = 202
 
 ifneq (,$(findstring VK_VERSION_1_2,$(VERSIONS)))
 SPECMINOR = 2
@@ -154,9 +155,6 @@ SPECDATE     = $(shell echo `date -u "+%Y-%m-%d %TZ"`)
 SPECREMARK = from git branch: $(shell echo `git symbolic-ref --short HEAD 2> /dev/null || echo Git branch not available`) \
 	     commit: $(shell echo `git log -1 --format="%H" 2> /dev/null || echo Git commit not available`)
 
-# Base path to SPIR-V extensions on the web.
-SPIRVPATH = https://htmlpreview.github.io/?https://github.com/KhronosGroup/SPIRV-Registry/blob/master/extensions
-
 # Some of the attributes used in building all spec documents:
 #   chapters - absolute path to chapter sources
 #   appendices - absolute path to appendix sources
@@ -176,7 +174,6 @@ ATTRIBOPTS   = -a revnumber="$(SPECREVISION)" \
 	       -a chapters=$(CURDIR)/chapters \
 	       -a images=$(IMAGEPATH) \
 	       -a generated=$(GENERATED) \
-	       -a spirv="$(SPIRVPATH)" \
 	       -a refprefix \
 	       $(VERSIONATTRIBS) \
 	       $(EXTATTRIBS) \

diff --git a/appendices/VK_AMD_gcn_shader.txt b/appendices/VK_AMD_gcn_shader.txt
@@ -14,7 +14,7 @@ include::{generated}/meta/{refprefix}VK_AMD_gcn_shader.txt[]
   - This extension requires
     {spirv}/AMD/SPV_AMD_gcn_shader.html[`SPV_AMD_gcn_shader`]
   - This extension provides API support for
-    https://www.khronos.org/registry/OpenGL/extensions/AMD/AMD_gcn_shader.txt[`GL_AMD_gcn_shader`]
+    {GLregistry}/AMD/AMD_gcn_shader.txt[`GL_AMD_gcn_shader`]
 *Contributors*::
   - Dominik Witczak, AMD
   - Daniel Rakos, AMD

diff --git a/appendices/VK_AMD_gpu_shader_half_float.txt b/appendices/VK_AMD_gpu_shader_half_float.txt
@@ -14,7 +14,7 @@ include::{generated}/meta/{refprefix}VK_AMD_gpu_shader_half_float.txt[]
   - This extension requires
     {spirv}/AMD/SPV_AMD_gpu_shader_half_float.html[`SPV_AMD_gpu_shader_half_float`]
   - This extension provides API support for
-    https://www.khronos.org/registry/OpenGL/extensions/AMD/AMD_gpu_shader_half_float.txt[`GL_AMD_gpu_shader_half_float`]
+    {GLregistry}/AMD/AMD_gpu_shader_half_float.txt[`GL_AMD_gpu_shader_half_float`]
 *Contributors*::
   - Daniel Rakos, AMD
   - Dominik Witczak, AMD

diff --git a/appendices/VK_AMD_gpu_shader_int16.txt b/appendices/VK_AMD_gpu_shader_int16.txt
@@ -14,7 +14,7 @@ include::{generated}/meta/{refprefix}VK_AMD_gpu_shader_int16.txt[]
   - This extension requires
     {spirv}/AMD/SPV_AMD_gpu_shader_int16.html[`SPV_AMD_gpu_shader_int16`]
   - This extension provides API support for
-    https://www.khronos.org/registry/OpenGL/extensions/AMD/AMD_gpu_shader_int16.txt[`GL_AMD_gpu_shader_int16`]
+    {GLregistry}/AMD/AMD_gpu_shader_int16.txt[`GL_AMD_gpu_shader_int16`]
 *Contributors*::
   - Daniel Rakos, AMD
   - Dominik Witczak, AMD

diff --git a/appendices/VK_AMD_shader_ballot.txt b/appendices/VK_AMD_shader_ballot.txt
@@ -14,7 +14,7 @@ include::{generated}/meta/{refprefix}VK_AMD_shader_ballot.txt[]
   - This extension requires
     {spirv}/AMD/SPV_AMD_shader_ballot.html[`SPV_AMD_shader_ballot`]
   - This extension provides API support for
-    https://www.khronos.org/registry/OpenGL/extensions/AMD/AMD_shader_ballot.txt[`GL_AMD_shader_ballot`]
+    {GLregistry}/AMD/AMD_shader_ballot.txt[`GL_AMD_shader_ballot`]
 *Contributors*::
   - Qun Lin, AMD
   - Graham Sellers, AMD

diff --git a/appendices/VK_AMD_shader_explicit_vertex_parameter.txt b/appendices/VK_AMD_shader_explicit_vertex_parameter.txt
@@ -14,7 +14,7 @@ include::{generated}/meta/{refprefix}VK_AMD_shader_explicit_vertex_parameter.txt
   - This extension requires
     {spirv}/AMD/SPV_AMD_shader_explicit_vertex_parameter.html[`SPV_AMD_shader_explicit_vertex_parameter`]
   - This extension provides API support for
-    https://www.khronos.org/registry/OpenGL/extensions/AMD/AMD_shader_explicit_vertex_parameter.txt[`GL_AMD_shader_explicit_vertex_parameter`]
+    {GLregistry}/AMD/AMD_shader_explicit_vertex_parameter.txt[`GL_AMD_shader_explicit_vertex_parameter`]
 *Contributors*::
   - Matthaeus G. Chajdas, AMD
   - Qun Lin, AMD

diff --git a/appendices/VK_AMD_shader_fragment_mask.txt b/appendices/VK_AMD_shader_fragment_mask.txt
@@ -14,7 +14,7 @@ include::{generated}/meta/{refprefix}VK_AMD_shader_fragment_mask.txt[]
   - This extension requires
     {spirv}/AMD/SPV_AMD_shader_fragment_mask.html[`SPV_AMD_shader_fragment_mask`]
   - This extension provides API support for
-    https://github.com/KhronosGroup/GLSL/blob/master/extensions/amd/GL_AMD_shader_fragment_mask.txt[`GL_AMD_shader_fragment_mask`]
+    {GLSLregistry}/amd/GL_AMD_shader_fragment_mask.txt[`GL_AMD_shader_fragment_mask`]
 *Contributors*::
   - Aaron Hagan, AMD
   - Daniel Rakos, AMD

diff --git a/appendices/VK_AMD_shader_image_load_store_lod.txt b/appendices/VK_AMD_shader_image_load_store_lod.txt
@@ -12,7 +12,7 @@ include::{generated}/meta/{refprefix}VK_AMD_shader_image_load_store_lod.txt[]
   - This extension requires
     {spirv}/AMD/SPV_AMD_shader_image_load_store_lod.html[`SPV_AMD_shader_image_load_store_lod`]
   - This extension provides API support for
-    https://www.khronos.org/registry/OpenGL/extensions/AMD/AMD_shader_image_load_store_lod.txt[`GL_AMD_shader_image_load_store_lod`]
+    {GLregistry}/AMD/AMD_shader_image_load_store_lod.txt[`GL_AMD_shader_image_load_store_lod`]
 *IP Status*::
     No known IP claims.
 *Contributors*::

diff --git a/appendices/VK_AMD_shader_trinary_minmax.txt b/appendices/VK_AMD_shader_trinary_minmax.txt
@@ -14,7 +14,7 @@ include::{generated}/meta/{refprefix}VK_AMD_shader_trinary_minmax.txt[]
   - This extension requires
     {spirv}/AMD/SPV_AMD_shader_trinary_minmax.html[`SPV_AMD_shader_trinary_minmax`]
   - This extension provides API support for
-    https://www.khronos.org/registry/OpenGL/extensions/AMD/AMD_shader_trinary_minmax.txt[`GL_AMD_shader_trinary_minmax`]
+    {GLregistry}/AMD/AMD_shader_trinary_minmax.txt[`GL_AMD_shader_trinary_minmax`]
 *Contributors*::
   - Matthaeus G. Chajdas, AMD
   - Qun Lin, AMD

diff --git a/appendices/VK_AMD_texture_gather_bias_lod.txt b/appendices/VK_AMD_texture_gather_bias_lod.txt
@@ -14,7 +14,7 @@ include::{generated}/meta/{refprefix}VK_AMD_texture_gather_bias_lod.txt[]
   - This extension requires
     {spirv}/AMD/SPV_AMD_texture_gather_bias_lod.html[`SPV_AMD_texture_gather_bias_lod`]
   - This extension provides API support for
-    https://www.khronos.org/registry/OpenGL/extensions/AMD/AMD_texture_gather_bias_lod.txt[`GL_AMD_texture_gather_bias_lod`]
+    {GLregistry}/AMD/AMD_texture_gather_bias_lod.txt[`GL_AMD_texture_gather_bias_lod`]
 *Contributors*::
   - Dominik Witczak, AMD
   - Daniel Rakos, AMD

diff --git a/appendices/VK_EXT_buffer_device_address.txt b/appendices/VK_EXT_buffer_device_address.txt
@@ -14,9 +14,9 @@ include::{generated}/meta/{refprefix}VK_EXT_buffer_device_address.txt[]
   - This extension requires
     {spirv}/EXT/SPV_EXT_physical_storage_buffer.html[`SPV_EXT_physical_storage_buffer`]
   - This extension provides API support for
-    https://github.com/KhronosGroup/GLSL/blob/master/extensions/ext/GLSL_EXT_buffer_reference.txt[`GLSL_EXT_buffer_reference`]
+    {GLSLregistry}/ext/GLSL_EXT_buffer_reference.txt[`GLSL_EXT_buffer_reference`]
     and
-    https://github.com/KhronosGroup/GLSL/blob/master/extensions/ext/GLSL_EXT_buffer_reference_uvec2.txt[`GLSL_EXT_buffer_reference_uvec2`]
+    {GLSLregistry}/ext/GLSL_EXT_buffer_reference_uvec2.txt[`GLSL_EXT_buffer_reference_uvec2`]
 *Contributors*::
   - Jeff Bolz, NVIDIA
   - Neil Henning, AMD
@@ -29,7 +29,7 @@ include::{generated}/meta/{refprefix}VK_EXT_buffer_device_address.txt[]
 This extension allows the application to query a 64-bit buffer device
 address value for a buffer, which can be used to access the buffer memory
 via the code:PhysicalStorageBufferEXT storage class in the
-https://github.com/KhronosGroup/GLSL/blob/master/extensions/ext/GLSL_EXT_buffer_reference.txt[`GL_EXT_buffer_reference`]
+{GLSLregistry}/ext/GLSL_EXT_buffer_reference.txt[`GL_EXT_buffer_reference`]
 GLSL extension and
 {spirv}/EXT/SPV_EXT_physical_storage_buffer.html[`SPV_EXT_physical_storage_buffer`]
 SPIR-V extension.

diff --git a/appendices/VK_EXT_conservative_rasterization.txt b/appendices/VK_EXT_conservative_rasterization.txt
@@ -20,7 +20,7 @@ include::{generated}/meta/{refprefix}VK_EXT_conservative_rasterization.txt[]
     sname:VkPhysicalDeviceConservativeRasterizationPropertiesEXT::pname:conservativeRasterizationPostDepthCoverage
     feature is used.
   - This extension provides API support for
-    https://www.khronos.org/registry/OpenGL/extensions/NV/NV_conservative_raster_underestimation.txt[`GL_NV_conservative_raster_underestimation`]
+    {GLregistry}/NV/NV_conservative_raster_underestimation.txt[`GL_NV_conservative_raster_underestimation`]
     if the
     sname:VkPhysicalDeviceConservativeRasterizationPropertiesEXT::pname:fullyCoveredFragmentShaderInputVariable
     feature is used.

diff --git a/appendices/VK_EXT_descriptor_indexing.txt b/appendices/VK_EXT_descriptor_indexing.txt
@@ -13,7 +13,7 @@ include::{generated}/meta/{refprefix}VK_EXT_descriptor_indexing.txt[]
   - This extension requires
     {spirv}/EXT/SPV_EXT_descriptor_indexing.html[`SPV_EXT_descriptor_indexing`]
   - This extension provides API support for
-    https://github.com/KhronosGroup/GLSL/blob/master/extensions/ext/GL_EXT_nonuniform_qualifier.txt[`GL_EXT_nonuniform_qualifier`]
+    {GLSLregistry}/ext/GL_EXT_nonuniform_qualifier.txt[`GL_EXT_nonuniform_qualifier`]
 *Contributors*::
   - Jeff Bolz, NVIDIA
   - Daniel Rakos, AMD

diff --git a/appendices/VK_EXT_fragment_density_map.txt b/appendices/VK_EXT_fragment_density_map.txt
@@ -12,7 +12,7 @@ include::{generated}/meta/{refprefix}VK_EXT_fragment_density_map.txt[]
   - This extension requires
     {spirv}/EXT/SPV_EXT_fragment_invocation_density.html[`SPV_EXT_fragment_invocation_density`]
   - This extension provides API support for
-    https://github.com/KhronosGroup/GLSL/blob/master/extensions/ext/GLSL_EXT_fragment_invocation_density.txt[`GL_EXT_fragment_invocation_density`]
+    {GLSLregistry}/ext/GLSL_EXT_fragment_invocation_density.txt[`GL_EXT_fragment_invocation_density`]
 *Contributors*::
   - Matthew Netsch, Qualcomm Technologies, Inc.
   - Robert VanReenen, Qualcomm Technologies, Inc.

diff --git a/appendices/VK_EXT_fragment_shader_interlock.txt b/appendices/VK_EXT_fragment_shader_interlock.txt
@@ -12,7 +12,7 @@ include::{generated}/meta/{refprefix}VK_EXT_fragment_shader_interlock.txt[]
   - This extension requires
     {spirv}/EXT/SPV_EXT_fragment_shader_interlock.html[`SPV_EXT_fragment_shader_interlock`]
   - This extension provides API support for
-    https://www.khronos.org/registry/OpenGL/extensions/ARB/ARB_fragment_shader_interlock.txt[`GL_ARB_fragment_shader_interlock`]
+    {GLregistry}/ARB/ARB_fragment_shader_interlock.txt[`GL_ARB_fragment_shader_interlock`]
 *Contributors*::
   - Daniel Koch, NVIDIA
   - Graeme Leese, Broadcom

diff --git a/appendices/VK_EXT_post_depth_coverage.txt b/appendices/VK_EXT_post_depth_coverage.txt
@@ -12,9 +12,9 @@ include::{generated}/meta/{refprefix}VK_EXT_post_depth_coverage.txt[]
   - This extension requires
     {spirv}/KHR/SPV_KHR_post_depth_coverage.html[`SPV_KHR_post_depth_coverage`]
   - This extension provides API support for
-    https://www.khronos.org/registry/OpenGL/extensions/ARB/ARB_post_depth_coverage.txt[`GL_ARB_post_depth_coverage`]
+    {GLregistry}/ARB/ARB_post_depth_coverage.txt[`GL_ARB_post_depth_coverage`]
     and
-    https://www.khronos.org/registry/OpenGL/extensions/EXT/EXT_post_depth_coverage.txt[`GL_EXT_post_depth_coverage`]
+    {GLregistry}/EXT/EXT_post_depth_coverage.txt[`GL_EXT_post_depth_coverage`]
 *Contributors*::
   - Jeff Bolz, NVIDIA
 

diff --git a/appendices/VK_EXT_shader_atomic_float.txt b/appendices/VK_EXT_shader_atomic_float.txt
@@ -14,7 +14,7 @@ include::{generated}/meta/{refprefix}VK_EXT_shader_atomic_float.txt[]
   - This extension requires
     {spirv}/EXT/SPV_EXT_shader_atomic_float_add.html[`SPV_EXT_shader_atomic_float_add`]
   - This extension provides API support for
-    https://github.com/KhronosGroup/GLSL/tree/master/extensions/ext/GLSL_EXT_shader_atomic_float.txt[`GL_EXT_shader_atomic_float`]
+    {GLSLregistry}/ext/GLSL_EXT_shader_atomic_float.txt[`GL_EXT_shader_atomic_float`]
 *Contributors*::
   - Vikram Kushwaha, NVIDIA
   - Jeff Bolz, NVIDIA

diff --git a/appendices/VK_EXT_shader_atomic_float2.txt b/appendices/VK_EXT_shader_atomic_float2.txt
@@ -17,7 +17,7 @@ include::{generated}/meta/{refprefix}VK_EXT_shader_atomic_float2.txt[]
     and
     {spirv}/EXT/SPV_EXT_shader_atomic_float16_add.html[`SPV_EXT_shader_atomic_float16_add`]
   - This extension provides API support for
-    https://github.com/KhronosGroup/GLSL/blob/master/extensions/ext/GLSL_EXT_shader_atomic_float2.txt[`GLSL_EXT_shader_atomic_float2`]
+    {GLSLregistry}/ext/GLSL_EXT_shader_atomic_float2.txt[`GLSL_EXT_shader_atomic_float2`]
 *Contributors*::
   - Jason Ekstrand, Intel
 

diff --git a/appendices/VK_EXT_shader_demote_to_helper_invocation.txt b/appendices/VK_EXT_shader_demote_to_helper_invocation.txt
@@ -14,7 +14,7 @@ include::{generated}/meta/{refprefix}VK_EXT_shader_demote_to_helper_invocation.t
   - This extension requires
     {spirv}/EXT/SPV_EXT_demote_to_helper_invocation.html[`SPV_EXT_demote_to_helper_invocation`]
   - This extension provides API support for
-    https://github.com/KhronosGroup/GLSL/blob/master/extensions/ext/GLSL_EXT_demote_to_helper_invocation.txt[`GL_EXT_demote_to_helper_invocation`]
+    {GLSLregistry}/ext/GLSL_EXT_demote_to_helper_invocation.txt[`GL_EXT_demote_to_helper_invocation`]
 *Contributors*::
   - Jeff Bolz, NVIDIA
 

diff --git a/appendices/VK_EXT_shader_image_atomic_int64.txt b/appendices/VK_EXT_shader_image_atomic_int64.txt
@@ -14,7 +14,7 @@ include::{generated}/meta/{refprefix}VK_EXT_shader_image_atomic_int64.txt[]
   - This extension requires
     {spirv}/EXT/SPV_EXT_shader_image_int64.html[`SPV_EXT_shader_image_int64`]
   - This extension provides API support for
-    https://github.com/KhronosGroup/GLSL/blob/master/extensions/ext/GLSL_EXT_shader_image_int64.txt[`GLSL_EXT_shader_image_int64`]
+    {GLSLregistry}/ext/GLSL_EXT_shader_image_int64.txt[`GLSL_EXT_shader_image_int64`]
 *Contributors*::
   - Matthaeus Chajdas, AMD
   - Graham Wihlidal, Epic Games

diff --git a/appendices/VK_EXT_shader_stencil_export.txt b/appendices/VK_EXT_shader_stencil_export.txt
@@ -14,7 +14,7 @@ include::{generated}/meta/{refprefix}VK_EXT_shader_stencil_export.txt[]
   - This extension requires
     {spirv}/EXT/SPV_EXT_shader_stencil_export.html[`SPV_EXT_shader_stencil_export`]
   - This extension provides API support for
-    https://www.khronos.org/registry/OpenGL/extensions/ARB/ARB_shader_stencil_export.txt[`GL_ARB_shader_stencil_export`]
+    {GLregistry}/ARB/ARB_shader_stencil_export.txt[`GL_ARB_shader_stencil_export`]
 *Contributors*::
   - Dominik Witczak, AMD
   - Daniel Rakos, AMD

diff --git a/appendices/VK_EXT_shader_subgroup_ballot.txt b/appendices/VK_EXT_shader_subgroup_ballot.txt
@@ -14,7 +14,7 @@ include::{generated}/meta/{refprefix}VK_EXT_shader_subgroup_ballot.txt[]
   - This extension requires
     {spirv}/KHR/SPV_KHR_shader_ballot.html[`SPV_KHR_shader_ballot`]
   - This extension provides API support for
-    https://www.khronos.org/registry/OpenGL/extensions/ARB/ARB_shader_ballot.txt[`GL_ARB_shader_ballot`]
+    {GLregistry}/ARB/ARB_shader_ballot.txt[`GL_ARB_shader_ballot`]
 *Contributors*::
   - Jeff Bolz, NVIDIA
   - Neil Henning, Codeplay

diff --git a/appendices/VK_EXT_shader_subgroup_vote.txt b/appendices/VK_EXT_shader_subgroup_vote.txt
@@ -14,7 +14,7 @@ include::{generated}/meta/{refprefix}VK_EXT_shader_subgroup_vote.txt[]
   - This extension requires
     {spirv}/KHR/SPV_KHR_subgroup_vote.html[`SPV_KHR_subgroup_vote`]
   - This extension provides API support for
-    https://www.khronos.org/registry/OpenGL/extensions/ARB/ARB_shader_group_vote.txt[`GL_ARB_shader_group_vote`]
+    {GLregistry}/ARB/ARB_shader_group_vote.txt[`GL_ARB_shader_group_vote`]
 *Contributors*::
   - Neil Henning, Codeplay
   - Daniel Koch, NVIDIA Corporation