[core] LanguageProcessor.AnalysisTask#withFiles now internal

Refs pmd#4348
adangel · Jan 28, 2024 · bc31401 · bc31401
1 parent a0a289f
commit bc31401
Show file tree

Hide file tree

Showing 2 changed files with 12 additions and 0 deletions.
diff --git a/docs/pages/release_notes.md b/docs/pages/release_notes.md
@@ -173,6 +173,13 @@ package or made package private and are not accessible anymore.
   * {%jdoc core::cpd.Tokens#Tokens() %} (the constructor is now package private)
   * {%jdoc core::lang.rule.RuleTargetSelector %} - method `isRuleChain()` has been removed. It was internal API before.
 
+**Newly internal classes, interfaces and methods**
+
+The following classes/methods are for now considered being internal API. Its usage should
+be avoided.
+
+* {%jdoc core::lang.LanguageProcessor.AnalysisTask#withFiles(java.util.List) %}
+
 **Removed classes and methods (previously deprecated)**
 
 The following previously deprecated classes have been removed:

diff --git a/pmd-core/src/main/java/net/sourceforge/pmd/lang/LanguageProcessor.java b/pmd-core/src/main/java/net/sourceforge/pmd/lang/LanguageProcessor.java
@@ -72,6 +72,8 @@ class AnalysisTask {
         /**
          * Create a new task. This constructor is internal and will be
          * called by PMD.
+         *
+         * @apiNote Internal API
          */
         @InternalApi
         public AnalysisTask(RuleSets rulesets,
@@ -120,7 +122,10 @@ public LanguageProcessorRegistry getLpRegistry() {
 
         /**
          * Produce a new analysis task with just different files.
+         *
+         * @apiNote Internal API
          */
+        @InternalApi
         public AnalysisTask withFiles(List<TextFile> newFiles) {
             return new AnalysisTask(
                 rulesets,