OpenJDK / bsd-port / jdk9 / langtools
changeset 3885:b6960e2da008
8172531: Correct misstatements in javax.lang.model visitor documentation
Reviewed-by: jjg
line wrap: on
line diff
--- a/src/java.compiler/share/classes/javax/lang/model/element/AnnotationValueVisitor.java Fri Jan 13 18:29:21 2017 -0800 +++ b/src/java.compiler/share/classes/javax/lang/model/element/AnnotationValueVisitor.java Fri Jan 13 19:29:55 2017 -0800 @@ -1,5 +1,5 @@ /* - * Copyright (c) 2005, 2013, Oracle and/or its affiliates. All rights reserved. + * Copyright (c) 2005, 2017, 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 @@ -41,7 +41,7 @@ * implementing this interface are used to operate on a value when the * type of that value is unknown at compile time. When a visitor is * passed to a value's {@link AnnotationValue#accept accept} method, - * the <code>visit<i>XYZ</i></code> method applicable to that value is + * the <code>visit<i>Xyz</i></code> method applicable to that value is * invoked. * * <p> Classes implementing this interface may or may not throw a @@ -65,9 +65,9 @@ * be added in a source <em>compatible</em> way if they were added as * <em>default methods</em>. However, default methods are only * available on Java SE 8 and higher releases and the {@code - * javax.lang.model.*} packages bundled in Java SE 8 are required to + * javax.lang.model.*} packages bundled in Java SE 8 were required to * also be runnable on Java SE 7. Therefore, default methods - * <em>cannot</em> be used when extending {@code javax.lang.model.*} + * were <em>not</em> used when extending {@code javax.lang.model.*} * to cover Java SE 8 language features. However, default methods may * be used in subsequent revisions of the {@code javax.lang.model.*} * packages that are only required to run on Java SE 8 and higher
--- a/src/java.compiler/share/classes/javax/lang/model/element/ElementVisitor.java Fri Jan 13 18:29:21 2017 -0800 +++ b/src/java.compiler/share/classes/javax/lang/model/element/ElementVisitor.java Fri Jan 13 19:29:55 2017 -0800 @@ -1,5 +1,5 @@ /* - * Copyright (c) 2005, 2015, Oracle and/or its affiliates. All rights reserved. + * Copyright (c) 2005, 2017, 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 @@ -32,7 +32,7 @@ * pattern. Classes implementing this interface are used to operate * on an element when the kind of element is unknown at compile time. * When a visitor is passed to an element's {@link Element#accept - * accept} method, the <code>visit<i>XYZ</i></code> method most applicable + * accept} method, the <code>visit<i>Xyz</i></code> method most applicable * to that element is invoked. * * <p> Classes implementing this interface may or may not throw a @@ -56,9 +56,9 @@ * be added in a source <em>compatible</em> way if they were added as * <em>default methods</em>. However, default methods are only * available on Java SE 8 and higher releases and the {@code - * javax.lang.model.*} packages bundled in Java SE 8 are required to + * javax.lang.model.*} packages bundled in Java SE 8 were required to * also be runnable on Java SE 7. Therefore, default methods - * <em>cannot</em> be used when extending {@code javax.lang.model.*} + * were <em>not</em> used when extending {@code javax.lang.model.*} * to cover Java SE 8 language features. However, default methods may * be used in subsequent revisions of the {@code javax.lang.model.*} * packages that are only required to run on Java SE 8 and higher
--- a/src/java.compiler/share/classes/javax/lang/model/type/TypeVisitor.java Fri Jan 13 18:29:21 2017 -0800 +++ b/src/java.compiler/share/classes/javax/lang/model/type/TypeVisitor.java Fri Jan 13 19:29:55 2017 -0800 @@ -1,5 +1,5 @@ /* - * Copyright (c) 2005, 2013, Oracle and/or its affiliates. All rights reserved. + * Copyright (c) 2005, 2017, 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 @@ -32,7 +32,7 @@ * visitor design pattern. Classes implementing this * interface are used to operate on a type when the kind of * type is unknown at compile time. When a visitor is passed to a - * type's {@link TypeMirror#accept accept} method, the <code>visit<i>XYZ</i></code> + * type's {@link TypeMirror#accept accept} method, the <code>visit<i>Xyz</i></code> * method most applicable to that type is invoked. * * <p> Classes implementing this interface may or may not throw a @@ -56,9 +56,9 @@ * be added in a source <em>compatible</em> way if they were added as * <em>default methods</em>. However, default methods are only * available on Java SE 8 and higher releases and the {@code - * javax.lang.model.*} packages bundled in Java SE 8 are required to + * javax.lang.model.*} packages bundled in Java SE 8 were required to * also be runnable on Java SE 7. Therefore, default methods - * <em>cannot</em> be used when extending {@code javax.lang.model.*} + * were <em>not</em> used when extending {@code javax.lang.model.*} * to cover Java SE 8 language features. However, default methods may * be used in subsequent revisions of the {@code javax.lang.model.*} * packages that are only required to run on Java SE 8 and higher
--- a/src/java.compiler/share/classes/javax/lang/model/util/AbstractAnnotationValueVisitor6.java Fri Jan 13 18:29:21 2017 -0800 +++ b/src/java.compiler/share/classes/javax/lang/model/util/AbstractAnnotationValueVisitor6.java Fri Jan 13 19:29:55 2017 -0800 @@ -1,5 +1,5 @@ /* - * Copyright (c) 2005, 2014, Oracle and/or its affiliates. All rights reserved. + * Copyright (c) 2005, 2017, 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 @@ -54,15 +54,6 @@ * 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 * @param <P> the type of the additional parameter to this visitor's methods. *
--- a/src/java.compiler/share/classes/javax/lang/model/util/AbstractAnnotationValueVisitor7.java Fri Jan 13 18:29:21 2017 -0800 +++ b/src/java.compiler/share/classes/javax/lang/model/util/AbstractAnnotationValueVisitor7.java Fri Jan 13 19:29:55 2017 -0800 @@ -1,5 +1,5 @@ /* - * Copyright (c) 2010, 2014, Oracle and/or its affiliates. All rights reserved. + * Copyright (c) 2010, 2017, 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 @@ -51,15 +51,6 @@ * 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 * @param <P> the type of the additional parameter to this visitor's methods. *
--- a/src/java.compiler/share/classes/javax/lang/model/util/AbstractAnnotationValueVisitor8.java Fri Jan 13 18:29:21 2017 -0800 +++ b/src/java.compiler/share/classes/javax/lang/model/util/AbstractAnnotationValueVisitor8.java Fri Jan 13 19:29:55 2017 -0800 @@ -1,5 +1,5 @@ /* - * Copyright (c) 2011, 2014, Oracle and/or its affiliates. All rights reserved. + * Copyright (c) 2011, 2017, 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 @@ -51,15 +51,6 @@ * 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 * @param <P> the type of the additional parameter to this visitor's methods. *
--- a/src/java.compiler/share/classes/javax/lang/model/util/AbstractElementVisitor6.java Fri Jan 13 18:29:21 2017 -0800 +++ b/src/java.compiler/share/classes/javax/lang/model/util/AbstractElementVisitor6.java Fri Jan 13 19:29:55 2017 -0800 @@ -1,5 +1,5 @@ /* - * Copyright (c) 2005, 2015, Oracle and/or its affiliates. All rights reserved. + * Copyright (c) 2005, 2017, 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 @@ -53,15 +53,6 @@ * 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 {@link * Void} for visitors that do not need to return results. * @param <P> the type of the additional parameter to this visitor's
--- a/src/java.compiler/share/classes/javax/lang/model/util/AbstractElementVisitor7.java Fri Jan 13 18:29:21 2017 -0800 +++ b/src/java.compiler/share/classes/javax/lang/model/util/AbstractElementVisitor7.java Fri Jan 13 19:29:55 2017 -0800 @@ -1,5 +1,5 @@ /* - * Copyright (c) 2010, 2014, Oracle and/or its affiliates. All rights reserved. + * Copyright (c) 2010, 2017, 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 @@ -52,15 +52,6 @@ * 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 {@link * Void} for visitors that do not need to return results. * @param <P> the type of the additional parameter to this visitor's
--- a/src/java.compiler/share/classes/javax/lang/model/util/AbstractElementVisitor8.java Fri Jan 13 18:29:21 2017 -0800 +++ b/src/java.compiler/share/classes/javax/lang/model/util/AbstractElementVisitor8.java Fri Jan 13 19:29:55 2017 -0800 @@ -1,5 +1,5 @@ /* - * Copyright (c) 2011, 2014, Oracle and/or its affiliates. All rights reserved. + * Copyright (c) 2011, 2017, 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 @@ -52,15 +52,6 @@ * 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 {@link * Void} for visitors that do not need to return results. * @param <P> the type of the additional parameter to this visitor's
--- a/src/java.compiler/share/classes/javax/lang/model/util/AbstractTypeVisitor6.java Fri Jan 13 18:29:21 2017 -0800 +++ b/src/java.compiler/share/classes/javax/lang/model/util/AbstractTypeVisitor6.java Fri Jan 13 19:29:55 2017 -0800 @@ -1,5 +1,5 @@ /* - * Copyright (c) 2005, 2014, Oracle and/or its affiliates. All rights reserved. + * Copyright (c) 2005, 2017, 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 @@ -52,15 +52,6 @@ * 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 {@link * Void} for visitors that do not need to return results. * @param <P> the type of the additional parameter to this visitor's
--- a/src/java.compiler/share/classes/javax/lang/model/util/AbstractTypeVisitor7.java Fri Jan 13 18:29:21 2017 -0800 +++ b/src/java.compiler/share/classes/javax/lang/model/util/AbstractTypeVisitor7.java Fri Jan 13 19:29:55 2017 -0800 @@ -1,5 +1,5 @@ /* - * Copyright (c) 2010, 2014, Oracle and/or its affiliates. All rights reserved. + * Copyright (c) 2010, 2017, 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 @@ -52,15 +52,6 @@ * 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 {@link * Void} for visitors that do not need to return results. * @param <P> the type of the additional parameter to this visitor's
--- a/src/java.compiler/share/classes/javax/lang/model/util/AbstractTypeVisitor8.java Fri Jan 13 18:29:21 2017 -0800 +++ b/src/java.compiler/share/classes/javax/lang/model/util/AbstractTypeVisitor8.java Fri Jan 13 19:29:55 2017 -0800 @@ -1,5 +1,5 @@ /* - * Copyright (c) 2011, 2014, Oracle and/or its affiliates. All rights reserved. + * Copyright (c) 2011, 2017, 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 @@ -52,15 +52,6 @@ * 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 {@link * Void} for visitors that do not need to return results. * @param <P> the type of the additional parameter to this visitor's
--- a/src/java.compiler/share/classes/javax/lang/model/util/ElementKindVisitor6.java Fri Jan 13 18:29:21 2017 -0800 +++ b/src/java.compiler/share/classes/javax/lang/model/util/ElementKindVisitor6.java Fri Jan 13 19:29:55 2017 -0800 @@ -1,5 +1,5 @@ /* - * Copyright (c) 2005, 2014, Oracle and/or its affiliates. All rights reserved. + * Copyright (c) 2005, 2017, 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 @@ -36,10 +36,10 @@ * A visitor of program elements based on their {@linkplain * ElementKind kind} with default behavior appropriate for the {@link * SourceVersion#RELEASE_6 RELEASE_6} source version. For {@linkplain - * Element elements} <code><i>XYZ</i></code> that may have more than one - * kind, the <code>visit<i>XYZ</i></code> methods in this class delegate - * to the <code>visit<i>XYZKind</i></code> method corresponding to the - * first argument's kind. The <code>visit<i>XYZKind</i></code> methods + * Element elements} <code><i>Xyz</i></code> that may have more than one + * kind, the <code>visit<i>Xyz</i></code> methods in this class delegate + * to the <code>visit<i>Xyz</i>As<i>Kind</i></code> method corresponding to the + * first argument's kind. The <code>visit<i>Xyz</i>As<i>Kind</i></code> methods * call {@link #defaultAction defaultAction}, passing their arguments * to {@code defaultAction}'s corresponding parameters. * @@ -67,15 +67,6 @@ * 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 {@link * Void} for visitors that do not need to return results. * @param <P> the type of the additional parameter to this visitor's
--- a/src/java.compiler/share/classes/javax/lang/model/util/ElementKindVisitor7.java Fri Jan 13 18:29:21 2017 -0800 +++ b/src/java.compiler/share/classes/javax/lang/model/util/ElementKindVisitor7.java Fri Jan 13 19:29:55 2017 -0800 @@ -1,5 +1,5 @@ /* - * Copyright (c) 2010, 2014, Oracle and/or its affiliates. All rights reserved. + * Copyright (c) 2010, 2017, 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 @@ -34,10 +34,10 @@ * A visitor of program elements based on their {@linkplain * ElementKind kind} with default behavior appropriate for the {@link * SourceVersion#RELEASE_7 RELEASE_7} source version. For {@linkplain - * Element elements} <code><i>XYZ</i></code> that may have more than one - * kind, the <code>visit<i>XYZ</i></code> methods in this class delegate - * to the <code>visit<i>XYZKind</i></code> method corresponding to the - * first argument's kind. The <code>visit<i>XYZKind</i></code> methods + * Element elements} <code><i>Xyz</i></code> that may have more than one + * kind, the <code>visit<i>Xyz</i></code> methods in this class delegate + * to the <code>visit<i>Xyz</i>As<i>Kind</i></code> method corresponding to the + * first argument's kind. The <code>visit<i>Xyz</i>As<i>Kind</i></code> methods * call {@link #defaultAction defaultAction}, passing their arguments * to {@code defaultAction}'s corresponding parameters. * @@ -65,15 +65,6 @@ * 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 {@link * Void} for visitors that do not need to return results. * @param <P> the type of the additional parameter to this visitor's
--- a/src/java.compiler/share/classes/javax/lang/model/util/ElementKindVisitor8.java Fri Jan 13 18:29:21 2017 -0800 +++ b/src/java.compiler/share/classes/javax/lang/model/util/ElementKindVisitor8.java Fri Jan 13 19:29:55 2017 -0800 @@ -1,5 +1,5 @@ /* - * Copyright (c) 2011, 2014, Oracle and/or its affiliates. All rights reserved. + * Copyright (c) 2011, 2017, 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 @@ -34,10 +34,10 @@ * A visitor of program elements based on their {@linkplain * ElementKind kind} with default behavior appropriate for the {@link * SourceVersion#RELEASE_8 RELEASE_8} source version. For {@linkplain - * Element elements} <code><i>XYZ</i></code> that may have more than one - * kind, the <code>visit<i>XYZ</i></code> methods in this class delegate - * to the <code>visit<i>XYZKind</i></code> method corresponding to the - * first argument's kind. The <code>visit<i>XYZKind</i></code> methods + * Element elements} <code><i>Xyz</i></code> that may have more than one + * kind, the <code>visit<i>Xyz</i></code> methods in this class delegate + * to the <code>visit<i>Xyz</i>As<i>Kind</i></code> method corresponding to the + * first argument's kind. The <code>visit<i>Xyz</i>As<i>Kind</i></code> methods * call {@link #defaultAction defaultAction}, passing their arguments * to {@code defaultAction}'s corresponding parameters. * @@ -65,15 +65,6 @@ * 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 {@link * Void} for visitors that do not need to return results. * @param <P> the type of the additional parameter to this visitor's
--- a/src/java.compiler/share/classes/javax/lang/model/util/ElementKindVisitor9.java Fri Jan 13 18:29:21 2017 -0800 +++ b/src/java.compiler/share/classes/javax/lang/model/util/ElementKindVisitor9.java Fri Jan 13 19:29:55 2017 -0800 @@ -1,5 +1,5 @@ /* - * Copyright (c) 2011, 2015, Oracle and/or its affiliates. All rights reserved. + * Copyright (c) 2011, 2017, 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 @@ -34,10 +34,10 @@ * A visitor of program elements based on their {@linkplain * ElementKind kind} with default behavior appropriate for the {@link * SourceVersion#RELEASE_9 RELEASE_9} source version. For {@linkplain - * Element elements} <code><i>XYZ</i></code> that may have more than one - * kind, the <code>visit<i>XYZ</i></code> methods in this class delegate - * to the <code>visit<i>XYZKind</i></code> method corresponding to the - * first argument's kind. The <code>visit<i>XYZKind</i></code> methods + * Element elements} <code><i>Xyz</i></code> that may have more than one + * kind, the <code>visit<i>Xyz</i></code> methods in this class delegate + * to the <code>visit<i>Xyz</i>As<i>Kind</i></code> method corresponding to the + * first argument's kind. The <code>visit<i>Xyz</i>As<i>Kind</i></code> methods * call {@link #defaultAction defaultAction}, passing their arguments * to {@code defaultAction}'s corresponding parameters. *
--- a/src/java.compiler/share/classes/javax/lang/model/util/ElementScanner6.java Fri Jan 13 18:29:21 2017 -0800 +++ b/src/java.compiler/share/classes/javax/lang/model/util/ElementScanner6.java Fri Jan 13 19:29:55 2017 -0800 @@ -1,5 +1,5 @@ /* - * Copyright (c) 2005, 2014, Oracle and/or its affiliates. All rights reserved. + * Copyright (c) 2005, 2017, 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 @@ -34,26 +34,26 @@ /** * A scanning visitor of program elements with default behavior * appropriate for the {@link SourceVersion#RELEASE_6 RELEASE_6} - * source version. The <code>visit<i>XYZ</i></code> methods in this + * source version. The <code>visit<i>Xyz</i></code> methods in this * class scan their component elements by calling {@code scan} on * their {@linkplain Element#getEnclosedElements enclosed elements}, * {@linkplain ExecutableElement#getParameters parameters}, etc., as * indicated in the individual method specifications. A subclass can * control the order elements are visited by overriding the - * <code>visit<i>XYZ</i></code> methods. Note that clients of a scanner + * <code>visit<i>Xyz</i></code> methods. Note that clients of a scanner * may get the desired behavior be invoking {@code v.scan(e, p)} rather * than {@code v.visit(e, p)} on the root objects of interest. * - * <p>When a subclass overrides a <code>visit<i>XYZ</i></code> method, the + * <p>When a subclass overrides a <code>visit<i>Xyz</i></code> method, the * new method can cause the enclosed elements to be scanned in the - * default way by calling <code>super.visit<i>XYZ</i></code>. In this + * default way by calling <code>super.visit<i>Xyz</i></code>. In this * fashion, the concrete visitor can control the ordering of traversal * over the component elements with respect to the additional * processing; for example, consistently calling - * <code>super.visit<i>XYZ</i></code> at the start of the overridden + * <code>super.visit<i>Xyz</i></code> at the start of the overridden * 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 + * 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
--- a/src/java.compiler/share/classes/javax/lang/model/util/ElementScanner7.java Fri Jan 13 18:29:21 2017 -0800 +++ b/src/java.compiler/share/classes/javax/lang/model/util/ElementScanner7.java Fri Jan 13 19:29:55 2017 -0800 @@ -1,5 +1,5 @@ /* - * Copyright (c) 2010, 2014, Oracle and/or its affiliates. All rights reserved. + * Copyright (c) 2010, 2017, 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 @@ -34,26 +34,26 @@ /** * A scanning visitor of program elements with default behavior * appropriate for the {@link SourceVersion#RELEASE_7 RELEASE_7} - * source version. The <code>visit<i>XYZ</i></code> methods in this + * source version. The <code>visit<i>Xyz</i></code> methods in this * class scan their component elements by calling {@code scan} on * their {@linkplain Element#getEnclosedElements enclosed elements}, * {@linkplain ExecutableElement#getParameters parameters}, etc., as * indicated in the individual method specifications. A subclass can * control the order elements are visited by overriding the - * <code>visit<i>XYZ</i></code> methods. Note that clients of a scanner + * <code>visit<i>Xyz</i></code> methods. Note that clients of a scanner * may get the desired behavior be invoking {@code v.scan(e, p)} rather * than {@code v.visit(e, p)} on the root objects of interest. * - * <p>When a subclass overrides a <code>visit<i>XYZ</i></code> method, the + * <p>When a subclass overrides a <code>visit<i>Xyz</i></code> method, the * new method can cause the enclosed elements to be scanned in the - * default way by calling <code>super.visit<i>XYZ</i></code>. In this + * default way by calling <code>super.visit<i>Xyz</i></code>. In this * fashion, the concrete visitor can control the ordering of traversal * over the component elements with respect to the additional * processing; for example, consistently calling - * <code>super.visit<i>XYZ</i></code> at the start of the overridden + * <code>super.visit<i>Xyz</i></code> at the start of the overridden * 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 + * 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
--- a/src/java.compiler/share/classes/javax/lang/model/util/ElementScanner8.java Fri Jan 13 18:29:21 2017 -0800 +++ b/src/java.compiler/share/classes/javax/lang/model/util/ElementScanner8.java Fri Jan 13 19:29:55 2017 -0800 @@ -1,5 +1,5 @@ /* - * Copyright (c) 2011, 2014, Oracle and/or its affiliates. All rights reserved. + * Copyright (c) 2011, 2017, 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 @@ -34,26 +34,26 @@ /** * A scanning visitor of program elements with default behavior * appropriate for the {@link SourceVersion#RELEASE_8 RELEASE_8} - * source version. The <code>visit<i>XYZ</i></code> methods in this + * source version. The <code>visit<i>Xyz</i></code> methods in this * class scan their component elements by calling {@code scan} on * their {@linkplain Element#getEnclosedElements enclosed elements}, * {@linkplain ExecutableElement#getParameters parameters}, etc., as * indicated in the individual method specifications. A subclass can * control the order elements are visited by overriding the - * <code>visit<i>XYZ</i></code> methods. Note that clients of a scanner + * <code>visit<i>Xyz</i></code> methods. Note that clients of a scanner * may get the desired behavior be invoking {@code v.scan(e, p)} rather * than {@code v.visit(e, p)} on the root objects of interest. * - * <p>When a subclass overrides a <code>visit<i>XYZ</i></code> method, the + * <p>When a subclass overrides a <code>visit<i>Xyz</i></code> method, the * new method can cause the enclosed elements to be scanned in the - * default way by calling <code>super.visit<i>XYZ</i></code>. In this + * default way by calling <code>super.visit<i>Xyz</i></code>. In this * fashion, the concrete visitor can control the ordering of traversal * over the component elements with respect to the additional * processing; for example, consistently calling - * <code>super.visit<i>XYZ</i></code> at the start of the overridden + * <code>super.visit<i>Xyz</i></code> at the start of the overridden * 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 + * 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
--- a/src/java.compiler/share/classes/javax/lang/model/util/ElementScanner9.java Fri Jan 13 18:29:21 2017 -0800 +++ b/src/java.compiler/share/classes/javax/lang/model/util/ElementScanner9.java Fri Jan 13 19:29:55 2017 -0800 @@ -1,5 +1,5 @@ /* - * Copyright (c) 2011, 2015, Oracle and/or its affiliates. All rights reserved. + * Copyright (c) 2011, 2017, 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 @@ -34,26 +34,26 @@ /** * A scanning visitor of program elements with default behavior * appropriate for the {@link SourceVersion#RELEASE_9 RELEASE_9} - * source version. The <code>visit<i>XYZ</i></code> methods in this + * source version. The <code>visit<i>Xyz</i></code> methods in this * class scan their component elements by calling {@code scan} on * their {@linkplain Element#getEnclosedElements enclosed elements}, * {@linkplain ExecutableElement#getParameters parameters}, etc., as * indicated in the individual method specifications. A subclass can * control the order elements are visited by overriding the - * <code>visit<i>XYZ</i></code> methods. Note that clients of a scanner + * <code>visit<i>Xyz</i></code> methods. Note that clients of a scanner * may get the desired behavior be invoking {@code v.scan(e, p)} rather * than {@code v.visit(e, p)} on the root objects of interest. * - * <p>When a subclass overrides a <code>visit<i>XYZ</i></code> method, the + * <p>When a subclass overrides a <code>visit<i>Xyz</i></code> method, the * new method can cause the enclosed elements to be scanned in the - * default way by calling <code>super.visit<i>XYZ</i></code>. In this + * default way by calling <code>super.visit<i>Xyz</i></code>. In this * fashion, the concrete visitor can control the ordering of traversal * over the component elements with respect to the additional * processing; for example, consistently calling - * <code>super.visit<i>XYZ</i></code> at the start of the overridden + * <code>super.visit<i>Xyz</i></code> at the start of the overridden * 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 + * 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
--- a/src/java.compiler/share/classes/javax/lang/model/util/SimpleAnnotationValueVisitor6.java Fri Jan 13 18:29:21 2017 -0800 +++ b/src/java.compiler/share/classes/javax/lang/model/util/SimpleAnnotationValueVisitor6.java Fri Jan 13 19:29:55 2017 -0800 @@ -1,5 +1,5 @@ /* - * Copyright (c) 2005, 2014, Oracle and/or its affiliates. All rights reserved. + * Copyright (c) 2005, 2017, 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 @@ -63,15 +63,6 @@ * 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 * @param <P> the type of the additional parameter to this visitor's methods. *
--- a/src/java.compiler/share/classes/javax/lang/model/util/SimpleAnnotationValueVisitor7.java Fri Jan 13 18:29:21 2017 -0800 +++ b/src/java.compiler/share/classes/javax/lang/model/util/SimpleAnnotationValueVisitor7.java Fri Jan 13 19:29:55 2017 -0800 @@ -1,5 +1,5 @@ /* - * Copyright (c) 2010, 2014, Oracle and/or its affiliates. All rights reserved. + * Copyright (c) 2010, 2017, 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 @@ -58,15 +58,6 @@ * 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 * @param <P> the type of the additional parameter to this visitor's methods. *
--- a/src/java.compiler/share/classes/javax/lang/model/util/SimpleAnnotationValueVisitor8.java Fri Jan 13 18:29:21 2017 -0800 +++ b/src/java.compiler/share/classes/javax/lang/model/util/SimpleAnnotationValueVisitor8.java Fri Jan 13 19:29:55 2017 -0800 @@ -1,5 +1,5 @@ /* - * Copyright (c) 2011, 2014, Oracle and/or its affiliates. All rights reserved. + * Copyright (c) 2011, 2017, 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 @@ -58,15 +58,6 @@ * 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 * @param <P> the type of the additional parameter to this visitor's methods. *
--- a/src/java.compiler/share/classes/javax/lang/model/util/SimpleElementVisitor6.java Fri Jan 13 18:29:21 2017 -0800 +++ b/src/java.compiler/share/classes/javax/lang/model/util/SimpleElementVisitor6.java Fri Jan 13 19:29:55 2017 -0800 @@ -1,5 +1,5 @@ /* - * Copyright (c) 2005, 2014, Oracle and/or its affiliates. All rights reserved. + * Copyright (c) 2005, 2017, 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 @@ -65,15 +65,6 @@ * 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}
--- a/src/java.compiler/share/classes/javax/lang/model/util/SimpleElementVisitor7.java Fri Jan 13 18:29:21 2017 -0800 +++ b/src/java.compiler/share/classes/javax/lang/model/util/SimpleElementVisitor7.java Fri Jan 13 19:29:55 2017 -0800 @@ -1,5 +1,5 @@ /* - * Copyright (c) 2010, 2014, Oracle and/or its affiliates. All rights reserved. + * Copyright (c) 2010, 2017, 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 @@ -62,15 +62,6 @@ * 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}
--- a/src/java.compiler/share/classes/javax/lang/model/util/SimpleElementVisitor8.java Fri Jan 13 18:29:21 2017 -0800 +++ b/src/java.compiler/share/classes/javax/lang/model/util/SimpleElementVisitor8.java Fri Jan 13 19:29:55 2017 -0800 @@ -1,5 +1,5 @@ /* - * Copyright (c) 2011, 2014, Oracle and/or its affiliates. All rights reserved. + * Copyright (c) 2011, 2017, 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 @@ -61,15 +61,6 @@ * 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}
--- a/src/java.compiler/share/classes/javax/lang/model/util/SimpleTypeVisitor6.java Fri Jan 13 18:29:21 2017 -0800 +++ b/src/java.compiler/share/classes/javax/lang/model/util/SimpleTypeVisitor6.java Fri Jan 13 19:29:55 2017 -0800 @@ -1,5 +1,5 @@ /* - * Copyright (c) 2005, 2014, Oracle and/or its affiliates. All rights reserved. + * Copyright (c) 2005, 2017, 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 @@ -64,15 +64,6 @@ * 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 {@link * Void} for visitors that do not need to return results. * @param <P> the type of the additional parameter to this visitor's
--- a/src/java.compiler/share/classes/javax/lang/model/util/SimpleTypeVisitor7.java Fri Jan 13 18:29:21 2017 -0800 +++ b/src/java.compiler/share/classes/javax/lang/model/util/SimpleTypeVisitor7.java Fri Jan 13 19:29:55 2017 -0800 @@ -1,5 +1,5 @@ /* - * Copyright (c) 2010, 2014, Oracle and/or its affiliates. All rights reserved. + * Copyright (c) 2010, 2017, 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 @@ -61,15 +61,6 @@ * 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 {@link * Void} for visitors that do not need to return results. * @param <P> the type of the additional parameter to this visitor's
--- a/src/java.compiler/share/classes/javax/lang/model/util/SimpleTypeVisitor8.java Fri Jan 13 18:29:21 2017 -0800 +++ b/src/java.compiler/share/classes/javax/lang/model/util/SimpleTypeVisitor8.java Fri Jan 13 19:29:55 2017 -0800 @@ -1,5 +1,5 @@ /* - * Copyright (c) 2011, 2014, Oracle and/or its affiliates. All rights reserved. + * Copyright (c) 2011, 2017, 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 @@ -61,15 +61,6 @@ * 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 {@link * Void} for visitors that do not need to return results. * @param <P> the type of the additional parameter to this visitor's
--- a/src/java.compiler/share/classes/javax/lang/model/util/TypeKindVisitor6.java Fri Jan 13 18:29:21 2017 -0800 +++ b/src/java.compiler/share/classes/javax/lang/model/util/TypeKindVisitor6.java Fri Jan 13 19:29:55 2017 -0800 @@ -1,5 +1,5 @@ /* - * Copyright (c) 2005, 2013, Oracle and/or its affiliates. All rights reserved. + * Copyright (c) 2005, 2017, 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 @@ -34,10 +34,10 @@ * A visitor of types based on their {@linkplain TypeKind kind} with * default behavior appropriate for the {@link SourceVersion#RELEASE_6 * RELEASE_6} source version. For {@linkplain - * TypeMirror types} <code><i>XYZ</i></code> that may have more than one - * kind, the <code>visit<i>XYZ</i></code> methods in this class delegate - * to the <code>visit<i>XYZKind</i></code> method corresponding to the - * first argument's kind. The <code>visit<i>XYZKind</i></code> methods + * TypeMirror types} <code><i>Xyz</i></code> that may have more than one + * kind, the <code>visit<i>Xyz</i></code> methods in this class delegate + * to the <code>visit<i>Xyz</i>As<i>Kind</i></code> method corresponding to the + * first argument's kind. The <code>visit<i>Xyz</i>As<i>Kind</i></code> methods * call {@link #defaultAction defaultAction}, passing their arguments * to {@code defaultAction}'s corresponding parameters. * @@ -63,15 +63,6 @@ * 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 {@link * Void} for visitors that do not need to return results. * @param <P> the type of the additional parameter to this visitor's
--- a/src/java.compiler/share/classes/javax/lang/model/util/TypeKindVisitor7.java Fri Jan 13 18:29:21 2017 -0800 +++ b/src/java.compiler/share/classes/javax/lang/model/util/TypeKindVisitor7.java Fri Jan 13 19:29:55 2017 -0800 @@ -1,5 +1,5 @@ /* - * Copyright (c) 2010, 2014, Oracle and/or its affiliates. All rights reserved. + * Copyright (c) 2010, 2017, 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 @@ -34,10 +34,10 @@ * A visitor of types based on their {@linkplain TypeKind kind} with * default behavior appropriate for the {@link SourceVersion#RELEASE_7 * RELEASE_7} source version. For {@linkplain - * TypeMirror types} <code><i>XYZ</i></code> that may have more than one - * kind, the <code>visit<i>XYZ</i></code> methods in this class delegate - * to the <code>visit<i>XYZKind</i></code> method corresponding to the - * first argument's kind. The <code>visit<i>XYZKind</i></code> methods + * TypeMirror types} <code><i>Xyz</i></code> that may have more than one + * kind, the <code>visit<i>Xyz</i></code> methods in this class delegate + * to the <code>visit<i>Xyz</i>As<i>Kind</i></code> method corresponding to the + * first argument's kind. The <code>visit<i>Xyz</i>As<i>Kind</i></code> methods * call {@link #defaultAction defaultAction}, passing their arguments * to {@code defaultAction}'s corresponding parameters. * @@ -63,15 +63,6 @@ * 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 {@link * Void} for visitors that do not need to return results. * @param <P> the type of the additional parameter to this visitor's
--- a/src/java.compiler/share/classes/javax/lang/model/util/TypeKindVisitor8.java Fri Jan 13 18:29:21 2017 -0800 +++ b/src/java.compiler/share/classes/javax/lang/model/util/TypeKindVisitor8.java Fri Jan 13 19:29:55 2017 -0800 @@ -1,5 +1,5 @@ /* - * Copyright (c) 2011, 2013, Oracle and/or its affiliates. All rights reserved. + * Copyright (c) 2011, 2017, 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 @@ -34,10 +34,10 @@ * A visitor of types based on their {@linkplain TypeKind kind} with * default behavior appropriate for the {@link SourceVersion#RELEASE_8 * RELEASE_8} source version. For {@linkplain - * TypeMirror types} <code><i>XYZ</i></code> that may have more than one - * kind, the <code>visit<i>XYZ</i></code> methods in this class delegate - * to the <code>visit<i>XYZKind</i></code> method corresponding to the - * first argument's kind. The <code>visit<i>XYZKind</i></code> methods + * TypeMirror types} <code><i>Xyz</i></code> that may have more than one + * kind, the <code>visit<i>Xyz</i></code> methods in this class delegate + * to the <code>visit<i>Xyz</i>As<i>Kind</i></code> method corresponding to the + * first argument's kind. The <code>visit<i>Xyz</i>As<i>Kind</i></code> methods * call {@link #defaultAction defaultAction}, passing their arguments * to {@code defaultAction}'s corresponding parameters. * @@ -63,15 +63,6 @@ * 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 {@link * Void} for visitors that do not need to return results. * @param <P> the type of the additional parameter to this visitor's
--- a/src/java.compiler/share/classes/javax/lang/model/util/TypeKindVisitor9.java Fri Jan 13 18:29:21 2017 -0800 +++ b/src/java.compiler/share/classes/javax/lang/model/util/TypeKindVisitor9.java Fri Jan 13 19:29:55 2017 -0800 @@ -1,5 +1,5 @@ /* - * Copyright (c) 2011, 2014, Oracle and/or its affiliates. All rights reserved. + * Copyright (c) 2011, 2017, 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 @@ -34,10 +34,10 @@ * A visitor of types based on their {@linkplain TypeKind kind} with * default behavior appropriate for the {@link SourceVersion#RELEASE_9 * RELEASE_9} source version. For {@linkplain - * TypeMirror types} <code><i>XYZ</i></code> that may have more than one - * kind, the <code>visit<i>XYZ</i></code> methods in this class delegate - * to the <code>visit<i>XYZKind</i></code> method corresponding to the - * first argument's kind. The <code>visit<i>XYZKind</i></code> methods + * TypeMirror types} <code><i>Xyz</i></code> that may have more than one + * kind, the <code>visit<i>Xyz</i></code> methods in this class delegate + * to the <code>visit<i>Xyz</i>As<i>Kind</i></code> method corresponding to the + * first argument's kind. The <code>visit<i>Xyz</i>As<i>Kind</i></code> methods * call {@link #defaultAction defaultAction}, passing their arguments * to {@code defaultAction}'s corresponding parameters. *