KhronosGroup / KhronosGroup/Vulkan-Docs

Xml spec: Converting C text to attributes

Open
#19 10 comments 1 reaction 1 assignee Claimed by @oddhack View on GitHub
Registry
Dominant language
JavaScript
Stars
3.3k
Forks
549
Avg merge
5d 5h
Merged PRs (30d)
2

Description

Hi.

Are there any plans to make the xml spec less dependent on the C language?

For example, for const and/or pointer arguments it would be possible to add a type/parameter `modifier` attribute:

``` xml

VkResult vkCreateFence
VkDevice device
VkFenceCreateInfo pCreateInfo
VkAllocationCallbacks pAllocator
VkFence pFence

```

And for function pointers, it would be possible to wrap a `command` inside a `type`:

``` xml


void PFN_vkInternalAllocationNotification
void pUserData
size_t size
VkInternalAllocationType allocationType
VkSystemAllocationScope allocationScope

```

This would be useful to language bindings, since the definitions would be more aligned with xml, instead of text in between elements, and still without loosing the expressiveness of C.

Related with https://github.com/KhronosGroup/Vulkan-Docs/issues/10

Contributor guide

Open the contributing guide

Assessment

This issue has not been assessed yet.

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.