--- old/src/java.base/share/classes/java/util/RandomAccess.java 2015-08-07 21:15:17.542584089 +0400 +++ new/src/java.base/share/classes/java/util/RandomAccess.java 2015-08-07 21:15:17.338584098 +0400 @@ -26,27 +26,27 @@ package java.util; /** - * Marker interface used by List implementations to indicate that + * Marker interface used by {@code List} implementations to indicate that * they support fast (generally constant time) random access. The primary * purpose of this interface is to allow generic algorithms to alter their * behavior to provide good performance when applied to either random or * sequential access lists. * *

The best algorithms for manipulating random access lists (such as - * ArrayList) can produce quadratic behavior when applied to - * sequential access lists (such as LinkedList). Generic list + * {@code ArrayList}) can produce quadratic behavior when applied to + * sequential access lists (such as {@code LinkedList}). Generic list * algorithms are encouraged to check whether the given list is an - * instanceof this interface before applying an algorithm that would + * {@code instanceof} this interface before applying an algorithm that would * provide poor performance if it were applied to a sequential access list, * and to alter their behavior if necessary to guarantee acceptable * performance. * *

It is recognized that the distinction between random and sequential - * access is often fuzzy. For example, some List implementations + * access is often fuzzy. For example, some {@code List} implementations * provide asymptotically linear access times if they get huge, but constant - * access times in practice. Such a List implementation + * access times in practice. Such a {@code List} implementation * should generally implement this interface. As a rule of thumb, a - * List implementation should implement this interface if, + * {@code List} implementation should implement this interface if, * for typical instances of the class, this loop: *

  *     for (int i=0, n=list.size(); i < n; i++)