deprecate jbullet bridge apis

Author: 8Keep

jme3-jbullet/src/main/java/com/jme3/bullet/collision/shapes/CollisionShape.java

@@ -64,7 +64,9 @@ protected CollisionShape() {
      * 
      * @param mass the desired mass for the body
      * @param vector storage for the result (not null, modified)
+     * @deprecated This exposes the JBullet backend type directly.
      */
+    @Deprecated
     public void calculateLocalInertia(float mass, javax.vecmath.Vector3f vector) {
         if (cShape == null) {
             return;
@@ -80,7 +82,9 @@ public void calculateLocalInertia(float mass, javax.vecmath.Vector3f vector) {
      * used internally
      *
      * @return the pre-existing instance
+     * @deprecated This exposes the JBullet backend type directly.
      */
+    @Deprecated
     public com.bulletphysics.collision.shapes.CollisionShape getCShape() {
         return cShape;
     }
@@ -89,7 +93,9 @@ public com.bulletphysics.collision.shapes.CollisionShape getCShape() {
      * used internally
      *
      * @param cShape the shape to use (alias created)
+     * @deprecated This exposes the JBullet backend type directly.
      */
+    @Deprecated
     public void setCShape(com.bulletphysics.collision.shapes.CollisionShape cShape) {
         this.cShape = cShape;
     }

jme3-jbullet/src/main/java/com/jme3/bullet/joints/motors/RotationalLimitMotor.java

@@ -32,17 +32,28 @@
 package com.jme3.bullet.joints.motors;
 
 /**
+ * Legacy wrapper around the JBullet rotational limit motor.
  *
+ * @deprecated This exposes the JBullet backend type directly.
  * @author normenhansen
  */
+@Deprecated
 public class RotationalLimitMotor {
 
     private com.bulletphysics.dynamics.constraintsolver.RotationalLimitMotor motor;
 
+    /**
+     * @deprecated This exposes the JBullet backend type directly.
+     */
+    @Deprecated
     public RotationalLimitMotor(com.bulletphysics.dynamics.constraintsolver.RotationalLimitMotor motor) {
         this.motor = motor;
     }
 
+    /**
+     * @deprecated This exposes the JBullet backend type directly.
+     */
+    @Deprecated
     public com.bulletphysics.dynamics.constraintsolver.RotationalLimitMotor getMotor() {
         return motor;
     }

jme3-jbullet/src/main/java/com/jme3/bullet/joints/motors/TranslationalLimitMotor.java

@@ -35,17 +35,28 @@
 import com.jme3.math.Vector3f;
 
 /**
+ * Legacy wrapper around the JBullet translational limit motor.
  *
+ * @deprecated This exposes the JBullet backend type directly.
  * @author normenhansen
  */
+@Deprecated
 public class TranslationalLimitMotor {
 
     private com.bulletphysics.dynamics.constraintsolver.TranslationalLimitMotor motor;
 
+    /**
+     * @deprecated This exposes the JBullet backend type directly.
+     */
+    @Deprecated
     public TranslationalLimitMotor(com.bulletphysics.dynamics.constraintsolver.TranslationalLimitMotor motor) {
         this.motor = motor;
     }
 
+    /**
+     * @deprecated This exposes the JBullet backend type directly.
+     */
+    @Deprecated
     public com.bulletphysics.dynamics.constraintsolver.TranslationalLimitMotor getMotor() {
         return motor;
     }

jme3-jbullet/src/main/java/com/jme3/bullet/objects/VehicleWheel.java

@@ -114,10 +114,18 @@ public void applyWheelTransform() {
         }
     }
 
+    /**
+     * @deprecated This exposes the JBullet backend type directly.
+     */
+    @Deprecated
     public com.bulletphysics.dynamics.vehicle.WheelInfo getWheelInfo() {
         return wheelInfo;
     }
 
+    /**
+     * @deprecated This exposes the JBullet backend type directly.
+     */
+    @Deprecated
     public void setWheelInfo(com.bulletphysics.dynamics.vehicle.WheelInfo wheelInfo) {
         this.wheelInfo = wheelInfo;
         applyInfo();

jme3-jbullet/src/main/java/com/jme3/bullet/package-info.java

@@ -30,6 +30,10 @@
  * SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
  */
 /**
- * central classes of the physics system
+ * Central classes of the physics system.
+ *
+ * <p>The public physics API remains in place for compatibility while the
+ * JBullet backend is being phased out. The JBullet-specific escape hatches are
+ * deprecated and should not be used for new code.</p>
  */
 package com.jme3.bullet;

jme3-jbullet/src/main/java/com/jme3/bullet/util/Converter.java

@@ -42,10 +42,13 @@
 import java.nio.FloatBuffer;
 
 /**
- * Nice convenience methods for conversion between javax.vecmath and com.jme3.math
- * Objects, also some jme to jbullet mesh conversion.
+ * Legacy convenience methods for conversion between javax.vecmath and
+ * com.jme3.math objects, plus a few JBullet bridge helpers.
+ *
+ * @deprecated This utility exposes JBullet backend types directly.
  * @author normenhansen
  */
+@Deprecated
 public class Converter {
 
     private Converter() {

jme3-jbullet/src/main/java/com/jme3/bullet/util/package-info.java

@@ -30,6 +30,9 @@
  * SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
  */
 /**
- * utility classes related to Bullet physics
+ * Utility classes related to Bullet physics.
+ *
+ * <p>{@link com.jme3.bullet.util.Converter} is deprecated because it exposes
+ * backend-specific JBullet types.</p>
  */
 package com.jme3.bullet.util;