Skip to content
Permalink
Browse files

Change log for April 16, 2019 Vulkan 1.1.107 spec update:

  * Update release number to 107.

Public Issues:

  * Fix revision date for the `<<VK_AMD_gpu_shader_half_float>>` appendix
    (public issue 617).
  * Make <<synchronization-pipeline-barriers-subpass-self-dependencies,
    subpass self-dependencies>> less restrictive (public issue 777).
  * Fix the `<<VK_EXT_full_screen_exclusive>>` dependency on
    `<<VK_KHR_win32_surface>>` in `vk.xml` (public pull request 849).
  * Remove single-page (`apispec.html`) refpage sub-targets from the
    Makefile `allman` target and the build instructions. The target is still
    present in the Makefile, but we have not been actively maintaining the
    single-page document and do not promise it will work. The full
    Specification and the individual API reference pages are what we support
    and publish at present (public issue 949).

Internal Issues:

  * De-duplicate common valid usage statements shared by multiple commands
    or structures by using asciidoctor includes and dynamically assigning
    part of the valid usage ID based on which command or structure they're
    being applied to (internal issue 779).
  * Add reference pages for constructs not part of the formal API, such as
    platform calling convention macros, and script changes supporting them
    This required suppressing some check_spec_links warning classes in order
    to pass CI, until a more sophisticated fix can be done (internal issue
    888).
  * Change math notation for the elink:VkPrimitiveTopology descriptions to
    use short forms `v` and `p` instead of `vertex` and `primitive`,
    increasing legibility (internal issue 1611).
  * Rewrite generated file includes relative to a globally specified path,
    fixing some issues with refpage generation (internal issue 1630).
  * Update contributor list for `<<VK_EXT_calibrated_timestamps>>`.
  * Fix use of pathlin in `scripts/generator.py` so the script will work on
    Windows under Python 3.5 (internal merge request 3107).
  * Add missing conditionals around the
    <<descriptorsets-accelerationstructure, Acceleration Structure>>
    section (internal merge request 3108).
  * More script synchronization with OpenXR spec repository (internal merge
    request 3109).
  * Mark the `<<VK_AMD_gpu_shader_half_float>>` and
    `<<VK_AMD_gpu_shader_int16>>` extensions as deprecated in `vk.xml` and
    the corresponding extension appendices (internal merge request 3112).

New Extensions:

  * `<<VK_EXT_headless_surface>>`
  • Loading branch information...
