[java] Deprecate ASTImportDeclaration#getPackage(), refs #1888

docs/pages/release_notes.md

@@ -18,6 +18,13 @@ This is a {{ site.pmd.release_type }} release.
 
 ### API Changes
 
+#### Deprecated APIs
+
+##### For removal
+
+*   The method {% jdoc java::ast.ASTImportDeclaration#getPackage() %} has been deprecated and
+    will be removed with PMD 7.0.0.
+
 ### External Contributions
 
 {% endtocmaker %}

pmd-java/src/main/java/net/sourceforge/pmd/lang/java/ast/ASTImportDeclaration.java

@@ -153,9 +153,10 @@ public class ASTImportDeclaration extends AbstractJavaTypeNode {
      * type or method imported by this declaration. This may be null if the
      * auxclasspath is not correctly set, as this method depends on correct
      * type resolution.
+     *
+     * @deprecated this will be removed with PMD 7.0.0
      */
-    // TODO deprecate? This is only used in a test. I don't think it's really
-    // useful and it gives work to ClassTypeResolver.
+    @Deprecated
     public Package getPackage() {
         return this.pkg;
     }