Use Javadoc instead of HTML tag

Author: garydgregory

src/main/java/org/apache/commons/scxml2/NotificationRegistry.java

@@ -28,10 +28,10 @@
 
 /**
  * The registry where SCXML listeners are recorded for nodes of
- * interest such as the <code>SCXML</code> root,
- * <code>EnterableState</code>s and <code>Transition</code>s.
+ * interest such as the {@code SCXML} root,
+ * {@code EnterableState}s and {@code Transition}s.
  * The notification registry keeps track of all
- * <code>SCXMLListener</code>s attached and notifies relevant
+ * {@code SCXMLListener}s attached and notifies relevant
  * listeners of the events that interest them.
  */
 public final class NotificationRegistry {

src/main/java/org/apache/commons/scxml2/SCInstance.java

@@ -39,9 +39,9 @@
 import org.apache.commons.scxml2.semantics.ErrorConstants;
 
 /**
- * The <code>SCInstance</code> performs book-keeping functions for
+ * The {@code SCInstance} performs book-keeping functions for
  * a particular execution of a state chart represented by a
- * <code>SCXML</code> object.
+ * {@code SCXML} object.
  */
 public class SCInstance implements Serializable {
 

src/main/java/org/apache/commons/scxml2/SCXMLExecutionContext.java

@@ -285,7 +285,7 @@ public Map<Invoke, String> getInvokeIds() {
      * returned if and only if the {@link Invoke} parent TransitionalState is
      * currently active and contains the &lt;invoke&gt; child.
      *
-     * @param invoke The <code>Invoke</code>.
+     * @param invoke The {@code Invoke}.
      * @return The Invoker.
      */
     public Invoker getInvoker(final Invoke invoke) {

src/main/java/org/apache/commons/scxml2/SCXMLExecutor.java

@@ -39,7 +39,7 @@
  * encapsulated in the SCXMLSemantics implementation that it uses.</p>
  *
  * <p>The default implementation is
- * <code>org.apache.commons.scxml2.semantics.SCXMLSemanticsImpl</code></p>
+ * {@code org.apache.commons.scxml2.semantics.SCXMLSemanticsImpl}</p>
  *
  * <p>The executor uses SCXMLExecutionContext to manage the state and
  * provide all the services to the SCXMLSemantics implementation.</p>

src/main/java/org/apache/commons/scxml2/SCXMLSemantics.java

@@ -27,7 +27,7 @@
  * <p>The purpose of this interface is to separate the
  * <a href="https://www.w3.org/TR/2015/REC-scxml-20150901/#AlgorithmforSCXMLInterpretation">
  *     W3C SCXML Algorithm for SCXML Interpretation</a>
- * from the <code>SCXMLExecutor</code> and therefore make it pluggable.</p>
+ * from the {@code SCXMLExecutor} and therefore make it pluggable.</p>
  * <p>
  * From an SCXML execution POV, there are only four entry points needed into the Algorithm, namely:
  * </p>
@@ -66,7 +66,7 @@
  * </p>
  *
  * <p>Specific semantics can be created by subclassing
- * <code>org.apache.commons.scxml2.semantics.SCXMLSemanticsImpl</code>.</p>
+ * {@code org.apache.commons.scxml2.semantics.SCXMLSemanticsImpl}.</p>
  */
 public interface SCXMLSemantics {
 

src/main/java/org/apache/commons/scxml2/TriggerEvent.java

@@ -32,32 +32,32 @@ public class TriggerEvent implements Serializable {
     private static final long serialVersionUID = 1L;
 
     /**
-     * <code>CALL_EVENT</code>.
+     * {@code CALL_EVENT}.
      */
     public static final int CALL_EVENT = 1;
 
     /**
-     * <code>CHANGE_EVENT</code>.
+     * {@code CHANGE_EVENT}.
      */
     public static final int CHANGE_EVENT = 2;
 
     /**
-     * <code>SIGNAL_EVENT</code>.
+     * {@code SIGNAL_EVENT}.
      */
     public static final int SIGNAL_EVENT = 3;
 
     /**
-     * <code>TIME_EVENT</code>.
+     * {@code TIME_EVENT}.
      */
     public static final int TIME_EVENT = 4;
 
     /**
-     * <code>ERROR_EVENT</code>.
+     * {@code ERROR_EVENT}.
      */
     public static final int ERROR_EVENT = 5;
 
     /**
-     * <code>CANCEL_EVENT</code>.
+     * {@code CANCEL_EVENT}.
      */
     public static final int CANCEL_EVENT = 6;
 

src/main/java/org/apache/commons/scxml2/env/AbstractSCXMLListener.java

@@ -22,7 +22,7 @@
 import org.apache.commons.scxml2.model.TransitionTarget;
 
 /**
- * An abstract adapter class for the <code>SXCMLListener</code> interface.
+ * An abstract adapter class for the {@code SXCMLListener} interface.
  * This class exists as a convenience for creating listener objects, and as
  * such all the methods in this class are empty.
  *

src/main/java/org/apache/commons/scxml2/env/AbstractStateMachine.java

@@ -60,8 +60,8 @@
  * <p>This class swallows all exceptions only to log them. Developers of
  * subclasses should think of themselves as &quot;component developers&quot;
  * catering to other end users, and therefore ensure that the subclasses
- * are free of <code>ModelException</code>s and the like. Most methods
- * are <code>protected</code> for ease of subclassing.</p>
+ * are free of {@code ModelException}s and the like. Most methods
+ * are {@code protected} for ease of subclassing.</p>
  */
 public abstract class AbstractStateMachine {
 

src/main/java/org/apache/commons/scxml2/env/SimpleContext.java

@@ -94,7 +94,7 @@ public Object get(final String name) {
     }
 
     /**
-     * Gets the log used by this <code>Context</code> instance.
+     * Gets the log used by this {@code Context} instance.
      *
      * @return Log The log being used.
      */

src/main/java/org/apache/commons/scxml2/env/SimpleDispatcher.java

@@ -33,16 +33,16 @@
 import org.apache.commons.scxml2.model.ActionExecutionError;
 
 /**
- * <p>EventDispatcher implementation that can schedule <code>delay</code>ed
- * &lt;send&gt; events for the &quot;scxml&quot; <code>type</code>
+ * <p>EventDispatcher implementation that can schedule {@code delay}ed
+ * &lt;send&gt; events for the &quot;scxml&quot; {@code type}
  * attribute value (which is also the default). This implementation uses
- * J2SE <code>Timer</code>s.</p>
+ * J2SE {@code Timer}s.</p>
  *
- * <p>No other <code>type</code>s are processed. Subclasses may support
- * additional <code>type</code>s by overriding the
- * <code>send(...)</code> and <code>cancel(...)</code> methods and
- * delegating to their <code>super</code> counterparts for the
- * &quot;scxml&quot; <code>type</code>.</p>
+ * <p>No other {@code type}s are processed. Subclasses may support
+ * additional {@code type}s by overriding the
+ * {@code send(...)} and {@code cancel(...)} methods and
+ * delegating to their {@code super} counterparts for the
+ * &quot;scxml&quot; {@code type}.</p>
  */
 public class SimpleDispatcher implements EventDispatcher, Serializable {
 
@@ -100,8 +100,8 @@ public void run() {
      private static final Log log = LogFactory.getLog(EventDispatcher.class);
 
     /**
-     * The <code>Map</code> of active <code>Timer</code>s, keyed by
-     * &lt;send&gt; element <code>id</code>s.
+     * The {@code Map} of active {@code Timer}s, keyed by
+     * &lt;send&gt; element {@code id}s.
      */
     private final Map<String, Timer> timers = Collections.synchronizedMap(new HashMap<String, Timer>());