Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

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

Open
bashbaug opened this issue May 21, 2024 · 4 comments
Labels
cl_khr_command_buffer Relating to the command-buffer family of extension

Comments

@bashbaug
Copy link
Contributor

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 EwanC added the cl_khr_command_buffer Relating to the command-buffer family of extension label May 22, 2024
@EwanC
Copy link
Contributor

EwanC commented Jul 23, 2024

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
Copy link
Contributor Author

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
Copy link
Contributor

EwanC commented Jul 31, 2024

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
Copy link
Contributor Author

@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.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
cl_khr_command_buffer Relating to the command-buffer family of extension
Projects
Status: Next Spec Release
Development

No branches or pull requests

2 participants