salvage or resolve dangling javadoc

jme3-android/src/main/java/com/jme3/util/AndroidBufferAllocator.java

@@ -79,7 +79,6 @@ public class AndroidBufferAllocator implements BufferAllocator {
         }
     }
 
-    @Override
     /**
      * This function search the inner direct buffer of the android specific wrapped buffer classes
      * and destroys it using the reflection allocator method.
@@ -87,6 +86,7 @@ public class AndroidBufferAllocator implements BufferAllocator {
      * @param toBeDestroyed The direct buffer that will be "cleaned".
      *
      */
+    @Override
     public void destroyDirectBuffer(Buffer toBeDestroyed) {
         // If it is a wrapped buffer, get it's inner direct buffer field and destroy it
         Field field = fieldIndex.get(toBeDestroyed.getClass());

jme3-bullet/src/common/java/com/jme3/bullet/control/ragdoll/RagdollPreset.java

@@ -123,7 +123,6 @@ public abstract class RagdollPreset {
         public JointPreset() {
         }
 
-        public JointPreset(float maxX, float minX, float maxY, float minY, float maxZ, float minZ) {
         /**
          * Instantiate a preset with the specified range of motion.
          *
@@ -134,6 +133,7 @@ public abstract class RagdollPreset {
          * @param maxZ the maximum rotation on the Z axis (in radians)
          * @param minZ the minimum rotation on the Z axis (in radians)
          */
+        public JointPreset(float maxX, float minX, float maxY, float minY, float maxZ, float minZ) {
             this.maxX = maxX;
             this.minX = minX;
             this.maxY = maxY;
@@ -172,13 +172,13 @@ public abstract class RagdollPreset {
             put(word.toLowerCase(), score);
         }
 
-        public int getScore(String word) {
         /**
          * Calculate a total score for the specified bone name.
          *
          * @param name the name of a bone (not null)
          * @return total score: larger value means more likely to correspond
          */
+        public int getScore(String word) {
             int score = 0;
             String searchWord = word.toLowerCase();
             for (String key : this.keySet()) {

jme3-core/src/main/java/com/jme3/audio/openal/AL.java

@@ -235,7 +235,7 @@ public interface AL {
     public static final int AL_RENDERER = 0xB003;
     public static final int AL_EXTENSIONS = 0xB004;
 
-    /**
+    /*
      * Global tweakage.
      */
     /**

jme3-core/src/main/java/com/jme3/effect/Particle.java

@@ -86,7 +86,7 @@ public class Particle {
      */
     public int imageIndex = 0;
     
-    /**
+    /*
      * Distance to camera. Only used for sorted particles.
      */
     //public float distToCam;

jme3-core/src/main/java/com/jme3/util/ReflectionAllocator.java

@@ -86,14 +86,13 @@ public final class ReflectionAllocator implements BufferAllocator {
         }
     }
 
-    @Override
     /**
      * This function explicitly calls the Cleaner method of a direct buffer.
      *
      * @param toBeDestroyed
      *            The direct buffer that will be "cleaned". Utilizes reflection.
-     *
      */
+    @Override
     public void destroyDirectBuffer(Buffer toBeDestroyed) {
         try {
             if (freeMethod != null) {

jme3-core/src/test/java/com/jme3/collision/CollideIgnoreTransformTest.java

@@ -99,13 +99,13 @@ public class CollideIgnoreTransformTest {
 
         rootNode.updateLogicalState(0.01f);
         rootNode.updateGeometricState();
-        /**
+        /*
          * ray in the -Z direction, starting from (0.5, 0.6, 10)
          */
         Ray ray1 = new Ray(/* origin */new Vector3f(0.5f, 0.6f, 10f),
                 /* direction */ new Vector3f(0f, 0f, -1f));
         castRay(ray1, 1);
-        /**
+        /*
          * ray in the -Z direction, starting from (0.5, 3, 10)
          */
         Ray ray0 = new Ray(/* origin */new Vector3f(0.5f, 3f, 10f),

jme3-examples/src/main/java/jme3test/TestChooser.java

@@ -96,7 +96,7 @@ public class TestChooser extends JFrame {
      */
     public TestChooser() throws HeadlessException {
         super("TestChooser");
-        /** This listener ends application when window is closed (x button on top right corner of test chooser).
+        /* This listener ends application when window is closed (x button on top right corner of test chooser).
          * @see issue#85 https://github.com/jMonkeyEngine/jmonkeyengine/issues/85
          */
         setDefaultCloseOperation(JDialog.DISPOSE_ON_CLOSE);

jme3-examples/src/main/java/jme3test/bullet/TestIssue877.java

@@ -31,13 +31,6 @@
  */
 package jme3test.bullet;
 
-/**
- * Test case for JME issue #877: multiple hinges. Based on code submitted by
- * Daniel Martensson.
- *
- * If successful, all pendulums will swing at the same frequency, and all the
- * free-falling objects will fall straight down.
- */
 import com.jme3.app.SimpleApplication;
 import com.jme3.bullet.BulletAppState;
 import com.jme3.bullet.collision.shapes.BoxCollisionShape;
@@ -48,6 +41,13 @@ import com.jme3.math.Quaternion;
 import com.jme3.math.Vector3f;
 import com.jme3.scene.Node;
 
+/**
+ * Test case for JME issue #877: multiple hinges. Based on code submitted by
+ * Daniel Martensson.
+ *
+ * If successful, all pendulums will swing at the same frequency, and all the
+ * free-falling objects will fall straight down.
+ */
 public class TestIssue877 extends SimpleApplication {
 
     final private BulletAppState bulletAppState = new BulletAppState();

jme3-examples/src/main/java/jme3test/bullet/TestIssue883.java

@@ -31,15 +31,15 @@
  */
 package jme3test.bullet;
 
-/**
- * Test case for JME issue #883: extra physicsTicks in ThreadingType.PARALLEL.
- *
- * If successful, physics time and frame time will advance at the same rate.
- */
 import com.jme3.app.SimpleApplication;
 import com.jme3.bullet.BulletAppState;
 import com.jme3.bullet.PhysicsSpace;
 
+/**
+ * Test case for JME issue #883: extra physicsTicks in ThreadingType.PARALLEL.
+ *
+ * <p></p>If successful, physics time and frame time will advance at the same rate.
+ */
 public class TestIssue883 extends SimpleApplication {
 
     private boolean firstPrint = true;

jme3-examples/src/main/java/jme3test/collision/TestMousePick.java

@@ -62,7 +62,7 @@ public class TestMousePick extends SimpleApplication {
         flyCam.setEnabled(false);
         initMark();
 
-        /** create four colored boxes and a floor to shoot at: */
+        /* Create four colored boxes and a floor to shoot at: */
         shootables = new Node("Shootables");
         rootNode.attachChild(shootables);
         shootables.attachChild(makeCube("a Dragon", -2f, 0f, 1f));

jme3-examples/src/main/java/jme3test/helloworld/HelloAnimation.java

@@ -65,12 +65,12 @@ public class HelloAnimation extends SimpleApplication {
     viewPort.setBackgroundColor(ColorRGBA.LightGray);
     initKeys();
 
-    /** Add a light source so we can see the model */
+    /* Add a light source so we can see the model */
     DirectionalLight dl = new DirectionalLight();
     dl.setDirection(new Vector3f(-0.1f, -1f, -1).normalizeLocal());
     rootNode.addLight(dl);
 
-    /** Load a model that contains animation */
+    /* Load a model that contains animation */
     Node player = (Node) assetManager.loadModel("Models/Oto/Oto.mesh.xml");
     player.setLocalScale(0.5f);
     rootNode.attachChild(player);
@@ -96,7 +96,7 @@ public class HelloAnimation extends SimpleApplication {
    * Callback to indicate that the "advance" animation action has completed.
    */
   void onAdvanceDone() {
-    /**
+    /*
      * Play the "stand" animation action.
      */
     control.setCurrentAction("stand");

jme3-examples/src/main/java/jme3test/helloworld/HelloAssets.java

@@ -77,13 +77,13 @@ public class HelloAssets extends SimpleApplication {
         helloText.setLocalTranslation(300, helloText.getLineHeight(), 0);
         guiNode.attachChild(helloText);
 
-        /** Load a Ninja model (OgreXML + material + texture from test_data) */
+        /* Load a Ninja model (OgreXML + material + texture from test_data) */
         Spatial ninja = assetManager.loadModel("Models/Ninja/Ninja.mesh.xml");
         ninja.scale(0.05f, 0.05f, 0.05f);
         ninja.rotate(0.0f, -3.0f, 0.0f);
         ninja.setLocalTranslation(0.0f, -5.0f, -2.0f);
         rootNode.attachChild(ninja);
-        /** You must add a light to make the model visible */
+        /* You must add a light to make the model visible. */
         DirectionalLight sun = new DirectionalLight();
         sun.setDirection(new Vector3f(-0.1f, -0.7f, -1.0f).normalizeLocal());
         rootNode.addLight(sun);

jme3-examples/src/main/java/jme3test/helloworld/HelloAudio.java

@@ -25,7 +25,7 @@ public class HelloAudio extends SimpleApplication {
   public void simpleInitApp() {
     flyCam.setMoveSpeed(40);
     
-    /** just a blue box floating in space */
+    /* just a blue box floating in space */
     Box box1 = new Box(1, 1, 1);
     Geometry player = new Geometry("Player", box1);
     Material mat1 = new Material(assetManager,"Common/MatDefs/Misc/Unshaded.j3md");
@@ -33,7 +33,7 @@ public class HelloAudio extends SimpleApplication {
     player.setMaterial(mat1);
     rootNode.attachChild(player);
 
-    /** custom init methods, see below */
+    /* custom init methods, see below */
     initKeys();
     initAudio();
   }

jme3-examples/src/main/java/jme3test/helloworld/HelloCollision.java

@@ -73,7 +73,7 @@ public class HelloCollision extends SimpleApplication
 
   @Override
   public void simpleInitApp() {
-    /** Set up Physics */
+    /* Set up Physics */
     BulletAppState bulletAppState = new BulletAppState();
     stateManager.attach(bulletAppState);
 

jme3-examples/src/main/java/jme3test/helloworld/HelloInput.java

@@ -68,13 +68,13 @@ public class HelloInput extends SimpleApplication {
 
   /** Custom Keybinding: Map named actions to inputs. */
   private void initKeys() {
-    /** You can map one or several inputs to one named mapping. */
+    /* You can map one or several inputs to one named mapping. */
     inputManager.addMapping("Pause",  new KeyTrigger(KeyInput.KEY_P));
     inputManager.addMapping("Left",   new KeyTrigger(KeyInput.KEY_J));
     inputManager.addMapping("Right",  new KeyTrigger(KeyInput.KEY_K));
     inputManager.addMapping("Rotate", new KeyTrigger(KeyInput.KEY_SPACE), // spacebar!
                                       new MouseButtonTrigger(MouseInput.BUTTON_LEFT) );        // left click!
-    /** Add the named mappings to the action listeners. */
+    /* Add the named mappings to the action listeners. */
     inputManager.addListener(actionListener,"Pause");
     inputManager.addListener(analogListener,"Left", "Right", "Rotate");
   }

jme3-examples/src/main/java/jme3test/helloworld/HelloLoop.java

@@ -52,7 +52,7 @@ public class HelloLoop extends SimpleApplication {
 
     @Override
     public void simpleInitApp() {
-        /** this blue box is our player character */
+        /* This blue box is our player character. */
         Box b = new Box(1, 1, 1);
         player = new Geometry("blue cube", b);
         Material mat = new Material(assetManager,

jme3-examples/src/main/java/jme3test/helloworld/HelloMaterial.java

@@ -57,7 +57,7 @@ public class HelloMaterial extends SimpleApplication {
   @Override
   public void simpleInitApp() {
 
-    /** A simple textured cube -- in good MIP map quality. */
+    /* A simple textured cube -- in good MIP map quality. */
     Box cube1Mesh = new Box( 1f,1f,1f);
     Geometry cube1Geo = new Geometry("My Textured Box", cube1Mesh);
     cube1Geo.setLocalTranslation(new Vector3f(-3f,1.1f,0f));
@@ -67,7 +67,7 @@ public class HelloMaterial extends SimpleApplication {
     cube1Geo.setMaterial(cube1Mat);
     rootNode.attachChild(cube1Geo);
 
-    /** A translucent/transparent texture, similar to a window frame. */
+    /* A translucent/transparent texture, similar to a window frame. */
     Box cube2Mesh = new Box( 1f,1f,0.01f);
     Geometry cube2Geo = new Geometry("window frame", cube2Mesh);
     Material cube2Mat = new Material(assetManager, "Common/MatDefs/Misc/Unshaded.j3md");
@@ -77,7 +77,7 @@ public class HelloMaterial extends SimpleApplication {
     cube2Geo.setMaterial(cube2Mat);
     rootNode.attachChild(cube2Geo);
 
-    /** A bumpy rock with a shiny light effect. To make bumpy objects you must create a NormalMap. */
+    /* A bumpy rock with a shiny light effect. To make bumpy objects you must create a NormalMap. */
     Sphere sphereMesh = new Sphere(32,32, 2f);
     Geometry sphereGeo = new Geometry("Shiny rock", sphereMesh);
     sphereMesh.setTextureMode(Sphere.TextureMode.Projected); // better quality on spheres
@@ -95,7 +95,7 @@ public class HelloMaterial extends SimpleApplication {
     sphereGeo.rotate(1.6f, 0, 0);          // Rotate it a bit
     rootNode.attachChild(sphereGeo);
     
-    /** Must add a light to make the lit object visible! */
+    /* Must add a light to make the lit object visible! */
     DirectionalLight sun = new DirectionalLight();
     sun.setDirection(new Vector3f(1,0,-2).normalizeLocal());
     sun.setColor(ColorRGBA.White);

jme3-examples/src/main/java/jme3test/helloworld/HelloNode.java

@@ -53,7 +53,7 @@ public class HelloNode extends SimpleApplication {
     @Override
     public void simpleInitApp() {
 
-        /** create a blue box at coordinates (1,-1,1) */
+        /* create a blue box at coordinates (1,-1,1) */
         Box box1 = new Box(1,1,1);
         Geometry blue = new Geometry("Box", box1);
         blue.setLocalTranslation(new Vector3f(1,-1,1));
@@ -62,7 +62,7 @@ public class HelloNode extends SimpleApplication {
         mat1.setColor("Color", ColorRGBA.Blue);
         blue.setMaterial(mat1);
 
-        /** create a red box straight above the blue one at (1,3,1) */
+        /* create a red box straight above the blue one at (1,3,1) */
         Box box2 = new Box(1,1,1);      
         Geometry red = new Geometry("Box", box2);
         red.setLocalTranslation(new Vector3f(1,3,1));
@@ -71,14 +71,14 @@ public class HelloNode extends SimpleApplication {
         mat2.setColor("Color", ColorRGBA.Red);
         red.setMaterial(mat2);
 
-        /** Create a pivot node at (0,0,0) and attach it to the root node */
+        /* Create a pivot node at (0,0,0) and attach it to the root node */
         Node pivot = new Node("pivot");
         rootNode.attachChild(pivot); // put this node in the scene
 
-        /** Attach the two boxes to the *pivot* node. (And transitively to the root node.) */
+        /* Attach the two boxes to the *pivot* node. (And transitively to the root node.) */
         pivot.attachChild(blue);
         pivot.attachChild(red);
-        /** Rotate the pivot node: Note that both boxes have rotated! */
+        /* Rotate the pivot node: Note that both boxes have rotated! */
         pivot.rotate(.4f,.4f,0f);
     }
 }

jme3-examples/src/main/java/jme3test/helloworld/HelloPhysics.java

@@ -1,4 +1,4 @@
-/**
+/*
  * Copyright (c) 2009-2021 jMonkeyEngine
  * All rights reserved.
  *
@@ -80,26 +80,26 @@ public class HelloPhysics extends SimpleApplication {
   private static final float brickHeight = 0.12f;
 
   static {
-    /** Initialize the cannon ball geometry */
+    /* Initialize the cannonball geometry */
     sphere = new Sphere(32, 32, 0.4f, true, false);
     sphere.setTextureMode(TextureMode.Projected);
-    /** Initialize the brick geometry */
+    /* Initialize the brick geometry */
     box = new Box(brickLength, brickHeight, brickWidth);
     box.scaleTextureCoordinates(new Vector2f(1f, .5f));
-    /** Initialize the floor geometry */
+    /* Initialize the floor geometry */
     floor = new Box(10f, 0.1f, 5f);
     floor.scaleTextureCoordinates(new Vector2f(3, 6));
   }
 
   @Override
   public void simpleInitApp() {
-    /** Set up Physics Game */
+    /* Set up Physics Game */
     bulletAppState = new BulletAppState();
     stateManager.attach(bulletAppState);
-    /** Configure cam to look at scene */
+    /* Configure cam to look at scene */
     cam.setLocation(new Vector3f(0, 4f, 6f));
     cam.lookAt(new Vector3f(2, 2, 0), Vector3f.UNIT_Y);
-    /** Initialize the scene, materials, inputs, and physics space */
+    /* Initialize the scene, materials, inputs, and physics space */
     initInputs();
     initMaterials();
     initWall();
@@ -178,15 +178,15 @@ public class HelloPhysics extends SimpleApplication {
 
   /** This method creates one individual physical brick. */
   private void makeBrick(Vector3f loc) {
-    /** Create a brick geometry and attach to scene graph. */
+    /* Create a brick geometry and attach it to the scene graph. */
     Geometry brick_geo = new Geometry("brick", box);
     brick_geo.setMaterial(wall_mat);
     rootNode.attachChild(brick_geo);
-    /** Position the brick geometry  */
+    /* Position the brick geometry. */
     brick_geo.setLocalTranslation(loc);
-    /** Make brick physical with a mass > 0.0f. */
+    /* Make brick physical with a mass > 0. */
     RigidBodyControl brick_phy = new RigidBodyControl(2f);
-    /** Add physical brick to physics space. */
+    /* Add physical brick to physics space. */
     brick_geo.addControl(brick_phy);
     bulletAppState.getPhysicsSpace().add(brick_phy);
   }
@@ -195,18 +195,18 @@ public class HelloPhysics extends SimpleApplication {
    * By default, the ball is accelerated and flies
    * from the camera position in the camera direction.*/
    public void makeCannonBall() {
-    /** Create a cannon ball geometry and attach to scene graph. */
+    /* Create a cannonball geometry and attach to scene graph. */
     Geometry ball_geo = new Geometry("cannon ball", sphere);
     ball_geo.setMaterial(stone_mat);
     rootNode.attachChild(ball_geo);
-    /** Position the cannon ball  */
+    /* Position the cannonball.  */
     ball_geo.setLocalTranslation(cam.getLocation());
-    /** Make the ball physical with a mass > 0.0f */
+    /* Make the ball physical with a mass > 0.0f */
     RigidBodyControl ball_phy = new RigidBodyControl(1f);
-    /** Add physical ball to physics space. */
+    /* Add physical ball to physics space. */
     ball_geo.addControl(ball_phy);
     bulletAppState.getPhysicsSpace().add(ball_phy);
-    /** Accelerate the physical ball to shoot it. */
+    /* Accelerate the physical ball to shoot it. */
     ball_phy.setLinearVelocity(cam.getDirection().mult(25));
   }
 

jme3-examples/src/main/java/jme3test/helloworld/HelloPicking.java

@@ -69,7 +69,7 @@ public class HelloPicking extends SimpleApplication {
     initKeys();       // load custom key mappings
     initMark();       // a red sphere to mark the hit
 
-    /** create four colored boxes and a floor to shoot at: */
+    /* Create four colored boxes and a floor to shoot at: */
     shootables = new Node("Shootables");
     rootNode.attachChild(shootables);
     shootables.attachChild(makeCube("a Dragon", -2f, 0f, 1f));

jme3-examples/src/main/java/jme3test/helloworld/HelloTerrain.java

@@ -53,42 +53,42 @@ public class HelloTerrain extends SimpleApplication {
   public void simpleInitApp() {
     flyCam.setMoveSpeed(50);
 
-    /** 1. Create terrain material and load four textures into it. */
+    /* 1. Create terrain material and load four textures into it. */
     Material mat_terrain = new Material(assetManager, 
             "Common/MatDefs/Terrain/Terrain.j3md");
 
-    /** 1.1) Add ALPHA map (for red-blue-green coded splat textures) */
+    /* 1.1) Add ALPHA map (for red-blue-green coded splat textures) */
     mat_terrain.setTexture("Alpha", assetManager.loadTexture(
             "Textures/Terrain/splat/alphamap.png"));
 
-    /** 1.2) Add GRASS texture into the red layer (Tex1). */
+    /* 1.2) Add GRASS texture into the red layer (Tex1). */
     Texture grass = assetManager.loadTexture(
             "Textures/Terrain/splat/grass.jpg");
     grass.setWrap(WrapMode.Repeat);
     mat_terrain.setTexture("Tex1", grass);
     mat_terrain.setFloat("Tex1Scale", 64f);
 
-    /** 1.3) Add DIRT texture into the green layer (Tex2) */
+    /* 1.3) Add DIRT texture into the green layer (Tex2) */
     Texture dirt = assetManager.loadTexture(
             "Textures/Terrain/splat/dirt.jpg");
     dirt.setWrap(WrapMode.Repeat);
     mat_terrain.setTexture("Tex2", dirt);
     mat_terrain.setFloat("Tex2Scale", 32f);
 
-    /** 1.4) Add ROAD texture into the blue layer (Tex3) */
+    /* 1.4) Add ROAD texture into the blue layer (Tex3) */
     Texture rock = assetManager.loadTexture(
             "Textures/Terrain/splat/road.jpg");
     rock.setWrap(WrapMode.Repeat);
     mat_terrain.setTexture("Tex3", rock);
     mat_terrain.setFloat("Tex3Scale", 128f);
 
-    /** 2.a Create a custom height map from an image */
+    /* 2.a Create a custom height map from an image */
     AbstractHeightMap heightmap = null;
     Texture heightMapImage = assetManager.loadTexture(
             "Textures/Terrain/splat/mountains512.png");
     heightmap = new ImageBasedHeightMap(heightMapImage.getImage());
     
-/** 2.b Create a random height map */    
+/* 2.b Create a random height map */
 //      HillHeightMap heightmap = null;
 //      HillHeightMap.NORMALIZE_RANGE = 100;
 //      try {
@@ -99,7 +99,7 @@ public class HelloTerrain extends SimpleApplication {
 
     heightmap.load();
 
-    /** 3. We have prepared material and heightmap. 
+    /* 3. We have prepared material and heightmap.
      * Now we create the actual terrain:
      * 3.1) Create a TerrainQuad and name it "my terrain".
      * 3.2) A good value for terrain tiles is 64x64 -- so we supply 64+1=65.
@@ -111,13 +111,13 @@ public class HelloTerrain extends SimpleApplication {
     TerrainQuad terrain
             = new TerrainQuad("my terrain", patchSize, 513, heightmap.getHeightMap());
 
-    /** 4. We give the terrain its material, position & scale it, and attach it. */
+    /* 4. We give the terrain its material, position & scale it, and attach it. */
     terrain.setMaterial(mat_terrain);
     terrain.setLocalTranslation(0, -100, 0);
     terrain.setLocalScale(2f, 1f, 2f);
     rootNode.attachChild(terrain);
 
-    /** 5. The LOD (level of detail) depends on were the camera is: */
+    /* 5. The LOD (level of detail) depends on were the camera is: */
     TerrainLodControl control = new TerrainLodControl(terrain, getCamera());
     control.setLodCalculator( new DistanceLodCalculator(patchSize, 2.7f) ); // patch size, and a multiplier
     terrain.addControl(control);

jme3-examples/src/main/java/jme3test/helloworld/HelloTerrainCollision.java

@@ -76,50 +76,50 @@ public class HelloTerrainCollision extends SimpleApplication
 
   @Override
   public void simpleInitApp() {
-    /** Set up Physics */
+    /* Set up physics */
     bulletAppState = new BulletAppState();
     stateManager.attach(bulletAppState);
     
     flyCam.setMoveSpeed(100);
     setUpKeys();
 
-    /** 1. Create terrain material and load four textures into it. */
+    /* 1. Create terrain material and load four textures into it. */
     Material mat_terrain = new Material(assetManager, 
             "Common/MatDefs/Terrain/Terrain.j3md");
 
-    /** 1.1) Add ALPHA map (for red-blue-green coded splat textures) */
+    /* 1.1) Add ALPHA map (for red-blue-green coded splat textures) */
     mat_terrain.setTexture("Alpha", assetManager.loadTexture(
             "Textures/Terrain/splat/alphamap.png"));
 
-    /** 1.2) Add GRASS texture into the red layer (Tex1). */
+    /* 1.2) Add GRASS texture into the red layer (Tex1). */
     Texture grass = assetManager.loadTexture(
             "Textures/Terrain/splat/grass.jpg");
     grass.setWrap(WrapMode.Repeat);
     mat_terrain.setTexture("Tex1", grass);
     mat_terrain.setFloat("Tex1Scale", 64f);
 
-    /** 1.3) Add DIRT texture into the green layer (Tex2) */
+    /* 1.3) Add DIRT texture into the green layer (Tex2) */
     Texture dirt = assetManager.loadTexture(
             "Textures/Terrain/splat/dirt.jpg");
     dirt.setWrap(WrapMode.Repeat);
     mat_terrain.setTexture("Tex2", dirt);
     mat_terrain.setFloat("Tex2Scale", 32f);
 
-    /** 1.4) Add ROAD texture into the blue layer (Tex3) */
+    /* 1.4) Add ROAD texture into the blue layer (Tex3) */
     Texture rock = assetManager.loadTexture(
             "Textures/Terrain/splat/road.jpg");
     rock.setWrap(WrapMode.Repeat);
     mat_terrain.setTexture("Tex3", rock);
     mat_terrain.setFloat("Tex3Scale", 128f);
 
-    /** 2. Create the height map */
+    /* 2. Create the height map */
     AbstractHeightMap heightmap = null;
     Texture heightMapImage = assetManager.loadTexture(
             "Textures/Terrain/splat/mountains512.png");
     heightmap = new ImageBasedHeightMap(heightMapImage.getImage());
     heightmap.load();
 
-    /** 3. We have prepared material and heightmap. 
+    /* 3. We have prepared material and heightmap.
      * Now we create the actual terrain:
      * 3.1) Create a TerrainQuad and name it "my terrain".
      * 3.2) A good value for terrain tiles is 64x64 -- so we supply 64+1=65.
@@ -130,19 +130,19 @@ public class HelloTerrainCollision extends SimpleApplication
     TerrainQuad terrain
             = new TerrainQuad("my terrain", 65, 513, heightmap.getHeightMap());
 
-    /** 4. We give the terrain its material, position & scale it, and attach it. */
+    /* 4. We give the terrain its material, position & scale it, and attach it. */
     terrain.setMaterial(mat_terrain);
     terrain.setLocalTranslation(0, -100, 0);
     terrain.setLocalScale(2f, 1f, 2f);
     rootNode.attachChild(terrain);
 
-    /** 5. The LOD (level of detail) depends on were the camera is: */
+    /* 5. The LOD (level of detail) depends on were the camera is: */
     List<Camera> cameras = new ArrayList<>();
     cameras.add(getCamera());
     TerrainLodControl control = new TerrainLodControl(terrain, cameras);
     terrain.addControl(control);
     
-    /** 6. Add physics: */ 
+    /* 6. Add physics: */
     /* We set up collision detection for the scene by creating a static 
      * RigidBodyControl with mass zero.*/
     terrain.addControl(new RigidBodyControl(0));

jme3-examples/src/main/java/jme3test/light/TestConeVSFrustum.java

@@ -214,7 +214,7 @@ public class TestConeVSFrustum extends SimpleApplication {
                 }
             }
         }, "click", "middleClick", "shift");
-        /**
+        /*
          * An unshaded textured cube.
          * Uses texture from jme3-testdata library!
          */

jme3-examples/src/main/java/jme3test/light/TestManyLightsSingle.java

@@ -204,7 +204,7 @@ public class TestManyLightsSingle extends SimpleApplication {
         rootNode.addLight(al);
 
 
-        /**
+        /*
          * Write text on the screen (HUD)
          */
         guiNode.detachAllChildren();

jme3-examples/src/main/java/jme3test/light/TestTangentCube.java

@@ -74,7 +74,7 @@ public class TestTangentCube extends SimpleApplication {
         aGeometry.rotate(FastMath.QUARTER_PI, FastMath.QUARTER_PI, 0.0f);
         rootNode.attachChild(aGeometry);
 
-        /**
+        /*
          * Must add a light to make the lit object visible!
          */
         PointLight aLight = new PointLight();

jme3-examples/src/main/java/jme3test/model/anim/TestSkeletonControlRefresh.java

@@ -31,12 +31,6 @@
  */
 package jme3test.model.anim;
 
-/**
- *
- * @author Nehon
- */
-
-
 import com.jme3.anim.AnimClip;
 import com.jme3.anim.AnimComposer;
 import com.jme3.anim.SkinningControl;
@@ -63,6 +57,9 @@ import com.jme3.shadow.DirectionalLightShadowFilter;
 import java.util.ArrayList;
 import java.util.List;
 
+/**
+ * @author Nehon
+ */
 public class TestSkeletonControlRefresh extends SimpleApplication implements ActionListener{
 
     private final static int SIZE = 10;

jme3-examples/src/main/java/jme3test/terrain/TerrainTest.java

@@ -146,7 +146,7 @@ public class TerrainTest extends SimpleApplication {
          * Here we create the actual terrain. The tiles will be 65x65, and the total size of the
          * terrain will be 513x513. It uses the heightmap we created to generate the height values.
          */
-        /**
+        /*
          * Optimal terrain patch size is 65 (64x64).
          * The total size is up to you. At 1025, it ran fine for me (200+FPS), however at
          * size=2049, it got really slow. But that is a jump from 2 million to 8 million triangles...

jme3-examples/src/main/java/jme3test/terrain/TerrainTestAdvanced.java

@@ -194,7 +194,7 @@ public class TerrainTestAdvanced extends SimpleApplication {
          * Here we create the actual terrain. The tiles will be 65x65, and the total size of the
          * terrain will be 513x513. It uses the heightmap we created to generate the height values.
          */
-        /**
+        /*
          * Optimal terrain patch size is 65 (64x64).
          * The total size is up to you. At 1025, it ran fine for me (200+FPS), however at
          * size=2049 it got really slow. But that is a jump from 2 million to 8 million triangles...

jme3-examples/src/main/java/jme3test/terrain/TerrainTestCollision.java

@@ -140,7 +140,7 @@ public class TerrainTestCollision extends SimpleApplication {
         // if set to false, only the first collision is returned and collision is slightly faster.
         terrain.setSupportMultipleCollisions(true);
 
-        /**
+        /*
          * Create PhysicsRigidBodyControl for collision
          */
         terrain.addControl(new RigidBodyControl(0));

jme3-terrain/src/main/java/com/jme3/terrain/Terrain.java

@@ -174,7 +174,7 @@ public interface Terrain {
      */
     public int getTerrainSize();
 
-    /**
+    /*
      * Get the scale of the texture coordinates. Normally if the texture is
      * laid on the terrain and not scaled so that the texture does not repeat,
      * then each texture coordinate (on a vertex) will be 1/(terrain size).

jme3-terrain/src/main/java/com/jme3/terrain/geomipmap/grid/ImageTileLoader.java

@@ -79,7 +79,7 @@ public class ImageTileLoader implements TerrainGridTileLoader{
     }
     
     
-    /**
+    /*
      * Lets you specify the type of images that are being loaded. All images
      * must be the same type.
      * @param imageType eg. BufferedImage.TYPE_USHORT_GRAY
@@ -88,7 +88,7 @@ public class ImageTileLoader implements TerrainGridTileLoader{
         this.imageType = imageType;
     }*/
 
-    /**
+    /*
      * The ImageHeightmap that will parse the image type that you 
      * specify with setImageType().
      * @param customImageHeightmap must extend AbstractHeightmap

jme3-terrain/src/main/java/com/jme3/terrain/heightmap/HeightMapGrid.java

@@ -36,11 +36,9 @@ import com.jme3.math.Vector3f;
 /**
  *
  * @author Anthyon
- */
-@Deprecated
-/**
  * @Deprecated in favor of TerrainGridTileLoader
  */
+@Deprecated
 public interface HeightMapGrid {
 
     public HeightMap getHeightMapAt(Vector3f location);

jme3-terrain/src/main/java/com/jme3/terrain/noise/Basis.java

@@ -1,4 +1,4 @@
-/**
+/*
  * Copyright (c) 2011, Novyon Events
  * 
  * All rights reserved.

jme3-terrain/src/main/java/com/jme3/terrain/noise/Color.java

@@ -1,4 +1,4 @@
-/**
+/*
  * Copyright (c) 2011, Novyon Events
  * 
  * All rights reserved.

jme3-terrain/src/main/java/com/jme3/terrain/noise/Filter.java

@@ -1,4 +1,4 @@
-/**
+/*
  * Copyright (c) 2011, Novyon Events
  * 
  * All rights reserved.

jme3-terrain/src/main/java/com/jme3/terrain/noise/ShaderUtils.java

@@ -1,4 +1,4 @@
-/**
+/*
  * Copyright (c) 2011, Novyon Events
  * 
  * All rights reserved.

jme3-terrain/src/main/java/com/jme3/terrain/noise/basis/FilteredBasis.java

@@ -1,4 +1,4 @@
-/**
+/*
  * Copyright (c) 2011, Novyon Events
  * 
  * All rights reserved.

jme3-terrain/src/main/java/com/jme3/terrain/noise/basis/ImprovedNoise.java

@@ -1,4 +1,4 @@
-/**
+/*
  * Copyright (c) 2011, Novyon Events
  * 
  * All rights reserved.

jme3-terrain/src/main/java/com/jme3/terrain/noise/basis/Noise.java

@@ -1,4 +1,4 @@
-/**
+/*
  * Copyright (c) 2011, Novyon Events
  * 
  * All rights reserved.

jme3-terrain/src/main/java/com/jme3/terrain/noise/basis/NoiseAggregator.java

@@ -1,4 +1,4 @@
-/**
+/*
  * Copyright (c) 2011, Novyon Events
  * 
  * All rights reserved.

jme3-terrain/src/main/java/com/jme3/terrain/noise/filter/AbstractFilter.java

@@ -1,4 +1,4 @@
-/**
+/*
  * Copyright (c) 2011, Novyon Events
  * 
  * All rights reserved.

jme3-terrain/src/main/java/com/jme3/terrain/noise/filter/HydraulicErodeFilter.java

@@ -1,4 +1,4 @@
-/**
+/*
  * Copyright (c) 2011-2018, Novyon Events
  * 
  * All rights reserved.

jme3-terrain/src/main/java/com/jme3/terrain/noise/filter/IterativeFilter.java

@@ -1,4 +1,4 @@
-/**
+/*
  * Copyright (c) 2011, Novyon Events
  * 
  * All rights reserved.

jme3-terrain/src/main/java/com/jme3/terrain/noise/filter/OptimizedErode.java

@@ -1,4 +1,4 @@
-/**
+/*
  * Copyright (c) 2011, Novyon Events
  * 
  * All rights reserved.

jme3-terrain/src/main/java/com/jme3/terrain/noise/filter/PerturbFilter.java

@@ -1,4 +1,4 @@
-/**
+/*
  * Copyright (c) 2011, Novyon Events
  * 
  * All rights reserved.

jme3-terrain/src/main/java/com/jme3/terrain/noise/filter/SmoothFilter.java

@@ -1,4 +1,4 @@
-/**
+/*
  * Copyright (c) 2011, Novyon Events
  * 
  * All rights reserved.

jme3-terrain/src/main/java/com/jme3/terrain/noise/filter/ThermalErodeFilter.java

@@ -1,4 +1,4 @@
-/**
+/*
  * Copyright (c) 2011, Novyon Events
  * 
  * All rights reserved.

jme3-terrain/src/main/java/com/jme3/terrain/noise/fractal/Fractal.java

@@ -1,4 +1,4 @@
-/**
+/*
  * Copyright (c) 2011, Novyon Events
  * 
  * All rights reserved.

jme3-terrain/src/main/java/com/jme3/terrain/noise/fractal/FractalSum.java

@@ -1,4 +1,4 @@
-/**
+/*
  * Copyright (c) 2011, Novyon Events
  * 
  * All rights reserved.

jme3-terrain/src/main/java/com/jme3/terrain/noise/modulator/CatRom2.java

@@ -1,4 +1,4 @@
-/**
+/*
  * Copyright (c) 2011, Novyon Events
  * 
  * All rights reserved.

jme3-terrain/src/main/java/com/jme3/terrain/noise/modulator/Modulator.java

@@ -1,4 +1,4 @@
-/**
+/*
  * Copyright (c) 2011, Novyon Events
  * 
  * All rights reserved.

jme3-terrain/src/main/java/com/jme3/terrain/noise/modulator/NoiseModulator.java

@@ -1,4 +1,4 @@
-/**
+/*
  * Copyright (c) 2011, Novyon Events
  * 
  * All rights reserved.

jme3-vr/src/main/java/com/jme3/input/vr/lwjgl_openvr/LWJGLOpenVRViewManager.java

@@ -120,10 +120,10 @@ public class LWJGLOpenVRViewManager extends AbstractVRViewManager {
         }
     }
 
-    @Override
     /**
      * updatePose can be called here because appstates are always called before the main renderer. This way we get the latest pose close to when it's supposed to render
      */
+    @Override
     public void render() {
         if (environment != null) {
             // grab the observer