src/share/classes/javax/lang/model/util/SimpleElementVisitor8.java

*** 1,7 ****
  /*
!  * Copyright (c) 2011, 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) 2011, 2013, 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
*** 59,68 ****
--- 59,77 ----
   * 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.
   *
+  * <p>Note that adding a default implementation of a new visit method
+  * in a visitor class will occur instead of adding a <em>default
+  * method</em> directly in the visitor interface since a Java SE 8
+  * language feature cannot be used to this version of the API since
+  * this version is required to be runnable on Java SE 7
+  * implementations.  Future versions of the API that are only required
+  * to run on Java SE 8 and later may take advantage of default methods
+  * in this situation.
+  *
   * @param <R> the return type of this visitor's methods.  Use {@code 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.
   *