more comments

src/main/java/com/jme3/bullet/PhysicsSoftSpace.java

@@ -272,7 +272,7 @@ public void removeCollisionObject(PhysicsCollisionObject pco) {
      * Alter the gravitational acceleration acting on newly-added bodies.
      * <p>
      * Typically, when a body is added to a space, the body's gravity gets set
-     * to that of the space. Thus it is preferable to set the space's gravity
+     * to that of the space. Thus, it is preferable to set the space's gravity
      * before adding any bodies to the space.
      *
      * @param gravity the desired acceleration vector (not null, unaffected,

src/main/java/com/jme3/bullet/collision/PhysicsCollisionObject.java

@@ -957,8 +957,8 @@ public void setRestitution(float restitution) {
 
     /**
      * Alter this object's rolling friction: torsional friction orthogonal to
-     * the contact normal (native field: m_rollingFriction). Use to stop objects
-     * from rolling.
+     * the contact normal (native field: m_rollingFriction). Use this to stop
+     * bodies from rolling.
      *
      * @param friction the desired friction value (default=0)
      */

src/main/java/com/jme3/bullet/collision/shapes/Convex2dShape.java

@@ -38,8 +38,8 @@
 import jme3utilities.math.MyVector3f;
 
 /**
- * An convex CollisionShape optimized for 2-D, based on Bullet's
- * btConvex2dShape. For a rectangle, use Box2dShape instead.
+ * A convex CollisionShape optimized for 2-D, based on Bullet's btConvex2dShape.
+ * For a rectangle, use Box2dShape instead.
  *
  * @author Stephen Gold [email protected]
  */

src/main/java/com/jme3/bullet/collision/shapes/SimplexCollisionShape.java

@@ -120,8 +120,8 @@ public SimplexCollisionShape(Vector3f vertex1, Vector3f vertex2,
      *
      * @param vertex1 the location of first vertex (in shape coordinates, not
      * null, unaffected)
-     * @param vertex2 the location of 2nd vertex shape coordinates, not null,
-     * unaffected)
+     * @param vertex2 the location of 2nd vertex (in shape coordinates, not
+     * null, unaffected)
      * @param vertex3 the location of 3rd vertex (in shape coordinates, not
      * null, unaffected)
      * @param vertex4 the location of 4th vertex (in shape coordinates, not

src/main/java/com/jme3/bullet/objects/PhysicsCharacter.java

@@ -464,8 +464,8 @@ public void setMaxSlope(float slopeRadians) {
     }
 
     /**
-     * Directly alter this character's location. (Same as
-     * {@link #warp(com.jme3.math.Vector3f)}).)
+     * Directly alter this character's location. (This is equivalent to
+     * {@link #warp(com.jme3.math.Vector3f)}.)
      *
      * @param location the desired location (not null, unaffected)
      */