The `image` entry of the `aspect` enum is highlighted

[KornevNikita]

Specification Version

SYCL 2020 (Revision 12)

Section Number(s)

4.6.4.5. Aspects

Bug Description

See the html version of the spec:

Is there any reason for this entry to be highlighted? If so, can we have some note? I see no specific notes, so it seems like it's some rendering issue.

[gmlueck]

Recording some notes for the future:

• This is related to the Rouge / Pygments syntax highlighter we use for rendering C++ code snippets.
• The name "image" is a namespace name, which we define in "adoc/config/rouge/lib/rouge/lexers/sycl.rb". That script predefines the SYCL namespace names as the Pygments token type Generic::Heading.
• These tokens then get colored according to "adoc/config/rouge/lib/rouge/themes/sycl_spec.rb".
• If we simply remove the name "image" from the list in "rouge/lexers/sycl.rb", the aspect name image is colored as you would expect. However, then all occurrences of "image" when used as a namespace name are colored incorrectly.
• I don't know why we classify the SYCL namespace names as Generic::Heading. It seems like we should instead classify them as Name.Namespace. However, when I try this, I get an error about Name.Namespace being unknown.
• This makes me think we have an old version of Rouge / Pygments, which doesn't understand this token type.

I think the next step would be to see what version of Rouge / Pygments we have in our Docker container. Then, try updating to a newer version and see if we can use the Name.Namespace token type.