--- a/src/proto2/Physics.hh	Fri Nov 28 18:23:57 2008 +0000
+++ b/src/proto2/Physics.hh	Fri Nov 28 22:26:23 2008 +0000
@@ -93,7 +93,23 @@
      */
     TerrainType getType(Vector pos) const;
 
+    /**
+     * Remove ground from the terrain. Removes a circle with given
+     * radius.
+     *
+     * @param x center x coordinate
+     * @param y center y coordinate
+     * @param r circle radius
+     */
     void removeGround(int x, int y, float r);
+    
+    /**
+     * Remove ground from the terrain. Removes a circle with given
+     * radius.
+     *
+     * @param pos circle center
+     * @param r circle radius
+     */
     void removeGround(Vector pos, float r);
 };
 
@@ -104,11 +120,9 @@
     float mass;
     Vector position;
     Vector velocity;
-    // Whether the object (worms mainly) is in the air 
-    // or firmly on the ground. Affects to physics.
-    bool inAir;
-    float aim;
-    uint8_t facing;
+    float aim; // Aim direction (half circle)
+    bool facingRight; // Player facing
+    bool inAir; // Is the object "on the ground"
 
     // Shape of the object. We use a polygon with 4 edges
     // to make easy to draw with Clanlib. The coordinates