Name Date Size

..25-Oct-20244 KiB

__init__.py.docsH A D25-Oct-2024887

antora-prep.pyH A D25-Oct-202422 KiB

apiconventions.pyH A D25-Oct-2024556

asciidoctor-chunker/H25-Oct-20244 KiB

cgenerator.pyH A D25-Oct-202422.9 KiB

check_html_xrefs.pyH A D25-Oct-20243.2 KiB

check_spec_links.pyH A D25-Oct-20246.1 KiB

checkXrefsH A D25-Oct-2024657

ci/H25-Oct-20244 KiB

comment_convert.pyH A D25-Oct-20246.6 KiB

compImages.shH A D25-Oct-20242.7 KiB

conventions.pyH A D25-Oct-202410.8 KiB

deperiodize_vuids.pyH A D25-Oct-20241.2 KiB

docgenerator.pyH A D25-Oct-202420.4 KiB

doctransformer.pyH A D25-Oct-202417.9 KiB

extdependency.pyH A D25-Oct-20246.8 KiB

extensionmetadocgenerator.pyH A D25-Oct-202439.9 KiB

formatsgenerator.pyH A D25-Oct-202410.3 KiB

genanchorlinks.pyH A D25-Oct-2024885

generator.pyH A D25-Oct-202453.2 KiB

genRef.pyH A D25-Oct-202439 KiB

genReleaseH A D25-Oct-202410.4 KiB

genspec.pyH A D25-Oct-20245.6 KiB

genvk.pyH A D25-Oct-202445.6 KiB

globalizeIncludesH A D25-Oct-2024753

hostsyncgenerator.pyH A D25-Oct-20245.7 KiB

htmldiff/H25-Oct-20244 KiB

indexExt.pyH A D25-Oct-20243.1 KiB

interfacedocgenerator.pyH A D25-Oct-20245.4 KiB

jsgenerator.pyH A D25-Oct-20243.7 KiB

json_c_generator.pyH A D25-Oct-202426.9 KiB

json_generator.pyH A D25-Oct-202440.7 KiB

json_h_generator.pyH A D25-Oct-20247.4 KiB

json_parser.pyH A D25-Oct-202443 KiB

json_validate.pyH A D25-Oct-20242.9 KiB

linkcheck.pyH A D25-Oct-20242.3 KiB

makemanaliases.pyH A D25-Oct-20242.2 KiB

map_html_anchors.pyH A D25-Oct-20247.8 KiB

parse_dependency.pyH A D25-Oct-202412.7 KiB

promote.pyH A D25-Oct-20246.4 KiB

pygenerator.pyH A D25-Oct-20243.6 KiB

README.adocH A D25-Oct-20244 KiB

reflib.pyH A D25-Oct-202423.7 KiB

reflow-tests/H25-Oct-20244 KiB

reflow.pyH A D25-Oct-202427.9 KiB

reg.pyH A D25-Oct-202483.1 KiB

Retired/H25-Oct-20244 KiB

rubygenerator.pyH A D25-Oct-20244.3 KiB

runDockerH A D25-Oct-20241.2 KiB

schema_generator.pyH A D25-Oct-202411.5 KiB

scriptgenerator.pyH A D25-Oct-202415.2 KiB

spec_tools/H25-Oct-20244 KiB

spirvcapgenerator.pyH A D25-Oct-20249.2 KiB

stripAPI.pyH A D25-Oct-20241.7 KiB

syncgenerator.pyH A D25-Oct-20249.3 KiB

test_check_spec_links.pyH A D25-Oct-202420.6 KiB

test_check_spec_links_api_specific.pyH A D25-Oct-20244.5 KiB

test_entity_db.pyH A D25-Oct-2024692

test_reflow.pyH A D25-Oct-202418.1 KiB

testSpecVersion.pyH A D25-Oct-20242.5 KiB

translate_math.jsH A D25-Oct-20241.1 KiB

validitygenerator.pyH A D25-Oct-202467.7 KiB

vkconventions.pyH A D25-Oct-202411.1 KiB