oddhack committed Apr 16, 2019
1 parent be8ac42 commit 5abf83f95d89cf6ba104b4c70d42d5c7c678b630
Showing with 3,604 additions and 4,919 deletions.
  1. +1 −1 .gitlab-ci.yml
  2. +4 −6 BUILD.adoc
  3. +53 −0 ChangeLog.txt
  4. +57 −36 Makefile
  5. +7 −0 appendices/VK_AMD_draw_indirect_count.txt
  6. +12 −12 appendices/VK_AMD_gpu_shader_half_float.txt
  7. +14 −4 appendices/VK_AMD_gpu_shader_int16.txt
  8. +1 −4 appendices/VK_AMD_negative_viewport_height.txt
  9. +1 −0 appendices/VK_EXT_calibrated_timestamps.txt
  10. +62 −0 appendices/VK_EXT_headless_surface.txt
  11. +21 −26 appendices/boilerplate.txt
  12. +2 −2 chapters/VK_AMD_buffer_marker/copies.txt
  13. +7 −7 chapters/VK_AMD_shader_info.txt
  14. +4 −4 chapters/VK_EXT_acquire_xlib_display/acquire_xlib_display.txt
  15. +3 −3 chapters/VK_EXT_blend_operation_advanced/advanced_blend.txt
  16. +16 −16 chapters/VK_EXT_debug_marker.txt
  17. +13 −19 chapters/VK_EXT_debug_report.txt
  18. +38 −38 chapters/VK_EXT_debug_utils.txt
  19. +2 −2 chapters/VK_EXT_direct_mode_display/acquire_release_displays.txt
  20. +5 −5 chapters/VK_EXT_display_control/display_control.txt
  21. +10 −10 chapters/VK_EXT_display_control/fence_events.txt
  22. +4 −4 chapters/VK_EXT_display_control/swapchain_counters.txt
  23. +6 −6 chapters/VK_EXT_display_surface_counter/surface_capabilities.txt
  24. +5 −5 chapters/VK_EXT_hdr_metadata.txt
  25. +64 −0 chapters/VK_EXT_headless_surface/headless.txt
  26. +5 −5 chapters/VK_EXT_metal_surface/platformCreateSurface_metal.txt
  27. +6 −6 chapters/VK_EXT_pipeline_creation_feedback/pipelines.txt
  28. +2 −2 chapters/VK_EXT_validation_cache/shader-module-validation-cache.txt
  29. +4 −4 chapters/VK_EXT_validation_features.txt
  30. +3 −3 chapters/VK_EXT_validation_flags.txt
  31. +4 −4 chapters/VK_FUCHSIA_imagepipe_surface/platformCreateSurface_imagepipe.txt
  32. +2 −2 chapters/VK_GGP_frame_token.txt
  33. +4 −4 chapters/VK_GGP_stream_descriptor_surface/platformCreateSurface_streamdescriptor.txt
  34. +3 −3 chapters/VK_GOOGLE_display_timing/PresentTimeInfo.txt
  35. +7 −7 chapters/VK_GOOGLE_display_timing/queries.txt
  36. +5 −5 chapters/VK_KHR_android_surface/platformCreateSurface_android.txt
  37. +50 −50 chapters/VK_KHR_display/display.txt
  38. +2 −2 chapters/VK_KHR_display_swapchain/create_shared_swapchains.txt
  39. +2 −2 chapters/VK_KHR_display_swapchain/display_swapchain_present.txt
  40. +6 −6 chapters/VK_KHR_incremental_present/wsi.txt
  41. +2 −2 chapters/VK_KHR_shared_presentable_image/wsi.txt
  42. +64 −61 chapters/VK_KHR_surface/wsi.txt
  43. +29 −29 chapters/VK_KHR_swapchain/wsi.txt
  44. +4 −4 chapters/VK_KHR_wayland_surface/platformCreateSurface_wayland.txt
  45. +2 −2 chapters/VK_KHR_wayland_surface/platformQuerySupport_wayland.txt
  46. +4 −4 chapters/VK_KHR_win32_surface/platformCreateSurface_win32.txt
  47. +2 −2 chapters/VK_KHR_win32_surface/platformQuerySupport_win32.txt
  48. +4 −4 chapters/VK_KHR_xcb_surface/platformCreateSurface_xcb.txt
  49. +2 −2 chapters/VK_KHR_xcb_surface/platformQuerySupport_xcb.txt
  50. +4 −4 chapters/VK_KHR_xlib_surface/platformCreateSurface_xlib.txt
  51. +2 −2 chapters/VK_KHR_xlib_surface/platformQuerySupport_xlib.txt
  52. +4 −4 chapters/VK_MVK_ios_surface/platformCreateSurface_ios.txt
  53. +4 −4 chapters/VK_MVK_macos_surface/platformCreateSurface_macos.txt
  54. +4 −4 chapters/VK_NN_vi_surface/platformCreateSurface_vi.txt
  55. +6 −6 chapters/VK_NVX_device_generated_commands/generatedcommands.txt
  56. +8 −8 chapters/VK_NVX_device_generated_commands/generation.txt
  57. +14 −14 chapters/VK_NVX_device_generated_commands/indirectcommands.txt
  58. +26 −26 chapters/VK_NVX_device_generated_commands/objecttable.txt
  59. +6 −6 chapters/VK_NV_clip_space_w_scaling/vertexpostproc.txt
  60. +6 −6 chapters/VK_NV_device_diagnostic_checkpoints/device_diagnostic_checkpoints.txt
  61. +2 −2 chapters/VK_NV_device_diagnostic_checkpoints/queue_checkpoint_properties.txt
  62. +2 −2 chapters/VK_NV_external_memory/allocate_memory.txt
  63. +6 −6 chapters/VK_NV_external_memory_capabilities/external_image_format.txt
  64. +2 −2 chapters/VK_NV_external_memory_win32/get_handle_win32.txt
  65. +2 −2 chapters/VK_NV_external_memory_win32/handle_permissions.txt
  66. +4 −4 chapters/VK_NV_external_memory_win32/import_memory_win32.txt
  67. +18 −466 chapters/VK_NV_mesh_shader/drawing.txt
  68. +2 −2 chapters/VK_NV_ray_tracing/raytracing-descriptors.txt
  69. +11 −11 chapters/VK_NV_ray_tracing/raytracing-pipelines.txt
  70. +34 −34 chapters/VK_NV_ray_tracing/raytracing-resources.txt
  71. +16 −114 chapters/VK_NV_ray_tracing/raytracing.txt
  72. +2 −2 chapters/VK_NV_win32_keyed_mutex/keyed_mutex_submit.txt
  73. +88 −88 chapters/capabilities.txt
  74. +20 −20 chapters/clears.txt
  75. +64 −64 chapters/cmdbuffers.txt
  76. +34 −0 chapters/commonvalidity/draw_common.txt
  77. +116 −0 chapters/commonvalidity/draw_dispatch_common.txt
  78. +15 −0 chapters/commonvalidity/draw_dispatch_indirect_common.txt
  79. +14 −0 chapters/commonvalidity/draw_dispatch_nonindirect_common.txt
  80. +14 −0 chapters/commonvalidity/draw_indirect_count_common.txt
  81. +9 −0 chapters/commonvalidity/draw_indirect_drawcount.txt
  82. +2 −0 chapters/commonvalidity/draw_renderpass_validation.txt
  83. +11 −0 chapters/commonvalidity/draw_vertex_binding.txt
  84. +24 −24 chapters/copies.txt
  85. +1 −1 chapters/debugging.txt
  86. +106 −104 chapters/descriptorsets.txt
  87. +71 −71 chapters/devsandqueues.txt
  88. +17 −244 chapters/dispatch.txt
  89. +139 −1,597 chapters/drawing.txt
  90. +18 −18 chapters/extensions.txt
  91. +82 −82 chapters/features.txt
  92. +17 −17 chapters/formats.txt
  93. +39 −39 chapters/fragops.txt
  94. +12 −12 chapters/framebuffer.txt
  95. +21 −21 chapters/fundamentals.txt
  96. +14 −14 chapters/fxvertex.txt
  97. +17 −17 chapters/initialization.txt
  98. +63 −63 chapters/limits.txt
  99. +114 −114 chapters/memory.txt
  100. +44 −44 chapters/pipelines.txt
  101. +60 −60 chapters/primsrast.txt
  102. +33 −33 chapters/queries.txt
  103. +87 −87 chapters/renderpass.txt
  104. +150 −150 chapters/resources.txt
  105. +36 −36 chapters/samplers.txt
  106. +27 −27 chapters/shaders.txt
  107. +54 −54 chapters/sparsemem.txt
  108. +123 −120 chapters/synchronization.txt
  109. +12 −12 chapters/tessellation.txt
  110. +10 −10 chapters/textures.txt
  111. +21 −21 chapters/vertexpostproc.txt
  112. +1 −1 config/README.md
  113. +10 −9 config/chunkindex/chunked.css
  114. +2 −1 config/{vulkan-macros.rb → spec-macros.rb}
  115. +12 −7 config/{vulkan-macros → spec-macros}/extension.rb
  116. +14 −5 config/vu-to-json/extension.rb
  117. +6 −5 scripts/check_spec_links.py
  118. +1 −2 scripts/conventions.py
  119. +6 −7 scripts/extensionmetadocgenerator.py
  120. +101 −46 scripts/genRef.py
  121. +3 −2 scripts/genRelease
  122. +2 −2 scripts/generator.py
  123. +17 −13 scripts/genvk.py
  124. +32 −0 scripts/globalizeIncludes
  125. +33 −2 scripts/reflib.py
  126. +24 −10 scripts/reflow.py
  127. +1 −1 scripts/reflow_count.py
  128. +5 −2 scripts/reg.py
  129. +66 −15 scripts/spec_tools/base_printer.py
  130. +43 −24 scripts/spec_tools/console_printer.py
  131. +121 −11 scripts/spec_tools/entity_db.py
  132. +13 −21 scripts/spec_tools/html_printer.py
  133. +10 −14 scripts/spec_tools/macro_checker.py
  134. +23 −20 scripts/spec_tools/macro_checker_file.py
  135. +8 −1 scripts/spec_tools/main.py
  136. +51 −69 scripts/spec_tools/shared.py
  137. +5 −2 scripts/test_check_spec_links.py
  138. +34 −0 scripts/test_check_spec_links_api_specific.py
  139. +216 −158 scripts/validitygenerator.py
  140. +26 −6 scripts/vkconventions.py
  141. +1 −1 style/markup.txt
  142. +76 −13 style/writing.txt
  143. +27 −29 xml/vk.xml
@@ -22,7 +22,7 @@ spec-generate:
# number of them. This is a slightly crude way of enforcing "don't add
# errors" but simpler than the alternatives (running against master,
# diff, etc)
- scripts/check_spec_links.py -Werror --ignore_count 0
- scripts/check_spec_links.py -Werror --ignore_count 0 -Wno_refpage_missing_desc -Wno_refpage_xrefs -Wno_refpage_name -Wno_refpage_unknown_attrib
# Build the actual spec
- ./makeAllExts QUIET= -j${nproc} -Otarget validusage html styleguide registry manhtmlpages
# Build headers, for use by all later stages
@@ -33,8 +33,8 @@ which builds an HTML5 specification output.

$ make all

builds the spec targets `html`, `pdf`, `styleguide`, `registry`, `manhtml`,
`manpdf`, `manhtmlpages`, and `allchecks`
builds the spec targets `html`, `pdf`, `styleguide`, `registry`,
`manhtmlpages`, and `allchecks`

[NOTE]
.Note
@@ -67,8 +67,6 @@ XML Registry schema document::
<<building-diff,Diff spec>>::
* `diff_html` -- Single-file HTML5 in `$(OUTDIR)/html/diff.html`
<<refpages,Reference pages>>::
* `manhtml` -- Single-file HTML in `$(OUTDIR)/apispec.html`
* `manpdf` -- Single-file PDF in `$(OUTDIR)/apispec.pdf`
* `manhtmlpages` -- File-per-entry-point HTML in `$(OUTDIR)/man/html/*`
<<validation-scripts,Validator output>>::
* None at present. The `allchecks` target writes to standard output unless
@@ -226,7 +224,7 @@ 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.

The supported macros are defined in the `config/vulkan-macros/extension.rb`
The supported macros are defined in the `config/spec-macros/extension.rb`
asciidoctor extension script.

The tags used are described in the
@@ -255,7 +253,7 @@ language into corresponding ref page.
Pages without corresponding content in the API spec are generated
automatically, when possible (e.g. for `Vk*FlagBits` pages).

If for some reason you want to regenerate the ref pages from scratch
If for some reason you want to regenerate the ref page sources from scratch
yourself, you can do so by

----
@@ -8,6 +8,59 @@ public pull requests that have been accepted.

-----------------------------------------------------

Change log for April 16, 2019 Vulkan 1.1.107 spec update:

* Update release number to 107.

Public Issues:

* Fix revision date for the `<<VK_AMD_gpu_shader_half_float>>` appendix
(public issue 617).
* Make <<synchronization-pipeline-barriers-subpass-self-dependencies,
subpass self-dependencies>> less restrictive (public issue 777).
* Fix the `<<VK_EXT_full_screen_exclusive>>` dependency on
`<<VK_KHR_win32_surface>>` in `vk.xml` (public pull request 849).
* Remove single-page (`apispec.html`) refpage sub-targets from the
Makefile `allman` target and the build instructions. The target is still
present in the Makefile, but we have not been actively maintaining the
single-page document and do not promise it will work. The full
Specification and the individual API reference pages are what we support
and publish at present (public issue 949).

Internal Issues:

