commit e0b6c593075a30837584778f194c4fd6b4bacbef
Author: Leszek Koltunski <leszek@distorted.org>
Date:   Fri Dec 16 00:31:05 2016 +0000

    Javadoc

diff --git a/src/main/java/org/distorted/library/DistortedFramebuffer.java b/src/main/java/org/distorted/library/DistortedFramebuffer.java
index f9b3883..50e6c85 100644
--- a/src/main/java/org/distorted/library/DistortedFramebuffer.java
+++ b/src/main/java/org/distorted/library/DistortedFramebuffer.java
@@ -31,9 +31,9 @@ import java.util.LinkedList;
  * <p>
  * User is able to create either Framebuffers from objects already constructed outside
  * of the library (the first constructor; primary use case: the screen) or an offscreen
- * FBOs (used by the DistortedTree, but also can be used by external users of the library)
+ * FBOs.
  * <p>
- * Also, keep all objects created in a static LinkedList. The point: we need to be able to mark
+ * Keep all objects created in a static LinkedList. The point: we need to be able to mark
  * Framebuffers for deletion, and delete all marked objects later at a convenient time (that's
  * because we can only delete from a thread that holds the OpenGL context so here we provide a
  * framework where one is able to mark for deletion at any time and actual deletion takes place
diff --git a/src/main/java/org/distorted/library/DistortedTexture.java b/src/main/java/org/distorted/library/DistortedTexture.java
index 502000c..f07228c 100644
--- a/src/main/java/org/distorted/library/DistortedTexture.java
+++ b/src/main/java/org/distorted/library/DistortedTexture.java
@@ -28,7 +28,17 @@ import java.util.Iterator;
 import java.util.LinkedList;
 
 ///////////////////////////////////////////////////////////////////////////////////////////////////
-
+/**
+ * Class which represents a OpenGL Texture object.
+ * <p>
+ * Create a Texture of arbitrary size and feed some pixels to it via the setTexture() method.
+ * <p>
+ * Keep all objects created in a static LinkedList. The point: we need to be able to mark
+ * Textures for deletion, and delete all marked objects later at a convenient time (that's
+ * because we can only delete from a thread that holds the OpenGL context so here we provide a
+ * framework where one is able to mark for deletion at any time and actual deletion takes place
+ * on the next render).
+ */
 public class DistortedTexture
   {
   private static boolean mListMarked = false;
diff --git a/src/main/java/org/distorted/library/GridCubes.java b/src/main/java/org/distorted/library/GridCubes.java
index bb90cf5..bd91187 100644
--- a/src/main/java/org/distorted/library/GridCubes.java
+++ b/src/main/java/org/distorted/library/GridCubes.java
@@ -24,7 +24,11 @@ import java.nio.ByteOrder;
 import java.util.ArrayList;
 
 ///////////////////////////////////////////////////////////////////////////////////////////////////
-
+/**
+ * Create a 3D grid composed of Cubes.
+ * <p>
+ * Any subset of a MxNx1 cuboid is possible.
+ */
 public class GridCubes extends GridObject
    {
    private static final float R = 0.0f;//0.2f;
@@ -740,7 +744,7 @@ public class GridCubes extends GridObject
 // PUBLIC API
 ///////////////////////////////////////////////////////////////////////////////////////////////////
 /**
- * Creates the underlying grid of vertices, normals, texture coords and colors.
+ * Creates the underlying grid of vertices, normals, texture coords.
  *    
  * @param cols      Integer helping to parse the next parameter.
  * @param desc      String describing the subset of a MxNx1 cuboid that we want to create.
diff --git a/src/main/java/org/distorted/library/GridFlat.java b/src/main/java/org/distorted/library/GridFlat.java
index 5f1c71a..91f3c2f 100644
--- a/src/main/java/org/distorted/library/GridFlat.java
+++ b/src/main/java/org/distorted/library/GridFlat.java
@@ -23,7 +23,12 @@ import java.nio.ByteBuffer;
 import java.nio.ByteOrder;
 
 ///////////////////////////////////////////////////////////////////////////////////////////////////
-
+/**
+ * Create a flat, rectangular Grid.
+ * <p>
+ * Perfect if you just want to display a flat Texture. If you are not planning to apply any VERTEX
+ * effects to it, use GridFlat(1,1), i.e. a Quad. Otherwise, create more vertices for more realistic effects!
+ */
 public class GridFlat extends GridObject
   {
   private int mCols, mRows;
diff --git a/src/main/java/org/distorted/library/GridObject.java b/src/main/java/org/distorted/library/GridObject.java
index cf771fb..70bcfa7 100644
--- a/src/main/java/org/distorted/library/GridObject.java
+++ b/src/main/java/org/distorted/library/GridObject.java
@@ -24,7 +24,13 @@ import java.nio.FloatBuffer;
 import android.opengl.GLES20;
 
 ///////////////////////////////////////////////////////////////////////////////////////////////////
-
+/**
+ * Abstract class which represents a Grid, ie 3 arrays of Vertex attributes: 1) positions
+ * 2) normals 3) texture coordinates.
+ * <p>
+ * If you want to render to a particular shape, extend from here, construct the three FloatBuffers and
+ * provide correct dataLength, i.e. the number of vertices.
+ */
 public abstract class GridObject
    {
    protected static final int BYTES_PER_FLOAT   = 4; //