resolve javadoc errors in jme3-core

jme3-core/src/main/java/checkers/quals/DefaultQualifiers.java

@@ -16,13 +16,13 @@ import java.lang.annotation.Target;
  *
  * Example:
  * <!-- &nbsp; is a hack that prevents @ from being the first character on the line, which confuses Javadoc -->
- * <code><pre>
+ * <pre>
  * &nbsp; @DefaultQualifiers({
  * &nbsp;     @DefaultQualifier("NonNull"),
  * &nbsp;     @DefaultQualifier(value = "Interned", locations = ALL_EXCEPT_LOCALS),
  * &nbsp;     @DefaultQualifier("Tainted")
  * &nbsp; })
- * </pre></code>
+ * </pre>
  *
  * @see DefaultQualifier
  */

jme3-core/src/main/java/com/jme3/app/SimpleApplication.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
@@ -54,13 +54,11 @@ import com.jme3.system.JmeSystem;
  * <code>SimpleApplication</code> will display a statistics view
  * using the {@link com.jme3.app.StatsAppState} AppState. It will display
  * the current frames-per-second value on-screen in addition to the statistics.
- * Several keys have special functionality in <code>SimpleApplication</code>:<br/>
+ * Several keys have special functionality in <code>SimpleApplication</code>:<br>
  *
- * <table>
- * <tr><td>Esc</td><td>- Close the application</td></tr>
- * <tr><td>C</td><td>- Display the camera position and rotation in the console.</td></tr>
- * <tr><td>M</td><td>- Display memory usage in the console.</td></tr>
- * </table>
+ *  Esc - Close the application.<br>
+ *  C - Display the camera position and rotation in the console.<br>
+ *  M - Display memory usage in the console.<br>
  *
  * A {@link com.jme3.app.FlyCamAppState} is by default attached as well and can
  * be removed by calling <code>stateManager.detach( stateManager.getState(FlyCamAppState.class) );</code>

