7376fb77d1
* Update release number to 112. Github Issues: * Clarify that it is possible to use the <<memory-host, Host Memory>> pname:pfnReallocation callback to free memory in any case that pname:pfnFree could be used (public issue 973). Internal Issues: * Clarify range and precision of code:OpImageQueryLod in the discussion of scale factor and level-of-detail operation in the <<textures-normalized-operations, Normalized Texel Coordinate Operations>> section (internal issues 926, 1719). * Fix framebuffer layer valid usage statements for slink:VkRenderPassCreateInfo, slink:VkRenderPassCreateInfo2KHR, and slink:VkFramebufferCreateInfo (internal issue 1670). * Refactor common valid usage statements for flink:vkCmdBeginQuery and flink:vkCmdBeginQueryIndexedEXT (internal issue 1682). * Prohibit the ename:ename:VK_SAMPLER_YCBCR_RANGE_ITU_NARROW range from being used in slink:VkSamplerYcbcrConversionCreateInfo for formats with a bit depth less than 8 (internal issue 1688). * Add missing interactions with `<<VK_EXT_host_query_reset_usage>>` in the <<queries, Queries>> chapter (internal issue 1692). * Clean up error output from the `optimize-pdf` build script on success. * Fix an internal link to the <<spirvenv-correctly-rounded, Correctly Rounded>> section in the SPIR-V appendix by adding and referring to that anchor. * Fix extension version numbers in `vk.xml` for `VK_EXT_filter_cubic` and `VK_IMG_filter_cubic`. * Specify division precision for negative numbers, and remove statement that trigonometric functions have undefined precision, in the <<spirvenv-precision-operation, Precision and Operation of SPIR-V Instructions>> appendix. |
||
---|---|---|
.. | ||
chunkindex | ||
extension-highlighter | ||
katex_replace | ||
spec-macros | ||
themes | ||
vu-to-json | ||
.gitignore | ||
README.md | ||
asciidoctor-mathematical-ext.rb | ||
attribs.txt | ||
extension-highlighter.rb | ||
katex_replace.rb | ||
khronos.css | ||
makeSubmit.py | ||
mathtest.txt | ||
optimize-pdf | ||
spec-macros.rb | ||
tilde_open_block.rb | ||
vu-to-json.rb |
README.md
Vulkan Asciidoc Configuration Files
Macros
The macros in spec-macros.rb
and spec-macros/extension.rb
are
described in the "Vulkan Documentation and Extensions: Procedures and
Conventions" document (see the styleguide).
Support for Math
Asciidoctor is customized to insert KaTeX <script>
tags from
math.js
for HTML5, and properly pass through math which has
\begin{}\/end{}
delimiters instead of []
.
For PDF builds, asciidoctor-mathematical is used to generate
math-docbook.conf
is heavily conditionalized depending on whether the
final output format (which should be described in the a2x-format variable)
is pdf
or not, since Docbook passes through math differently to dblatex
vs. the XHTML stylesheets. This could be simplified now that we're only
using Docbook for PDFs.
Stylesheets
khronos.css
is the stylesheet used for HTML output.
Chunked Spec Index
chunkindex
contains scripts for building and using a search index for the
Vulkan chunked HTML specification.