src/share/classes/javax/lang/model/element/Element.java

*** 1,7 ****
  /*
!  * Copyright (c) 2005, 2011, 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) 2005, 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
*** 212,238 ****
  
      /**
       * Returns the elements that are, loosely speaking, directly
       * enclosed by this element.
       *
!      * A class or interface is considered to enclose the fields,
!      * methods, constructors, and member types that it directly
!      * declares.  This includes any (implicit) default constructor and
!      * the implicit {@code values} and {@code valueOf} methods of an
!      * enum type.
!      *
!      * A package encloses the top-level classes and interfaces within
!      * it, but is not considered to enclose subpackages.
       *
       * Other kinds of elements are not currently considered to enclose
       * any elements; however, that may change as this API or the
       * programming language evolves.
       *
       * <p>Note that elements of certain kinds can be isolated using
       * methods in {@link ElementFilter}.
       *
       * @return the enclosed elements, or an empty list if none
       * @see Elements#getAllMembers
       * @jls 8.8.9 Default Constructor
       * @jls 8.9 Enums
       */
      List<? extends Element> getEnclosedElements();
--- 212,239 ----
  
      /**
       * Returns the elements that are, loosely speaking, directly
       * enclosed by this element.
       *
!      * A {@linkplain TypeElement#getEnclosedElements class or
!      * interface} is considered to enclose the fields, methods,
!      * constructors, and member types that it directly declares.
!      *
!      * A {@linkplain PackageElement#getEnclosedElements package}
!      * encloses the top-level classes and interfaces within it, but is
!      * not considered to enclose subpackages.
       *
       * Other kinds of elements are not currently considered to enclose
       * any elements; however, that may change as this API or the
       * programming language evolves.
       *
       * <p>Note that elements of certain kinds can be isolated using
       * methods in {@link ElementFilter}.
       *
       * @return the enclosed elements, or an empty list if none
+      * @see PackageElement#getEnclosedElements
+      * @see TypeElement#getEnclosedElements
       * @see Elements#getAllMembers
       * @jls 8.8.9 Default Constructor
       * @jls 8.9 Enums
       */
      List<? extends Element> getEnclosedElements();