src/java.xml.bind/share/classes/com/sun/xml/internal/bind/v2/runtime/IllegalAnnotationException.java

*** 117,140 ****
       * <p>
       * Normally, an annotation error happens on one particular
       * annotation, in which case this method returns a list that
       * contains another list, which in turn contains the location
       * information that leads to the error location
!      * (IOW, <tt>[ [pos1,pos2,...,posN] ]</tt>)
       *
       * <p>
       * Sometimes, an error could occur because of two or more conflicting
       * annotations, in which case this method returns a list
       * that contains many lists, where each list contains
       * the location information that leads to each of the conflicting
       * annotations
!      * (IOW, <tt>[ [pos11,pos12,...,pos1N],[pos21,pos22,...,pos2M], ... ]</tt>)
       *
       * <p>
       * Yet some other time, the runtime can fail to provide any
       * error location, in which case this method returns an empty list.
!      * (IOW, <tt>[]</tt>). We do try hard to make sure this won't happen,
       * so please <a href="http://jaxb.dev.java.net/">let us know</a>
       * if you see this behavior.
       *
       *
       * <h3>List of {@link Location}</h3>
--- 117,140 ----
       * <p>
       * Normally, an annotation error happens on one particular
       * annotation, in which case this method returns a list that
       * contains another list, which in turn contains the location
       * information that leads to the error location
!      * (IOW, {@code [ [pos1,pos2,...,posN] ]})
       *
       * <p>
       * Sometimes, an error could occur because of two or more conflicting
       * annotations, in which case this method returns a list
       * that contains many lists, where each list contains
       * the location information that leads to each of the conflicting
       * annotations
!      * (IOW, {@code [ [pos11,pos12,...,pos1N],[pos21,pos22,...,pos2M], ... ]})
       *
       * <p>
       * Yet some other time, the runtime can fail to provide any
       * error location, in which case this method returns an empty list.
!      * (IOW, {@code []}). We do try hard to make sure this won't happen,
       * so please <a href="http://jaxb.dev.java.net/">let us know</a>
       * if you see this behavior.
       *
       *
       * <h3>List of {@link Location}</h3>
*** 144,160 ****
       * the runtime is led to the place of the error.
       * This list is sorted such that the most specific {@link Location} comes
       * to the first in the list, sort of like a stack trace.
       *
       * <p>
!      * For example, suppose you specify class <tt>Foo</tt> to {@link JAXBContext},
!      * <tt>Foo</tt> derives from <tt>Bar</tt>, <tt>Bar</tt> has a field <tt>pea</tt>
!      * that points to <tt>Zot</tt>, <tt>Zot</tt> contains a <tt>gum</tt>
       * property, and this property has an errornous annotation.
       * Then when this exception is thrown, the list of {@link Location}s
       * will look something like
!      * <tt>[ "gum property", "Zot class", "pea property", "Bar class", "Foo class" ]</tt>
       *
       *
       * @return
       *      can be empty when no source position is available,
       *      but never null. The returned list will never contain
--- 144,160 ----
       * the runtime is led to the place of the error.
       * This list is sorted such that the most specific {@link Location} comes
       * to the first in the list, sort of like a stack trace.
       *
       * <p>
!      * For example, suppose you specify class {@code Foo} to {@link JAXBContext},
!      * {@code Foo} derives from {@code Bar}, {@code Bar} has a field {@code pea}
!      * that points to {@code Zot}, {@code Zot} contains a {@code gum}
       * property, and this property has an errornous annotation.
       * Then when this exception is thrown, the list of {@link Location}s
       * will look something like
!      * {@code [ "gum property", "Zot class", "pea property", "Bar class", "Foo class" ]}
       *
       *
       * @return
       *      can be empty when no source position is available,
       *      but never null. The returned list will never contain