You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
the functions declarations within glbinding might benefit from the brief description, parameters, and return section of the opengl man pages. however, this needs to be applied in a way that, e.g., glVertex### variations all use the same slightly adapted glVertex description.
some minor drawbacks to discuss here:
the parsing even though the pages are xhtml, might not be that easy,
parsing might take much longer and man pages should be loaded at generation time or stored within the glbinding repository as well?,
the deployment package, mainly the functions header massively increase in file size (which should not matter that much, since only comments that are discarded efficiently by compiler?).
The text was updated successfully, but these errors were encountered:
Comments should be discarded during the lexer, so the actual compiler shouldn't be bothered.
But this can differ for every compiler, I don't know for sure.
Actually I would prefer a link to the man page as comment for every parsed entry in glbinding instead of the complete documentation in the header files.
You could introduce an option in the generation script to switch between the two options? And while you're at it, generate different comments for popular documentation tools - not only doxygen.
the functions declarations within glbinding might benefit from the brief description, parameters, and return section of the opengl man pages. however, this needs to be applied in a way that, e.g.,
glVertex###
variations all use the same slightly adaptedglVertex
description.some minor drawbacks to discuss here:
The text was updated successfully, but these errors were encountered: