doc: Added Lioncash's much-improved inline Java documentation for EGL.

Highly recommended for working with GameSurface.java.