The last part states it doesn’t NEED to be called by the end user, are there any circumstances the user MAY call this method?
If not, the method could be made protected to ensure it won’t be called by the user. How about ‘setGL’ method , same there?
Best rergards
This is a really good point. Thanks for bringing this up and for your suggestion. I agree that the method could just as easily be protected and still have its intended usage, which is to allow third parties to extend GLContext without needing to necessarily use the RI’s implementations. I’ve sent an email to the JSR-231 expert group about this and your suggested change should be in the source tree in a couple of days.
Glad, I could contribute. 
I realized I didn’t answer your second question about setGL(). This method needs to be public in order for end users to install the DebugGL, TraceGL and other potentially user-defined composable pipelines.