* De-duplicate common valid usage statements shared by multiple commands
or structures by using asciidoctor includes and dynamically assigning
part of the valid usage ID based on which command or structure they're
being applied to (internal issue 779).
* Add reference pages for constructs not part of the formal API, such as
platform calling convention macros, and script changes supporting them
This required suppressing some check_spec_links warning classes in order
to pass CI, until a more sophisticated fix can be done (internal issue
888).
* Change math notation for the elink:VkPrimitiveTopology descriptions to
use short forms `v` and `p` instead of `vertex` and `primitive`,
increasing legibility (internal issue 1611).
* Rewrite generated file includes relative to a globally specified path,
fixing some issues with refpage generation (internal issue 1630).
* Update contributor list for `<<VK_EXT_calibrated_timestamps>>`.
* Fix use of pathlin in `scripts/generator.py` so the script will work on
Windows under Python 3.5 (internal merge request 3107).
* Add missing conditionals around the
<<descriptorsets-accelerationstructure, Acceleration Structure>>
section (internal merge request 3108).
* More script synchronization with OpenXR spec repository (internal merge
request 3109).
* Mark the `<<VK_AMD_gpu_shader_half_float>>` and
`<<VK_AMD_gpu_shader_int16>>` extensions as deprecated in `vk.xml` and
the corresponding extension appendices (internal merge request 3112).

New Extensions:

* `<<VK_EXT_headless_surface>>`

-----------------------------------------------------

Change log for April 7, 2019 Vulkan 1.1.106 spec update:

* Update release number to 106.
@@ -56,8 +56,8 @@ IMAGEOPTS = inline
# pdf - PDF single-page API specification
# styleguide - HTML5 single-page "Documentation and Extensions" guide
# registry - HTML5 single-page XML Registry Schema documentation
# manhtml - HTML5 single-page reference guide
# manpdf - PDF reference guide
# manhtml - HTML5 single-page reference guide - NOT SUPPORTED
# manpdf - PDF reference guide - NOT SUPPORTED
# manhtmlpages - HTML5 separate per-feature reference pages
# allchecks - Python sanity checker for script markup and macro use

@@ -67,7 +67,7 @@ alldocs: allspecs allman

allspecs: html pdf styleguide registry

allman: manhtml manpdf manhtmlpages
allman: manhtmlpages

allchecks:
$(PYTHON) $(SCRIPTS)/check_spec_links.py -Werror
@@ -110,7 +110,7 @@ VERBOSE =
# asciidoc attributes to set (defaults are usually OK)
# NOTEOPTS sets options controlling which NOTEs are generated
# PATCHVERSION must equal VK_HEADER_VERSION from vk.xml
# ATTRIBOPTS sets the api revision and enables KaTeX generation
# ATTRIBOPTS sets the API revision and enables KaTeX generation
# VERSIONATTRIBS sets attributes for enabled API versions (set above
# based on $(VERSIONS))
# EXTATTRIBS sets attributes for enabled extensions (set above based on
@@ -121,7 +121,7 @@ VERBOSE =
# ADOCOPTS options for asciidoc->HTML5 output

