android: comments for new interfaces and methods

Change-Id: I742e232b3a9994f82423bc4bdfa1a5b656f8af87

android/Bootstrap/src/org/libreoffice/kit/Document.java

@@ -85,7 +85,15 @@ public class Document {
 
     public native void initializeForRendering();
 
+    /**
+     * Callback to retrieve messages from LOK
+     */
     public interface MessageCallback {
+        /**
+         * Invoked when a message is retrieved from LOK
+         * @param signalNumber - signal type / number
+         * @param payload - retrieved for the signal
+         */
         void messageRetrieved(int signalNumber, String payload);
     }
 

android/Bootstrap/src/org/libreoffice/kit/Office.java

@@ -12,6 +12,8 @@ package org.libreoffice.kit;
 import java.nio.ByteBuffer;
 
 public class Office {
+    public static final int KEY_PRESS = 0;
+    public static final int KEY_RELEASE = 1;
 
     private ByteBuffer handle;
 
@@ -32,6 +34,11 @@ public class Office {
         return document;
     }
 
+    /**
+     * Post a key event to LibreOffice.
+     * @param type - type of key event
+     * @param code - key event code
+     */
     public native void postKeyEvent(int type, int code);
 
     public native void destroy();

android/experimental/LOAndroid3/src/java/org/libreoffice/TileProvider.java

@@ -16,6 +16,9 @@ public interface TileProvider {
 
     CairoImage createTile(float x, float y, IntSize tileSize, float zoom);
 
+    /**
+     * Rerender and overwrite tile's image buffer directly
+     */
     void rerenderTile(CairoImage image, float x, float y, IntSize tileSize, float zoom);
 
     void changePart(int partIndex);
@@ -30,7 +33,14 @@ public interface TileProvider {
 
     void registerInvalidationCallback(TileProvider.TileInvalidationCallback tileInvalidationCallback);
 
+    /**
+     * Callback to retrieve invalidation calls
+     */
     public interface TileInvalidationCallback {
+        /**
+         * Invoked when a region is invalidated.
+         * @param rect area in pixels which was invalidated and needs to be redrawn
+         */
         void invalidate(RectF rect);
     }
 }