OpenGL-Registry icon indicating copy to clipboard operation
OpenGL-Registry copied to clipboard

glObjectPtrLabel inconsistensies

Open frederikja163 opened this issue 4 years ago • 4 comments

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*

frederikja163 avatar Nov 21 '20 14:11 frederikja163

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 *".

pdaniell-nv avatar Dec 08 '20 21:12 pdaniell-nv

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

frederikja163 avatar Jan 25 '21 19:01 frederikja163

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.

Perksey avatar Jan 25 '21 20:01 Perksey

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

frederikja163 avatar Nov 17 '21 00:11 frederikja163