Vulkan-Docs/xml/Makefile
Jon Leech e24e42dcff Change log for November 4, 2018 Vulkan 1.1.91 spec update:
* Update release number to 91.

Public Issues:

  * Update Ubuntu subsystem build instructions in `BUILD.adoc` (public pull
    request 624).
  * Delete the `VK_KHR_mir_surface` extension from the Specification and
    XML, due to EOL of the only driver known to have supported it, and
    near-EOL of Mir itself (public issue 814).
  * Fix options for some figures that were using old ones (public pull
    request 841).
  * Fix various accidentally repeated words (public pull request 843).
  * Use `time.process_time()`, introduced in Python 3.3, in the scripts
    instead of `time.clock()`, which will be removed in Python 3.8 (public
    pull request 844).

Internal Issues:

  * Update valid usage statements for
    `VK_ANDROID_external_memory_android_hardware_buffer` in
    slink:VkMemoryAllocateInfo,
    slink:VkImportAndroidHardwareBufferInfoANDROID, and
    flink:vkGetAndroidHardwareBufferPropertiesANDROID to actually be
    verifiable (internal issue 1419).
  * Update valid usage statements for
    `VK_ANDROID_external_memory_android_hardware_buffer` in
    slink:VkMemoryAllocateInfo, slink:VkImageCreateInfo, and
    slink:VkImageViewCreateInfo to move valid usage statements in
    doubly-nested bullet points up one level, accomodating limitations of
    the valid usage extraction script that creates `validusage.json`
    (internal issue 1434).
  * Fix typo etext:VK_ACCESS_SHADING_RATE_IMAGE_BIT_NV to the correct
    ename:VK_ACCESS_SHADING_RATE_IMAGE_READ_BIT_NV.
  * Add missing etext:VK_STRUCTURE_TYPE_* tokens to appendices for
    extensions missing them.

New Extensions:

  * `VK_AMD_memory_overallocation_behavior`
  * `VK_NV_ray_tracing`, replacing `VK_NVX_raytracing`
2018-11-03 23:50:13 -07:00

111 lines
3.3 KiB
Makefile

# Copyright (c) 2013-2018 The Khronos Group Inc.
#
# Licensed under the Apache License, Version 2.0 (the "License");
# you may not use this file except in compliance with the License.
# You may obtain a copy of the License at
#
# http://www.apache.org/licenses/LICENSE-2.0
#
# Unless required by applicable law or agreed to in writing, software
# distributed under the License is distributed on an "AS IS" BASIS,
# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
# See the License for the specific language governing permissions and
# limitations under the License.
# If a recipe fails, delete its target file. Without this cleanup, the leftover
# file from the failed recipe can falsely satisfy dependencies on subsequent
# runs of `make`.
.DELETE_ON_ERROR:
# Generator scripts and options
# GENOPTS can be e.g. '-noprotect'
PYTHON ?= python3
PYFILES = genheaders.py reg.py
GENOPTS =
# Generate Vulkan header from XML. Many other files can be generated
# from vk.xml using the scripts, but they are all generated in ../ as
# part of the process of building the Specification.
#
# Targets:
#
# default / install - regenerate headers in ../include/vulkan/.
# validate - run XML validator on vk.xml against the schema.
# test - check if vulkan_core.h compiles.
# clean_dirt - remove intermediate files.
# clean - remove installed and intermediate files.
INCLUDE = ../include
VULKAN = $(INCLUDE)/vulkan
SRC = ../src
# Vulkan platform-specific headers
PLATFORM_HEADERS = \
$(VULKAN)/vulkan_android.h \
$(VULKAN)/vulkan_fuchsia.h \
$(VULKAN)/vulkan_ios.h \
$(VULKAN)/vulkan_macos.h \
$(VULKAN)/vulkan_vi.h \
$(VULKAN)/vulkan_wayland.h \
$(VULKAN)/vulkan_win32.h \
$(VULKAN)/vulkan_xcb.h \
$(VULKAN)/vulkan_xlib.h \
$(VULKAN)/vulkan_xlib_xrandr.h
HEADERS = $(VULKAN)/vulkan_core.h $(PLATFORM_HEADERS)
default install: $(HEADERS)
################################################
# Autogenerate vulkan header from XML API description
# Python and XML files on which vulkan_core.h depends
VKH_DEPENDS = vk.xml genvk.py reg.py generator.py
$(HEADERS): $(VKH_DEPENDS)
$(PYTHON) genvk.py -registry vk.xml -o $(VULKAN) $(notdir $@)
platform: $(PLATFORM_HEADERS)
# Verify registry XML file against the schema
validate:
jing -c registry.rnc vk.xml
# Test that vulkan_core.h compiles
# Platforms to test
TESTDEFS = -DVK_USE_PLATFORM_XCB_KHR -DVK_USE_PLATFORM_XLIB_KHR
test: $(HEADERS) $(VULKAN)/vulkan.h $(VULKAN)/vk_platform.h
gcc -Wall -pedantic -std=c99 -c -I$(INCLUDE) test.c
g++ -Wall -c -std=c++98 -I$(INCLUDE) test.c
g++ -Wall -c -std=c++11 -I$(INCLUDE) test.c
gcc $(TESTDEFS) -Wall -pedantic -std=c99 -c -I$(INCLUDE) test.c
rm test.o
################################################
# Autogenerate extension loader from XML API description
# Also generates $(EXTLOADER)/vulkan_ext.h
# No longer supported.
EXTLOADER = $(SRC)/ext_loader
EXTSRCS = $(EXTLOADER)/vulkan_ext.c
extloader $(EXTSRCS): $(VKH_DEPENDS)
$(PYTHON) genvk.py -registry vk.xml -o $(EXTLOADER) vulkan_ext.c
################################################
# Files to clean up
PYDIRT = diag.txt dumpReg.txt errwarn.txt *.pyc regdump.txt
DIRT = $(PYDIRT) ERRS \#*
# Clean intermediate files
clean_dirt:
-rm -f $(DIRT)
# Clean generated targets as well as intermediates.
clean clobber: clean_dirt
-rm -f $(HEADERS) $(PLATFORM_HEADERS)