(Part 4) Mark all gfx functions invoked by JNI so I don't shoot myself in the foot shortly

mobile/android/base/gfx/GeckoGLLayerClient.java

@@ -174,7 +174,7 @@ public class GeckoGLLayerClient extends GeckoLayerClient
         GeckoAppShell.sendEventToGecko(event);
     }
 
-    /** For Gecko to use. */
+    /** This function is invoked by Gecko via JNI; be careful when modifying signature. */
     public ViewTransform getViewTransform() {
         Log.e(LOGTAG, "### getViewTransform()");
 
@@ -216,7 +216,7 @@ public class GeckoGLLayerClient extends GeckoLayerClient
         renderRequested();
     }
 
-    /** For Gecko to use. */
+    /** This function is invoked by Gecko via JNI; be careful when modifying signature. */
     public LayerRenderer.Frame createFrame() {
         // Create the shaders and textures if necessary.
         if (!mLayerRendererInitialized) {
@@ -230,12 +230,12 @@ public class GeckoGLLayerClient extends GeckoLayerClient
         return mLayerRenderer.createFrame(pageContext, screenContext);
     }
 
-    /** For Gecko to use. */
+    /** This function is invoked by Gecko via JNI; be careful when modifying signature. */
     public void activateProgram() {
         mLayerRenderer.activateProgram();
     }
 
-    /** For Gecko to use. */
+    /** This function is invoked by Gecko via JNI; be careful when modifying signature. */
     public void deactivateProgram() {
         mLayerRenderer.deactivateProgram();
     }

mobile/android/base/gfx/GeckoLayerClient.java

@@ -120,6 +120,7 @@ public abstract class GeckoLayerClient implements GeckoEventListener {
         sendResizeEventIfNecessary();
     }
 
+    /** This function is invoked by Gecko via JNI; be careful when modifying signature. */
     public Rect beginDrawing(int width, int height, int tileWidth, int tileHeight,
                              String metadata, boolean hasDirectTexture) {
         Log.e(LOGTAG, "### beginDrawing " + width + " " + height + " " + tileWidth + " " +
@@ -196,7 +197,8 @@ public abstract class GeckoLayerClient implements GeckoEventListener {
         return bufferRect;
     }
 
-    /*
+    /** This function is invoked by Gecko via JNI; be careful when modifying signature.
+     *
      * TODO: Would be cleaner if this took an android.graphics.Rect instead, but that would require
      * a little more JNI magic.
      */