search

KhronosGroup / OpenCL-Docs

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

Table 58. Summary of command-buffer creation configurations title is rendering incorrectly #1175

Open bashbaug opened 3 months ago

bashbaug commented 3 months ago

The table title for:

Table 58. Summary of command-buffer creation configurations, for the cl_khr_command_buffer_multi_device extension

... is rendering incorrectly in the HTML spec, at least for the version of asciidoctor that I am using to build the specs. The PDF spec looks fine.

We should either figure out what's happening with it, or rephrase the table title so it renders correctly.

EwanC commented 1 month ago

What asciidoctor version are you using? Looking at a HTML rendered locally with Asciidoctor 2.0.16 (the version suggested by the repo README) the title renders correctly

bashbaug commented 1 month ago

What asciidoctor version are you using?

Odd, I'm using 2.0.16:

$ asciidoctor -V
Asciidoctor 2.0.16 [https://asciidoctor.org]
Runtime Environment (ruby 3.0.2p107 (2021-07-07 revision 0db68f0233) [x86_64-linux-gnu]) (lc:UTF-8 fs:UTF-8 in:UTF-8 ex:UTF-8)

What command line are you using to build the specs locally? I'm basically using a command line like the one from our CI: python3 makeSpec -clean -spec khr OUTDIR=out.khr -j 12 html.

EwanC commented 1 month ago

My setup is

$ asciidoctor -V
Asciidoctor 2.0.16 [https://asciidoctor.org]
Runtime Environment (ruby 2.3.3p222 (2016-11-21 revision 56859) [x86_64-linux]) (lc:UTF-8 fs:UTF-8 in:UTF-8 ex:UTF-8)

I was using, $ make html, but with $python3 makeSpec -clean -spec khr OUTDIR=out.khr -j 12 html I still see an okay rendering: image

@alycm Could you try this out?

bashbaug commented 2 weeks ago

@EwanC, @alycm (and any others), do you have any more thoughts what might be causing the difference?

I have a workflow that does automated spec builds using the Khronos docker image and this also seems to render the table title incorrectly, for whatever that's worth.