| #!/usr/bin/python3 |
| # |
| # Copyright 2016-2021 The Khronos Group Inc. |
| # |
| # SPDX-License-Identifier: Apache-2.0 |
| |
| import argparse |
| import subprocess |
| import sys |
| |
| from genspec import * |
| |
| # Eventually, these may be defined by extDependency.py |
| allVersions = [ 'VK_VERSION_1_0', 'VK_VERSION_1_1', 'VK_VERSION_1_2' ] |
| Version1_1 = [ '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('-norefpages', action='store_true', |
| help='Do not generate refpages') |
| parser.add_argument('-singlerefpage', action='store_true', |
| help='Generate single-page refpage - NOT SUPPORTED') |
| parser.add_argument('-chunked', action='store_true', |
| help='Generate chunked HTML outputs') |
| parser.add_argument('-pdf', action='store_true', |
| help='Generate PDF outputs') |
| |
| parser.add_argument('-nov12', action='store_false', dest='v12', |
| help='Suppress Vulkan 1.2 targets') |
| parser.add_argument('-v11', action='store_true', |
| help='Generate Vulkan 1.1 targets') |
| parser.add_argument('-v10', action='store_true', |
| help='Generate Vulkan 1.0 targets') |
| |
| parser.add_argument('-nocorespec', action='store_false', dest='corespec', |
| help='Do not generate core API-only targets') |
| parser.add_argument('-nokhrspec', action='store_false', dest='khrspec', |
| help='Do not generate core API + KHR extensions-only targets') |
| parser.add_argument('-noallspec', action='store_false', dest='allspec', |
| help='Do not generate full API + all extensions targets') |
| |
| parser.add_argument('-genpath', action='store', |
| default='gen', |
| help='Path to directory containing generated files') |
| parser.add_argument('-repodir', action='store', dest='repoDir', |
| default=None, |
| help='Set the repository directory to build from (overrides defaults)') |
| parser.add_argument('-outdir', action='store', dest='outDir', |
| default=None, |
| help='Set the output directory to build into (overrides defaults)') |
| |
| args = parser.parse_args() |
| |
| # Ensure gen/extDependency.py is up-to-date before we import it. |
| # If it is up to date, 'make' will print a useless warning without '-s'. |
| subprocess.check_call(['make', '-s', 'GENERATED=' + args.genpath, 'extDependency']) |
| |
| # Alter sys.path to import extDependency.py |
| sys.path.insert(0, args.genpath) |
| |
| from extDependency import allExts, khrExts |
| |
| if args.internal: |
| # For internal build & pseudo-release |
| if args.repoDir == None: |
| args.repoDir = '/home/tree/git/vulkan' |
| if args.outDir == None: |
| args.outDir = '/home/tree/git/vulkan/out' |
| else: |
| # For public release |
| if args.repoDir == None: |
| args.repoDir = '/home/tree/git/Vulkan-Docs' |
| if args.outDir == None: |
| args.outDir = '/home/tree/git/registry/vulkan/specs' |
| |
| refPageTargets = '' |
| |
| if not args.norefpages: |
| # Generate separate reference pages |
| refPageTargets += ' manhtmlpages' |
| |
| if args.singlerefpage: |
| # Generate single-page refpage. |
| refPageTargets += ' manhtml' |
| if args.pdf: |
| refPageTargets += ' manpdf' |
| print('echo Info: single-page refpage targets are NOT SUPPORTED') |
| |
| specTargets = ' html' |
| if args.chunked: |
| specTargets += ' chunked' |
| if args.pdf: |
| specTargets += ' pdf' |
| |
| print('echo Info: Building release from', args.repoDir, 'to', args.outDir) |
| print('echo Info: Building spec targets', specTargets) |
| print('') |
| |
| # Current Vulkan 1.2 specs |
| if args.v12: |
| if args.allspec: |
| # Build ref pages and validusage targets only for 1.2 + all exts |
| # Formerly set xmlTargets = 'clobber install', but we no longer |
| # generate headers in the registry tree. |
| buildBranch(targetDir = '1.2-extensions', |
| versions = allVersions, |
| extensions = allExts, |
| ratified = False, |
| apititle = '(with all registered Vulkan extensions)', |
| specTargets = specTargets + ' validusage' + refPageTargets, |
| repoDir = args.repoDir, |
| outDir = args.outDir) |
| |
| if args.khrspec: |
| buildBranch(targetDir = '1.2-khr-extensions', |
| versions = allVersions, |
| extensions = khrExts, |
| ratified = True, |
| apititle = '(with KHR extensions)', |
| specTargets = specTargets, |
| repoDir = args.repoDir, |
| outDir = args.outDir) |
| |
| if args.corespec: |
| # Build style guide and registry documentation targets only for 1.2 |
| # + no extensions. |
| buildBranch(targetDir = '1.2', |
| versions = allVersions, |
| extensions = None, |
| ratified = True, |
| apititle = None, |
| specTargets = specTargets + ' styleguide registry', |
| repoDir = args.repoDir, |
| outDir = args.outDir, |
| needRefSources = True) |
| |
| # Vulkan 1.1 specs |
| if args.v11: |
| if args.allspec: |
| buildBranch(targetDir = '1.1-extensions', |
| versions = Version1_1, |
| extensions = allExts, |
| ratified = False, |
| apititle = '(with all registered Vulkan extensions)', |
| specTargets = specTargets, |
| repoDir = args.repoDir, |
| outDir = args.outDir) |
| |
| if args.khrspec: |
| buildBranch(targetDir = '1.1-khr-extensions', |
| versions = Version1_1, |
| extensions = khrExts, |
| ratified = True, |
| apititle = '(with KHR extensions)', |
| specTargets = specTargets, |
| repoDir = args.repoDir, |
| outDir = args.outDir) |
| |
| if args.corespec: |
| buildBranch(targetDir = '1.1', |
| versions = Version1_1, |
| extensions = None, |
| ratified = True, |
| apititle = None, |
| specTargets = specTargets, |
| repoDir = args.repoDir, |
| outDir = args.outDir) |
| else: |
| print('echo Info: Not building 1.1 specs yet') |
| |
| |
| # Vulkan 1.0 specs. |
| if args.v10: |
| if args.allspec: |
| buildBranch(targetDir = '1.0-extensions', |
| versions = Version1_0, |
| extensions = allExts, |
| ratified = False, |
| apititle = '(with all registered Vulkan extensions)', |
| specTargets = specTargets, |
| repoDir = args.repoDir, |
| outDir = args.outDir) |
| |
| if args.khrspec: |
| buildBranch(targetDir = '1.0-wsi_extensions', |
| versions = Version1_0, |
| extensions = khrExts, |
| ratified = True, |
| apititle = '(with KHR extensions)', |
| specTargets = specTargets, |
| repoDir = args.repoDir, |
| outDir = args.outDir) |
| |
| if args.corespec: |
| buildBranch(targetDir = '1.0', |
| versions = Version1_0, |
| extensions = None, |
| ratified = True, |
| apititle = None, |
| specTargets = specTargets, |
| repoDir = args.repoDir, |
| outDir = args.outDir) |
| else: |
| print('echo Info: Not building 1.0 specs yet') |
| |
| print('echo Info: post-generation cleanup') |
| createTags(releaseNum(), buildOnFriday()) |