--- old/src/java.compiler/share/classes/javax/lang/model/element/TypeElement.java	2017-01-31 00:24:32.454851879 -0800
+++ new/src/java.compiler/share/classes/javax/lang/model/element/TypeElement.java	2017-01-31 00:24:32.358851876 -0800
@@ -67,14 +67,14 @@
      * the implicit {@code values} and {@code valueOf} methods of an
      * enum type.
      *
-     * <p> Note that as a particular instance of the {@linkplain
+     * @apiNote As a particular instance of the {@linkplain
      * javax.lang.model.element general accuracy requirements} and the
      * ordering behavior required of this interface, the list of
      * enclosed elements will be returned in the natural order for the
      * originating source of information about the type.  For example,
      * if the information about the type is originating from a source
      * file, the elements will be returned in source code order.
-     * (However, in that case the the ordering of synthesized
+     * (However, in that case the the ordering of {@linkplain Elements.Origin#MANDATED mandated}
      * elements, such as a default constructor, is not specified.)
      *
      * @return the enclosed elements in proper order, or an empty list if none