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

*** 1,7 ****
  /*
!  * Copyright (c) 2005, 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) 2005, 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
*** 76,85 ****
--- 76,122 ----
      TypeMirror asType();
  
      /**
       * Returns the {@code kind} of this element.
       *
+      * <ul>
+      *
+      * <li> The kind of a {@linkplain PackageElement package} is
+      * {@link ElementKind#PACKAGE PACKAGE}.
+      *
+      * <li> The kind of a {@linkplain ModuleElement module} is {@link
+      * ElementKind#MODULE MODULE}.
+      *
+      * <li> The kind of a {@linkplain TypeElement type element} is one
+      * of {@link ElementKind#ANNOTATION_TYPE ANNOTATION_TYPE}, {@link
+      * ElementKind#CLASS CLASS}, {@link ElementKind#ENUM ENUM}, {@link
+      * ElementKind#INTERFACE INTERFACE}, or {@link ElementKind#RECORD
+      * RECORD}.
+      *
+      * <li> The kind of a {@linkplain VariableElement variable} is one
+      * of {@link ElementKind#ENUM_CONSTANT ENUM_CONSTANT}, {@link
+      * ElementKind#EXCEPTION_PARAMETER EXCEPTION_PARAMETER}, {@link
+      * ElementKind#FIELD FIELD}, {@link ElementKind#LOCAL_VARIABLE
+      * LOCAL_VARIABLE}, {@link ElementKind#PARAMETER PARAMETER},
+      * {@link ElementKind#RESOURCE_VARIABLE RESOURCE_VARIABLE}, or
+      * {@link ElementKind#BINDING_VARIABLE BINDING_VARIABLE}.
+      *
+      * <li> The kind of an {@linkplain ExecutableElement executable}
+      * is one of {@link ElementKind#CONSTRUCTOR CONSTRUCTOR}, {@link
+      * ElementKind#INSTANCE_INIT INSTANCE_INIT}, {@link
+      * ElementKind#METHOD METHOD}, or {@link ElementKind#STATIC_INIT
+      * STATIC_INIT}.
+      *
+      * <li> The kind of a {@linkplain TypeParameterElement type parameter} is
+      * {@link ElementKind#TYPE_PARAMETER TYPE_PARAMETER}.
+      *
+      * <li> The kind of a {@linkplain RecordComponentElement record
+      * component} is {@link ElementKind#RECORD_COMPONENT
+      * RECORD_COMPONENT}.
+      *
+      * </ul>
+      *
       * @return the kind of this element
       */
      ElementKind getKind();
  
      /**