xml_consistency.pyH A D25-Oct-202433.9 KiB

README.adoc

1// Copyright 2014-2024 The Khronos Group Inc.
2// SPDX-License-Identifier: CC-BY-4.0
3
4= Vulkan^(R)^ Specification Repository Scripts
5
6This directory contains scripts used in building the Vulkan API
7specification and related artifacts. For the most part, these scripts are
8invoked from the top-level directory or from the API Registry in
9../xml to build generated components of the specification.
10
11Scripts in this directory include:
12
13  * `genvk.py` - Python script to generate Vulkan headers and some other
14    targets, using the generators described below.
15  * `reg.py` - Python tools to read a registry XML file and call into
16    generators to create headers and other types of output.
17  * `conventions.py`, `vkconventions.py`, `apiconventions.py` - API-specific
18    parameters and formatting / style conventions used by generators.
19  * `generator.py` - output generator base class.
20  ** `cgenerator.py` - C header output generator.
21  ** `docgenerator.py` - Asciidoc interface language include generator.
22  ** `extensionmetadocgenerator.py` - Generator for Asciidoc extension
23     descriptions in spec appendices.
24  ** `hostsyncgenerator.py` - Asciidoc host sync table generator.
25  ** `interfacedocgenerator.py` - Asciidoc extension appendix interface
26     generator.
27  ** `pygenerator.py, `rubygenerator.py`, `scriptgenerator.py` - generate
28     Python and Ruby encodings of parts of the API description for use in
29     other scripts and asciidoctor extensions.
30  ** `spirvcapgenerator.py` - Asciidoc generator for SPIR-V capability
31     tables.
32  ** `validitygenerator.py` - Asciidoc validity language generator.
33
34  * `check_spec_links.py` - validates a variety of markup and content in the
35    Asciidoctor specification source.
36  * `conventions.py`, `vkconventions.py` - API-specific options used by
37    scripts shared with OpenXR and other APIs.
38  * `extdependency.py` - generate extension dependencies for use when
39    building the specification.
40  * `genRelease`, `genspec.py` - build HTML and PDF Specifications with a
41    variety of options to control target directories, extensions included
42    while building, etc.
43  * `genRef.py`, `reflib.py`, `makemanaliases.py` - extract API reference
44    pages from specification source into single-page source documents, and
45    create symbolic links in the generated refpage HTML for API aliases.
46  * `indexExt.py` - generate HTML index of all extensions for inclusion into
47    the Vulkan registry index page.
48  * `reflow.py`, `reflow_count.py` - reflow specification source text to
49    follow style guidelines, and insert Valid Usage statements where they
50    are needed.
51  * `test_check_spec_links.py`, `test_check_spec_links_api_specific.py`,
52    `test_entity_db.py` - these are from another Khronos WG repository and
53    are unused by Vulkan at present.
54  * `xml_consistency.py` - perform some internal consistency checks on
55    `vk.xml`.
56
57  * `compImages.sh` - compare images in two branches.
58  * `htmldiff/htmldiff` - HTML diff script (see below).
59  * `Retired/` - contains obsolete, unused, or single-purpose scripts. Not
60    maintained.
61
62== HTML Diff Script for Vulkan
63
64This is a first cut at a script to compare Vulkan HTML specifications. Usage
65is simply 'htmldiff file1.html file2.html > diff.html'. The script does not
66copy CSS and images required by the input specs, so it is best to generate
67the output in the same directory as one of the inputs. However, the script
68must be invoked from the directory it is located within.
69
70The scripts used require Python and Perl. Additionally, the python
71'utidylib' module and the underlying libtidy C library are required.
72On Debian Linux, it may be necessary to install the 'python-utidylib' and
73'libtidy' packages if they are not already present.
74
75The scripts are taken from the code backing the
76
77    http://services.w3.org/htmldiff
78
79website. `htmldiff` is the Python driver script. `htmldiff.pl` is the
80Perl script which generates the diff after preprocessing of the input
81HTML by `htmldiff`. `htmldiff.orig` is the original Python script from
82the website, modified to run at the command line instead of as a CGI
83script.
84