NOTEOPTS = -a editing-notes -a implementation-guide
PATCHVERSION = 106
PATCHVERSION = 107
ifneq (,$(findstring VK_VERSION_1_1,$(VERSIONS)))
SPECREVISION = 1.1.$(PATCHVERSION)
else
@@ -141,17 +141,24 @@ 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 information not available`) \
commit: $(shell echo `git log -1 --format="%H"`)

# Some of the attributes used in building all spec documents:
# chapters - absolute path to chapter sources
# images - absolute path to images
# generated - absolute path to generated sources
ATTRIBOPTS = -a revnumber="$(SPECREVISION)" \
-a revdate="$(SPECDATE)" \
-a revremark="$(SPECREMARK)" \
-a apititle="$(APITITLE)" \
-a stem=latexmath \
-a imageopts="$(IMAGEOPTS)" \
-a chapters=$(CURDIR)/chapters \
-a images=$(IMAGEPATH) \
-a generated=$(GENERATED) \
$(VERSIONATTRIBS) \
$(EXTATTRIBS) \
$(EXTRAATTRIBS)
ADOCMISCOPTS = --failure-level ERROR
ADOCEXTS = -r $(CURDIR)/config/vulkan-macros.rb -r $(CURDIR)/config/tilde_open_block.rb
ADOCEXTS = -r $(CURDIR)/config/spec-macros.rb -r $(CURDIR)/config/tilde_open_block.rb
ADOCOPTS = -d book $(ADOCMISCOPTS) $(ATTRIBOPTS) $(NOTEOPTS) $(VERBOSE) $(ADOCEXTS)

ADOCHTMLEXTS = -r $(CURDIR)/config/katex_replace.rb
@@ -176,19 +183,29 @@ ADOCVUOPTS = $(ADOCVUEXTS)
.PHONY: directories

# Images used by the spec. These are included in generated HTML now.
IMAGEPATH :=images
SVGFILES := $(wildcard $(IMAGEPATH)/*.svg)
IMAGEPATH = $(CURDIR)/images
SVGFILES = $(wildcard $(IMAGEPATH)/*.svg)

# Top-level spec source file
SPECSRC := vkspec.txt
# Static files making up sections of the API spec.
SPECFILES = $(wildcard chapters/[A-Za-z]*.txt appendices/[A-Za-z]*.txt chapters/*/[A-Za-z]*.txt appendices/*/[A-Za-z]*.txt)
# Shorthand for where the extension appendix generated files go
METADIR = appendices/meta
# Dynamically generated dependencies of the spec and other targets, from vk.xml
GENDEPENDS = api/timeMarker validity/timeMarker hostsynctable/timeMarker $(METADIR)/timeMarker
# Shorthand for where different types generated files go.
# All can be relocated by overriding GENERATED in the make invocation.
GENERATED = $(CURDIR)/gen
APIPATH = $(GENERATED)/api
VALIDITYPATH = $(GENERATED)/validity
HOSTSYNCPATH = $(GENERATED)/hostsynctable
METAPATH = $(CURDIR)/appendices/meta
# Dynamically generated markers when many generated files are made at once
APIDEPEND = $(APIPATH)/timeMarker
VALIDITYDEPEND = $(VALIDITYPATH)/timeMarker
HOSTSYNCDEPEND = $(HOSTSYNCPATH)/timeMarker
METADEPEND = $(METAPATH)/timeMarker
# All generated dependencies
GENDEPENDS = $(APIDEPEND) $(VALIDITYDEPEND) $(HOSTSYNCDEPEND) $(METADEPEND)
# All non-format-specific dependencies
COMMONDOCS = $(SPECFILES) $(GENDEPENDS)
COMMONDOCS = $(SPECFILES) $(GENDEPENDS)

# Install katex in $(OUTDIR)/katex for reference by all HTML targets
# README.md is a proxy for all the katex files that need to be installed
@@ -219,7 +236,7 @@ chunked: $(HTMLDIR)/vkspec.html $(SPECSRC) $(COMMONDOCS)
$(CHUNKINDEX)/lunr.js $(HTMLDIR)
$(QUIET)$(ROSWELL) $(ROSWELLOPTS) $(CHUNKER) \
$(HTMLDIR)/prechunked.html -o $(HTMLDIR)
$(QUIET)$(RM) prechunked.html
$(QUIET)$(RM) $(HTMLDIR)/prechunked.html
$(QUIET)$(RUBY) $(CHUNKINDEX)/generate-index.rb $(HTMLDIR)/chap*html | \
$(NODEJS) $(CHUNKINDEX)/build-index.js > $(HTMLDIR)/search.index.js

@@ -309,7 +326,7 @@ clean_checks:

MANTRASH = $(filter-out $(MANDIR)/copyright-ccby.txt $(MANDIR)/footer.txt,$(wildcard $(MANDIR)/*.txt)) $(LOGFILE)
clean_generated:
$(QUIET)$(RMRF) api/* hostsynctable/* validity/* $(METADIR)/*
$(QUIET)$(RMRF) $(APIPATH) $(HOSTSYNCPATH) $(VALIDITYPATH) $(METAPATH)
$(QUIET)$(RMRF) include/vulkan/vulkan_*.h $(SCRIPTS)/vkapi.py
$(QUIET)$(RM) config/extDependency.*
$(QUIET)$(RM) $(MANTRASH)
@@ -370,7 +387,8 @@ $(MANHTMLDIR)/%.html: $(MANDIR)/%.txt $(MANCOPYRIGHT) $(GENDEPENDS) katexinst
$(QUIET)$(MKDIR) $(MANHTMLDIR)
$(QUIET)$(ASCIIDOC) -b html5 -a cross-file-links -a html_spec_relative='../../html/vkspec.html' $(ADOCOPTS) $(ADOCHTMLOPTS) -d manpage -o $@ $<

# These targets are HTML5 and PDF single-file versions of the ref pages
# The 'manhtml' and 'manpdf' targets are NO LONGER SUPPORTED by Khronos.
# They generate HTML5 and PDF single-file versions of the ref pages.
# The generated ref page sources are included by man/apispec.txt, and
# are always generated along with man/apispec.txt. Therefore there's no
# need for a recursive $(MAKE) or a $(MANHTML) dependency, unlike the
@@ -400,10 +418,13 @@ $(OUTDIR)/apispec.html: $(SPECVERSION) man/apispec.txt $(MANCOPYRIGHT) $(SVGFILE

# Targets generated from the XML and registry processing scripts
# $(SCRIPTS)/vkapi.py - Python encoding of the registry
# api/timeMarker - proxy for 'apiincludes' - API include files under api/*/*.txt
# hostsynctable/timeMarker - proxy for host sync table include files under hostsynctable/*.txt
# validity/timeMarker - proxy for API validity include files under validity/*/*.txt
# appendices/meta/timeMarker - proxy for extension appendix metadata include files under appendices/*.txt
# The $(...DEPEND) targets are files named 'timeMarker' in generated
# target directories. They serve as proxies for the multiple generated
# files written for each target:
# apiinc / proxy $(APIDEPEND) - API interface include files in $(APIPATH)
# hostsyncinc / proxy $(HOSTSYNCDEPEND) - host sync table include files in $(HOSTSYNCPATH)
# validinc / proxy $(VALIDITYDEPEND) - API validity include files in $(VALIDITYPATH)
# extinc / proxy $(METADEPEND) - extension appendix metadata include files in $(METAPATH)
#
# $(VERSIONOPTIONS) specifies the core API versions which are included
# in these targets, and is set above based on $(VERSIONS)
@@ -423,29 +444,29 @@ GENVKEXTRA =
$(SCRIPTS)/vkapi.py: $(VKXML) $(GENVK)
$(PYTHON) $(GENVK) $(GENVKOPTS) -o scripts vkapi.py

apiinc: api/timeMarker
apiinc: $(APIDEPEND)

api/timeMarker: $(VKXML) $(GENVK)
$(QUIET)$(MKDIR) api
$(QUIET)$(PYTHON) $(GENVK) $(GENVKOPTS) -o api apiinc
$(APIDEPEND): $(VKXML) $(GENVK)
$(QUIET)$(MKDIR) $(APIPATH)
$(QUIET)$(PYTHON) $(GENVK) $(GENVKOPTS) -o $(APIPATH) apiinc

hostsyncinc: hostsynctable/timeMarker
hostsyncinc: $(HOSTSYNCDEPEND)

hostsynctable/timeMarker: $(VKXML) $(GENVK)
$(QUIET)$(MKDIR) hostsynctable
$(QUIET)$(PYTHON) $(GENVK) $(GENVKOPTS) -o hostsynctable hostsyncinc
$(HOSTSYNCDEPEND): $(VKXML) $(GENVK)
$(QUIET)$(MKDIR) $(HOSTSYNCPATH)
$(QUIET)$(PYTHON) $(GENVK) $(GENVKOPTS) -o $(HOSTSYNCPATH) hostsyncinc

validinc: validity/timeMarker
validinc: $(VALIDITYDEPEND)

validity/timeMarker: $(VKXML) $(GENVK)
$(QUIET)$(MKDIR) validity
$(QUIET)$(PYTHON) $(GENVK) $(GENVKOPTS) -o validity validinc
$(VALIDITYDEPEND): $(VKXML) $(GENVK)
$(QUIET)$(MKDIR) $(VALIDITYPATH)
$(QUIET)$(PYTHON) $(GENVK) $(GENVKOPTS) -o $(VALIDITYPATH) validinc

extinc: $(METADIR)/timeMarker
extinc: $(METAPATH)/timeMarker

$(METADIR)/timeMarker: $(VKXML) $(GENVK)
$(QUIET)$(MKDIR) $(METADIR)
$(QUIET)$(PYTHON) $(GENVK) $(GENVKOPTS) -o $(METADIR) extinc
$(METADEPEND): $(VKXML) $(GENVK)
$(QUIET)$(MKDIR) $(METAPATH)
$(QUIET)$(PYTHON) $(GENVK) $(GENVKOPTS) -o $(METAPATH) extinc

# Debugging aid - generate all files from registry XML
# This leaves out config/extDependency.sh intentionally as it only
@@ -21,6 +21,13 @@ execute them without host intervention.
* flink:vkCmdDrawIndirectCountAMD
* flink:vkCmdDrawIndexedIndirectCountAMD

=== Promotion to VK_KHR_draw_indirect_count

All functionality in this extension is included in
<<VK_KHR_draw_indirect_count>>, with the suffix changed to KHR.
The original type, enum and command names are still available as aliases of
the core functionality.

=== Version History

* Revision 2, 2016-08-23 (Dominik Witczak)
@@ -1,7 +1,7 @@
include::meta/VK_AMD_gpu_shader_half_float.txt[]

*Last Modified Date*::
2016-09-21
2019-04-11
*IP Status*::
No known IP claims.
*Contributors*::
@@ -11,21 +11,21 @@ include::meta/VK_AMD_gpu_shader_half_float.txt[]
- Graham Sellers, AMD
- Qun Lin, AMD
- Rex Xu, AMD
*External Dependencies*::
- https://www.khronos.org/registry/spir-v/extensions/AMD/SPV_AMD_gpu_shader_half_float.html[`SPV_AMD_gpu_shader_half_float`]

This extension adds support for the following SPIR-V extension in Vulkan:
This extension adds support for using half float variables in shaders.

* https://www.khronos.org/registry/spir-v/extensions/AMD/SPV_AMD_gpu_shader_half_float.html[`SPV_AMD_gpu_shader_half_float`]
=== Deprecation by VK_KHR_shader_float16_int8

ifdef::editing-notes[]
[NOTE]
.editing-note
====
Shouldn't the SPV extension be in the Interactions and External Dependencies
block?
====
endif::editing-notes[]
Functionality in this extension was included in
<<VK_KHR_shader_float16_int8>> extension, when
slink::VkPhysicalDeviceFloat16Int8FeaturesKHR::pname:shaderFloat16 is
enabled.

=== Version History

* Revision 1, 2019-09-21 (Dominik Witczak)
* Revision 2, 2019-04-11 (Tobias Hector)
- Marked as deprecated
* Revision 1, 2016-09-21 (Dominik Witczak)
- Initial draft
@@ -1,7 +1,7 @@
include::meta/VK_AMD_gpu_shader_int16.txt[]

*Last Modified Date*::
2017-06-08
2019-04-11
*IP Status*::
No known IP claims.
*Interactions and External Dependencies*::
@@ -15,12 +15,22 @@ include::meta/VK_AMD_gpu_shader_int16.txt[]
- Rex Xu, AMD
- Timothy Lottes, AMD
- Zhi Cai, AMD
*External Dependencies*::
- https://www.khronos.org/registry/spir-v/extensions/AMD/SPV_AMD_gpu_shader_int16.html[`SPV_AMD_gpu_shader_int16`]

This extension adds support for the following SPIR-V extension in Vulkan:
This extension adds support for using 16-bit integer variables in shaders.

* `SPV_AMD_gpu_shader_int16`
=== Deprecation by VK_KHR_shader_float16_int8

Functionality in this extension was included in
<<VK_KHR_shader_float16_int8>> extension, when
slink:VkPhysicalDeviceFeatures::pname:shaderInt16 and
slink::VkPhysicalDeviceFloat16Int8FeaturesKHR::pname:shaderFloat16 are
enabled.

=== Version History

* Revision 2, 2019-04-11 (Tobias Hector)
- Marked as deprecated
* Revision 1, 2017-06-18 (Dominik Witczak)
- First version.
- First version

0 comments on commit 5abf83f

Please sign in to comment.
You can’t perform that action at this time.