OpenCL-Docs icon indicating copy to clipboard operation
OpenCL-Docs copied to clipboard

Misleading reference to device-side enqueue section

Open bashbaug opened this issue 2 months ago • 0 comments

Currently, in section 3.3.9.1. Atomic Operations: https://registry.khronos.org/OpenCL/specs/3.0-unified/html/OpenCL_API.html#_atomic_operations

We have the line:

Device-side enqueue defines the enumerated type memory_order.

This is confusing and misleading, though: the device-side enqueue section does not define the enumerated type memory_order, and indeed has nothing to do with the memory model.

This appears to be a long-standing issue in the spec, going all the way back to the OpenCL 2.0 spec, where it referred to a section number and not a section title.

We should figure out the section this is supposed to be referring to and fix the reference - maybe to section 3.3.7. Memory Consistency Model for OpenCL 2.x. Or, if we can't figure out the right section to refer to, I think we can just remove the line, since it's not adding much.

bashbaug avatar Oct 08 '25 17:10 bashbaug