src/java.compiler/share/classes/javax/lang/model/util/ElementScanner14.java

*** 1,7 ****
  /*
!  * Copyright (c) 2019, 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) 2019, 2020, 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
*** 64,101 ****
   * methods will yield a preorder traversal, etc.  If the component
   * elements should be traversed in some other order, instead of
   * calling <code>super.visit<i>Xyz</i></code>, an overriding visit method
   * should call {@code scan} with the elements in the desired order.
   *
!  * <p> Methods in this class may be overridden subject to their
!  * general contract.  Note that annotating methods in concrete
!  * subclasses with {@link java.lang.Override @Override} will help
!  * ensure that methods are overridden as intended.
!  *
!  * <p> <b>WARNING:</b> The {@code ElementVisitor} interface
!  * implemented by this class may have methods added to it in the
!  * future to accommodate new, currently unknown, language structures
!  * added to future versions of the Java&trade; programming language.
!  * Therefore, methods whose names begin with {@code "visit"} may be
!  * added to this class in the future; to avoid incompatibilities,
!  * classes which extend this class should not declare any instance
!  * methods with names beginning with {@code "visit"}.
!  *
!  * <p>When such a new visit method is added, the default
!  * implementation in this class will be to call the {@link
!  * #visitUnknown visitUnknown} method.  A new element scanner visitor
!  * class will also be introduced to correspond to the new language
!  * level; this visitor will have different default behavior for the
!  * visit method in question.  When the new visitor is introduced, all
!  * or portions of this visitor may be deprecated.
   *
   * @param <R> the return type of this visitor's methods.  Use {@link
   *            Void} for visitors that do not need to return results.
   * @param <P> the type of the additional parameter to this visitor's
   *            methods.  Use {@code Void} for visitors that do not need an
   *            additional parameter.
   *
   * @see ElementScanner6
   * @see ElementScanner7
   * @see ElementScanner8
   * @see ElementScanner9
   * @since 14
--- 64,84 ----
   * methods will yield a preorder traversal, etc.  If the component
   * elements should be traversed in some other order, instead of
   * calling <code>super.visit<i>Xyz</i></code>, an overriding visit method
   * should call {@code scan} with the elements in the desired order.
   *
!  * @apiNote
!  * Methods in this class may be overridden subject to their
!  * general contract.
   *
   * @param <R> the return type of this visitor's methods.  Use {@link
   *            Void} for visitors that do not need to return results.
   * @param <P> the type of the additional parameter to this visitor's
   *            methods.  Use {@code Void} for visitors that do not need an
   *            additional parameter.
   *
+  * @see <a href="ElementScanner6.html#note_for_subclasses"><strong>Compatibility note for subclasses</strong></a>
   * @see ElementScanner6
   * @see ElementScanner7
   * @see ElementScanner8
   * @see ElementScanner9
   * @since 14