correct errors in documentation (#1581)

* correct typos in comments

* correct typos in Gradle variables

* correct typos in Java comments and Javadoc

* correct typos in non-Java comments

* Skeleton.java: don't replace "matrixes" with "matrices"

.github/workflows/main.yml

@@ -26,7 +26,7 @@
 #   is running the build.
 # >> Configure  JAVADOC
 #     JAVADOC_GHPAGES_REPO="riccardoblsandbox/javadoc.jmonkeyengine.org.git"
-#   Generate a deloy key
+#   Generate a deploy key
 #       ssh-keygen -t rsa -b 4096 -C "[email protected]" -f javadoc_deploy
 #   Set
 #     JAVADOC_GHPAGES_DEPLOY_PRIVKEY="......."

build.gradle

@@ -181,18 +181,18 @@ gradle.rootProject.ext.set("usePrebuildNatives", buildNativeProjects!="true");
 if (skipPrebuildLibraries != "true" && buildNativeProjects != "true") {
     String rootPath = rootProject.projectDir.absolutePath
 
-    Properties nativesSnasphotProp = new Properties()
-    File nativesSnasphotPropF = new File("${rootPath}/natives-snapshot.properties");
+    Properties nativesSnapshotProp = new Properties()
+    File nativesSnapshotPropF = new File("${rootPath}/natives-snapshot.properties");
 
-    if (nativesSnasphotPropF.exists()) {
+    if (nativesSnapshotPropF.exists()) {
 
-        nativesSnasphotPropF.withInputStream { nativesSnasphotProp.load(it) }
+        nativesSnapshotPropF.withInputStream { nativesSnapshotProp.load(it) }
 
-        String nativesSnasphot = nativesSnasphotProp.getProperty("natives.snapshot");
-        String nativesUrl = PREBUILD_NATIVES_URL.replace('${natives.snapshot}', nativesSnasphot)
+        String nativesSnapshot = nativesSnapshotProp.getProperty("natives.snapshot");
+        String nativesUrl = PREBUILD_NATIVES_URL.replace('${natives.snapshot}', nativesSnapshot)
         println "Use natives snapshot: " + nativesUrl
 
-        String nativesZipFile = "${rootPath}" + File.separator + "build" + File.separator + nativesSnasphot + "-natives.zip"
+        String nativesZipFile = "${rootPath}" + File.separator + "build" + File.separator + nativesSnapshot + "-natives.zip"
         String nativesPath = "${rootPath}" + File.separator + "build" + File.separator + "native"
 
 

jme3-android-examples/src/main/java/org/jmonkeyengine/jme3androidexamples/MainActivity.java

@@ -263,7 +263,7 @@ public class MainActivity extends AppCompatActivity implements OnItemClickListen
         boolean include = true;
         /* check to see if the class in inside the rootPackage package */
         if (className.startsWith(rootPackage)) {
-            /* check to see if the class contains any of the exlusion strings */
+            /* check to see if the class contains any of the exclusion strings */
             for (int i = 0; i < exclusions.size(); i++) {
                 if (className.contains(exclusions.get(i))) {
                     Log.d(TAG, "Skipping Class " + className + ". Includes exclusion string: " + exclusions.get(i) + ".");

jme3-android-native/decode.gradle

@@ -96,7 +96,7 @@ if (ndkExists && buildNativeProjects == "true") {
 
 jar.into("lib") { from decodeBuildLibsDir }
 
-// Helper class to wrap ant dowload task
+// Helper class to wrap ant download task
 class MyDownload extends DefaultTask {
     @Input
     String sourceUrl

jme3-android-native/openalsoft.gradle

@@ -124,7 +124,7 @@ if (ndkExists && buildNativeProjects == "true") {
 
 jar.into("lib") { from openalsoftBuildLibsDir }
 
-// Helper class to wrap ant dowload task
+// Helper class to wrap ant download task
 class MyDownload extends DefaultTask {
     @Input
     String sourceUrl

jme3-android/src/main/java/com/jme3/app/AndroidHarness.java

@@ -211,7 +211,7 @@ public class AndroidHarness extends Activity implements TouchListener, DialogInt
             logger.log(Level.FINE, "Using Retained App");
             this.app = data.app;
         } else {
-            // Discover the screen reolution
+            // Discover the screen resolution
             //TODO try to find a better way to get a hand on the resolution
             WindowManager wind = this.getWindowManager();
             Display disp = wind.getDefaultDisplay();

jme3-android/src/main/java/com/jme3/input/android/AndroidGestureProcessor.java

@@ -1,5 +1,5 @@
 /*
- * Copyright (c) 2009-2012 jMonkeyEngine
+ * Copyright (c) 2009-2021 jMonkeyEngine
  * All rights reserved.
  *
  * Redistribution and use in source and binary forms, with or without
@@ -116,11 +116,11 @@ public class AndroidGestureProcessor implements
 
     @Override
     public boolean onScroll(MotionEvent startEvent, MotionEvent endEvent, float distX, float distY) {
-        // if not scaleInProgess, send scroll events.  This is to avoid sending
+        // if not scaleInProgress, send scroll events.  This is to avoid sending
         // scroll events when one of the fingers is lifted just before the other one.
         // Avoids sending the scroll for that brief period of time.
         // Return true so that the next event doesn't accumulate the distX and distY values.
-        // Apparantly, both distX and distY are negative.
+        // Apparently, both distX and distY are negative.
         // Negate distX to get the real value, but leave distY negative to compensate
         // for the fact that jME has y=0 at bottom where Android has y=0 at top.
         if (!touchInput.getScaleDetector().isInProgress()) {

jme3-android/src/main/java/com/jme3/input/android/AndroidJoyInput.java

@@ -59,7 +59,7 @@ import java.util.logging.Logger;
  * case, when joystick.rumble(rumbleAmount) is called, the Android device will vibrate
  * if the device has a built in vibrate motor.
  *
- * Because Andorid does not allow for the user to define the intensity of the
+ * Because Android does not allow for the user to define the intensity of the
  * vibration, the rumble amount (ie strength) is converted into vibration pulses
  * The stronger the strength amount, the shorter the delay between pulses.  If
  * amount is 1, then the vibration stays on the whole time.  If amount is 0.5,

jme3-android/src/main/java/com/jme3/input/android/AndroidTouchInput.java

@@ -57,7 +57,7 @@ import java.util.logging.Logger;
  * AndroidTouchInput is the base class that receives touch inputs from the
  * Android system and creates the TouchEvents for jME.  This class is designed
  * to handle the base touch events for Android rev 9 (Android 2.3).  This is
- * extended by other classes to add features that were introducted after
+ * extended by other classes to add features that were introduced after
  * Android rev 9.
  *
  * @author iwgeric

jme3-bullet/src/common/java/com/jme3/bullet/control/BetterCharacterControl.java

@@ -219,7 +219,7 @@ public class BetterCharacterControl extends AbstractPhysicsControl implements Ph
         float designatedVelocity = walkDirection.length();
         if (designatedVelocity > 0) {
             Vector3f localWalkDirection = vars.vect1;
-            //normalize walkdirection
+            //normalize walkDirection
             localWalkDirection.set(walkDirection).normalizeLocal();
             //check for the existing velocity in the desired direction
             float existingVelocity = velocity.dot(localWalkDirection);

jme3-bullet/src/common/java/com/jme3/bullet/control/KinematicRagdollControl.java

@@ -322,7 +322,7 @@ public class KinematicRagdollControl extends AbstractPhysicsControl implements P
             //if the bone is the root bone, we apply the physic's transform to the model, so its position and rotation are correctly updated
             if (link.bone.getParent() == null) {
 
-                //offsetting the physic's position/rotation by the root bone inverse model space position/rotaion
+                //offsetting the physics position/rotation by the root bone inverse model space position/rotation
                 modelPosition.set(p).subtractLocal(link.bone.getBindPosition());
                 targetModel.getParent().getWorldTransform().transformInverseVector(modelPosition, modelPosition);
                 modelRotation.set(q).multLocal(tmpRot2.set(link.bone.getBindRotation()).inverseLocal());
@@ -337,8 +337,8 @@ public class KinematicRagdollControl extends AbstractPhysicsControl implements P
                 link.bone.setUserTransformsInModelSpace(position, tmpRot1);
 
             } else {
-                //some bones of the skeleton might not be associated with a collision shape.
-                //So we update them recusively
+                //some bones of the skeleton might not be associated with a collision shape
+                //so we update them recursively
                 RagdollUtils.setTransform(link.bone, position, tmpRot1, false, boneList);
             }
         }
@@ -351,7 +351,7 @@ public class KinematicRagdollControl extends AbstractPhysicsControl implements P
      * @param tpf the time interval between frames (in seconds, ≥0)
      */
     protected void kinematicUpdate(float tpf) {
-        //the ragdoll does not have control, so the keyframed animation updates the physics position of the physics bonces
+        //the ragdoll does not have control, so the keyframe animation updates the physics position of the physics bones
         TempVars vars = TempVars.get();
         Quaternion tmpRot1 = vars.quat1;
         Quaternion tmpRot2 = vars.quat2;
@@ -360,7 +360,7 @@ public class KinematicRagdollControl extends AbstractPhysicsControl implements P
 //            if(link.usedbyIK){
 //                continue;
 //            }
-            //if blended control this means, keyframed animation is updating the skeleton,
+            //blended control means keyframe animation is updating the skeleton,
             //but to allow smooth transition, we blend this transformation with the saved position of the ragdoll
             if (blendedControl) {
                 Vector3f position2 = vars.vect2;
@@ -368,7 +368,7 @@ public class KinematicRagdollControl extends AbstractPhysicsControl implements P
                 position.set(link.startBlendingPos);
                 tmpRot1.set(link.startBlendingRot);
 
-                //interpolating between ragdoll position/rotation and keyframed position/rotation
+                //interpolate between ragdoll position/rotation and keyframe position/rotation
                 tmpRot2.set(tmpRot1).nlerp(link.bone.getModelSpaceRotation(), blendStart / blendTime);
                 position2.set(position).interpolateLocal(link.bone.getModelSpacePosition(), blendStart / blendTime);
                 tmpRot1.set(tmpRot2);

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

@@ -323,7 +323,7 @@ public class RagdollUtils {
                 setTransform(childBone, t.getTranslation(), t.getRotation(), restoreBoneControl, boneList);
             }
         }
-        //we give back the control to the keyframed animation
+        // return control to the keyframe animation
         if (restoreBoneControl) {
             bone.setUserControl(false);
         }

jme3-bullet/src/common/java/com/jme3/bullet/util/CollisionShapeFactory.java

@@ -185,7 +185,7 @@ public class CollisionShapeFactory {
      * @param spatial the spatial on which to base the shape (not null)
      * @return A MeshCollisionShape or a CompoundCollisionShape with
      * MeshCollisionShapes as children if the supplied spatial is a Node. A
-     * HeightieldCollisionShape if a TerrainQuad was supplied.
+     * HeightfieldCollisionShape if a TerrainQuad was supplied.
      */
     public static CollisionShape createMeshShape(Spatial spatial) {
         if (spatial instanceof TerrainQuad) {

jme3-core/src/main/java/com/jme3/anim/AnimFactory.java

@@ -58,7 +58,7 @@ import java.util.TreeSet;
  * it's possible for
  * {@link #buildAnimation(com.jme3.anim.util.HasLocalTransform)} to negate the
  * final rotation. To prevent an unwanted rotation at the end of the loop, you
- * may need to add intemediate rotation keyframes.
+ * may need to add intermediate rotation keyframes.
  *
  * Inspired by Nehon's {@link com.jme3.animation.AnimationFactory}.
  */

jme3-core/src/main/java/com/jme3/anim/SkinningControl.java

@@ -337,7 +337,7 @@ public class SkinningControl extends AbstractControl implements Cloneable, JmeCl
                 bpb.clear();
                 bnb.clear();
 
-                //reseting bind tangents if there is a bind tangent buffer
+                //resetting bind tangents if there is a bind tangent buffer
                 VertexBuffer bindTangents = mesh.getBuffer(Type.BindPoseTangent);
                 if (bindTangents != null) {
                     VertexBuffer tangents = mesh.getBuffer(Type.Tangent);
@@ -457,7 +457,7 @@ public class SkinningControl extends AbstractControl implements Cloneable, JmeCl
      * Method to apply skinning transforms to a mesh's buffers
      *
      * @param mesh           the mesh
-     * @param offsetMatrices the offset matices to apply
+     * @param offsetMatrices the offset matrices to apply
      */
     private void applySkinning(Mesh mesh, Matrix4f[] offsetMatrices) {
         int maxWeightsPerVert = mesh.getMaxNumWeights();

jme3-core/src/main/java/com/jme3/anim/tween/AbstractTween.java

@@ -1,5 +1,5 @@
 /*
- * Copyright (c) 2015-2020 jMonkeyEngine
+ * Copyright (c) 2015-2021 jMonkeyEngine
  * All rights reserved.
  *
  * Redistribution and use in source and binary forms, with or without
@@ -36,7 +36,7 @@ import com.jme3.util.clone.JmeCloneable;
 
 /**
  * Base implementation of the Tween interface that provides
- * default implementations of the getLength() and interopolate()
+ * default implementations of the getLength() and interpolate()
  * methods that provide common tween clamping and bounds checking.
  * Subclasses need only override the doInterpolate() method and
  * the rest is handled for them.

jme3-core/src/main/java/com/jme3/animation/AnimationFactory.java

@@ -84,7 +84,7 @@ public class AnimationFactory {
          */
         Vector3f eulerAngles = new Vector3f();
         /**
-         * the index of the parent key frame is this keyFrame is a splitted rotation
+         * the index of the parent key frame is this keyFrame is a split rotation
          */
         int masterKeyFrame = -1;
 
@@ -425,11 +425,11 @@ public class AnimationFactory {
             if (key != -1) {
                 //computing the frame span to interpolate over
                 int span = key - i;
-                //interating over the frames
+                //iterating over the frames
                 for (int j = i; j <= key; j++) {
                     // computing interpolation value
                     float val = (j - i) / (float) span;
-                    //interpolationg depending on the transform type
+                    //interpolating depending on the transform type
                     switch (type) {
                         case Translation:
                             translations[j] = FastMath.interpolateLinear(val, (Vector3f) keyFrames[i], (Vector3f) keyFrames[key]);

jme3-core/src/main/java/com/jme3/animation/AudioTrack.java

@@ -49,7 +49,7 @@ import java.util.logging.Logger;
  * usage is
  * <pre>
  * AnimControl control model.getControl(AnimControl.class);
- * AudioTrack track = new AudioTrack(existionAudioNode, control.getAnim("TheAnim").getLength());
+ * AudioTrack track = new AudioTrack(existingAudioNode, control.getAnim("TheAnim").getLength());
  * control.getAnim("TheAnim").addTrack(track);
  * </pre>
  *

jme3-core/src/main/java/com/jme3/animation/SkeletonControl.java

@@ -453,7 +453,7 @@ public class SkeletonControl extends AbstractControl implements Cloneable, JmeCl
      * Method to apply skinning transforms to a mesh's buffers
      *
      * @param mesh the mesh
-     * @param offsetMatrices the offset matices to apply
+     * @param offsetMatrices the offset matrices to apply
      */
     private void applySkinning(Mesh mesh, Matrix4f[] offsetMatrices) {
         int maxWeightsPerVert = mesh.getMaxNumWeights();
@@ -560,7 +560,7 @@ public class SkeletonControl extends AbstractControl implements Cloneable, JmeCl
      *
      * @param maxWeightsPerVert maximum number of weights per vertex
      * @param mesh the mesh
-     * @param offsetMatrices the offsetMaytrices to apply
+     * @param offsetMatrices the offset matrices to apply
      * @param tb the tangent vertexBuffer
      */
     private void applySkinningTangents(Mesh mesh, Matrix4f[] offsetMatrices, VertexBuffer tb) {

jme3-core/src/main/java/com/jme3/animation/package.html

@@ -48,9 +48,9 @@ If a vertex is influenced by less than 4 bones, the indices following the last
 valid bone should be 0 and the weights following the last valid bone should be 0.0.
 The buffers are designed in such a way so as to permit hardware skinning.<br>
 <p>
-The {@link com.jme3.animation.Skeleton} class describes a bone heirarchy with one
+The {@link com.jme3.animation.Skeleton} class describes a bone hierarchy with one
 or more root bones having children, thus containing all bones of the skeleton.
-In addition to accessing the bones in the skeleton via the tree heirarchy, it
+In addition to accessing the bones in the skeleton via the tree hierarchy, it
 is also possible to access bones via index. The index for any given bone is
 arbitrary and does not depend on the bone's location in the tree hierarchy.
 It is this index that is specified in the BoneIndex VertexBuffer mentioned above

jme3-core/src/main/java/com/jme3/app/Application.java

@@ -169,13 +169,13 @@ public interface Application {
 
     /**
      * Starts the application.
-     * A bug occuring when using LWJGL3 prevents this method from returning until after the application is stopped.
+     * A bug occurring when using LWJGL3 prevents this method from returning until after the application is stopped.
      */
     public void start();
 
     /**
      * Starts the application.
-     * A bug occuring when using LWJGL3 prevents this method from returning until after the application is stopped.
+     * A bug occurring when using LWJGL3 prevents this method from returning until after the application is stopped.
      *
      * @param waitFor true→wait for the context to be initialized,
      * false→don't wait

jme3-core/src/main/java/com/jme3/app/LegacyApplication.java

@@ -274,7 +274,7 @@ public class LegacyApplication implements Application, SystemListener {
     }
 
     private void initDisplay(){
-        // aquire important objects
+        // acquire important objects
         // from the context
         settings = context.getSettings();
 
@@ -310,7 +310,7 @@ public class LegacyApplication implements Application, SystemListener {
         cam.lookAt(new Vector3f(0f, 0f, 0f), Vector3f.UNIT_Y);
 
         renderManager = new RenderManager(renderer);
-        //Remy - 09/14/2010 setted the timer in the renderManager
+        //Remy - 09/14/2010 set the timer in the renderManager
         renderManager.setTimer(timer);
 
         if (prof != null) {

jme3-core/src/main/java/com/jme3/app/ResetStatsState.java

@@ -1,5 +1,5 @@
 /*
- * Copyright (c) 2009-2012 jMonkeyEngine
+ * Copyright (c) 2009-2021 jMonkeyEngine
  * All rights reserved.
  *
  * Redistribution and use in source and binary forms, with or without
@@ -39,7 +39,7 @@ import com.jme3.renderer.RenderManager;
  *  Resets (clearFrame()) the render's stats object every frame
  *  during AppState.render().  This state is registered once
  *  with Application to ensure that the stats are cleared once
- *  a frame.  Using this makes sure that any Appliction based
+ *  a frame.  Using this makes sure that any Application-based
  *  application that properly runs its state manager will have
  *  stats reset no matter how many views it has or if it even
  *  has views.

jme3-core/src/main/java/com/jme3/app/package.html

@@ -27,7 +27,7 @@ An <code>Application</code> will typically provide the following services:
     <li>{@link com.jme3.audio.AudioRenderer} - Allows playing sound effects and 
         music.</li>
     <li>{@link com.jme3.system.Timer} - The timer keeps track of time and allows
-        computing the time since the last frame (TPF) that is neccessary
+        computing the time since the last frame (TPF) that is necessary
         for framerate-independent updates and motion.</li>
     <li>{@link com.jme3.system.AppSettings} - A database containing various
         settings for the application. These settings may be set by the user

jme3-core/src/main/java/com/jme3/app/state/AppState.java

@@ -35,7 +35,7 @@ import com.jme3.app.Application;
 import com.jme3.renderer.RenderManager;
 
 /**
- * AppState represents continously executing code inside the main loop.
+ * AppState represents continuously executing code inside the main loop.
  * 
  * An <code>AppState</code> can track when it is attached to the 
  * {@link AppStateManager} or when it is detached. 

jme3-core/src/main/java/com/jme3/asset/ShaderNodeDefinitionKey.java

@@ -1,5 +1,5 @@
 /*
- * Copyright (c) 2009-2012 jMonkeyEngine
+ * Copyright (c) 2009-2021 jMonkeyEngine
  * All rights reserved.
  *
  * Redistribution and use in source and binary forms, with or without
@@ -38,7 +38,7 @@ import java.util.List;
 /**
  * Used for loading {@link ShaderNodeDefinition shader nodes definition}
  *
- * Tells if the defintion has to be loaded with or without its documentation
+ * Determines whether the definition will be loaded with or without its documentation
  */
 public class ShaderNodeDefinitionKey extends AssetKey<List<ShaderNodeDefinition>> {
 

jme3-core/src/main/java/com/jme3/asset/cache/WeakRefAssetCache.java

@@ -88,7 +88,7 @@ public class WeakRefAssetCache implements AssetCache {
     public <T> void addToCache(AssetKey<T> key, T obj) {
         removeCollectedAssets();
         
-        // NOTE: Some thread issues can hapen if another
+        // NOTE: Some thread issues can happen if another
         // thread is loading an asset with the same key ..
         AssetRef ref = new AssetRef(key, obj, refQueue);
         assetCache.put(key, ref);

jme3-core/src/main/java/com/jme3/audio/AudioNode.java

@@ -52,7 +52,7 @@ import java.util.logging.Logger;
  * An AudioNode is either positional or ambient, with positional being the
  * default. Once a positional node is attached to the scene, its location and
  * velocity relative to the {@link Listener} affect how it sounds when played.
- * Positional nodes can only play monoaural (single-channel) assets, not stereo
+ * Positional nodes can only play monaural (single-channel) assets, not stereo
  * ones.
  *
  * An ambient AudioNode plays in "headspace", meaning that the node's location

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

@@ -469,7 +469,7 @@ public interface AL {
     public int alGetSourcei(int source, int param);
 
     /**
-     * Removes a number of buffer entries that have finished processing, in the order of apperance, from the queue of the specified source.
+     * Removes a number of buffer entries that have finished processing, in the order of appearance, from the queue of the specified source.
      *
      * <p>Once a queue entry for a buffer has been appended to a queue and is pending processing, it should not be changed. Removal of a given queue entry is not
      * possible unless either the source is stopped (in which case then entire queue is considered processed), or if the queue entry has already been processed

jme3-core/src/main/java/com/jme3/bounding/BoundingSphere.java

@@ -66,7 +66,7 @@ public class BoundingSphere extends BoundingVolume {
     private static final float RADIUS_EPSILON = 1f + 0.00001f;
 
     /**
-     * Default contstructor instantiates a new <code>BoundingSphere</code>
+     * Default constructor instantiates a new <code>BoundingSphere</code>
      * object.
      */
     public BoundingSphere() {
@@ -206,7 +206,7 @@ public class BoundingSphere extends BoundingVolume {
      *            The number of points currently considering to include with the
      *            sphere.
      * @param ap
-     *            A variable simulating pointer arithmatic from C++, and offset
+     *            A variable simulating pointer arithmetic from C++, and offset
      *            in <code>points</code>.
      */
     private void recurseMini(FloatBuffer points, int p, int b, int ap) {

jme3-core/src/main/java/com/jme3/bounding/BoundingVolume.java

@@ -78,7 +78,7 @@ public abstract class BoundingVolume implements Savable, Cloneable, Collidable {
     }
 
     /**
-     * Grabs the checkplane we should check first.
+     * Grabs the plane we should check first.
      *
      * @return the index of the plane to be checked first
      */

jme3-core/src/main/java/com/jme3/bounding/Intersection.java

@@ -1,5 +1,5 @@
 /*
- * Copyright (c) 2009-2012 jMonkeyEngine
+ * Copyright (c) 2009-2021 jMonkeyEngine
  * All rights reserved.
  *
  * Redistribution and use in source and binary forms, with or without
@@ -140,7 +140,7 @@ public final class Intersection {
         //  1) the {x,y,z}-directions (actually, since we use the AABB of the triangle
         //     we do not even need to test these)
         //  2) normal of the triangle
-        //  3) crossproduct(edge from tri, {x,y,z}-directin)
+        //  3) cross product (edge from tri, {x,y,z}-direction)
         //       this gives 3x3=9 more tests
 
         TempVars vars = TempVars.get();

jme3-core/src/main/java/com/jme3/bounding/OrientedBoundingBox.java

@@ -1,5 +1,5 @@
 /*
- * Copyright (c) 2009-2012 jMonkeyEngine
+ * Copyright (c) 2009-2021 jMonkeyEngine
  * All rights reserved.
  *
  * Redistribution and use in source and binary forms, with or without
@@ -108,7 +108,7 @@ package com.jme3.bounding;
 //    public final Vector3f[] vectorStore = new Vector3f[8];
 //
 //    private final Vector3f tempVk = new Vector3f();
-//    private final Vector3f tempForword = new Vector3f(0, 0, 1);
+//    private final Vector3f tempForward = new Vector3f(0, 0, 1);
 //    private final Vector3f tempLeft = new Vector3f(1, 0, 0);
 //    private final Vector3f tempUp = new Vector3f(0, 1, 0);
 //
@@ -880,7 +880,7 @@ package com.jme3.bounding;
 //
 //        // convenience variables
 //        Vector3f akA[] = new Vector3f[] { xAxis, yAxis, zAxis };
-//        Vector3f[] akB = new Vector3f[] { tempForword, tempLeft, tempUp };
+//        Vector3f[] akB = new Vector3f[] { tempForward, tempLeft, tempUp };
 //        Vector3f afEA = extent;
 //        Vector3f afEB = tempVk.set(bb.xExtent, bb.yExtent, bb.zExtent);
 //

jme3-core/src/main/java/com/jme3/cinematic/MotionPath.java

@@ -293,7 +293,7 @@ public class MotionPath implements Savable {
      */
     public void enableDebugShape(AssetManager manager, Node rootNode) {
         assetManager = manager;
-        // computeTotalLentgh();
+        // computeTotalLength();
         attachDebugNode(rootNode);
     }
 

jme3-core/src/main/java/com/jme3/cinematic/PlayState.java

@@ -1,5 +1,5 @@
 /*
- * Copyright (c) 2009-2012 jMonkeyEngine
+ * Copyright (c) 2009-2021 jMonkeyEngine
  * All rights reserved.
  *
  * Redistribution and use in source and binary forms, with or without
@@ -37,11 +37,11 @@ package com.jme3.cinematic;
  */
 public enum PlayState {
 
-        /**The CinematicEvent is currently beeing played*/
+        /** The CinematicEvent is currently being played. */
         Playing,
-        /**The animatable has been paused*/
+        /** The CinematicEvent is paused. */
         Paused,
-        /**the animatable is stoped*/
+        /** The CinematicEvent is stopped. */
         Stopped
 }
     

jme3-core/src/main/java/com/jme3/cinematic/events/AbstractCinematicEvent.java

@@ -235,7 +235,7 @@ public abstract class AbstractCinematicEvent implements CinematicEvent {
     }
 
     /**
-     * Returns the current playstate of the animation (playing or paused or stopped).
+     * Returns the current play state of the animation (playing or paused or stopped).
      * @return the enum value
      */
     @Override

jme3-core/src/main/java/com/jme3/cinematic/events/AnimationEvent.java

@@ -307,7 +307,7 @@ public class AnimationEvent extends AbstractCinematicEvent {
                 if (model == null) {
                     //the model is null we try to find it according to the name
                     //this should occur only when loading an old saved cinematic
-                    //othewise it's an error
+                    //otherwise it's an error
                     model = cinematic.getScene().getChild(modelName);
                 }
                 if (model != null) {
@@ -442,7 +442,7 @@ public class AnimationEvent extends AbstractCinematicEvent {
         //FIXME always the same issue, because of the cloning of assets, this won't work
         //we have to somehow store userdata in the spatial and then recurse the 
         //scene sub scenegraph to find the correct instance of the model
-        //This brings a reflaxion about the cinematic being an appstate, 
+        //This brings a reflection about the cinematic being an appstate,
         //shouldn't it be a control over the scene
         // this would allow to use the cloneForSpatial method and automatically 
         //rebind cloned references of original objects.

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

@@ -253,7 +253,7 @@ public class ParticleEmitter extends Geometry {
         setMeshType(meshType);
 
         // change in behavior: temp and lastPos were not cloned before...
-        // perhaps because it was believed that 'transient' fields were exluded
+        // perhaps because it was believed that 'transient' fields were excluded
         // from cloning?  (they aren't)
         // If it was ok for these to be shared because of how they are used
         // then they could just as well be made static... else I think it's clearer

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

@@ -66,7 +66,7 @@ public abstract class ParticleMesh extends Mesh {
      * Initialize mesh data.
      * 
      * @param emitter The emitter which will use this <code>ParticleMesh</code>.
-     * @param numParticles The maxmimum number of particles to simulate
+     * @param numParticles The maximum number of particles to simulate
      */
     public abstract void initParticleData(ParticleEmitter emitter, int numParticles);
     

jme3-core/src/main/java/com/jme3/effect/influencers/DefaultParticleInfluencer.java

@@ -1,5 +1,5 @@
 /*
- * Copyright (c) 2009-2012 jMonkeyEngine
+ * Copyright (c) 2009-2021 jMonkeyEngine
  * All rights reserved.
  *
  * Redistribution and use in source and binary forms, with or without
@@ -50,7 +50,7 @@ import java.io.IOException;
  */
 public class DefaultParticleInfluencer implements ParticleInfluencer {
 
-    //Version #1 : changed startVelocity to initialvelocity for consistency with accessors
+    //Version #1 : changed startVelocity to initialVelocity for consistency with accessors
     //and also changed it in serialization
     public static final int SAVABLE_VERSION = 1;
     /** Temporary variable used to help with calculations. */

jme3-core/src/main/java/com/jme3/effect/shapes/EmitterMeshConvexHullShape.java

@@ -1,5 +1,5 @@
 /*
- * Copyright (c) 2009-2018 jMonkeyEngine
+ * Copyright (c) 2009-2021 jMonkeyEngine
  * All rights reserved.
  *
  * Redistribution and use in source and binary forms, with or without
@@ -69,7 +69,7 @@ public class EmitterMeshConvexHullShape extends EmitterMeshFaceShape {
     @Override
     public void getRandomPoint(Vector3f store) {
         super.getRandomPoint(store);
-        // now move the point from the meshe's face towards the center of the mesh
+        // now move the point from the mesh's face toward the center of the mesh
         // the center is in (0, 0, 0) in the local coordinates
         store.multLocal(FastMath.nextRandomFloat());
     }
@@ -87,7 +87,7 @@ public class EmitterMeshConvexHullShape extends EmitterMeshFaceShape {
     @Override
     public void getRandomPointAndNormal(Vector3f store, Vector3f normal) {
         super.getRandomPointAndNormal(store, normal);
-        // now move the point from the meshe's face towards the center of the mesh
+        // now move the point from the mesh's face toward the center of the mesh
         // the center is in (0, 0, 0) in the local coordinates
         store.multLocal(FastMath.nextRandomFloat());
     }

jme3-core/src/main/java/com/jme3/environment/EnvironmentCamera.java

@@ -363,7 +363,7 @@ public class EnvironmentCamera extends BaseAppState {
     }
 
     /**
-     * creates an offsceen VP
+     * creates an off-screen VP
      *
      * @param name the desired name for the offscreen viewport
      * @param offCamera the Camera to be used (alias created)

jme3-core/src/main/java/com/jme3/environment/generation/JobProgressListener.java

@@ -1,5 +1,5 @@
 /*
- * Copyright (c) 2009-2015 jMonkeyEngine
+ * Copyright (c) 2009-2021 jMonkeyEngine
  * All rights reserved.
  *
  * Redistribution and use in source and binary forms, with or without
@@ -48,7 +48,7 @@ public interface JobProgressListener<T> {
     
     /**
      * Can be called when a step of the process has been completed with a relevant message.
-     * @param message the message stating of the paricular step completion.
+     * @param message the message stating of the particular step completion.
      */
     public void step(String message);
     

jme3-core/src/main/java/com/jme3/environment/generation/PrefilteredEnvMapFaceGenerator.java

@@ -147,7 +147,7 @@ public class PrefilteredEnvMapFaceGenerator extends RunnableWithProgress {
 
     /**
      * Generates the prefiltered env map (used for image based specular
-     * lighting) With the GGX/Shlick brdf
+     * lighting) With the GGX/Schlick brdf
      * {@link EnvMapUtils#getSphericalHarmonicsCoefficents(com.jme3.texture.TextureCubeMap)}
      * Note that the output cube map is in RGBA8 format.
      *

jme3-core/src/main/java/com/jme3/environment/util/CubeMapWrapper.java

@@ -1,5 +1,5 @@
 /*
- * Copyright (c) 2009-2020 jMonkeyEngine
+ * Copyright (c) 2009-2021 jMonkeyEngine
  * All rights reserved.
  *
  * Redistribution and use in source and binary forms, with or without
@@ -201,7 +201,7 @@ public class CubeMapWrapper {
     }
 
     /**
-     * Writes a pixel given the 2D cordinates and the color
+     * Writes a pixel given the 2-D coordinates and the color
      * @param x the x tex coord (from 0 to width)
      * @param y the y tex coord (from 0 to height)
      * @param face the face to write to
@@ -213,7 +213,7 @@ public class CubeMapWrapper {
     }
 
     /**
-     * Writes a pixel given the 2D cordinates, the mip level and the color
+     * Writes a pixel given the 2-D coordinates, the mip level and the color
      * @param x the x tex coord (from 0 to width)
      * @param y the y tex coord (from 0 to height)
      * @param face the face to write to

jme3-core/src/main/java/com/jme3/environment/util/EnvMapUtils.java

@@ -49,8 +49,8 @@ import static com.jme3.math.FastMath.*;
 
 /**
  *
- * This class holds several utility method unseful for Physically Based
- * Rendering. It alloaws to compute useful pre filtered maps from an env map.
+ * This class holds several utility method useful for Physically Based
+ * Rendering. It allows us to compute useful prefiltered maps from an env map.
  *
  * @author Nehon
  */
@@ -180,7 +180,7 @@ public class EnvMapUtils {
      *
      *
      * Original solid angle calculation code is from Ignacio Castaño. This
-     * formula is from Manne Öhrström's thesis. It takes two coordiantes in the
+     * formula is from Manne Öhrström's thesis. It takes two coordinates in the
      * range [-1, 1] that define a portion of a cube face and return the area of
      * the projection of that portion on the surface of the sphere.
      *
@@ -297,10 +297,10 @@ public class EnvMapUtils {
 
     /**
      *
-     * Computes the texture coortinates and the face of the cube map from the
+     * Computes the texture coordinates and the face of the cube map from the
      * given vector
      *
-     * @param texelVect the vector to fetch texelt from the cube map
+     * @param texelVect the vector to fetch texels from the cube map
      * @param fixSeamsMethod the method to fix the seams
      * @param mapSize the size of one face of the cube map
      * @param store a Vector2f where the texture coordinates will be stored
@@ -716,7 +716,7 @@ public class EnvMapUtils {
     }
     
      /**
-     * initialize the Irradiancemap
+     * initialize the irradiance map
      * @param size the size of the map
      * @param imageFormat the format of the image
      * @return the initialized Irradiance map

jme3-core/src/main/java/com/jme3/environment/util/LightsDebugState.java

@@ -46,7 +46,7 @@ import java.util.List;
 import java.util.Map;
 
 /**
- * A debug state that will display LIght gizmos on screen.
+ * A debug state that will display Light gizmos on screen.
  * Still a wip and for now it only displays light probes.
  * 
  * @author nehon

jme3-core/src/main/java/com/jme3/export/SavableClassUtil.java

@@ -174,7 +174,7 @@ public class SavableClassUtil {
      * @param className the class name to create.
      * @return the Savable instance of the class.
      * @throws InstantiationException thrown if the class does not have an empty constructor.
-     * @throws IllegalAccessException thrown if the class is not accessable.
+     * @throws IllegalAccessException thrown if the class is not accessible.
      * @throws InvocationTargetException if the underlying constructor throws an exception
      * @throws ClassNotFoundException thrown if the class name is not in the classpath.
      */

jme3-core/src/main/java/com/jme3/font/BitmapFont.java

@@ -191,7 +191,7 @@ public class BitmapFont implements Savable {
         //
         // The way BitmapText ultimately works is that the first character
         // starts with xOffset included (ie: it is rendered at -xOffset).
-        // Its xAdvance is wider to accomodate that initial offset.
+        // Its xAdvance is wider to accommodate that initial offset.
         // The cursor position is advanced by xAdvance each time.
         //
         // So, a width should be calculated in a similar way.  Start with
@@ -231,7 +231,7 @@ public class BitmapFont implements Savable {
                     lineWidth += findKerningAmount(lastChar, theChar) * sizeScale;                    
                 } else {
                     // The first character needs to add in its xOffset but it
-                    // is the only one... and negative offsets = postive width
+                    // is the only one... and negative offsets = positive width
                     // because we're trying to account for the part that hangs
                     // over the left.  So we subtract. 
                     lineWidth -= c.getXOffset() * sizeScale;                    

jme3-core/src/main/java/com/jme3/font/BitmapText.java

@@ -427,7 +427,7 @@ public class BitmapText extends Node {
     }
 
     private void assemble() {
-        // first generate quadlist
+        // first generate quad list
         letters.update();
         for (int i = 0; i < textPages.length; i++) {
             textPages[i].assemble(letters);

jme3-core/src/main/java/com/jme3/font/BitmapTextPage.java

@@ -93,10 +93,10 @@ class BitmapTextPage extends Geometry {
          * - Skye (sbook)
          */
         if (arrayBased) {
-            pos = new float[4 * 3];  // 4 verticies * 3 floats
-            tc = new float[4 * 2];  // 4 verticies * 2 floats
+            pos = new float[4 * 3];  // 4 vertices * 3 floats
+            tc = new float[4 * 2];  // 4 vertices * 2 floats
             idx = new short[2 * 3];  // 2 triangles * 3 indices
-            color = new byte[4 * 4];   // 4 verticies * 4 bytes
+            color = new byte[4 * 4];   // 4 vertices * 4 bytes
         } else {
             pos = null;
             tc = null;

jme3-core/src/main/java/com/jme3/input/CameraInput.java

@@ -78,7 +78,7 @@ public class CameraInput {
     
         
     
-    //fly cameara constants
+    //fly camera constants
     /**
      * Fly camera mapping to look left. Default assigned to MouseInput.AXIS_X,
      * direction negative

jme3-core/src/main/java/com/jme3/input/ChaseCamera.java

@@ -401,7 +401,7 @@ public class ChaseCamera implements ActionListener, AnalogListener, Control, Jme
                 targetDir.set(targetLocation).subtractLocal(prevPos);
                 float dist = targetDir.length();
 
-                //Low pass filtering on the target postition to avoid shaking when physics are enabled.
+                //Low pass filtering on the target position to avoid shaking when physics are enabled.
                 if (offsetDistance < dist) {
                     //target moves, start chasing.
                     chasing = true;
@@ -412,8 +412,8 @@ public class ChaseCamera implements ActionListener, AnalogListener, Control, Jme
                     //target moves...
                     targetMoves = true;
                 } else {
-                    //if target was moving, we compute a slight offset in rotation to avoid a rought stop of the cam
-                    //We do not if the player is rotationg the cam
+                    //if target was moving, we compute a slight offset in rotation to avoid a rough stop of the cam
+                    //We do not if the player is rotating the cam
                     if (targetMoves && !canRotate) {
                         if (targetRotation - rotation > trailingRotationInertia) {
                             targetRotation = rotation + trailingRotationInertia;

jme3-core/src/main/java/com/jme3/input/FlyByCamera.java

@@ -307,7 +307,7 @@ public class FlyByCamera implements AnalogListener, ActionListener {
             joystick.getPovYAxis().assignAxis(CameraInput.FLYCAM_RISE, CameraInput.FLYCAM_LOWER);
 
             if( joystick.getButton( "Button 8" ) != null ) {
-                // Let the stanard select button be the y invert toggle
+                // Let the standard select button be the y invert toggle
                 joystick.getButton( "Button 8" ).assignButton( CameraInput.FLYCAM_INVERTY );
             }
 

jme3-core/src/main/java/com/jme3/input/SensorJoystickAxis.java

@@ -1,5 +1,5 @@
 /*
- * Copyright (c) 2009-2012 jMonkeyEngine
+ * Copyright (c) 2009-2021 jMonkeyEngine
  * All rights reserved.
  *
  * Redistribution and use in source and binary forms, with or without
@@ -47,7 +47,7 @@ public interface SensorJoystickAxis {
 
     /**
      * Calibrates the axis to the current value.  Future axis values will be
-     * sent as a delta from the calibratation value.
+     * sent as a delta from the calibration value.
      */
     public void calibrateCenter();
     

jme3-core/src/main/java/com/jme3/light/LightProbe.java

@@ -236,7 +236,7 @@ public class LightProbe extends Light implements Savable {
 
     /**
      * return true if the LightProbe is ready, meaning the Environment maps have
-     * been loaded or rnedered and are ready to be used by a material
+     * been loaded or rendered and are ready to be used by a material
      * @return the LightProbe ready state
      */
     public boolean isReady() {
@@ -263,7 +263,7 @@ public class LightProbe extends Light implements Savable {
 
     /**
      * Returns the position of the LightProbe in world space
-     * @return the wolrd space position
+     * @return the world-space position
      */
     public Vector3f getPosition() {
         return position;
@@ -271,7 +271,7 @@ public class LightProbe extends Light implements Savable {
 
     /**
      * Sets the position of the LightProbe in world space
-     * @param position the wolrd space position
+     * @param position the world-space position
      */
     public void setPosition(Vector3f position) {
         this.position.set(position);

jme3-core/src/main/java/com/jme3/light/OrientedBoxProbeArea.java

@@ -156,7 +156,7 @@ public class OrientedBoxProbeArea implements ProbeArea {
         for (int i = 0; i < 3; i++) {
             // extract the axis from the 3x3 matrix
             Vector3f axis = getScaledAxis(i, vars.vect1);
-            // nomalize (here we just divide by the extent
+            // normalize (here we just divide by the extent)
             axis.divideLocal(r[i]);
             // distance to the closest point on this axis.
             float d = FastMath.clamp(dir.dot(axis), -r[i], r[i]);

jme3-core/src/main/java/com/jme3/material/RenderState.java

@@ -940,7 +940,7 @@ public class RenderState implements Cloneable, Savable {
     }
 
     /**
-     * Set the depth conparison function to the given TestFunction 
+     * Set the depth comparison function to the given TestFunction
      * default is LessOrEqual (GL_LEQUAL)
      * @see TestFunction
      * @see RenderState#setDepthTest(boolean) 

jme3-core/src/main/java/com/jme3/material/ShaderGenerationInfo.java

@@ -42,7 +42,7 @@ import java.util.ArrayList;
 import java.util.List;
 
 /**
- * this class is basically a struct that contains the ShaderNodes informations
+ * This class is basically a struct that contains the ShaderNodes information
  * in an appropriate way to ease the shader generation process and make it
  * faster.
  *
@@ -105,7 +105,7 @@ public class ShaderGenerationInfo implements Savable, Cloneable {
 
     /**
      *
-     * @return the vertex shader global ouput
+     * @return the vertex shader global output
      */
     public ShaderNodeVariable getVertexGlobal() {
         return vertexGlobal;
@@ -156,7 +156,7 @@ public class ShaderGenerationInfo implements Savable, Cloneable {
     /**
      * convenient toString method
      *
-     * @return the informations
+     * @return the information
      */
     @Override
     public String toString() {

jme3-core/src/main/java/com/jme3/material/logic/MultiPassLightingLogic.java

@@ -1,5 +1,5 @@
 /*
- * Copyright (c) 2009-2015 jMonkeyEngine
+ * Copyright (c) 2009-2021 jMonkeyEngine
  * All rights reserved.
  *
  * Redistribution and use in source and binary forms, with or without
@@ -111,7 +111,7 @@ public final class MultiPassLightingLogic extends DefaultTechniqueDefLogic {
                 case Directional:
                     DirectionalLight dl = (DirectionalLight) l;
                     Vector3f dir = dl.getDirection();
-                    //FIXME : there is an inconstency here due to backward
+                    //FIXME : there is an inconsistency here due to backward
                     //compatibility of the lighting shader.
                     //The directional light direction is passed in the
                     //LightPosition uniform. The lighting shader needs to be

jme3-core/src/main/java/com/jme3/material/logic/SinglePassAndImageBasedLightingLogic.java

@@ -233,7 +233,7 @@ public final class SinglePassAndImageBasedLightingLogic extends DefaultTechnique
         }
         vars.release();
 
-        //Padding of unsued buffer space
+        // pad unused buffer space
         while(lightDataIndex < numLights * 3) {
             lightData.setVector4InArray(0f, 0f, 0f, 0f, lightDataIndex);
             lightDataIndex++;

jme3-core/src/main/java/com/jme3/material/logic/SinglePassLightingLogic.java

@@ -197,7 +197,7 @@ public final class SinglePassLightingLogic extends DefaultTechniqueDefLogic {
             }
         }
         vars.release();
-        //Padding of unsued buffer space
+        // pad unused buffer space
         while(lightDataIndex < numLights * 3) {
             lightData.setVector4InArray(0f, 0f, 0f, 0f, lightDataIndex);
             lightDataIndex++;

jme3-core/src/main/java/com/jme3/math/Matrix3f.java

@@ -643,7 +643,7 @@ public final class Matrix3f implements Savable, Cloneable, java.io.Serializable
 
     /**
      * <code>set</code> sets the values of the matrix to those supplied by the
-     * 3x3 two dimenion array.
+     * 3x3 two-dimensional array.
      *
      * @param matrix
      *            the new values of the matrix.

jme3-core/src/main/java/com/jme3/math/Plane.java

@@ -172,7 +172,7 @@ public class Plane implements Savable, Cloneable, java.io.Serializable {
      * Find the point in this plane that's nearest to the specified point.
      *
      * @param point location vector of the input point (not null, unaffected)
-     * @param store storage for the result (not null, modififed)
+     * @param store storage for the result (not null, modified)
      * @return a location in this plane (store)
      */
     public Vector3f getClosestPoint(Vector3f point, Vector3f store) {
@@ -196,7 +196,7 @@ public class Plane implements Savable, Cloneable, java.io.Serializable {
      * Reflect the specified point in this plane.
      *
      * @param point location vector of the input point (not null, unaffected)
-     * @param store storage for the result (modififed if not null)
+     * @param store storage for the result (modified if not null)
      * @return a location vector for the reflected point (either store or a new
      * vector)
      */

jme3-core/src/main/java/com/jme3/math/Quaternion.java

@@ -1402,7 +1402,7 @@ public final class Quaternion implements Savable, Cloneable, java.io.Serializabl
     }
 
     /**
-     * <code>lookAt</code> is a convienence method for auto-setting the
+     * <code>lookAt</code> is a convenience method for auto-setting the
      * quaternion based on a direction and an up vector. It computes
      * the rotation to transform the z-axis to point into 'direction'
      * and the y-axis to 'up'.

jme3-core/src/main/java/com/jme3/math/Vector2f.java

@@ -586,7 +586,7 @@ public final class Vector2f implements Savable, Cloneable, java.io.Serializable
 
     /**
      * <code>angleBetween</code> returns (in radians) the angle required to
-     * rotate a ray represented by this vector to be colinear with a ray
+     * rotate a ray represented by this vector to be collinear with a ray
      * described by the given vector. It is assumed that both this vector and
      * the given vector are unit vectors (iow, normalized).
      *

jme3-core/src/main/java/com/jme3/math/package.html

@@ -7,7 +7,7 @@
 </head>
 <body>
 
-The <code>com.jme3.math</code> package provides mathematic data structures
+The <code>com.jme3.math</code> package provides mathematical data structures
 and utilities which are used by the rest of the engine.
 The math package provides the following classes:<br>
 <h3>General purpose vectors</h3>

jme3-core/src/main/java/com/jme3/opencl/Buffer.java

@@ -40,7 +40,7 @@ import java.nio.ByteBuffer;
  * <br>
  * Buffers are created by the {@link Context}.
  * <br>
- * All access methods (read/write/copy/map) are available in both sychronized/blocking versions
+ * All access methods (read/write/copy/map) are available in both synchronized/blocking versions
  * and in async/non-blocking versions. The later ones always return an {@link Event} object
  * and have the prefix -Async in their name.
  *
@@ -404,7 +404,7 @@ public abstract class Buffer extends AbstractOpenCLObject {
 
     /**
      * Result of an async mapping operation, contains the event and the target byte buffer.
-     * This is a work-around since no generic pair-structure is avaiable.
+     * This is a work-around since no generic pair-structure is available.
      *
      * @author shaman
      */
@@ -439,7 +439,7 @@ public abstract class Buffer extends AbstractOpenCLObject {
      * Copies this buffer to the specified image.
      * Note that no format conversion is done.
      * <br>
-     * For detailed description of the origin and region paramenter, see the
+     * For detailed description of the origin and region parameter, see the
      * documentation of the {@link Image} class.
      *
      * @param queue the command queue
@@ -452,7 +452,7 @@ public abstract class Buffer extends AbstractOpenCLObject {
     public abstract Event copyToImageAsync(CommandQueue queue, Image dest, long srcOffset, long[] destOrigin, long[] destRegion);
 
     /**
-     * Aquires this buffer object for using. Only call this method if this buffer
+     * Acquires this buffer object for using. Only call this method if this buffer
      * represents a shared object from OpenGL, created with e.g.
      * {@link Context#bindVertexBuffer(com.jme3.scene.VertexBuffer, com.jme3.opencl.MemoryAccess) }.
      * This method must be called before the buffer is used. After the work is
@@ -466,7 +466,7 @@ public abstract class Buffer extends AbstractOpenCLObject {
     public abstract Event acquireBufferForSharingAsync(CommandQueue queue);
 
     /**
-     * Aquires this buffer object for using. Only call this method if this buffer
+     * Acquires this buffer object for using. Only call this method if this buffer
      * represents a shared object from OpenGL, created with e.g.
      * {@link Context#bindVertexBuffer(com.jme3.scene.VertexBuffer, com.jme3.opencl.MemoryAccess) }.
      * This method must be called before the buffer is used. After the work is

jme3-core/src/main/java/com/jme3/opencl/CommandQueue.java

@@ -1,5 +1,5 @@
 /*
- * Copyright (c) 2009-2020 jMonkeyEngine
+ * Copyright (c) 2009-2021 jMonkeyEngine
  * All rights reserved.
  *
  * Redistribution and use in source and binary forms, with or without
@@ -37,7 +37,7 @@ package com.jme3.opencl;
  * queue to OpenCL function (buffer, image operations, kernel calls), it is
  * ensured that they are executed in the order in which they are passed.
  * <br>
- * Each command queue is associtated with exactly one device: that device
+ * Each command queue is associated with exactly one device: that device
  * is specified on creation ({@link Context#createQueue(com.jme3.opencl.Device) })
  * and all commands are sent to this device.
  *

jme3-core/src/main/java/com/jme3/opencl/DefaultPlatformChooser.java

@@ -53,7 +53,7 @@ public class DefaultPlatformChooser implements PlatformChooser {
             }
             for (Device d : p.getDevices()) {
                 if (d.hasOpenGLInterop() && d.getDeviceType()==Device.DeviceType.GPU) {
-                    result.add(d); //GPU prefered
+                    result.add(d); //GPU preferred
                 }
             }
             if (!result.isEmpty()) {

jme3-core/src/main/java/com/jme3/opencl/Device.java

@@ -1,5 +1,5 @@
 /*
- * Copyright (c) 2009-2020 jMonkeyEngine
+ * Copyright (c) 2009-2021 jMonkeyEngine
  * All rights reserved.
  *
  * Redistribution and use in source and binary forms, with or without
@@ -118,7 +118,7 @@ public interface Device {
     boolean hasOpenGLInterop();
 
     /**
-     * Explictly tests for the availability of the specified extension
+     * Explicitly tests for the availability of the specified extension
      *
      * @param extension the name of the extension
      * @return {@code true} iff this extension is supported
@@ -251,7 +251,7 @@ public interface Device {
      */
     int getMaximumConstantArguments();
 
-    //TODO: cache, prefered sizes properties
+    //TODO: cache, preferred sizes properties
     /**
      * OpenCL profile string. Returns the profile name supported by the device.
      * The profile name returned can be one of the following strings:<br>

jme3-core/src/main/java/com/jme3/opencl/Image.java

@@ -197,7 +197,7 @@ public abstract class Image extends AbstractOpenCLObject {
         }
 
         /**
-         * Used to specify an image with the provided ByteBuffer as soruce
+         * Used to specify an image with the provided ByteBuffer as source
          *
          * @param type the image type
          * @param width the width
@@ -389,7 +389,7 @@ public abstract class Image extends AbstractOpenCLObject {
     /**
      * Maps the image into host memory.
      * The returned structure contains the mapped byte buffer and row and slice pitch.
-     * The event object is set to {@code null}, it is needed for the asnyc
+     * The event object is set to {@code null}, it is needed for the async
      * version {@link #mapAsync(com.jme3.opencl.CommandQueue, long[], long[], com.jme3.opencl.MappingAccess) }.
      *
      * @param queue the command queue
@@ -502,7 +502,7 @@ public abstract class Image extends AbstractOpenCLObject {
     public abstract Event copyToBufferAsync(CommandQueue queue, Buffer dest, long[] srcOrigin, long[] srcRegion, long destOffset);
 
     /**
-     * Aquires this image object for using. Only call this method if this image
+     * Acquires this image object for using. Only call this method if this image
      * represents a shared object from OpenGL, created with e.g.
      * {@link Context#bindImage(com.jme3.texture.Image, com.jme3.texture.Texture.Type, int, com.jme3.opencl.MemoryAccess) }
      * or variations.
@@ -517,7 +517,7 @@ public abstract class Image extends AbstractOpenCLObject {
     public abstract Event acquireImageForSharingAsync(CommandQueue queue);
 
     /**
-     * Aquires this image object for using. Only call this method if this image
+     * Acquires this image object for using. Only call this method if this image
      * represents a shared object from OpenGL, created with e.g.
      * {@link Context#bindImage(com.jme3.texture.Image, com.jme3.texture.Texture.Type, int, com.jme3.opencl.MemoryAccess) }
      * or variations.

jme3-core/src/main/java/com/jme3/opencl/OpenCLException.java

@@ -45,7 +45,7 @@ public class OpenCLException extends RuntimeException {
     private final int errorCode;
 
     /**
-     * Creates a new instance of <code>OpenCLExceptionn</code> without detail
+     * Creates a new instance of <code>OpenCLException</code> without detail
      * message.
      */
     public OpenCLException() {
@@ -53,7 +53,7 @@ public class OpenCLException extends RuntimeException {
     }
 
     /**
-     * Constructs an instance of <code>OpenCLExceptionn</code> with the
+     * Constructs an instance of <code>OpenCLException</code> with the
      * specified detail message.
      *
      * @param msg the detail message.

jme3-core/src/main/java/com/jme3/opencl/OpenCLObject.java

@@ -1,5 +1,5 @@
 /*
- * Copyright (c) 2009-2016 jMonkeyEngine
+ * Copyright (c) 2009-2021 jMonkeyEngine
  * All rights reserved.
  *
  * Redistribution and use in source and binary forms, with or without
@@ -33,7 +33,7 @@ package com.jme3.opencl;
 
 /**
  * Base interface of all native OpenCL objects.
- * This interface provides the functionality for savely release the object.
+ * This interface provides the functionality to safely release the object.
  * @author shaman
  */
 public interface OpenCLObject {

jme3-core/src/main/java/com/jme3/opencl/package-info.java

@@ -115,7 +115,7 @@
  * terrain based on height maps, post processing effects and so forth.
  * <br>
  * <i>Important:</i> Before shared objects can be used by any OpenCL function
- * like kernel calls or read/write/copy methods, they must be aquired explicitly
+ * like kernel calls or read/write/copy methods, they must be acquired explicitly
  * by {@link com.jme3.opencl.Buffer#acquireBufferForSharingAsync(com.jme3.opencl.CommandQueue) }
  * or {@link com.jme3.opencl.Image#acquireImageForSharingAsync(com.jme3.opencl.CommandQueue) }.
  * After the work is done, release the resource with

jme3-core/src/main/java/com/jme3/post/FilterPostProcessor.java

@@ -157,7 +157,7 @@ public class FilterPostProcessor implements SceneProcessor, Savable {
         
         Camera cam = vp.getCamera();
 
-        //save view port diensions
+        //save view port dimensions
         left = cam.getViewPortLeft();
         right = cam.getViewPortRight();
         top = cam.getViewPortTop();
@@ -398,7 +398,7 @@ public class FilterPostProcessor implements SceneProcessor, Savable {
         for (int i = filters.size() - 1; i >= 0 && lastFilterIndex == -1; i--) {
             if (filters.get(i).isEnabled()) {
                 lastFilterIndex = i;
-                //the Fpp is initialized, but the viwport framebuffer is the 
+                //the Fpp is initialized, but the viewport framebuffer is the
                 //original out framebuffer so we must recover from a situation 
                 //where no filter was enabled. So we set the correct framebuffer 
                 //on the viewport

jme3-core/src/main/java/com/jme3/renderer/Caps.java

@@ -1,5 +1,5 @@
 /*
- * Copyright (c) 2009-2019 jMonkeyEngine
+ * Copyright (c) 2009-2021 jMonkeyEngine
  * All rights reserved.
  *
  * Redistribution and use in source and binary forms, with or without
@@ -378,7 +378,7 @@ public enum Caps {
     PartialNonPowerOfTwoTextures,
     
     /**
-     * When sampling cubemap edges, interpolate between the adjecent faces
+     * When sampling cubemap edges, interpolate between the adjacent faces
      * instead of just sampling one face.
      * <p>
      * Improves the quality of environment mapping.

jme3-core/src/main/java/com/jme3/renderer/IDList.java

@@ -1,5 +1,5 @@
 /*
- * Copyright (c) 2009-2012 jMonkeyEngine
+ * Copyright (c) 2009-2021 jMonkeyEngine
  * All rights reserved.
  *
  * Redistribution and use in source and binary forms, with or without
@@ -69,7 +69,7 @@ public class IDList {
             // add item to newList first
             newList[newLen++] = idx;
 
-        // find idx in oldList, if removed successfuly, return true.
+        // find idx in oldList, if removed successfully, return true.
         for (int i = 0; i < oldLen; i++){
             if (oldList[i] == idx){
                 // found index in slot i

jme3-core/src/main/java/com/jme3/renderer/RenderManager.java

@@ -334,7 +334,7 @@ public class RenderManager {
      * the given width and height.
      *
      * @param w the new width (in pixels)
-     * @param h the new heigh (in pixels)
+     * @param h the new height (in pixels)
      */
     public void notifyReshape(int w, int h) {
         for (ViewPort vp : preViewPorts) {

jme3-core/src/main/java/com/jme3/renderer/opengl/GL4.java

@@ -1,5 +1,5 @@
 /*
- * Copyright (c) 2009-2014 jMonkeyEngine
+ * Copyright (c) 2009-2021 jMonkeyEngine
  * All rights reserved.
  *
  * Redistribution and use in source and binary forms, with or without
@@ -89,7 +89,7 @@ public interface GL4 extends GL3 {
     public int glGetProgramResourceIndex(int program, int programInterface, String name);
 
     /**
-     * Cchanges the active shader storage block with an assigned index of storageBlockIndex in program object program.
+     * Changes the active shader storage block with an assigned index of storageBlockIndex in program object program.
      * storageBlockIndex must be an active shader storage block index in program. storageBlockBinding must be less
      * than the value of {@code #GL_MAX_SHADER_STORAGE_BUFFER_BINDINGS}. If successful, glShaderStorageBlockBinding specifies
      * that program will use the data store of the buffer object bound to the binding point storageBlockBinding to

jme3-core/src/main/java/com/jme3/renderer/opengl/GLDebug.java

@@ -121,7 +121,7 @@ public class GLDebug implements InvocationHandler {
      * @param gl The GL Context, required to call {@link GL#glGetError()}
      * @param obj The object which methods will be proxied
      * @param implementedInterfaces The interfaces/class this object implements
-     * @return The Proxy object (or null if an error occured)
+     * @return The Proxy object (or null if an error occurred)
      */
     public static Object createProxy(GL gl, Object obj, Class<?>... implementedInterfaces) {
         try {

jme3-core/src/main/java/com/jme3/renderer/opengl/GLRenderer.java

@@ -1463,7 +1463,7 @@ public final class GLRenderer implements Renderer {
 
         if(insertPrecision){
             // default precision could be defined in GLSLCompat.glsllib so final users can use custom defined precision instead
-            // precision token is not a preprocessor dirrective therefore it must be placed after #extension tokens to avoid
+            // precision token is not a preprocessor directive therefore it must be placed after #extension tokens to avoid
             // Error P0001: Extension directive must occur before any non-preprocessor tokens
             int idx = stringBuf.lastIndexOf("#extension");
             idx = stringBuf.indexOf("\n", idx);

jme3-core/src/main/java/com/jme3/scene/BatchNode.java

@@ -254,7 +254,7 @@ public class BatchNode extends GeometryGroupNode {
         }
     }
 
-    //in case the detached spatial is a node, we unbatch all geometries in its subegraph
+    //in case the detached spatial is a node, we unbatch all geometries in its subgraph
     @Override
     public Spatial detachChildAt(int index) {
         Spatial s = super.detachChildAt(index);

jme3-core/src/main/java/com/jme3/scene/Geometry.java

@@ -628,7 +628,7 @@ public class Geometry extends Spatial {
     }
 
     /**
-     * Seting this to true will stop this geometry morph buffer to be updated,
+     * Setting this to true will stop this geometry morph buffer to be updated,
      * unless the morph state changes
      *
      * @param dirtyMorph true→prevent updating, false→allow updating

jme3-core/src/main/java/com/jme3/scene/GeometryGroupNode.java

@@ -72,7 +72,7 @@ public abstract class GeometryGroupNode extends Node {
     
     /**
      * Called by {@link Geometry geom} to specify that it
-     * has been unassociated from its <code>GeoemtryGroupNode</code>.
+     * has been unassociated from its <code>GeometryGroupNode</code>.
      * 
      * Unassociation occurs when the {@link Geometry} is 
      * {@link Spatial#removeFromParent() detached} from its parent

jme3-core/src/main/java/com/jme3/scene/Mesh.java

@@ -417,7 +417,7 @@ public class Mesh implements Savable, Cloneable, JmeCloneable {
                 weights.updateData(arrayWeight);
             }
             weights.setUsage(Usage.CpuOnly);
-            // position, normal, and tanget buffers to be in "Stream" mode
+            // position, normal, and tangent buffers to be in "Stream" mode
             VertexBuffer positions = getBuffer(Type.Position);
             VertexBuffer normals = getBuffer(Type.Normal);
             VertexBuffer tangents = getBuffer(Type.Tangent);
@@ -467,7 +467,7 @@ public class Mesh implements Savable, Cloneable, JmeCloneable {
                         weights.getFormat(), directWeight);
             }
 
-            // position, normal, and tanget buffers to be in "Static" mode
+            // position, normal, and tangent buffers to be in "Static" mode
             VertexBuffer positions = getBuffer(Type.Position);
             VertexBuffer normals = getBuffer(Type.Normal);
             VertexBuffer tangents = getBuffer(Type.Tangent);
@@ -903,7 +903,7 @@ public class Mesh implements Savable, Cloneable, JmeCloneable {
         if (pb != null && pb.getFormat() == Format.Float && pb.getNumComponents() == 3) {
             FloatBuffer fpb = (FloatBuffer) pb.getData();
 
-            // aquire triangle's vertex indices
+            // acquire triangle's vertex indices
             int vertIndex = index * 3;
             int vert1 = ib.get(vertIndex);
             int vert2 = ib.get(vertIndex + 1);
@@ -1335,7 +1335,7 @@ public class Mesh implements Savable, Cloneable, JmeCloneable {
         // Copy max weights per vertex as well
         setMaxNumWeights(other.getMaxNumWeights());
 
-        // The data has been copied over, update informations
+        // The data has been copied over, update information
         updateCounts();
         updateBound();
     }

jme3-core/src/main/java/com/jme3/scene/Node.java

@@ -228,7 +228,7 @@ public class Node extends Spatial {
         super.updateLogicalState(tpf);
 
         // Only perform updates on children if we are the
-        // root and then only peform updates on children we
+        // root and then only perform updates on children we
         // know to require updates.
         // So if this isn't the root, abort.
         if (parent != null) {

jme3-core/src/main/java/com/jme3/scene/UserData.java

@@ -268,7 +268,7 @@ public final class UserData implements Savable {
                 } else if (o instanceof Boolean) {
                     oc.write(TYPE_BOOLEAN, listName + "t" + counter, 0);
                     oc.write((Boolean) o, listName + "v" + counter, false);
-                } else if (o instanceof String || o == null) {// treat null's like Strings just to store them and keep the List like the user intended
+                } else if (o instanceof String || o == null) {// treat nulls like Strings just to store them and keep the List like the user intended
                     oc.write(TYPE_STRING, listName + "t" + counter, 0);
                     oc.write((String) o, listName + "v" + counter, null);
                 } else if (o instanceof Long) {

jme3-core/src/main/java/com/jme3/scene/VertexBuffer.java

@@ -198,7 +198,7 @@ public class VertexBuffer extends NativeObject implements Savable, Cloneable {
          * So we can support up to
          * 14 simultaneous POSITION targets
          * 7 simultaneous POSITION and NORMAL targets
-         * 4 simultaneous POSTION, NORMAL and TANGENT targets.
+         * 4 simultaneous POSITION, NORMAL and TANGENT targets.
          * <p>
          * Note that the MorphControl will find how many buffers
          * can be supported for each mesh/material combination.
@@ -932,7 +932,7 @@ public class VertexBuffer extends NativeObject implements Savable, Cloneable {
         int outPos = outIndex * components;
         int elementSz = components;
         if (format == Format.Half) {
-            // because half is stored as bytebuf but its 2 bytes long
+            // because half is stored as ByteBuffer but it's 2 bytes long
             inPos *= 2;
             outPos *= 2;
             elementSz *= 2;

jme3-core/src/main/java/com/jme3/scene/control/CameraControl.java

@@ -105,7 +105,7 @@ public class CameraControl extends AbstractControl {
         this.controlDir = controlDir;
     }
 
-    // fields used, when inversing ControlDirection:
+    // fields used, when inverting ControlDirection:
     @Override
     protected void controlUpdate(float tpf) {
         if (spatial != null && camera != null) {

jme3-core/src/main/java/com/jme3/scene/control/LightControl.java

@@ -115,7 +115,7 @@ public class LightControl extends AbstractControl {
         this.controlDir = controlDir;
     }
 
-    // fields used, when inversing ControlDirection:
+    // fields used when inverting ControlDirection:
     @Override
     protected void controlUpdate(float tpf) {
         if (spatial != null && light != null) {

jme3-core/src/main/java/com/jme3/scene/debug/SkeletonInterBoneWire.java

@@ -45,7 +45,7 @@ import com.jme3.scene.VertexBuffer.Usage;
 import com.jme3.util.BufferUtils;
 
 /**
- * A class that displays a dotted line between a bone tail and its childrens' heads.
+ * A class that displays a dotted line between a bone tail and its children's heads.
  * 
  * @author Marcin Roguski (Kaelthas)
  */
@@ -84,7 +84,7 @@ public class SkeletonInterBoneWire extends Mesh {
     }
 
     /**
-     * The method updates the geometry according to the poitions of the bones.
+     * This method updates the geometry according to the positions of the bones.
      */
     public void updateGeometry() {
         VertexBuffer vb = this.getBuffer(Type.Position);
@@ -113,7 +113,7 @@ public class SkeletonInterBoneWire extends Mesh {
     }
 
     /**
-     * Th method couns the connections between bones.
+     * This method counts the connections between bones.
      * @param bone
      *            the bone where counting starts
      */

jme3-core/src/main/java/com/jme3/scene/debug/SkeletonWire.java

@@ -112,7 +112,7 @@ public class SkeletonWire extends Mesh {
     }
 
     /**
-     * The method updates the geometry according to the poitions of the bones.
+     * This method updates the geometry according to the positions of the bones.
      */
     public void updateGeometry() {
         VertexBuffer vb = this.getBuffer(Type.Position);
@@ -135,7 +135,7 @@ public class SkeletonWire extends Mesh {
     }
 
     /**
-     * Th method couns the connections between bones.
+     * This method counts the connections between bones.
      * @param bone
      *            the bone where counting starts
      */

jme3-core/src/main/java/com/jme3/scene/debug/custom/ArmatureInterJointsWire.java

@@ -41,7 +41,7 @@ import com.jme3.scene.VertexBuffer.Type;
 import java.nio.FloatBuffer;
 
 /**
- * A class that displays a dotted line between a bone tail and its childrens' heads.
+ * A class that displays a dotted line between a bone tail and its children's heads.
  *
  * @author Marcin Roguski (Kaelthas)
  */

jme3-core/src/main/java/com/jme3/scene/mesh/WrappedIndexBuffer.java

@@ -42,7 +42,7 @@ import java.nio.Buffer;
  * into a list based mode such as {@link Mode#Triangles} or {@link Mode#Lines}.
  * As it is often more convenient to read vertex data in list format
  * than in a non-list format, using this class is recommended to avoid
- * convoluting classes used to process mesh data from an external source.
+ * complicating classes used to process mesh data from an external source.
  * 
  * @author Kirill Vainer
  */

jme3-core/src/main/java/com/jme3/scene/shape/Cylinder.java

@@ -1,5 +1,5 @@
 /*
- * Copyright (c) 2009-2019 jMonkeyEngine
+ * Copyright (c) 2009-2021 jMonkeyEngine
  * All rights reserved.
  *
  * Redistribution and use in source and binary forms, with or without
@@ -280,7 +280,7 @@ public class Cylinder extends Mesh {
             float currentRadius = bottomRadius + (topRadius - bottomRadius) * axisSample / (axisSamples-1);
             
             for (int circlePoint = 0; circlePoint < radialSamples + 1; circlePoint++) {
-                // Position, by multipliying the position on a unit circle with the current radius.
+                // Position, by multiplying the position on a unit circle with the current radius.
                 vertices[currentIndex*3] = circlePoints[circlePoint][0] * currentRadius;
                 vertices[currentIndex*3 +1] = circlePoints[circlePoint][1] * currentRadius;
                 vertices[currentIndex*3 +2] = currentHeight;

jme3-core/src/main/java/com/jme3/shader/Glsl100ShaderGenerator.java

@@ -192,7 +192,7 @@ public class Glsl100ShaderGenerator extends ShaderGenerator {
      * Appends an output assignment to a shader globalOutputName =
      * nameSpace_varName;
      *
-     * @param source the source StringBuilter to append the code.
+     * @param source the source StringBuilder to append the code.
      * @param globalOutputName the name of the global output (can be gl_Position
      * or gl_FragColor etc...).
      * @param var the variable to assign to the output.
@@ -242,7 +242,7 @@ public class Glsl100ShaderGenerator extends ShaderGenerator {
 
         final List<String> declaredInputs = new ArrayList<>();
 
-        // Decalring variables with default values first
+        // Declaring variables with default values first
         final ShaderNodeDefinition definition = shaderNode.getDefinition();
 
         for (final ShaderNodeVariable var : definition.getInputs()) {

jme3-core/src/main/java/com/jme3/shader/Glsl300ShaderGenerator.java

@@ -38,7 +38,7 @@ import com.jme3.shader.Shader.ShaderType;
 /**
  * This shader Generator can generate Vertex and Fragment shaders from
  * ShaderNodes for GLESSL 3.0
- * Nowdays it's just a subclass of Glsl150ShaderGenerator overriding the version
+ * Nowadays it's just a subclass of Glsl150ShaderGenerator overriding the version
  * string because GLSL 1.5 is mostly compatible with GLESSL 3.0
  *
  * @author Nehon

jme3-core/src/main/java/com/jme3/shader/Shader.java

@@ -439,7 +439,7 @@ public final class Shader extends NativeObject {
 
     /**
      * Called by the object manager to reset all object IDs. This causes
-     * the shader to be reuploaded to the GPU incase the display was restarted.
+     * the shader to be reuploaded to the GPU in case the display was restarted.
      */
     @Override
     public void resetObject() {

jme3-core/src/main/java/com/jme3/shader/ShaderNode.java

@@ -205,7 +205,7 @@ public class ShaderNode implements Savable, Cloneable {
     }
 
     /**
-     * convenience tostring
+     * convenience toString
      *
      * @return a string
      */