Jan Ekholm @jan_ekholm 44m
Sometimes JOGL code becomes a frankenmess of plain OpenGL and JOGL utility stuff. No docs really tell what the utility stuff does.
I am sorry (not really, but just being polite here),
but such a critique is itself a 'frankenmess' since it doesn't specify which
modules lack documentation.
Asking for a better documentation while being broad and unspecific
is not constructive and itself lacks documentation.
Many utility classes do have proper API documentation
as well as covering unit test. The latter also demonstrate their usage.
I have to admit, nothing is 100% perfect, but we need to ask for
detailed question so we are able to better the product.
Iff serious, and this would imply cooperation and commitment,
I recommend to reopen this bug as a root bug entry
and add subsequent child bugs blocking this one asking for
missing documentation or clarification of specific modules.
Sorry if this sounds harsh .. but we need to have a doable process
w/ community as well.
The best JogAmp module utility class documentation to date is inside the JogAmp JOGL javadocs: