--- a/nashorn/src/jdk.dynalink/share/classes/jdk/dynalink/StandardOperation.java	Fri Apr 21 03:33:55 2017 +0000
+++ b/nashorn/src/jdk.dynalink/share/classes/jdk/dynalink/StandardOperation.java	Wed Apr 26 10:56:28 2017 -0700
@@ -95,8 +95,8 @@
     /**
      * Get the value from a namespace defined on an object. Call sites with this
      * operation should have a signature of
-     * <tt>(receiver,&nbsp;name)&rarr;value</tt> or
-     * <tt>(receiver)&rarr;value</tt> when used with {@link NamedOperation}, with
+     * <code>(receiver,&nbsp;name)&rarr;value</code> or
+     * <code>(receiver)&rarr;value</code> when used with {@link NamedOperation}, with
      * all parameters and return type being of any type (either primitive or
      * reference). This operation must always be used as part of a {@link NamespaceOperation}.
      */
@@ -104,21 +104,21 @@
     /**
      * Set the value in a namespace defined on an object. Call sites with this
      * operation should have a signature of
-     * <tt>(receiver,&nbsp;name,&nbsp;value)&rarr;void</tt> or
-     * <tt>(receiver,&nbsp;value)&rarr;void</tt> when used with {@link NamedOperation},
+     * <code>(receiver,&nbsp;name,&nbsp;value)&rarr;void</code> or
+     * <code>(receiver,&nbsp;value)&rarr;void</code> when used with {@link NamedOperation},
      * with all parameters and return type being of any type (either primitive
      * or reference). This operation must always be used as part of a {@link NamespaceOperation}.
      */
     SET,
     /**
      * Call a callable object. Call sites with this operation should have a
-     * signature of <tt>(callable,&nbsp;receiver,&nbsp;arguments...)&rarr;value</tt>,
+     * signature of <code>(callable,&nbsp;receiver,&nbsp;arguments...)&rarr;value</code>,
      * with all parameters and return type being of any type (either primitive or
      * reference). Typically, the callables are presumed to be methods of an object, so
      * an explicit receiver value is always passed to the callable before the arguments.
      * If a callable has no concept of a receiver, it is free to ignore the value of the
      * receiver argument.
-     * The <tt>CALL</tt> operation is allowed to be used with a
+     * The {@code CALL} operation is allowed to be used with a
      * {@link NamedOperation} even though it does not take a name. Using it with
      * a named operation won't affect its signature; the name is solely meant to
      * be used as a diagnostic description for error messages.
@@ -126,9 +126,9 @@
     CALL,
     /**
      * Call a constructor object. Call sites with this operation should have a
-     * signature of <tt>(constructor,&nbsp;arguments...)&rarr;value</tt>, with all
+     * signature of <code>(constructor,&nbsp;arguments...)&rarr;value</code>, with all
      * parameters and return type being of any type (either primitive or
-     * reference). The <tt>NEW</tt> operation is allowed to be used with a
+     * reference). The {@code NEW} operation is allowed to be used with a
      * {@link NamedOperation} even though it does not take a name. Using it with
      * a named operation won't affect its signature; the name is solely meant to
      * be used as a diagnostic description for error messages.

--- a/nashorn/src/jdk.dynalink/share/classes/jdk/dynalink/linker/GuardingTypeConverterFactory.java	Fri Apr 21 03:33:55 2017 +0000
+++ b/nashorn/src/jdk.dynalink/share/classes/jdk/dynalink/linker/GuardingTypeConverterFactory.java	Wed Apr 26 10:56:28 2017 -0700
@@ -108,8 +108,8 @@
      * language's objects to Java interfaces and classes by generating adapters
      * for them.
      * <p>
-     * The type of the invocation is <tt>(sourceType)&rarr;targetType</tt>, while the
-     * type of the guard is <tt>(sourceType)&rarr;boolean</tt>. You are allowed to
+     * The type of the invocation is <code>(sourceType)&rarr;targetType</code>, while the
+     * type of the guard is <code>(sourceType)&rarr;boolean</code>. You are allowed to
      * return unconditional invocations (with no guard) if the source type is
      * specific to your runtime and your runtime only.
      * <p>Note that this method will never be invoked for

--- a/nashorn/src/jdk.scripting.nashorn/share/classes/jdk/nashorn/api/tree/TreeVisitor.java	Fri Apr 21 03:33:55 2017 +0000
+++ b/nashorn/src/jdk.scripting.nashorn/share/classes/jdk/nashorn/api/tree/TreeVisitor.java	Wed Apr 26 10:56:28 2017 -0700
@@ -30,7 +30,7 @@
  * Classes implementing this interface are used to operate
  * on a tree when the kind of tree is unknown at compile time.
  * When a visitor is passed to an tree's {@link Tree#accept
- * accept} method, the <tt>visit<i>XYZ</i></tt> method most applicable
+ * accept} method, the <code>visit<i>Xyz</i></code> method most applicable
  * to that tree is invoked.
  *
  * <p> Classes implementing this interface may or may not throw a