jme3-core/src/main/java/com/jme3/app/StatsView.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
@@ -47,18 +47,17 @@ import com.jme3.util.clone.JmeCloneable;
 /**
  * The <code>StatsView</code> provides a heads-up display (HUD) of various
  * statistics of rendering. The data is retrieved every frame from a
- * {@link com.jme3.renderer.Statistics} and then displayed on screen.<br/>
- * <br/>
- * Usage:<br/>
+ * {@link com.jme3.renderer.Statistics} and then displayed on screen.
+ * <p>
  * To use the stats view, you need to retrieve the
  * {@link com.jme3.renderer.Statistics} from the
  * {@link com.jme3.renderer.Renderer} used by the application. Then, attach
- * the <code>StatsView</code> to the scene graph.<br/>
- * <code><br/>
- * Statistics stats = renderer.getStatistics();<br/>
- * StatsView statsView = new StatsView("MyStats", assetManager, stats);<br/>
- * rootNode.attachChild(statsView);<br/>
- * </code>
+ * the <code>StatsView</code> to the scene graph.
+ * <pre>
+ * Statistics stats = renderer.getStatistics();
+ * StatsView statsView = new StatsView("MyStats", assetManager, stats);
+ * rootNode.attachChild(statsView);
+ * </pre>
  */
 public class StatsView extends Node implements Control, JmeCloneable {
 

jme3-core/src/main/java/com/jme3/app/state/AppState.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
@@ -40,11 +40,11 @@ import com.jme3.renderer.RenderManager;
  * An <code>AppState</code> can track when it is attached to the 
  * {@link AppStateManager} or when it is detached. 
  * 
- * <br/><code>AppState</code>s are initialized in the render thread, upon a call to 
+ * <code>AppState</code>s are initialized in the render thread, upon a call to 
  * {@link AppState#initialize(com.jme3.app.state.AppStateManager, com.jme3.app.Application) }
  * and are de-initialized upon a call to {@link AppState#cleanup()}. 
  * Implementations should return the correct value with a call to 
- * {@link AppState#isInitialized() } as specified above.<br/>
+ * {@link AppState#isInitialized() } as specified above.
  * 
  * <ul>
  * <li>If a detached AppState is attached then <code>initialize()</code> will be called

jme3-core/src/main/java/com/jme3/app/state/AppStateManager.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
@@ -42,7 +42,7 @@ import java.util.concurrent.ConcurrentHashMap;
 
 /**
  * The <code>AppStateManager</code> holds a list of {@link AppState}s which
- * it will update and render.<br/>
+ * it will update and render.<br>
  * When an {@link AppState} is attached or detached, the
  * {@link AppState#stateAttached(com.jme3.app.state.AppStateManager) } and
  * {@link AppState#stateDetached(com.jme3.app.state.AppStateManager) } methods

jme3-core/src/main/java/com/jme3/asset/AssetConfig.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
@@ -41,12 +41,12 @@ import java.util.logging.Logger;
 
 /**
  * <code>AssetConfig</code> loads a config file to configure the asset manager.
- * <br/><br/>
+ *
  * The config file is specified with the following format:
  * <code>
- * "INCLUDE" <path>
- * "LOADER" <class> : (<extension> ",")* <extension>
- * "LOCATOR" <path> <class>
+ * "INCLUDE" path
+ * "LOADER" class : (extension ",")* extension
+ * "LOCATOR" path class
  * </code>
  *
  * @author Kirill Vainer

jme3-core/src/main/java/com/jme3/audio/AudioBuffer.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
@@ -39,7 +39,7 @@ import java.nio.ByteBuffer;
 /**
  * An <code>AudioBuffer</code> is an implementation of AudioData
  * where the audio is buffered (stored in memory). All parts of it
- * are accessible at any time. <br/>
+ * are accessible at any time. <br>
  * AudioBuffers are useful for short sounds, like effects, etc.
  *
  * @author Kirill Vainer

jme3-core/src/main/java/com/jme3/audio/AudioNode.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
@@ -533,7 +533,7 @@ public class AudioNode extends Node implements AudioSource {
 
     /**
      * Set the reverb filter for this audio node.
-     * <br/>
+     * <br>
      * The reverb filter will influence the reverberations
      * of the audio node playing. This only has an effect if
      * reverb is enabled.
@@ -560,7 +560,7 @@ public class AudioNode extends Node implements AudioSource {
     /**
      * Set the maximum distance for the attenuation of the audio node.
      * Does nothing if the audio node is not positional.
-     * <br/>
+     * <br>
      * The maximum distance is the distance beyond which the audio
      * node will no longer be attenuated.  Normal attenuation is logarithmic
      * from refDistance (it reduces by half when the distance doubles).
@@ -595,7 +595,7 @@ public class AudioNode extends Node implements AudioSource {
     /**
      * Set the reference playing distance for the audio node.
      * Does nothing if the audio node is not positional.
-     * <br/>
+     * <br>
      * The reference playing distance is the distance at which the
      * audio node will be exactly half of its volume.
      *
@@ -625,7 +625,7 @@ public class AudioNode extends Node implements AudioSource {
     /**
      * Set the audio node to be directional.
      * Does nothing if the audio node is not positional.
-     * <br/>
+     * <br>
      * After setting directional, you should call
      * {@link AudioNode#setDirection(com.jme3.math.Vector3f) }
      * to set the audio node's direction.

jme3-core/src/main/java/com/jme3/audio/AudioStream.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
@@ -179,8 +179,6 @@ public class AudioStream extends AudioData implements Closeable {
     /**
      * Closes the stream, releasing all data relating to it. 
      * Reading from the stream will return eof.
-     *
-     * @throws IOException
      */
     @Override
     public void close() {

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

@@ -357,7 +357,11 @@ public interface AL {
      * background music.</p>
      *
      * @param buffer    the buffer to modify.
-     * @param format    the data format. One of:<br><table><tr><td>{@link #AL_FORMAT_MONO8 FORMAT_MONO8}</td><td>{@link #AL_FORMAT_MONO16 FORMAT_MONO16}</td><td>{@link #AL_FORMAT_STEREO8 FORMAT_STEREO8}</td><td>{@link #AL_FORMAT_STEREO16 FORMAT_STEREO16}</td></tr></table>
+     * @param format    the data format. One of:
+     *  {@link #AL_FORMAT_MONO8 FORMAT_MONO8}
+     *  {@link #AL_FORMAT_MONO16 FORMAT_MONO16}
+     *  {@link #AL_FORMAT_STEREO8 FORMAT_STEREO8}
+     *  {@link #AL_FORMAT_STEREO16 FORMAT_STEREO16}
      * @param data      the sample data.
      * @param frequency the data frequency.
      */
@@ -391,7 +395,22 @@ public interface AL {
      * Sets the float value of a source parameter.
      *
      * @param source the source to modify.
-     * @param param  the parameter to modify. One of:<br><table><tr><td>{@link #AL_CONE_INNER_ANGLE CONE_INNER_ANGLE}</td><td>{@link #AL_CONE_OUTER_ANGLE CONE_OUTER_ANGLE}</td><td>{@link #AL_PITCH PITCH}</td><td>{@link #AL_DIRECTION DIRECTION}</td><td>{@link #AL_LOOPING LOOPING}</td><td>{@link #AL_BUFFER BUFFER}</td><td>{@link #AL_SOURCE_STATE SOURCE_STATE}</td></tr><tr><td>{@link #AL_CONE_OUTER_GAIN CONE_OUTER_GAIN}</td><td>{@link #AL_SOURCE_TYPE SOURCE_TYPE}</td><td>{@link #AL_POSITION POSITION}</td><td>{@link #AL_VELOCITY VELOCITY}</td><td>{@link #AL_GAIN GAIN}</td><td>{@link #AL_REFERENCE_DISTANCE REFERENCE_DISTANCE}</td><td>{@link #AL_ROLLOFF_FACTOR ROLLOFF_FACTOR}</td></tr><tr><td>{@link #AL_MAX_DISTANCE MAX_DISTANCE}</td></tr></table>
+     * @param param  the parameter to modify. One of:
+     *  {@link #AL_CONE_INNER_ANGLE CONE_INNER_ANGLE}
+     *  {@link #AL_CONE_OUTER_ANGLE CONE_OUTER_ANGLE}
+     *  {@link #AL_PITCH PITCH}
+     *  {@link #AL_DIRECTION DIRECTION}
+     *  {@link #AL_LOOPING LOOPING}
+     *  {@link #AL_BUFFER BUFFER}
+     *  {@link #AL_SOURCE_STATE SOURCE_STATE}
+     *  {@link #AL_CONE_OUTER_GAIN CONE_OUTER_GAIN}
+     *  {@link #AL_SOURCE_TYPE SOURCE_TYPE}
+     *  {@link #AL_POSITION POSITION}
+     *  {@link #AL_VELOCITY VELOCITY}
+     *  {@link #AL_GAIN GAIN}
+     *  {@link #AL_REFERENCE_DISTANCE REFERENCE_DISTANCE}
+     *  {@link #AL_ROLLOFF_FACTOR ROLLOFF_FACTOR}
+     *  {@link #AL_MAX_DISTANCE MAX_DISTANCE}
      * @param value  the parameter value.
      */
     public void alSourcef(int source, int param, float value);
@@ -400,7 +419,22 @@ public interface AL {
      * Sets the 3 dimensional values of a source parameter.
      *
      * @param source the source to modify.
-     * @param param  the parameter to modify. One of:<br><table><tr><td>{@link #AL_CONE_INNER_ANGLE CONE_INNER_ANGLE}</td><td>{@link #AL_CONE_OUTER_ANGLE CONE_OUTER_ANGLE}</td><td>{@link #AL_PITCH PITCH}</td><td>{@link #AL_DIRECTION DIRECTION}</td><td>{@link #AL_LOOPING LOOPING}</td><td>{@link #AL_BUFFER BUFFER}</td><td>{@link #AL_SOURCE_STATE SOURCE_STATE}</td></tr><tr><td>{@link #AL_CONE_OUTER_GAIN CONE_OUTER_GAIN}</td><td>{@link #AL_SOURCE_TYPE SOURCE_TYPE}</td><td>{@link #AL_POSITION POSITION}</td><td>{@link #AL_VELOCITY VELOCITY}</td><td>{@link #AL_GAIN GAIN}</td><td>{@link #AL_REFERENCE_DISTANCE REFERENCE_DISTANCE}</td><td>{@link #AL_ROLLOFF_FACTOR ROLLOFF_FACTOR}</td></tr><tr><td>{@link #AL_MAX_DISTANCE MAX_DISTANCE}</td></tr></table>
+     * @param param  the parameter to modify. One of:
+     *  {@link #AL_CONE_INNER_ANGLE CONE_INNER_ANGLE}
+     *  {@link #AL_CONE_OUTER_ANGLE CONE_OUTER_ANGLE}
+     *  {@link #AL_PITCH PITCH}
+     *  {@link #AL_DIRECTION DIRECTION}
+     *  {@link #AL_LOOPING LOOPING}
+     *  {@link #AL_BUFFER BUFFER}
+     *  {@link #AL_SOURCE_STATE SOURCE_STATE}
+     *  {@link #AL_CONE_OUTER_GAIN CONE_OUTER_GAIN}
+     *  {@link #AL_SOURCE_TYPE SOURCE_TYPE}
+     *  {@link #AL_POSITION POSITION}
+     *  {@link #AL_VELOCITY VELOCITY}
+     *  {@link #AL_GAIN GAIN}
+     *  {@link #AL_REFERENCE_DISTANCE REFERENCE_DISTANCE}
+     *  {@link #AL_ROLLOFF_FACTOR ROLLOFF_FACTOR}
+     *  {@link #AL_MAX_DISTANCE MAX_DISTANCE}
      * @param value1 the first parameter value.
      * @param value2 the second parameter value.
      * @param value3 the third parameter value.
@@ -411,7 +445,22 @@ public interface AL {
      * Returns the integer value of the specified source parameter.
      *
      * @param source the source to query.
-     * @param param  the parameter to query. One of:<br><table><tr><td>{@link #AL_CONE_INNER_ANGLE CONE_INNER_ANGLE}</td><td>{@link #AL_CONE_OUTER_ANGLE CONE_OUTER_ANGLE}</td><td>{@link #AL_PITCH PITCH}</td><td>{@link #AL_DIRECTION DIRECTION}</td><td>{@link #AL_LOOPING LOOPING}</td><td>{@link #AL_BUFFER BUFFER}</td><td>{@link #AL_SOURCE_STATE SOURCE_STATE}</td></tr><tr><td>{@link #AL_CONE_OUTER_GAIN CONE_OUTER_GAIN}</td><td>{@link #AL_SOURCE_TYPE SOURCE_TYPE}</td><td>{@link #AL_POSITION POSITION}</td><td>{@link #AL_VELOCITY VELOCITY}</td><td>{@link #AL_GAIN GAIN}</td><td>{@link #AL_REFERENCE_DISTANCE REFERENCE_DISTANCE}</td><td>{@link #AL_ROLLOFF_FACTOR ROLLOFF_FACTOR}</td></tr><tr><td>{@link #AL_MAX_DISTANCE MAX_DISTANCE}</td></tr></table>
+     * @param param  the parameter to query. One of:
+     *  {@link #AL_CONE_INNER_ANGLE CONE_INNER_ANGLE}
+     *  {@link #AL_CONE_OUTER_ANGLE CONE_OUTER_ANGLE}
+     *  {@link #AL_PITCH PITCH}
+     *  {@link #AL_DIRECTION DIRECTION}
+     *  {@link #AL_LOOPING LOOPING}
+     *  {@link #AL_BUFFER BUFFER}
+     *  {@link #AL_SOURCE_STATE SOURCE_STATE}
+     *  {@link #AL_CONE_OUTER_GAIN CONE_OUTER_GAIN}
+     *  {@link #AL_SOURCE_TYPE SOURCE_TYPE}
+     *  {@link #AL_POSITION POSITION}
+     *  {@link #AL_VELOCITY VELOCITY}
+     *  {@link #AL_GAIN GAIN}
+     *  {@link #AL_REFERENCE_DISTANCE REFERENCE_DISTANCE}
+     *  {@link #AL_ROLLOFF_FACTOR ROLLOFF_FACTOR}
+     *  {@link #AL_MAX_DISTANCE MAX_DISTANCE}
      */
     public int alGetSourcei(int source, int param);
 
@@ -453,7 +502,11 @@ public interface AL {
     /**
      * Sets the float value of a listener parameter.
      *
-     * @param param the parameter to modify. One of:<br><table><tr><td>{@link #AL_ORIENTATION ORIENTATION}</td><td>{@link #AL_POSITION POSITION}</td><td>{@link #AL_VELOCITY VELOCITY}</td><td>{@link #AL_GAIN GAIN}</td></tr></table>
+     * @param param the parameter to modify. One of:
+     *  {@link #AL_ORIENTATION ORIENTATION}
+     *  {@link #AL_POSITION POSITION}
+     *  {@link #AL_VELOCITY VELOCITY}
+     *  {@link #AL_GAIN GAIN}
      * @param value the parameter value.
      */
     public void alListenerf(int param, float value);
@@ -461,7 +514,11 @@ public interface AL {
     /**
      * Sets the 3 dimensional float values of a listener parameter.
      *
-     * @param param  the parameter to modify. One of:<br><table><tr><td>{@link #AL_ORIENTATION ORIENTATION}</td><td>{@link #AL_POSITION POSITION}</td><td>{@link #AL_VELOCITY VELOCITY}</td><td>{@link #AL_GAIN GAIN}</td></tr></table>
+     * @param param  the parameter to modify. One of:
+     *  {@link #AL_ORIENTATION ORIENTATION}
+     *  {@link #AL_POSITION POSITION}
+     *  {@link #AL_VELOCITY VELOCITY}
+     *  {@link #AL_GAIN GAIN}
      * @param value1 the first value.
      * @param value2 the second value.
      * @param value3 the third value.

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

@@ -82,7 +82,12 @@ public interface ALC {
     /**
      * Obtains string value(s) from ALC.
      *
-     * @param parameter the information to query. One of:<br><table><tr><td>{@link #ALC_DEFAULT_DEVICE_SPECIFIER DEFAULT_DEVICE_SPECIFIER}</td><td>{@link #ALC_DEVICE_SPECIFIER DEVICE_SPECIFIER}</td><td>{@link #ALC_EXTENSIONS EXTENSIONS}</td></tr><tr><td>{@link #ALC_CAPTURE_DEFAULT_DEVICE_SPECIFIER CAPTURE_DEFAULT_DEVICE_SPECIFIER}</td><td>{@link #ALC_CAPTURE_DEVICE_SPECIFIER CAPTURE_DEVICE_SPECIFIER}</td></tr></table>
+     * @param parameter the information to query. One of:
+     *  {@link #ALC_DEFAULT_DEVICE_SPECIFIER DEFAULT_DEVICE_SPECIFIER}
+     *  {@link #ALC_DEVICE_SPECIFIER DEVICE_SPECIFIER}
+     *  {@link #ALC_EXTENSIONS EXTENSIONS}
+     *  {@link #ALC_CAPTURE_DEFAULT_DEVICE_SPECIFIER CAPTURE_DEFAULT_DEVICE_SPECIFIER}
+     *  {@link #ALC_CAPTURE_DEVICE_SPECIFIER CAPTURE_DEVICE_SPECIFIER}
      */
     public String alcGetString(int parameter);
 
@@ -99,7 +104,12 @@ public interface ALC {
     /**
      * Obtains integer value(s) from ALC.
      *
-     * @param param  the information to query. One of:<br><table><tr><td>{@link #ALC_MAJOR_VERSION MAJOR_VERSION}</td><td>{@link #ALC_MINOR_VERSION MINOR_VERSION}</td><td>{@link #ALC_ATTRIBUTES_SIZE ATTRIBUTES_SIZE}</td><td>{@link #ALC_ALL_ATTRIBUTES ALL_ATTRIBUTES}</td><td>{@link #ALC_CAPTURE_SAMPLES CAPTURE_SAMPLES}</td></tr></table>
+     * @param param  the information to query. One of:
+     *  {@link #ALC_MAJOR_VERSION MAJOR_VERSION}
+     *  {@link #ALC_MINOR_VERSION MINOR_VERSION}
+     *  {@link #ALC_ATTRIBUTES_SIZE ATTRIBUTES_SIZE}
+     *  {@link #ALC_ALL_ATTRIBUTES ALL_ATTRIBUTES}
+     *  {@link #ALC_CAPTURE_SAMPLES CAPTURE_SAMPLES}
      * @param buffer the destination buffer.
      * @param size   the buffer size.
      */

jme3-core/src/main/java/com/jme3/bounding/BoundingBox.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
@@ -581,7 +581,7 @@ public class BoundingBox extends BoundingVolume {
 
     /**
      * <code>toString</code> returns the string representation of this object.
-     * The form is: "[Center: <Vector> xExtent: X.XX yExtent: Y.YY zExtent:
+     * The form is: "[Center: vector xExtent: X.XX yExtent: Y.YY zExtent:
      * Z.ZZ]".
      *
      * @return the string representation of this.

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

@@ -654,7 +654,7 @@ public class BoundingSphere extends BoundingVolume {
 
     /**
      * <code>toString</code> returns the string representation of this object.
-     * The form is: "Radius: RRR.SSSS Center: <Vector>".
+     * The form is: "Radius: RRR.SSSS Center: vector".
      *
      * @return the string representation of this.
      */

jme3-core/src/main/java/com/jme3/material/MatParam.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
@@ -132,15 +132,15 @@ public class MatParam implements Savable, Cloneable {
 
     /**
      * Returns the material parameter value as it would appear in a J3M
-     * file. E.g.<br/>
-     * <code>
-     * MaterialParameters {<br/>
-     *     ABC : 1 2 3 4<br/>
-     * }<br/>
-     * </code>
+     * file. E.g.
+     * <pre>
+     * MaterialParameters {
+     *     ABC : 1 2 3 4
+     * }
+     * </pre>
      * Assuming "ABC" is a Vector4 parameter, then the value
      * "1 2 3 4" would be returned by this method.
-     * <br/><br/>
+     *
      * @return material parameter value as it would appear in a J3M file.
      */
     public String getValueAsString() {

jme3-core/src/main/java/com/jme3/material/Material.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
@@ -64,7 +64,7 @@ import java.util.logging.Logger;
  * those parameters map to uniforms which are defined in a shader.
  * Setting the parameters can modify the behavior of a
  * shader.
- * <p/>
+ * </p>
  *
  * @author Kirill Vainer
  */

jme3-core/src/main/java/com/jme3/material/RenderState.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
@@ -346,12 +346,12 @@ public class RenderState implements Cloneable, Savable {
          * <p>
          * These attributes can be set by using the following methods:
          * <ul>
-         * <li>{@link RenderState#setBlendEquation(BlendEquation)}<br/>
-         * <li>{@link RenderState#setBlendEquationAlpha(BlendEquationAlpha)}<br/>
-         * <li>{@link RenderState#setCustomBlendFactors(BlendFunc, BlendFunc, BlendFunc, BlendFunc)}<br/>
+         * <li>{@link RenderState#setBlendEquation(BlendEquation)}
+         * <li>{@link RenderState#setBlendEquationAlpha(BlendEquationAlpha)}
+         * <li>{@link RenderState#setCustomBlendFactors(BlendFunc, BlendFunc, BlendFunc, BlendFunc)}
          * </ul>
          * <p>
-         * Result.RGB = BlendEquation( sfactorRGB * Source.RGB , dfactorRGB * Destination.RGB )<br/>
+         * Result.RGB = BlendEquation( sfactorRGB * Source.RGB , dfactorRGB * Destination.RGB )<br>
          * Result.A = BlendEquationAlpha( sfactorAlpha * Source.A , dfactorAlpha * Destination.A )
          */
         Custom
@@ -772,7 +772,7 @@ public class RenderState implements Cloneable, Savable {
      * already in the color buffer. The blending operation is determined
      * by the {@link BlendMode}. For example, the {@link BlendMode#Additive}
      * will add the input pixel's color to the color already in the color buffer:
-     * <br/>
+     * <br>
      * <code>Result = Source Color + Destination Color</code>
      *
      * @param blendMode The blend mode to use. Set to {@link BlendMode#Off}
@@ -788,10 +788,10 @@ public class RenderState implements Cloneable, Savable {
      * Set the blending equation for the color component (RGB).
      * <p>
      * The blending equation determines, how the RGB values of the input pixel
-     * will be blended with the RGB values of the pixel already in the color buffer.<br/>
+     * will be blended with the RGB values of the pixel already in the color buffer.<br>
      * For example, {@link BlendEquation#Add} will add the input pixel's color
      * to the color already in the color buffer:
-     * <br/>
+     * <br>
      * <code>Result = Source Color + Destination Color</code>
      * <p>
      * <b>Note:</b> This gets only used in {@link BlendMode#Custom} mode.
@@ -808,10 +808,10 @@ public class RenderState implements Cloneable, Savable {
      * Set the blending equation for the alpha component.
      * <p>
      * The alpha blending equation determines, how the alpha values of the input pixel
-     * will be blended with the alpha values of the pixel already in the color buffer.<br/>
+     * will be blended with the alpha values of the pixel already in the color buffer.<br>
      * For example, {@link BlendEquationAlpha#Add} will add the input pixel's color
      * to the color already in the color buffer:
-     * <br/>
+     * <br>
      * <code>Result = Source Color + Destination Color</code>
      * <p>
      * <b>Note:</b> This gets only used in {@link BlendMode#Custom} mode.
@@ -901,7 +901,7 @@ public class RenderState implements Cloneable, Savable {
      * typically with positive Z pointing into the screen.
      * Typical values are (1.0f, 1.0f) or (-1.0f, -1.0f)
      *
-     * @see <a href="http://www.opengl.org/resources/faq/technical/polygonoffset.htm" rel="nofollow">http://www.opengl.org/resources/faq/technical/polygonoffset.htm</a>
+     * @see <a href="http://www.opengl.org/resources/faq/technical/polygonoffset.htm">http://www.opengl.org/resources/faq/technical/polygonoffset.htm</a>
      * @param factor scales the maximum Z slope, with respect to X or Y of the polygon
      * @param units scales the minimum resolvable depth buffer value
      **/
@@ -1457,7 +1457,7 @@ public class RenderState implements Cloneable, Savable {
      * Merges <code>this</code> state and <code>additionalState</code> into
      * the parameter <code>state</code> based on a specific criteria.
      *
-     * <p>The criteria for this merge is the following:<br/>
+     * <p>The criteria for this merge is the following:<br>
      * For every given property, such as alpha test or depth write, check
      * if it was modified from the original in the <code>additionalState</code>
      * if it was modified, then copy the property from the <code>additionalState</code>

jme3-core/src/main/java/com/jme3/material/logic/SinglePassAndImageBasedLightingLogic.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
@@ -94,17 +94,16 @@ public final class SinglePassAndImageBasedLightingLogic extends DefaultTechnique
     }
 
     /**
-     * Uploads the lights in the light list as two uniform arrays.<br/><br/> *
+     * Uploads the lights in the light list as two uniform arrays.
      * <p>
-     * <code>uniform vec4 g_LightColor[numLights];</code><br/> //
-     * g_LightColor.rgb is the diffuse/specular color of the light.<br/> //
-     * g_Lightcolor.a is the type of light, 0 = Directional, 1 = Point, <br/> //
-     * 2 = Spot. <br/> <br/>
-     * <code>uniform vec4 g_LightPosition[numLights];</code><br/> //
-     * g_LightPosition.xyz is the position of the light (for point lights)<br/>
-     * // or the direction of the light (for directional lights).<br/> //
+     * <code>uniform vec4 g_LightColor[numLights];</code> //
+     * g_LightColor.rgb is the diffuse/specular color of the light. //
+     * g_Lightcolor.a is the type of light, 0 = Directional, 1 = Point, 2 = Spot.
+     * <code>uniform vec4 g_LightPosition[numLights];</code> //
+     * g_LightPosition.xyz is the position of the light (for point lights)
+     * // or the direction of the light (for directional lights). //
      * g_LightPosition.w is the inverse radius (1/r) of the light (for
-     * attenuation) <br/> </p>
+     * attenuation) </p>
      */
     protected int updateLightListUniforms(Shader shader, Geometry g, LightList lightList, int numLights, RenderManager rm, int startIndex, int lastTexUnit) {
         if (numLights == 0) { // this shader does not do lighting, ignore.

jme3-core/src/main/java/com/jme3/material/logic/SinglePassLightingLogic.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
@@ -85,17 +85,17 @@ public final class SinglePassLightingLogic extends DefaultTechniqueDefLogic {
     }
 
     /**
-     * Uploads the lights in the light list as two uniform arrays.<br/><br/> *
+     * Uploads the lights in the light list as two uniform arrays.
      * <p>
-     * <code>uniform vec4 g_LightColor[numLights];</code><br/> //
-     * g_LightColor.rgb is the diffuse/specular color of the light.<br/> //
-     * g_Lightcolor.a is the type of light, 0 = Directional, 1 = Point, <br/> //
-     * 2 = Spot. <br/> <br/>
-     * <code>uniform vec4 g_LightPosition[numLights];</code><br/> //
-     * g_LightPosition.xyz is the position of the light (for point lights)<br/>
-     * // or the direction of the light (for directional lights).<br/> //
+     * <code>uniform vec4 g_LightColor[numLights];</code><br> //
+     * g_LightColor.rgb is the diffuse/specular color of the light.<br> //
+     * g_Lightcolor.a is the type of light, 0 = Directional, 1 = Point, <br> //
+     * 2 = Spot. <br> <br>
+     * <code>uniform vec4 g_LightPosition[numLights];</code><br> //
+     * g_LightPosition.xyz is the position of the light (for point lights)<br>
+     * // or the direction of the light (for directional lights).<br> //
      * g_LightPosition.w is the inverse radius (1/r) of the light (for
-     * attenuation) <br/> </p>
+     * attenuation)</p>
      */
     protected int updateLightListUniforms(Shader shader, Geometry g, LightList lightList, int numLights, RenderManager rm, int startIndex) {
         if (numLights == 0) { // this shader does not do lighting, ignore.

jme3-core/src/main/java/com/jme3/math/Matrix3f.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
@@ -483,7 +483,7 @@ public final class Matrix3f implements Savable, Cloneable, java.io.Serializable
     /**
      * Copy all elements of this matrix to a float array.
      *
-     * @param f   the array to fill (not null, length >= 9)
+     * @param f   the array to fill (not null, length≥9)
      * @param columnMajor
      *            true → column-major order, false → row-major order
      */
@@ -1318,8 +1318,9 @@ public final class Matrix3f implements Savable, Cloneable, java.io.Serializable
      *            normalized non-zero starting vector
      * @param end
      *            normalized non-zero ending vector
-     * @see "Tomas M�ller, John Hughes \"Efficiently Building a Matrix to Rotate \
-     *      One Vector to Another\" Journal of Graphics Tools, 4(4):1-4, 1999"
+     *
+     * See Tomas M�ller, John Hughes "Efficiently Building a Matrix to Rotate
+     *      One Vector to Another" Journal of Graphics Tools, 4(4):1-4, 1999.
      */
     public void fromStartEndVectors(Vector3f start, Vector3f end) {
         Vector3f v = new Vector3f();

jme3-core/src/main/java/com/jme3/math/Matrix4f.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
@@ -862,7 +862,7 @@ public final class Matrix4f implements Savable, Cloneable, java.io.Serializable
     /**
      * Copy the elements of this matrix to a float array.
      *
-     * @param f   the array to fill (not null, length >= 16)
+     * @param f   the array to fill (not null, length≥16)
      * @param columnMajor
      *            true → column-major order, false → row-major order
      */

jme3-core/src/main/java/com/jme3/renderer/opengl/GL.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
@@ -205,7 +205,9 @@ public interface GL {
      * Selects which texture unit subsequent texture state calls will affect. The number of texture units an implementation supports is implementation
      * dependent.
      *
-     * @param texture which texture unit to make active. One of:<br><table><tr><td>{@link #GL_TEXTURE0 TEXTURE0}</td><td>GL_TEXTURE[1-31]</td></tr></table>
+     * @param texture which texture unit to make active. One of:
+     *  {@link #GL_TEXTURE0 TEXTURE0}
+     *  GL_TEXTURE[1-31]
      */
     public void glActiveTexture(int texture);
 
@@ -537,7 +539,12 @@ public interface GL {
      * <p>
      * Creates a shader object.
      *
-     * @param shaderType the type of shader to be created. One of:<br><table><tr><td>{@link #GL_VERTEX_SHADER VERTEX_SHADER}</td><td>{@link #GL_FRAGMENT_SHADER FRAGMENT_SHADER}</td><td>{@link GL3#GL_GEOMETRY_SHADER GEOMETRY_SHADER}</td><td>{@link GL4#GL_TESS_CONTROL_SHADER TESS_CONTROL_SHADER}</td></tr><tr><td>{@link GL4#GL_TESS_EVALUATION_SHADER TESS_EVALUATION_SHADER}</td></tr></table>
+     * @param shaderType the type of shader to be created. One of:
+     *  {@link #GL_VERTEX_SHADER VERTEX_SHADER}
+     *  {@link #GL_FRAGMENT_SHADER FRAGMENT_SHADER}
+     *  {@link GL3#GL_GEOMETRY_SHADER GEOMETRY_SHADER}
+     *  {@link GL4#GL_TESS_CONTROL_SHADER TESS_CONTROL_SHADER}
+     *  {@link GL4#GL_TESS_EVALUATION_SHADER TESS_EVALUATION_SHADER}
      */
     public int glCreateShader(int shaderType);
 
@@ -548,7 +555,10 @@ public interface GL {
      * CullFace mode is {@link #GL_BACK BACK} while back-facing polygons are rasterized only if either culling is disabled or the CullFace mode is
      * {@link #GL_FRONT FRONT}. The initial setting of the CullFace mode is {@link #GL_BACK BACK}. Initially, culling is disabled.
      *
-     * @param mode the CullFace mode. One of:<br><table><tr><td>{@link #GL_FRONT FRONT}</td><td>{@link #GL_BACK BACK}</td><td>{@link #GL_FRONT_AND_BACK FRONT_AND_BACK}</td></tr></table>
+     * @param mode the CullFace mode. One of:
+     *  {@link #GL_FRONT FRONT}
+     *  {@link #GL_BACK BACK}
+     *  {@link #GL_FRONT_AND_BACK FRONT_AND_BACK}
      */
     public void glCullFace(int mode);
 
@@ -599,7 +609,15 @@ public interface GL {
      * <p>
      * Specifies the comparison that takes place during the depth buffer test (when {@link #GL_DEPTH_TEST DEPTH_TEST} is enabled).
      *
-     * @param func the depth test comparison. One of:<br><table><tr><td>{@link #GL_NEVER NEVER}</td><td>{@link #GL_ALWAYS ALWAYS}</td><td>{@link #GL_LESS LESS}</td><td>{@link #GL_LEQUAL LEQUAL}</td><td>{@link #GL_EQUAL EQUAL}</td><td>{@link #GL_GREATER GREATER}</td><td>{@link #GL_GEQUAL GEQUAL}</td><td>{@link #GL_NOTEQUAL NOTEQUAL}</td></tr></table>
+     * @param func the depth test comparison. One of:
+     *  {@link #GL_NEVER NEVER}
+     *  {@link #GL_ALWAYS ALWAYS}
+     *  {@link #GL_LESS LESS}
+     *  {@link #GL_LEQUAL LEQUAL}
+     *  {@link #GL_EQUAL EQUAL}
+     *  {@link #GL_GREATER GREATER}
+     *  {@link #GL_GEQUAL GEQUAL}
+     *  {@link #GL_NOTEQUAL NOTEQUAL}
      */
     public void glDepthFunc(int func);
 
@@ -681,7 +699,7 @@ public interface GL {
      * <p>Vertex attributes that are modified by glDrawRangeElements have an unspecified value after glDrawRangeElements returns. Attributes that aren't modified
      * maintain their previous values.</p>
      * <p>
-     * <h5>Errors</h5>
+     * Errors
      * <p>
      * <p>It is an error for indices to lie outside the range start end, but implementations may not check for this situation. Such indices cause
      * implementation-dependent behavior.</p>
@@ -854,7 +872,9 @@ public interface GL {
      * Returns the integer value of a query object parameter.
      *
      * @param query the name of a query object
-     * @param pname the symbolic name of a query object parameter. One of:<br><table><tr><td>{@link #GL_QUERY_RESULT QUERY_RESULT}</td><td>{@link #GL_QUERY_RESULT_AVAILABLE QUERY_RESULT_AVAILABLE}</td></tr></table>
+     * @param pname the symbolic name of a query object parameter. One of:
+     *  {@link #GL_QUERY_RESULT QUERY_RESULT}
+     *  {@link #GL_QUERY_RESULT_AVAILABLE QUERY_RESULT_AVAILABLE}
      */
     public int glGetQueryObjectiv(int query, int pname);
 
@@ -884,7 +904,12 @@ public interface GL {
      * <p>
      * Return strings describing properties of the current GL context.
      *
-     * @param name the property to query. One of:<br><table><tr><td>{@link #GL_RENDERER RENDERER}</td><td>{@link #GL_VENDOR VENDOR}</td><td>{@link #GL_EXTENSIONS EXTENSIONS}</td><td>{@link #GL_VERSION VERSION}</td><td>{@link GL2#GL_SHADING_LANGUAGE_VERSION SHADING_LANGUAGE_VERSION}</td></tr></table>
+     * @param name the property to query. One of:
+     *  {@link #GL_RENDERER RENDERER}
+     *  {@link #GL_VENDOR VENDOR}
+     *  {@link #GL_EXTENSIONS EXTENSIONS}
+     *  {@link #GL_VERSION VERSION}
+     *  {@link GL2#GL_SHADING_LANGUAGE_VERSION SHADING_LANGUAGE_VERSION}
      */
     public String glGetString(int name);
 
@@ -1023,8 +1048,19 @@ public interface GL {
      * <p>
      * Sets front and/or back function and reference value for stencil testing.
      *
-     * @param face whether front and/or back stencil state is updated. One of:<br><table><tr><td>{@link GL#GL_FRONT FRONT}</td><td>{@link GL#GL_BACK BACK}</td><td>{@link GL#GL_FRONT_AND_BACK FRONT_AND_BACK}</td></tr></table>
-     * @param func the test function. The initial value is GL_ALWAYS. One of:<br><table><tr><td>{@link GL#GL_NEVER NEVER}</td><td>{@link GL#GL_LESS LESS}</td><td>{@link GL#GL_LEQUAL LEQUAL}</td><td>{@link GL#GL_GREATER GREATER}</td><td>{@link GL#GL_GEQUAL GEQUAL}</td><td>{@link GL#GL_EQUAL EQUAL}</td><td>{@link GL#GL_NOTEQUAL NOTEQUAL}</td><td>{@link GL#GL_ALWAYS ALWAYS}</td></tr></table>
+     * @param face whether front and/or back stencil state is updated. One of:
+     *  {@link GL#GL_FRONT FRONT}
+     *  {@link GL#GL_BACK BACK}
+     *  {@link GL#GL_FRONT_AND_BACK FRONT_AND_BACK}
+     * @param func the test function. The initial value is GL_ALWAYS. One of:
+     *  {@link GL#GL_NEVER NEVER}
+     *  {@link GL#GL_LESS LESS}
+     *  {@link GL#GL_LEQUAL LEQUAL}
+     *  {@link GL#GL_GREATER GREATER}
+     *  {@link GL#GL_GEQUAL GEQUAL}
+     *  {@link GL#GL_EQUAL EQUAL}
+     *  {@link GL#GL_NOTEQUAL NOTEQUAL}
+     *  {@link GL#GL_ALWAYS ALWAYS}
      * @param ref  the reference value for the stencil test. {@code ref} is clamped to the range [0, 2n &ndash; 1], where {@code n} is the number of bitplanes in the stencil
      *             buffer. The initial value is 0.
      * @param mask a mask that is ANDed with both the reference value and the stored stencil value when the test is done. The initial value is all 1's.
@@ -1036,8 +1072,19 @@ public interface GL {
      * <p>
      * Sets front and/or back stencil test actions.
      *
-     * @param face   whether front and/or back stencil state is updated. One of:<br><table><tr><td>{@link GL#GL_FRONT FRONT}</td><td>{@link GL#GL_BACK BACK}</td><td>{@link GL#GL_FRONT_AND_BACK FRONT_AND_BACK}</td></tr></table>
-     * @param sfail  the action to take when the stencil test fails. The initial value is GL_KEEP. One of:<br><table><tr><td>{@link GL#GL_KEEP KEEP}</td><td>{@link GL#GL_ZERO ZERO}</td><td>{@link GL#GL_REPLACE REPLACE}</td><td>{@link GL#GL_INCR INCR}</td><td>{@link GL#GL_INCR_WRAP INCR_WRAP}</td><td>{@link GL#GL_DECR DECR}</td><td>{@link GL#GL_DECR_WRAP DECR_WRAP}</td><td>{@link GL#GL_INVERT INVERT}</td></tr></table>
+     * @param face   whether front and/or back stencil state is updated. One of:
+     *  {@link GL#GL_FRONT FRONT}
+     *  {@link GL#GL_BACK BACK}
+     *  {@link GL#GL_FRONT_AND_BACK FRONT_AND_BACK}
+     * @param sfail  the action to take when the stencil test fails. The initial value is GL_KEEP. One of:
+     *  {@link GL#GL_KEEP KEEP}
+     *  {@link GL#GL_ZERO ZERO}
+     *  {@link GL#GL_REPLACE REPLACE}
+     *  {@link GL#GL_INCR INCR}
+     *  {@link GL#GL_INCR_WRAP INCR_WRAP}
+     *  {@link GL#GL_DECR DECR}
+     *  {@link GL#GL_DECR_WRAP DECR_WRAP}
+     *  {@link GL#GL_INVERT INVERT}
      * @param dpfail the stencil action when the stencil test passes, but the depth test fails. The initial value is GL_KEEP.
      * @param dppass the stencil action when both the stencil test and the depth test pass, or when the stencil test passes and either there is no depth buffer or depth
      *               testing is not enabled. The initial value is GL_KEEP.

jme3-core/src/main/java/com/jme3/renderer/opengl/GL2.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
@@ -82,7 +82,15 @@ public interface GL2 extends GL {
      * The comparison is enabled or disabled with the generic {@link #glEnable Enable} and {@link #glDisable Disable} commands using the symbolic constant {@link #GL_ALPHA_TEST ALPHA_TEST}.
      * When disabled, it is as if the comparison always passes. The test is controlled with this method.
      *
-     * @param func a symbolic constant indicating the alpha test function. One of:<br><table><tr><td>{@link #GL_NEVER NEVER}</td><td>{@link #GL_ALWAYS ALWAYS}</td><td>{@link #GL_LESS LESS}</td><td>{@link #GL_LEQUAL LEQUAL}</td><td>{@link #GL_EQUAL EQUAL}</td><td>{@link #GL_GEQUAL GEQUAL}</td><td>{@link #GL_GREATER GREATER}</td><td>{@link #GL_NOTEQUAL NOTEQUAL}</td></tr></table>
+     * @param func a symbolic constant indicating the alpha test function. One of:
+     *  {@link #GL_NEVER NEVER}
+     *  {@link #GL_ALWAYS ALWAYS}
+     *  {@link #GL_LESS LESS}
+     *  {@link #GL_LEQUAL LEQUAL}
+     *  {@link #GL_EQUAL EQUAL}
+     *  {@link #GL_GEQUAL GEQUAL}
+     *  {@link #GL_GREATER GREATER}
+     *  {@link #GL_NOTEQUAL NOTEQUAL}
      * @param ref  a reference value clamped to the range [0, 1]. When performing the alpha test, the GL will convert the reference value to the same representation as the fragment's alpha value (floating-point or fixed-point).
      */
     public void glAlphaFunc(int func, float ref);
@@ -105,8 +113,14 @@ public interface GL2 extends GL {
      * polygon's vertices are lit, and the polygon is clipped and possibly culled before these modes are applied. Polygon antialiasing applies only to the
      * {@link #GL_FILL FILL} state of PolygonMode. For {@link #GL_POINT POINT} or {@link #GL_LINE LINE}, point antialiasing or line segment antialiasing, respectively, apply.</p>
      *
-     * @param face the face for which to set the rasterizing method. One of:<br><table><tr><td>{@link #GL_FRONT FRONT}</td><td>{@link #GL_BACK BACK}</td><td>{@link #GL_FRONT_AND_BACK FRONT_AND_BACK}</td></tr></table>
-     * @param mode the rasterization mode. One of:<br><table><tr><td>{@link #GL_POINT POINT}</td><td>{@link #GL_LINE LINE}</td><td>{@link #GL_FILL FILL}</td></tr></table>
+     * @param face the face for which to set the rasterizing method. One of:
+     *  {@link #GL_FRONT FRONT}
+     *  {@link #GL_BACK BACK}
+     *  {@link #GL_FRONT_AND_BACK FRONT_AND_BACK}
+     * @param mode the rasterization mode. One of:
+     *  {@link #GL_POINT POINT}
+     *  {@link #GL_LINE LINE}
+     *  {@link #GL_FILL FILL}
      */
     public void glPolygonMode(int face, int mode);
 

jme3-core/src/main/java/com/jme3/renderer/opengl/GL3.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
@@ -168,7 +168,9 @@ public interface GL3 extends GL2 {
      * <p>
      * Queries indexed string state.
      *
-     * @param name  the indexed state to query. One of:<br><table><tr><td>{@link GL#GL_EXTENSIONS EXTENSIONS}</td><td>{@link GL2#GL_SHADING_LANGUAGE_VERSION SHADING_LANGUAGE_VERSION}</td></tr></table>
+     * @param name  the indexed state to query. One of:
+     *  {@link GL#GL_EXTENSIONS EXTENSIONS}
+     *  {@link GL2#GL_SHADING_LANGUAGE_VERSION SHADING_LANGUAGE_VERSION}
      * @param index the index of the particular element being queried.
      */
     public String glGetString(int name, int index); /// GL3+
@@ -190,7 +192,11 @@ public interface GL3 extends GL2 {
      *
      * Binds a buffer object to an indexed buffer target.
      *
-     * @param target the target of the bind operation. One of:<br><table><tr><td>{@link #GL_TRANSFORM_FEEDBACK_BUFFER TRANSFORM_FEEDBACK_BUFFER}</td><td>{@link #GL_UNIFORM_BUFFER UNIFORM_BUFFER}</td><td>{@link GL4#GL_ATOMIC_COUNTER_BUFFER ATOMIC_COUNTER_BUFFER}</td><td>{@link GL4#GL_SHADER_STORAGE_BUFFER SHADER_STORAGE_BUFFER}</td></tr></table>
+     * @param target the target of the bind operation. One of:
+     *  {@link #GL_TRANSFORM_FEEDBACK_BUFFER TRANSFORM_FEEDBACK_BUFFER}
+     *  {@link #GL_UNIFORM_BUFFER UNIFORM_BUFFER}
+     *  {@link GL4#GL_ATOMIC_COUNTER_BUFFER ATOMIC_COUNTER_BUFFER}
+     *  {@link GL4#GL_SHADER_STORAGE_BUFFER SHADER_STORAGE_BUFFER}
      * @param index  the index of the binding point within the array specified by {@code target}
      * @param buffer a buffer object to bind to the specified binding point
      */

jme3-core/src/main/java/com/jme3/renderer/opengl/GLDebug.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
@@ -39,12 +39,12 @@ import java.lang.reflect.Proxy;
 
 /**
  * This class uses Reflection to intercept method calls to the Proxy Object ({@link #createProxy(GL, Object, Class[])}
- * and extends them with the Error Checking in {@link #checkError()}.<br/>
+ * and extends them with the Error Checking in {@link #checkError()}.<br>
  * This means we don't have to generate a class with overrides for every possible method just to add a
- * {@link #checkError()} call.<br/>
- * Note that we should not call {@link #checkError()} for {@link GL#glGetError()}, it doesn't make sense.<br />
+ * {@link #checkError()} call.<br>
+ * Note that we should not call {@link #checkError()} for {@link GL#glGetError()}, it doesn't make sense.<br>
  * Note that this class is general purpose and as such every class instance (every object) can be guarded as long as
- * the passed gl instance is valid.<br/>
+ * the passed gl instance is valid.
  *
  * @author MeFisto94
  */

jme3-core/src/main/java/com/jme3/renderer/queue/RenderQueue.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
@@ -181,6 +181,7 @@ public class RenderQueue {
      *                     at all.
      *  <li>Bucket.Gui: {@link com.jme3.renderer.queue.GuiComparator} sorts geometries back to
      *                     front based on their Z values.
+     *  </ul>
      */
     public void setGeometryComparator(Bucket bucket, GeometryComparator c) {
         switch (bucket) {

jme3-core/src/main/java/com/jme3/scene/Node.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
@@ -623,17 +623,17 @@ public class Node extends Spatial {
      /**
      * Returns flat list of Spatials implementing the specified class AND
      * with name matching the specified pattern.
-     * </P> <P>
+     * <P>
      * Note that we are <i>matching</i> the pattern, therefore the pattern
      * must match the entire pattern (i.e. it behaves as if it is sandwiched
      * between "^" and "$").
      * You can set regex modes, like case insensitivity, by using the (?X)
      * or (?X:Y) constructs.
      * </P> <P>
-     * By design, it is always safe to code loops like:<CODE><PRE>
+     * By design, it is always safe to code loops like:<PRE>
      *     for (Spatial spatial : node.descendantMatches(AClass.class, "regex"))
-     * </PRE></CODE>
-     * </P> <P>
+     * </PRE>
+     * <P>
      * "Descendants" does not include self, per the definition of the word.
      * To test for descendants AND self, you must do a
      * <code>node.matches(aClass, aRegex)</code> +

jme3-core/src/main/java/com/jme3/shadow/DirectionalLightShadowRenderer.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
@@ -58,7 +58,7 @@ import java.io.IOException;
  * the shadow map.<br> This results in a better quality shadow than standard
  * shadow mapping.<br> for more informations on this read this <a
  * href="https://developer.nvidia.com/gpugems/GPUGems3/gpugems3_ch10.html">https://developer.nvidia.com/gpugems/GPUGems3/gpugems3_ch10.html</a><br>
- * <p/>
+ *
  * @author Rémy Bouquet aka Nehon
  */
 public class DirectionalLightShadowRenderer extends AbstractShadowRenderer {

jme3-core/src/main/java/com/jme3/shadow/PssmShadowRenderer.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
@@ -69,7 +69,7 @@ import java.util.List;
  * This results in a better quality shadow than standard shadow mapping.<br> for
  * more informations on this read this <a
  * href="http://http.developer.nvidia.com/GPUGems3/gpugems3_ch10.html">http://http.developer.nvidia.com/GPUGems3/gpugems3_ch10.html</a><br>
- * <p/>
+ *
  * @author Rémy Bouquet aka Nehon
  * @deprecated use {@link DirectionalLightShadowRenderer}
  */

jme3-core/src/main/java/com/jme3/shadow/SpotLightShadowRenderer.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
@@ -59,7 +59,7 @@ import java.io.IOException;
  * shadow map.<br> This results in a better quality shadow than standard shadow
  * mapping.<br> for more informations on this read this <a
  * href="http://http.developer.nvidia.com/GPUGems3/gpugems3_ch10.html">http://http.developer.nvidia.com/GPUGems3/gpugems3_ch10.html</a><br>
- * <p/>
+ *
  * @author Rémy Bouquet aka Nehon
  */
 public class SpotLightShadowRenderer extends AbstractShadowRenderer {

jme3-core/src/main/java/com/jme3/system/AppSettings.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
@@ -889,7 +889,7 @@ public final class AppSettings extends HashMap<String, Object> {
      * the latter for the alt-tab icon.
      * Linux (and similar platforms) expect one 32x32 icon.
      * Mac OS X should be supplied one 128x128 icon.
-     * <br/>
+     * <br>
      * The icon is used for the settings window, and the LWJGL render window.
      * Note that a bug in Java 6 (bug ID 6445278, currently hidden but available in Google cache) currently prevents
      * the icon working for alt-tab on the settings dialog in Windows.
@@ -1192,7 +1192,7 @@ public final class AppSettings extends HashMap<String, Object> {
 
     /**
      * Determine if the renderer will be run in Graphics Debug mode, which means every openGL call is checked and
-     * if it returns an error code, throw a {@link com.jme3.renderer.RendererException}.<br />
+     * if it returns an error code, throw a {@link com.jme3.renderer.RendererException}.<br>
      * Without this, many openGL calls might fail without notice, so turning it on is recommended for development.
      *
      * @return whether the context will be run in Graphics Debug Mode or not
@@ -1204,7 +1204,7 @@ public final class AppSettings extends HashMap<String, Object> {
 
     /**
      * Set whether the renderer will be run in Graphics Debug mode, which means every openGL call is checked and
-     * if it returns an error code, throw a {@link com.jme3.renderer.RendererException}.<br />
+     * if it returns an error code, throw a {@link com.jme3.renderer.RendererException}.<br>
      * Without this, many openGL calls might fail without notice, so turning it on is recommended for development.
      *
      * @param debug whether the context will be run in Graphics Debug Mode or not
@@ -1216,9 +1216,9 @@ public final class AppSettings extends HashMap<String, Object> {
 
     /**
      * Determine if the renderer will be run in Graphics Timing mode, which means every openGL call is checked and
-     * if it runs for longer than a millisecond, log it.<br />
+     * if it runs for longer than a millisecond, log it.<br>
      * It also keeps track of the time spent in GL Calls in general and displays them when
-     * {@link com.jme3.renderer.opengl.GL#resetStats()} is called.<br />
+     * {@link com.jme3.renderer.opengl.GL#resetStats()} is called.
      *
      * @return whether the context will be run in Graphics Timing Mode or not
      * @see #setGraphicsTiming(boolean)
@@ -1230,9 +1230,9 @@ public final class AppSettings extends HashMap<String, Object> {
 
     /**
      * Set whether the renderer will be run in Graphics Timing mode, which means every openGL call is checked and
-     * if it runs for longer than a millisecond, log it.<br />
+     * if it runs for longer than a millisecond, log it.<br>
      * It also keeps track of the time spent in GL Calls in general and displays them when
-     * {@link com.jme3.renderer.opengl.GL#resetStats()} is called.<br />
+     * {@link com.jme3.renderer.opengl.GL#resetStats()} is called.
      *
      * @param timing whether the context will be run in Graphics Timing Mode or not
      * @see #isGraphicsTiming()
@@ -1244,7 +1244,7 @@ public final class AppSettings extends HashMap<String, Object> {
 
     /**
      * Determine if the renderer will be run in Graphics Trace mode, which means every openGL call is logged so one
-     * can trace what openGL commands where executed in which order by the engine.<br />
+     * can trace what openGL commands where executed in which order by the engine.
      *
      * @return whether the context will be run in Graphics Trace Mode or not
      * @see #setGraphicsTrace(boolean)
@@ -1256,7 +1256,7 @@ public final class AppSettings extends HashMap<String, Object> {
 
     /**
      * Set whether the renderer will be run in Graphics Trace mode, which means every openGL call is logged so one
-     * can trace what openGL commands where executed in which order by the engine.<br />
+     * can trace what openGL commands where executed in which order by the engine.
      *
      * @param trace whether the context will be run in Graphics Trace Mode or not
      * @see #isGraphicsTrace()

jme3-core/src/main/java/com/jme3/texture/Image.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
@@ -1140,7 +1140,7 @@ public class Image extends NativeObject implements Savable /*, Cloneable*/ {
      * such conversion must not be performed, for example, when loading normal
      * maps.
      *
-     * @param colorSpace @see ColorSpace. Set to sRGB to enable srgb -> linear 
+     * @param colorSpace Set to sRGB to enable srgb -> linear 
      * conversion, Linear otherwise.
      *
      * @see Renderer#setLinearizeSrgbImages(boolean)

jme3-core/src/main/java/com/jme3/util/JmeFormatter.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
@@ -40,7 +40,7 @@ import java.util.logging.LogRecord;
 
 /**
  * More simple formatter than the default one used in Java logging.
- * Example output: <br/>
+ * Example output: <br>
  * INFO Display3D 12:00 PM: Display created.
  */
 public class JmeFormatter extends Formatter {

jme3-core/src/plugins/java/com/jme3/material/plugins/ShaderNodeLoaderDelegate.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
@@ -388,7 +388,7 @@ public class ShaderNodeLoaderDelegate {
     }
 
     /**
-     * Reads a Shader statement of this form <TYPE> <LANG> : <SOURCE>
+     * Reads a Shader statement of the form TYPE LANG : SOURCE
      *
      * @param statement
      * @throws IOException