search

KhronosGroup / OpenCL-Docs

OpenCL API, OpenCL C, Extensions, SPIR-V Environment Specs, Ref page, and C++ for OpenCL doc sources.
Other
359 stars 113 forks source link

Tooling around specification XML doesn't support extensions #419

Open kpet opened 4 years ago

kpet commented 4 years ago

It seems the various scripts don't support generating prototypes and version notes at least. A consequence of this is that we lose an opportunity to automatically detect inconsistencies in the XML for extensions.

Related to that we should probably use automatically generated prototypes in the extension specification.

kpet commented 4 years ago

Discussed on the 2020/09/08 teleconference: we have little experience with these scripts in the OpenCL WG. It seems those were lifted from the Vulkan tooling for the most part and the code relating to extensions seems to have been commented out. @oddhack Any chance you could shed some light / spare some cycles on this? Thanks!

oddhack commented 4 years ago

I am not familiar with the gen_dictionaries.py and gen_version_notes.py scripts, which is what I think you're referring to. Those are something added by CL people AFAICT. I will say that there's a big framework around the Vulkan-supplied generator scripts which gives many controls over formatting, boilerplate, selection of extensions and features, etc. which these two are not using, and so it's not surprising if they have some hardwired limitations. I'm willing to look at doing the equivalent thing using the imported generator scripts if the WG wants.