src/jdk.xml.bind/share/classes/com/sun/xml/internal/xsom/parser/AnnotationParser.java

*** 1,7 ****
  /*
!  * Copyright (c) 1997, 2012, Oracle and/or its affiliates. All rights reserved.
   * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
   *
   * This code is free software; you can redistribute it and/or modify it
   * under the terms of the GNU General Public License version 2 only, as
   * published by the Free Software Foundation.  Oracle designates this
--- 1,7 ----
  /*
!  * Copyright (c) 1997, 2015, Oracle and/or its affiliates. All rights reserved.
   * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
   *
   * This code is free software; you can redistribute it and/or modify it
   * under the terms of the GNU General Public License version 2 only, as
   * published by the Free Software Foundation.  Oracle designates this
*** 28,54 ****
  import org.xml.sax.ContentHandler;
  import org.xml.sax.EntityResolver;
  import org.xml.sax.ErrorHandler;
  
  /**
!  * Used to parse <xs:annotation>.
   *
   * @author Kohsuke Kawaguchi (kohsuke.kawaguchi@sun.com)
   */
  public abstract class AnnotationParser {
      /**
!      * Called every time a new <xs:annotation> element
       * is found.
       *
!      * The sub-tree rooted at <xs:annotation> will be
       * sent to this ContentHandler as if it is a whole document.
       *
       * @param context
       *      indicates the schema component that owns this annotation.
       *      Always non-null.
       * @param parentElementName
!      *      local name of the element that contains <xs:annotation>.
       *      (e.g., "element", "attribute", ... )
       * @param errorHandler
       *      The error handler that the client application specifies.
       *      The returned content handler can send its errors to this
       *      object.
--- 28,54 ----
  import org.xml.sax.ContentHandler;
  import org.xml.sax.EntityResolver;
  import org.xml.sax.ErrorHandler;
  
  /**
!  * Used to parse {@code <xs:annotation>}.
   *
   * @author Kohsuke Kawaguchi (kohsuke.kawaguchi@sun.com)
   */
  public abstract class AnnotationParser {
      /**
!      * Called every time a new {@code <xs:annotation>} element
       * is found.
       *
!      * The sub-tree rooted at {@code <xs:annotation>} will be
       * sent to this ContentHandler as if it is a whole document.
       *
       * @param context
       *      indicates the schema component that owns this annotation.
       *      Always non-null.
       * @param parentElementName
!      *      local name of the element that contains {@code <xs:annotation>}.
       *      (e.g., "element", "attribute", ... )
       * @param errorHandler
       *      The error handler that the client application specifies.
       *      The returned content handler can send its errors to this
       *      object.
*** 68,78 ****
       * this method will be called to retrieve the parsed result.
       *
       * @param existing
       *      An annotation object which was returned from another
       *      AnnotationParser before. Sometimes, one schema component
!      *      can have multiple &lt:xs:annotation> elements and
       *      this parameter is used to merge all those annotations
       *      together. If there is no existing object, null will be
       *      passed.
       * @return
       *      Any object, including null.
--- 68,78 ----
       * this method will be called to retrieve the parsed result.
       *
       * @param existing
       *      An annotation object which was returned from another
       *      AnnotationParser before. Sometimes, one schema component
!      *      can have multiple {@code <xs:annotation>} elements and
       *      this parameter is used to merge all those annotations
       *      together. If there is no existing object, null will be
       *      passed.
       * @return
       *      Any object, including null.