library: javadoc and whitespace

library/src/main/java/com/jme3/bullet/PhysicsSpace.java

@@ -57,7 +57,8 @@
 import jolt.physics.collision.broadphase.ObjectVsBroadPhaseLayerFilterFn;
 
 /**
- * A space to simulate dynamic physics.
+ * A CollisionSpace to simulate dynamic physics, with its own
+ * {@code PhysicsSystem}.
  *
  * @author normenhansen
  */
@@ -247,7 +248,7 @@ public void addTickListener(PhysicsTickListener listener) {
     }
 
     /**
-     * Return the number of active bodies.
+     * Count how many active bodies are in the space.
      *
      * @return the count (≥0)
      */

library/src/main/java/com/jme3/bullet/objects/PhysicsRigidBody.java

@@ -295,7 +295,7 @@ public Vec3d getLinearVelocityDp(Vec3d storeResult) {
     }
 
     /**
-     * Copy the location of the object's center to a Vector3f.
+     * Copy the location of the body's center to a Vector3f.
      *
      * @param storeResult storage for the result (modified if not null)
      * @return a location vector (in physics-space coordinates, either
@@ -319,7 +319,7 @@ public Vector3f getPhysicsLocation(Vector3f storeResult) {
     }
 
     /**
-     * Copy the location of the object's center to a Vec3d.
+     * Copy the location of the body's center to a Vec3d.
      *
      * @param storeResult storage for the result (modified if not null)
      * @return a location vector (in physics-space coordinates, either
@@ -343,7 +343,7 @@ public Vec3d getPhysicsLocationDp(Vec3d storeResult) {
     }
 
     /**
-     * Copy the orientation (rotation) of the object to a Quaternion.
+     * Copy the orientation (rotation) of the body to a {@code Quaternion}.
      *
      * @param storeResult storage for the result (modified if not null)
      * @return a rotation Quaternion (in physics-space coordinates, either
@@ -570,6 +570,7 @@ public void setCollisionShape(CollisionShape desiredShape) {
         if (isDynamic()) {
             validateDynamicShape(desiredShape);
         }
+
         super.setCollisionShape(desiredShape);
         rebuildRigidBody();
     }