search

KhronosGroup / OpenCL-Registry

OpenCL API and Extension Registry.
112 stars 42 forks source link

update the OpenCL reference pages for v3.0.10 #112

Closed bashbaug closed 2 years ago

bashbaug commented 2 years ago

Updates the online OpenCL reference pages for the v3.0.10 specs.

oddhack commented 2 years ago

Maybe we should consider not inlining the CSS for the refpages? Mostly to make the PR diff listing more comprehensible, more than for space savings.

bashbaug commented 2 years ago

Yeah, I noticed that. We updated the stylesheets and there are a lot more diffs this time than there were previously.

Is this an easy change to the reference page toolchain?

oddhack commented 2 years ago

Yeah, I noticed that. We updated the stylesheets and there are a lot more diffs this time than there were previously.

Is this an easy change to the reference page toolchain?

Yes. I can prototype it if you like (please open a tracking issue against me if so), or you can look at https://docs.asciidoctor.org/asciidoctor/latest/html-backend/stylesheet-modes/#embed . TL;DR will need to set the linkcss and copycss attributes appropriately. We don't do this by default since there's some value in keeping the files entirely self-contained and some slight complexity in getting the right stylesheet bundled with the refpages - but the process looks to have gotten a bit simpler since we made that decision years ago in Vulkan.

bashbaug commented 2 years ago

Closing - we should merge the v3.0.11 reference pages instead (https://github.com/KhronosGroup/OpenCL-Registry/pull/122).