142 lines
5.2 KiB
Python
Executable File
142 lines
5.2 KiB
Python
Executable File
#!/usr/bin/python3
|
|
#
|
|
# Copyright (c) 2016-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.
|
|
|
|
# Ensure config/extDependency.py is up-to-date before we import it.
|
|
# If it is up to date, 'make' will print a useless warning without '-s'.
|
|
import argparse,subprocess,sys
|
|
subprocess.check_call(['make', '-s', 'config/extDependency.py'])
|
|
|
|
# Alter sys.path to import config/extDependency.py.
|
|
sys.path = sys.path + [ 'config' ]
|
|
|
|
from genspec import *
|
|
from extDependency import allExts, khrExts
|
|
|
|
# Eventually, these may be defined by extDependency.py
|
|
allVersions = [ 'VK_VERSION_1_0', 'VK_VERSION_1_1' ]
|
|
Version1_0 = [ 'VK_VERSION_1_0' ]
|
|
|
|
if __name__ == '__main__':
|
|
parser = argparse.ArgumentParser()
|
|
|
|
parser.add_argument('-internal', action='store_true',
|
|
help='Generate internal build, not public')
|
|
parser.add_argument('-refpages', action='store_true',
|
|
help='Generate refpages')
|
|
parser.add_argument('-pdf', action='store_true',
|
|
help='Always generate PDF outputs')
|
|
parser.add_argument('-nov11', action='store_false', dest='v11',
|
|
help='Suppress Vulkan 1.1 targets')
|
|
parser.add_argument('-v10', action='store_true',
|
|
help='Generate Vulkan 1.0 targets')
|
|
|
|
args = parser.parse_args()
|
|
|
|
if args.internal:
|
|
# For internal build & pseudo-release
|
|
repoDir = '/home/tree/git/vulkan'
|
|
outDir = '/home/tree/git/vulkan/doc/specs/vulkan/out'
|
|
else:
|
|
# For public release
|
|
repoDir = '/home/tree/git/Vulkan-Docs'
|
|
outDir = '/home/tree/git/registry/vulkan/specs'
|
|
|
|
# Always build PDF for public releases
|
|
args.pdf = True
|
|
|
|
if args.refpages:
|
|
refPageTargets = ' manhtml manhtmlpages'
|
|
if args.pdf:
|
|
refPageTargets += ' manpdf'
|
|
else:
|
|
refPageTargets = ''
|
|
print('echo Info: Not building reference pages yet')
|
|
|
|
specTargets = ' html'
|
|
if args.pdf:
|
|
specTargets += ' pdf'
|
|
|
|
print('echo Info: Building release from', repoDir, 'to', outDir)
|
|
print('echo Info: Building spec targets', specTargets)
|
|
print('')
|
|
|
|
# Vulkan 1.1 specs
|
|
if args.v11:
|
|
# Build validusage target only for 1.1 + all extensions
|
|
buildBranch('1.1-extensions',
|
|
versions = allVersions,
|
|
extensions = allExts,
|
|
apititle = '(with all registered Vulkan extensions)',
|
|
xmlTargets = 'clobber install',
|
|
specTargets = specTargets + ' validusage',
|
|
repoDir = repoDir,
|
|
outDir = outDir)
|
|
|
|
buildBranch('1.1-khr-extensions',
|
|
versions = allVersions,
|
|
extensions = khrExts,
|
|
apititle = '(with KHR extensions)',
|
|
xmlTargets = 'clobber install',
|
|
specTargets = specTargets,
|
|
repoDir = repoDir,
|
|
outDir = outDir)
|
|
|
|
# Build ref pages, style guide, and registry documentation targets only for
|
|
# 1.1 + no extensions.
|
|
buildBranch('1.1',
|
|
versions = allVersions,
|
|
extensions = None,
|
|
apititle = None,
|
|
xmlTargets = 'clobber install',
|
|
specTargets = specTargets + ' styleguide registry' + refPageTargets,
|
|
repoDir = repoDir,
|
|
outDir = outDir,
|
|
needRefSources = True)
|
|
|
|
# Vulkan 1.0 specs. Only build the core spec now that 1.1 is out.
|
|
if args.v10:
|
|
# buildBranch('1.0-extensions',
|
|
# versions = Version1_0,
|
|
# extensions = allExts,
|
|
# apititle = '(with all registered Vulkan extensions)',
|
|
# xmlTargets = 'clobber install',
|
|
# specTargets = specTargets,
|
|
# repoDir = repoDir,
|
|
# outDir = outDir)
|
|
#
|
|
# buildBranch('1.0-wsi_extensions',
|
|
# versions = Version1_0,
|
|
# extensions = khrExts,
|
|
# apititle = '(with KHR extensions)',
|
|
# xmlTargets = 'clobber install',
|
|
# specTargets = specTargets,
|
|
# repoDir = repoDir,
|
|
# outDir = outDir)
|
|
|
|
buildBranch('1.0',
|
|
versions = Version1_0,
|
|
extensions = None,
|
|
apititle = None,
|
|
xmlTargets = 'clobber install',
|
|
specTargets = specTargets,
|
|
repoDir = repoDir,
|
|
outDir = outDir)
|
|
else:
|
|
print('echo Info: Not building 1.0 specs yet')
|
|
|
|
print('echo Info: post-generation cleanup')
|
|
createTags(releaseNum(), buildOnFriday())
|