Skip to content

handle case-insensitive asciidoctor attributes #443

@bashbaug

Description

@bashbaug

Unfortunately, asciidoctor attributes are currently case-insensitive. This means that the asciidoctor enum attribute for CL_DEVICE_DEVICE_ENQUEUE_CAPABILITIES is indistinguishable for the asciidoctor type attribute for cl_device_device_enqueue_capabilities. When both attributes are indistinguishable, it looks like the last one "wins", and as a result there are several places in the spec where the type name is used in place of the enum name.

There is an Asciidoctor issue open to fix this, but it's been open for a while without any updates.

Options to fix this issue in the OpenCL specs:

  1. Add a prefix or suffix to one class of attributes to disambiguate, probably the type name since there are fewer of them.
  2. Special-case this particular attribute and try to avoid duplicates in the future.

I suppose we could also rename either the type or the enum to disambiguate - is there any other reason to prefer unique case-insensitive names? - but that feels a bit like the tail wagging the dog.

I'll probably bite the bullet and go with (1) if it doesn't look too bad.

Metadata

Metadata

Assignees

Labels

Coming SoonIssues to Work NextOpenCL API SpecIssues related to the OpenCL API specification.

Type

No type

Projects

No projects

Milestone

No milestone

Relationships

None yet

Development

No branches or pull requests

Issue actions