KhronosGroup / OpenGL-Registry

OpenGL, OpenGL ES, and OpenGL ES-SC API and Extension Registry
679 stars 274 forks source link

glObjectPtrLabel inconsistensies #446

Open frederikja163 opened 3 years ago

frederikja163 commented 3 years ago

The methods glObjectPtrLabel and glObjectPtrLabelKHR are inconsistent with whats defined in the documentation on several points.

https://www.khronos.org/registry/OpenGL-Refpages/gl4/html/glObjectPtrLabel.xhtml

ptr parameter is defined as const void in the spec while its defined as void (without the const) in the documentation. ptr is also described as being a sync object in the documentation while its type is still a void*

pdaniell-nv commented 3 years ago

ptr parameter is defined as const void in the spec while its defined as void (without the const) in the documentation. ptr is also described as being a sync object in the documentation while its type is still a void*

Can you be more specific what you mean by "spec" and "documentation" here. On page 558 of the OpenGL 4.6 spec (https://www.khronos.org/registry/OpenGL/specs/gl/glspec46.core.pdf) ptr is defined as "void *".

frederikja163 commented 3 years ago

I was refering to the XML file, in there its defined as const void *

Perksey commented 3 years ago

That looks to be an error in the XML file then, but I fear it won't be able to be corrected for compatibility reasons.

frederikja163 commented 2 years ago

We just started working Documentation into our bindings generator, for this we are using the XML files talked about in this issue. We have found many other issues similar to this one and are currently working on a tool to tell us where the inconsistencies are. This should allow us to fix all the inconsistencies. 🤞