chore: update javadoc internal API tags (#6391)

adangel · adangel · commit 840a29fdb5fc · 2026-01-29T16:54:36.000+01:00
diff --git a/pmd-ant/src/main/java/net/sourceforge/pmd/ant/InternalApiBridge.java b/pmd-ant/src/main/java/net/sourceforge/pmd/ant/InternalApiBridge.java
@@ -20,7 +20,7 @@
  * <p><b>None of this is published API, and compatibility can be broken anytime!</b>
  * Use this only at your own risk.
  *
- * @apiNote Internal API
+ * @internalApi None of this is published API, and compatibility can be broken anytime! Use this only at your own risk.
  */
 @InternalApi
 public final class InternalApiBridge {
diff --git a/pmd-ant/src/main/java/net/sourceforge/pmd/ant/ReportException.java b/pmd-ant/src/main/java/net/sourceforge/pmd/ant/ReportException.java
@@ -6,7 +6,7 @@
 
 /**
  * @author Philippe T'Seyen
- * @apiNote Internal API
+ * @internalApi None of this is published API, and compatibility can be broken anytime! Use this only at your own risk.
  */
 class ReportException extends RuntimeException {
     private static final long serialVersionUID = 6043174086675858209L;
diff --git a/pmd-apex/src/main/java/net/sourceforge/pmd/lang/apex/ast/ApexCommentBuilder.java b/pmd-apex/src/main/java/net/sourceforge/pmd/lang/apex/ast/ApexCommentBuilder.java
@@ -19,7 +19,6 @@
 import org.antlr.v4.runtime.Recognizer;
 import org.antlr.v4.runtime.Token;
 
-import net.sourceforge.pmd.annotation.InternalApi;
 import net.sourceforge.pmd.lang.ast.LexException;
 import net.sourceforge.pmd.lang.ast.impl.SuppressionCommentImpl;
 import net.sourceforge.pmd.lang.document.FileLocation;
@@ -30,7 +29,6 @@
 import io.github.apexdevtools.apexparser.ApexLexer;
 import io.github.apexdevtools.apexparser.CaseInsensitiveInputStream;
 
-@InternalApi
 final class ApexCommentBuilder {
     private final TextDocument sourceCode;
     private final CommentInformation commentInfo;
diff --git a/pmd-apex/src/main/java/net/sourceforge/pmd/lang/apex/multifile/InternalApiBridge.java b/pmd-apex/src/main/java/net/sourceforge/pmd/lang/apex/multifile/InternalApiBridge.java
@@ -16,7 +16,7 @@
  * <p><b>None of this is published API, and compatibility can be broken anytime!</b>
  * Use this only at your own risk.
  *
- * @apiNote Internal API
+ * @internalApi None of this is published API, and compatibility can be broken anytime! Use this only at your own risk.
  */
 @InternalApi
 public final class InternalApiBridge {
diff --git a/pmd-core/src/main/java/net/sourceforge/pmd/PMDConfiguration.java b/pmd-core/src/main/java/net/sourceforge/pmd/PMDConfiguration.java
@@ -365,7 +365,7 @@ public void setReportProperties(Properties reportProperties) {
      *
      * @return The currently used analysis cache. Never null.
      *
-     * @apiNote This is internal API.
+     * @internalApi None of this is published API, and compatibility can be broken anytime! Use this only at your own risk.
      */
     AnalysisCache getAnalysisCache() {
         // Make sure we are not null
@@ -385,7 +385,8 @@ AnalysisCache getAnalysisCache() {
      *
      * @param cache The analysis cache to be used.
      *
-     * @apiNote This is internal API. Use {@link #setAnalysisCacheLocation(String)} to configure a cache.
+     * @internalApi None of this is published API, and compatibility can be broken anytime! Use this only at your own risk.
+     * Use {@link #setAnalysisCacheLocation(String)} to configure a cache.
      */
     void setAnalysisCache(final AnalysisCache cache) {
         // the doc says it's a noop if incremental analysis was disabled,
diff --git a/pmd-core/src/main/java/net/sourceforge/pmd/cpd/Tokens.java b/pmd-core/src/main/java/net/sourceforge/pmd/cpd/Tokens.java
@@ -32,7 +32,7 @@ public class Tokens {
     /**
      * Create a new instance.
      *
-     * @apiNote  Internal API
+     * @internalApi None of this is published API, and compatibility can be broken anytime! Use this only at your own risk.
      */
     Tokens() {
         // constructor is package private
diff --git a/pmd-core/src/main/java/net/sourceforge/pmd/lang/InternalApiBridge.java b/pmd-core/src/main/java/net/sourceforge/pmd/lang/InternalApiBridge.java
@@ -22,7 +22,7 @@
  * <p><b>None of this is published API, and compatibility can be broken anytime!</b>
  * Use this only at your own risk.
  *
- * @apiNote Internal API
+ * @internalApi None of this is published API, and compatibility can be broken anytime! Use this only at your own risk.
  */
 @InternalApi
 public final class InternalApiBridge {
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,7 +72,7 @@ class AnalysisTask {
          * Create a new task. This constructor is internal and will be
          * called by PMD.
          *
-         * @apiNote Internal API
+         * @internalApi None of this is published API, and compatibility can be broken anytime! Use this only at your own risk.
          */
         AnalysisTask(RuleSets rulesets,
                             List<TextFile> files,
@@ -121,7 +121,7 @@ public LanguageProcessorRegistry getLpRegistry() {
         /**
          * Produce a new analysis task with just different files.
          *
-         * @apiNote Internal API
+         * @internalApi None of this is published API, and compatibility can be broken anytime! Use this only at your own risk.
          */
         AnalysisTask withFiles(List<TextFile> newFiles) {
             return new AnalysisTask(
diff --git a/pmd-core/src/main/java/net/sourceforge/pmd/lang/ast/InternalApiBridge.java b/pmd-core/src/main/java/net/sourceforge/pmd/lang/ast/InternalApiBridge.java
@@ -15,7 +15,7 @@
  * <p><b>None of this is published API, and compatibility can be broken anytime!</b>
  * Use this only at your own risk.
  *
- * @apiNote Internal API
+ * @internalApi None of this is published API, and compatibility can be broken anytime! Use this only at your own risk.
  */
 @InternalApi
 public final class InternalApiBridge {
diff --git a/pmd-core/src/main/java/net/sourceforge/pmd/lang/ast/LexException.java b/pmd-core/src/main/java/net/sourceforge/pmd/lang/ast/LexException.java
@@ -44,7 +44,7 @@ public LexException(int line, int column, @Nullable FileId filename, String mess
     /**
      * Constructor called by JavaCC.
      *
-     * @apiNote Internal API.
+     * @internalApi None of this is published API, and compatibility can be broken anytime! Use this only at your own risk.
      */
     LexException(boolean eofSeen, String lexStateName, int errorLine, int errorColumn, String errorAfter, char curChar) {
         super(makeReason(eofSeen, lexStateName, errorAfter, curChar));
diff --git a/pmd-core/src/main/java/net/sourceforge/pmd/lang/ast/SemanticException.java b/pmd-core/src/main/java/net/sourceforge/pmd/lang/ast/SemanticException.java
@@ -29,6 +29,9 @@ public SemanticException(String message, Throwable cause) {
         super(message, cause);
     }
 
+    /**
+     * @internalApi None of this is published API, and compatibility can be broken anytime! Use this only at your own risk.
+     */
     @InternalApi
     public void setReported() {
         reported = true;
diff --git a/pmd-core/src/main/java/net/sourceforge/pmd/lang/document/FileCollector.java b/pmd-core/src/main/java/net/sourceforge/pmd/lang/document/FileCollector.java
@@ -73,8 +73,8 @@ private FileCollector(LanguageVersionDiscoverer discoverer, PmdReporter reporter
     }
 
     /**
-     * @apiNote Internal API - please use {@link PmdAnalysis#files()} instead of
-     * creating a collector yourself.
+     * @internalApi None of this is published API, and compatibility can be broken anytime! Use this only at your own risk.
+     * Please use {@link PmdAnalysis#files()} instead of creating a collector yourself.
      */
     static FileCollector newCollector(LanguageVersionDiscoverer discoverer, PmdReporter reporter) {
         return new FileCollector(discoverer, reporter, null);
@@ -83,8 +83,8 @@ static FileCollector newCollector(LanguageVersionDiscoverer discoverer, PmdRepor
     /**
      * Returns a new collector using the same configuration except for the logger.
      *
-     * @apiNote Internal API - please use {@link PmdAnalysis#files()} instead of
-     * creating a collector yourself.
+     * @internalApi None of this is published API, and compatibility can be broken anytime! Use this only at your own risk.
+     * Please use {@link PmdAnalysis#files()} instead of creating a collector yourself.
      */
     FileCollector newCollector(PmdReporter logger) {
         FileCollector fileCollector = new FileCollector(discoverer, logger, null);
diff --git a/pmd-core/src/main/java/net/sourceforge/pmd/lang/document/InternalApiBridge.java b/pmd-core/src/main/java/net/sourceforge/pmd/lang/document/InternalApiBridge.java
@@ -17,7 +17,7 @@
  * <p><b>None of this is published API, and compatibility can be broken anytime!</b>
  * Use this only at your own risk.
  *
- * @apiNote Internal API
+ * @internalApi None of this is published API, and compatibility can be broken anytime! Use this only at your own risk.
  */
 @InternalApi
 public final class InternalApiBridge {
diff --git a/pmd-core/src/main/java/net/sourceforge/pmd/lang/rule/InternalApiBridge.java b/pmd-core/src/main/java/net/sourceforge/pmd/lang/rule/InternalApiBridge.java
@@ -22,7 +22,7 @@
  * <p><b>None of this is published API, and compatibility can be broken anytime!</b>
  * Use this only at your own risk.
  *
- * @apiNote Internal API
+ * @internalApi None of this is published API, and compatibility can be broken anytime! Use this only at your own risk.
  */
 @InternalApi
 public final class InternalApiBridge {
diff --git a/pmd-core/src/main/java/net/sourceforge/pmd/lang/rule/RuleSet.java b/pmd-core/src/main/java/net/sourceforge/pmd/lang/rule/RuleSet.java
@@ -627,7 +627,7 @@ public Rule getRuleByName(String ruleName) {
      * @return <code>true</code> if the file should be checked,
      *     <code>false</code> otherwise
      *
-     * @apiNote Internal API.
+     * @internalApi None of this is published API, and compatibility can be broken anytime! Use this only at your own risk.
      */
     boolean applies(FileId qualFileName) {
         return filter.test(qualFileName.getAbsolutePath());
@@ -646,7 +646,7 @@ boolean applies(FileId qualFileName) {
      * @return <code>true</code> if the given rule matches the given language,
      *         which means, that the rule would be executed.
      *
-     * @apiNote This is internal API.
+     * @internalApi None of this is published API, and compatibility can be broken anytime! Use this only at your own risk.
      */
     static boolean applies(Rule rule, LanguageVersion languageVersion) {
         assert rule.getLanguage() != null : "Rule has no language " + rule;
diff --git a/pmd-core/src/main/java/net/sourceforge/pmd/lang/rule/RuleSetLoadException.java b/pmd-core/src/main/java/net/sourceforge/pmd/lang/rule/RuleSetLoadException.java
@@ -17,14 +17,14 @@
 public class RuleSetLoadException extends RuntimeException {
 
     /**
-     * @apiNote Internal API.
+     * @internalApi None of this is published API, and compatibility can be broken anytime! Use this only at your own risk.
      */
     RuleSetLoadException(RuleSetReferenceId rsetId, @NonNull Throwable cause) {
         super("Cannot load ruleset " + rsetId + ": " + cause.getMessage(), cause);
     }
 
     /**
-     * @apiNote Internal API.
+     * @internalApi Internal API.
      */
     RuleSetLoadException(RuleSetReferenceId rsetId, String message) {
         super("Cannot load ruleset " + rsetId + ": " + message);
diff --git a/pmd-core/src/main/java/net/sourceforge/pmd/lang/rule/RuleSetLoader.java b/pmd-core/src/main/java/net/sourceforge/pmd/lang/rule/RuleSetLoader.java
@@ -190,8 +190,8 @@ public List<RuleSet> loadFromResources(Collection<String> paths) {
      * Loads a list of rulesets, if any has an error, report it on the contextual
      * error reporter instead of aborting, and continue loading the rest.
      *
-     * @apiNote Internal API: might be published later, or maybe this
-     * will be the default behaviour of every method of this class.
+     * @internalApi None of this is published API, and compatibility can be broken anytime! Use this only at your own risk.
+     * It might be published later, or maybe this will be the default behaviour of every method of this class.
      */
     List<RuleSet> loadRuleSetsWithoutException(List<String> rulesetPaths) {
         List<RuleSet> ruleSets = new ArrayList<>(rulesetPaths.size());
diff --git a/pmd-core/src/main/java/net/sourceforge/pmd/lang/rule/xpath/Attribute.java b/pmd-core/src/main/java/net/sourceforge/pmd/lang/rule/xpath/Attribute.java
@@ -78,7 +78,7 @@ public Attribute(@NonNull Node parent, @NonNull String name, @Nullable String va
      * Note that the type must be supported by {@link net.sourceforge.pmd.lang.rule.xpath.internal.DomainConversion}
      * if you want this attribute to be used from XPath.
      *
-     * @apiNote Internal API
+     * @internalApi None of this is published API, and compatibility can be broken anytime! Use this only at your own risk.
      * @since 7.20.0
      */
     @InternalApi // used for tests
@@ -120,7 +120,7 @@ public Type getType() {
      * Returns null for "not deprecated", empty string for "deprecated without replacement",
      * otherwise name of replacement attribute.
      *
-     * @apiNote Internal API
+     * @internalApi None of this is published API, and compatibility can be broken anytime! Use this only at your own risk.
      */
     String replacementIfDeprecated() {
         if (method == null) {
diff --git a/pmd-core/src/main/java/net/sourceforge/pmd/lang/rule/xpath/InternalApiBridge.java b/pmd-core/src/main/java/net/sourceforge/pmd/lang/rule/xpath/InternalApiBridge.java
@@ -15,7 +15,7 @@
  * <p><b>None of this is published API, and compatibility can be broken anytime!</b>
  * Use this only at your own risk.
  *
- * @apiNote Internal API
+ * @internalApi None of this is published API, and compatibility can be broken anytime! Use this only at your own risk.
  */
 @InternalApi
 public final class InternalApiBridge {
diff --git a/pmd-core/src/main/java/net/sourceforge/pmd/properties/InternalApiBridge.java b/pmd-core/src/main/java/net/sourceforge/pmd/properties/InternalApiBridge.java
@@ -18,7 +18,7 @@
  * <p><b>None of this is published API, and compatibility can be broken anytime!</b>
  * Use this only at your own risk.
  *
- * @apiNote Internal API
+ * @internalApi None of this is published API, and compatibility can be broken anytime! Use this only at your own risk.
  */
 @InternalApi
 public final class InternalApiBridge {
diff --git a/pmd-core/src/main/java/net/sourceforge/pmd/properties/PropertyDescriptor.java b/pmd-core/src/main/java/net/sourceforge/pmd/properties/PropertyDescriptor.java
@@ -106,7 +106,7 @@ public PropertySerializer<T> serializer() {
      * null if this property was defined in Java code and not in XML. This
      * is used to write the property back to XML, when using a {@link RuleSetWriter}.
      *
-     * @apiNote Internal API
+     * @internalApi None of this is published API, and compatibility can be broken anytime! Use this only at your own risk.
      */
     @Nullable PropertyTypeId getTypeId() {
         return typeId;
diff --git a/pmd-core/src/main/java/net/sourceforge/pmd/properties/internal/PropertyTypeId.java b/pmd-core/src/main/java/net/sourceforge/pmd/properties/internal/PropertyTypeId.java
@@ -28,7 +28,7 @@
  *
  * @author Clément Fournier
  * @since 6.0.0
- * @apiNote Internal API
+ * @internalApi None of this is published API, and compatibility can be broken anytime! Use this only at your own risk.
  */
 public enum PropertyTypeId {
     // These are exclusively used for XPath rules. It would make more sense to model the supported
diff --git a/pmd-core/src/main/java/net/sourceforge/pmd/reporting/InternalApiBridge.java b/pmd-core/src/main/java/net/sourceforge/pmd/reporting/InternalApiBridge.java
@@ -20,7 +20,7 @@
  * <p><b>None of this is published API, and compatibility can be broken anytime!</b>
  * Use this only at your own risk.
  *
- * @apiNote Internal API
+ * @internalApi None of this is published API, and compatibility can be broken anytime! Use this only at your own risk.
  */
 @InternalApi
 public final class InternalApiBridge {
diff --git a/pmd-core/src/main/java/net/sourceforge/pmd/reporting/ParametricRuleViolation.java b/pmd-core/src/main/java/net/sourceforge/pmd/reporting/ParametricRuleViolation.java
@@ -12,7 +12,8 @@
 import net.sourceforge.pmd.util.AssertionUtil;
 
 /**
- * @apiNote This is internal API. Clients should exclusively use {@link RuleViolation}.
+ * @internalApi None of this is published API, and compatibility can be broken anytime! Use this only at your own risk.
+ * Clients should exclusively use {@link RuleViolation}.
  */
 class ParametricRuleViolation implements RuleViolation {
     protected final Rule rule;
diff --git a/pmd-core/src/main/java/net/sourceforge/pmd/reporting/RuleContext.java b/pmd-core/src/main/java/net/sourceforge/pmd/reporting/RuleContext.java
@@ -53,7 +53,7 @@ public final class RuleContext {
     private final Rule rule;
 
     /**
-     * @apiNote Internal API
+     * @internalApi None of this is published API, and compatibility can be broken anytime! Use this only at your own risk.
      */
     RuleContext(FileAnalysisListener listener, Rule rule) {
         Objects.requireNonNull(listener, "Listener was null");
@@ -63,8 +63,8 @@ public final class RuleContext {
     }
 
     /**
-     * @apiNote Internal API. Used in {@link AbstractRule} in {@code asCtx(Object)},
-     * through {@link InternalApiBridge}.
+     * @internalApi None of this is published API, and compatibility can be broken anytime! Use this only at your own risk.
+     * Used in {@link AbstractRule} in {@code asCtx(Object)}, through {@link InternalApiBridge}.
      */
     Rule getRule() {
         return rule;
diff --git a/pmd-core/src/main/java/net/sourceforge/pmd/util/internal/ResourceLoader.java b/pmd-core/src/main/java/net/sourceforge/pmd/util/internal/ResourceLoader.java
@@ -22,7 +22,7 @@
 import net.sourceforge.pmd.lang.rule.xpath.XPathRule;
 
 /**
- * @apiNote  Internal API
+ * @internalApi None of this is published API, and compatibility can be broken anytime! Use this only at your own risk.
  */
 public class ResourceLoader {
 
diff --git a/pmd-core/src/test/java/net/sourceforge/pmd/InternalApiBridgeForTestsOnly.java b/pmd-core/src/test/java/net/sourceforge/pmd/InternalApiBridgeForTestsOnly.java
@@ -16,7 +16,7 @@
  * <p><b>None of this is published API, and compatibility can be broken anytime!</b>
  * Use this only at your own risk.
  *
- * @apiNote Internal API
+ * @internalApi None of this is published API, and compatibility can be broken anytime! Use this only at your own risk.
  */
 @InternalApi
 public final class InternalApiBridgeForTestsOnly {
diff --git a/pmd-doc/src/main/java/net/sourceforge/pmd/doc/InternalApiBridge.java b/pmd-doc/src/main/java/net/sourceforge/pmd/doc/InternalApiBridge.java
@@ -15,7 +15,7 @@
  * <p><b>None of this is published API, and compatibility can be broken anytime!</b>
  * Use this only at your own risk.
  *
- * @apiNote Internal API
+ * @internalApi None of this is published API, and compatibility can be broken anytime! Use this only at your own risk.
  */
 @InternalApi
 public final class InternalApiBridge {
diff --git a/pmd-java/src/main/java/net/sourceforge/pmd/lang/java/ast/InternalApiBridge.java b/pmd-java/src/main/java/net/sourceforge/pmd/lang/java/ast/InternalApiBridge.java
@@ -47,7 +47,7 @@
  *
  * @author Clément Fournier
  * @since 7.0.0
- * @apiNote Internal API
+ * @internalApi None of this is published API, and compatibility can be broken anytime! Use this only at your own risk.
  */
 @InternalApi
 public final class InternalApiBridge {
diff --git a/pmd-java/src/main/java/net/sourceforge/pmd/lang/java/rule/internal/AbstractIgnoredAnnotationRule.java b/pmd-java/src/main/java/net/sourceforge/pmd/lang/java/rule/internal/AbstractIgnoredAnnotationRule.java
@@ -15,7 +15,7 @@
 import net.sourceforge.pmd.properties.PropertyDescriptor;
 
 /**
- * @apiNote  Internal API
+ * @internalApi None of this is published API, and compatibility can be broken anytime! Use this only at your own risk.
  */
 public abstract class AbstractIgnoredAnnotationRule extends AbstractJavaRule {
 
diff --git a/pmd-java/src/main/java/net/sourceforge/pmd/lang/java/types/InternalApiBridge.java b/pmd-java/src/main/java/net/sourceforge/pmd/lang/java/types/InternalApiBridge.java
@@ -15,7 +15,7 @@
  * <p><b>None of this is published API, and compatibility can be broken anytime!</b>
  * Use this only at your own risk.
  *
- * @apiNote Internal API
+ * @internalApi None of this is published API, and compatibility can be broken anytime! Use this only at your own risk.
  */
 @InternalApi
 public final class InternalApiBridge {
diff --git a/pmd-java/src/main/java/net/sourceforge/pmd/lang/java/types/TypeOps.java b/pmd-java/src/main/java/net/sourceforge/pmd/lang/java/types/TypeOps.java
@@ -95,7 +95,7 @@ public static boolean isSameTypeWithSameAnnotations(JTypeMirror t, JTypeMirror s
      * Return true if t and s are the same type. This may perform side effects
      * on inference variables. Annotations are ignored.
      *
-     * @apiNote Internal API
+     * @internalApi None of this is published API, and compatibility can be broken anytime! Use this only at your own risk.
      */
     static boolean isSameTypeInInference(JTypeMirror t, JTypeMirror s) {
         return isSameType(t, s, false, false);
diff --git a/pmd-java/src/main/java/net/sourceforge/pmd/lang/java/types/ast/InternalApiBridge.java b/pmd-java/src/main/java/net/sourceforge/pmd/lang/java/types/ast/InternalApiBridge.java
@@ -22,7 +22,7 @@
  * <p><b>None of this is published API, and compatibility can be broken anytime!</b>
  * Use this only at your own risk.
  *
- * @apiNote Internal API
+ * @internalApi None of this is published API, and compatibility can be broken anytime! Use this only at your own risk.
  */
 @InternalApi
 public final class InternalApiBridge {
diff --git a/pmd-jsp/src/main/java/net/sourceforge/pmd/lang/jsp/ast/InternalApiBridge.java b/pmd-jsp/src/main/java/net/sourceforge/pmd/lang/jsp/ast/InternalApiBridge.java
@@ -16,7 +16,7 @@
  * <p><b>None of this is published API, and compatibility can be broken anytime!</b>
  * Use this only at your own risk.
  *
- * @apiNote Internal API
+ * @internalApi None of this is published API, and compatibility can be broken anytime! Use this only at your own risk.
  */
 @InternalApi
 public final class InternalApiBridge {
diff --git a/pmd-lang-test/src/main/kotlin/net/sourceforge/pmd/lang/test/ast/IntelliMarker.kt b/pmd-lang-test/src/main/kotlin/net/sourceforge/pmd/lang/test/ast/IntelliMarker.kt
@@ -21,6 +21,9 @@ interface IntelliMarker {
     fun primer() {
     }
 
+    /**
+     * @apiNote Internal API
+     */
     @Test
     @InternalApi
     fun dummyTestForIntelliJIntegration() {
diff --git a/pmd-modelica/src/main/java/net/sourceforge/pmd/lang/modelica/ast/InternalApiBridge.java b/pmd-modelica/src/main/java/net/sourceforge/pmd/lang/modelica/ast/InternalApiBridge.java
diff --git a/pmd-modelica/src/main/java/net/sourceforge/pmd/lang/modelica/resolver/InternalApiBridge.java b/pmd-modelica/src/main/java/net/sourceforge/pmd/lang/modelica/resolver/InternalApiBridge.java
diff --git a/pmd-plsql/src/main/java/net/sourceforge/pmd/lang/plsql/ast/InternalApiBridge.java b/pmd-plsql/src/main/java/net/sourceforge/pmd/lang/plsql/ast/InternalApiBridge.java
diff --git a/pmd-plsql/src/main/java/net/sourceforge/pmd/lang/plsql/rule/design/AbstractNcssCountRule.java b/pmd-plsql/src/main/java/net/sourceforge/pmd/lang/plsql/rule/design/AbstractNcssCountRule.java
diff --git a/pmd-visualforce/src/main/java/net/sourceforge/pmd/lang/visualforce/ast/InternalApiBridge.java b/pmd-visualforce/src/main/java/net/sourceforge/pmd/lang/visualforce/ast/InternalApiBridge.java
diff --git a/pom.xml b/pom.xml

Original file line number	Diff line number	Diff line change
`@@ -20,7 +20,7 @@`
`20`	`20`	`* <p><b>None of this is published API, and compatibility can be broken anytime!</b>`
`21`	`21`	`* Use this only at your own risk.`
`22`	`22`	`*`
`23`		`- * @apiNote Internal API`
	`23`	`+ * @internalApi None of this is published API, and compatibility can be broken anytime! Use this only at your own risk.`
`24`	`24`	`*/`
`25`	`25`	`@InternalApi`
`26`	`26`	`public final class InternalApiBridge {`
Original file line number	Diff line number	Diff line change
`@@ -16,7 +16,7 @@`
`16`	`16`	`* <p><b>None of this is published API, and compatibility can be broken anytime!</b>`
`17`	`17`	`* Use this only at your own risk.`
`18`	`18`	`*`
`19`		`- * @apiNote Internal API`
	`19`	`+ * @internalApi None of this is published API, and compatibility can be broken anytime! Use this only at your own risk.`
`20`	`20`	`*/`
`21`	`21`	`@InternalApi`
`22`	`22`	`public final class InternalApiBridge {`
Original file line number	Diff line number	Diff line change
`@@ -365,7 +365,7 @@ public void setReportProperties(Properties reportProperties) {`
`365`	`365`	`*`
`366`	`366`	`* @return The currently used analysis cache. Never null.`
`367`	`367`	`*`
`368`		`- * @apiNote This is internal API.`
	`368`	`+ * @internalApi None of this is published API, and compatibility can be broken anytime! Use this only at your own risk.`
`369`	`369`	`*/`
`370`	`370`	`AnalysisCache getAnalysisCache() {`
`371`	`371`	`// Make sure we are not null`
`@@ -385,7 +385,8 @@ AnalysisCache getAnalysisCache() {`
`385`	`385`	`*`
`386`	`386`	`* @param cache The analysis cache to be used.`
`387`	`387`	`*`
`388`		`- * @apiNote This is internal API. Use {@link #setAnalysisCacheLocation(String)} to configure a cache.`
	`388`	`+ * @internalApi None of this is published API, and compatibility can be broken anytime! Use this only at your own risk.`
	`389`	`+ * Use {@link #setAnalysisCacheLocation(String)} to configure a cache.`
`389`	`390`	`*/`
`390`	`391`	`void setAnalysisCache(final AnalysisCache cache) {`
`391`	`392`	`// the doc says it's a noop if incremental analysis was disabled,`
Original file line number	Diff line number	Diff line change
`@@ -32,7 +32,7 @@ public class Tokens {`
`32`	`32`	`/**`
`33`	`33`	`* Create a new instance.`
`34`	`34`	`*`
`35`		`- * @apiNote Internal API`
	`35`	`+ * @internalApi None of this is published API, and compatibility can be broken anytime! Use this only at your own risk.`
`36`	`36`	`*/`
`37`	`37`	`Tokens() {`
`38`	`38`	`// constructor is package private`
Original file line number	Diff line number	Diff line change
`@@ -22,7 +22,7 @@`
`22`	`22`	`* <p><b>None of this is published API, and compatibility can be broken anytime!</b>`
`23`	`23`	`* Use this only at your own risk.`
`24`	`24`	`*`
`25`		`- * @apiNote Internal API`
	`25`	`+ * @internalApi None of this is published API, and compatibility can be broken anytime! Use this only at your own risk.`
`26`	`26`	`*/`
`27`	`27`	`@InternalApi`
`28`	`28`	`public final class InternalApiBridge {`
Original file line number	Diff line number	Diff line change
`@@ -15,7 +15,7 @@`
`15`	`15`	`* <p><b>None of this is published API, and compatibility can be broken anytime!</b>`
`16`	`16`	`* Use this only at your own risk.`
`17`	`17`	`*`
`18`		`- * @apiNote Internal API`
	`18`	`+ * @internalApi None of this is published API, and compatibility can be broken anytime! Use this only at your own risk.`
`19`	`19`	`*/`
`20`	`20`	`@InternalApi`
`21`	`21`	`public final class InternalApiBridge {`
Original file line number	Diff line number	Diff line change
`@@ -44,7 +44,7 @@ public LexException(int line, int column, @Nullable FileId filename, String mess`
`44`	`44`	`/**`
`45`	`45`	`* Constructor called by JavaCC.`
`46`	`46`	`*`
`47`		`- * @apiNote Internal API.`
	`47`	`+ * @internalApi None of this is published API, and compatibility can be broken anytime! Use this only at your own risk.`
`48`	`48`	`*/`
`49`	`49`	`LexException(boolean eofSeen, String lexStateName, int errorLine, int errorColumn, String errorAfter, char curChar) {`
`50`	`50`	`super(makeReason(eofSeen, lexStateName, errorAfter, curChar));`