diff --git a/engine/src/bullet-common/com/jme3/bullet/PhysicsTickListener.java b/engine/src/bullet-common/com/jme3/bullet/PhysicsTickListener.java
index 0f3bbca8c..f34753ba8 100644
--- a/engine/src/bullet-common/com/jme3/bullet/PhysicsTickListener.java
+++ b/engine/src/bullet-common/com/jme3/bullet/PhysicsTickListener.java
@@ -39,15 +39,15 @@ public interface PhysicsTickListener {
 
     /**
      * Called before the physics is actually stepped, use to apply forces etc.
-     * @param space
-     * @param f
+     * @param space the physics space
+     * @param tpf the time per frame in seconds 
      */
     public void prePhysicsTick(PhysicsSpace space, float f);
 
     /**
      * Called after the physics has been stepped, use to check for forces etc.
-     * @param space
-     * @param f
+     * @param space the physics space
+     * @param tpf the time per frame in seconds
      */
     public void physicsTick(PhysicsSpace space, float f);
 
diff --git a/engine/src/jbullet/com/jme3/bullet/collision/shapes/CapsuleCollisionShape.java b/engine/src/jbullet/com/jme3/bullet/collision/shapes/CapsuleCollisionShape.java
index 61024ebbe..1742d4fca 100644
--- a/engine/src/jbullet/com/jme3/bullet/collision/shapes/CapsuleCollisionShape.java
+++ b/engine/src/jbullet/com/jme3/bullet/collision/shapes/CapsuleCollisionShape.java
@@ -53,7 +53,8 @@ public class CapsuleCollisionShape extends CollisionShape{
     }
 
     /**
-     * creates a new CapsuleCollisionShape with the given radius and height
+     * Creates a new CapsuleCollisionShape with the given radius and height.
+     * The capsule is oriented along the Y axis (1).
      * @param radius the radius of the capsule
      * @param height the height of the capsule
      */
@@ -66,7 +67,7 @@ public class CapsuleCollisionShape extends CollisionShape{
     }
 
     /**
-     * creates a capsule shape around the given axis (0=X,1=Y,2=Z)
+     * Creates a capsule shape around the given axis (0=X,1=Y,2=Z).
      * @param radius
      * @param height
      * @param axis