glGetShader function pointer does not exist, glGetShaderiv redirecting to glGetShader about docs.gl HOT 4 OPEN

Certainly, I’d be happy to pull a PR :)

from docs.gl.

I tried adding an new .xhtml file with glGetShaderiv, and running the build script again to compile, thinking it would then pickup on this file from the opengl SDK, but I think the issue actually lies with khronos groups documentation. I have attached a picture for reference, the glGetShaderiv function and glGetShader function are both present in their navigation bar, but upon clicking each of these links, both take you to the /html/glGetShader.xhtml endpoint.

I actually think they need to fix their documentation and remove glGetShader for glGetShaderiv (looks like a typo maybe), so your compile script will pickup on the correct function.

will definitely try to contribute somewhere else in the project, I am assuming you do not want to manually add a separate html file for this function after compilation?

from docs.gl.

It's been a while since I applied my brain to docs.gl so I'll lean on you a bit for this one:

What are our options for fixing it on our side? Can we just rename glGetShader.xhtml to glGetShaderiv.xhtml or will we break links? Can we also update all the links? I see that the gles versions already have glGetShaderiv.xhtml so it can't be that bad?

from docs.gl.

I am not certain this is something that should ever be fixed, as it is following the same convention as the rest of the API. Whether it be g;GetUniformXXX, glGetVertexAttribXXX, glGetSamplerParameterXXX, or anything else, the suffix is dropped and there is a single page with the base name that documents all variations together.

The only difference here is that shaders objects (currently) only have a single "get" function, and do not have -ui or -f suffixed variants, in which case it would be more obvious.

from docs.gl.