[core] Unify javadoc for InternalApiBridge classes

Refs #4348

pmd-ant/src/main/java/net/sourceforge/pmd/ant/InternalApiBridge.java

@@ -12,15 +12,19 @@ import net.sourceforge.pmd.annotation.InternalApi;
 import net.sourceforge.pmd.reporting.GlobalAnalysisListener;
 
 /**
- * Gives access to package private methods.
+ * Internal API.
+ *
+ * <p>Acts as a bridge between outer parts of PMD and the restricted access
+ * internal API of this package.
+ *
+ * <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
 public final class InternalApiBridge {
-    private InternalApiBridge() {
+    private InternalApiBridge() {}
-        // utility class
-    }
 
     public static GlobalAnalysisListener newListener(Formatter formatter, Project project) throws IOException {
         return formatter.newListener(project);

pmd-apex/src/main/java/net/sourceforge/pmd/lang/apex/multifile/InternalApiBridge.java

@@ -8,13 +8,19 @@ import net.sourceforge.pmd.annotation.InternalApi;
 import net.sourceforge.pmd.lang.apex.ApexLanguageProperties;
 
 /**
+ * Internal API.
+ *
+ * <p>Acts as a bridge between outer parts of PMD and the restricted access
+ * internal API of this package.
+ *
+ * <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
 public final class InternalApiBridge {
-    private InternalApiBridge() {
+    private InternalApiBridge() {}
-        // utility class
-    }
 
     public static ApexMultifileAnalysis createApexMultiFileAnalysis(ApexLanguageProperties properties) {
         return new ApexMultifileAnalysis(properties);

pmd-core/src/main/java/net/sourceforge/pmd/InternalApiBridge.java

@@ -8,15 +8,19 @@ import net.sourceforge.pmd.annotation.InternalApi;
 import net.sourceforge.pmd.reporting.FileAnalysisListener;
 
 /**
- * Makes package private methods available for other packages. This is only internal.
+ * Internal API.
+ *
+ * <p>Acts as a bridge between outer parts of PMD and the restricted access
+ * internal API of this package.
+ *
+ * <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
 public final class InternalApiBridge {
-    private InternalApiBridge() {
+    private InternalApiBridge() {}
-        // utility class
-    }
 
     public static Rule getRule(RuleContext ruleContext) {
         return ruleContext.getRule();

pmd-core/src/main/java/net/sourceforge/pmd/lang/InternalApiBridge.java

@@ -15,6 +15,14 @@ import net.sourceforge.pmd.util.log.PmdReporter;
 
 /**
  * Internal API.
+ *
+ * <p>Acts as a bridge between outer parts of PMD and the restricted access
+ * internal API of this package.
+ *
+ * <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
 public final class InternalApiBridge {

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

@@ -35,7 +35,9 @@ import net.sourceforge.pmd.lang.java.types.internal.infer.TypeInferenceLogger;
 import net.sourceforge.pmd.util.AssertionUtil;
 
 /**
- * Acts as a bridge between outer parts of PMD and the restricted access
+ * Internal API.
+ *
+ * <p>Acts as a bridge between outer parts of PMD and the restricted access
  * internal API of this package.
  *
  * <p><b>None of this is published API, and compatibility can be broken anytime!</b>
@@ -43,14 +45,11 @@ import net.sourceforge.pmd.util.AssertionUtil;
  *
  * @author Clément Fournier
  * @since 7.0.0
+ * @apiNote Internal API
  */
 @InternalApi
 public final class InternalApiBridge {
-
+    private InternalApiBridge() {}
-
-    private InternalApiBridge() {
-
-    }
 
     @Deprecated
     public static ASTVariableId newVarId(String image) {

pmd-java/src/main/java/net/sourceforge/pmd/lang/java/types/InternalApiBridge.java

@@ -7,13 +7,19 @@ package net.sourceforge.pmd.lang.java.types;
 import net.sourceforge.pmd.annotation.InternalApi;
 
 /**
+ * Internal API.
+ *
+ * <p>Acts as a bridge between outer parts of PMD and the restricted access
+ * internal API of this package.
+ *
+ * <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
 public final class InternalApiBridge {
-    private InternalApiBridge() {
+    private InternalApiBridge() {}
-        // internal api
-    }
 
     public static boolean isSameTypeInInference(JTypeMirror t, JTypeMirror s) {
         return TypeOps.isSameTypeInInference(t, s);

pmd-java/src/main/java/net/sourceforge/pmd/lang/java/types/ast/InternalApiBridge.java

@@ -14,13 +14,19 @@ import net.sourceforge.pmd.lang.java.types.ast.internal.RegularCtx;
 import net.sourceforge.pmd.util.AssertionUtil;
 
 /**
+ * Internal API.
+ *
+ * <p>Acts as a bridge between outer parts of PMD and the restricted access
+ * internal API of this package.
+ *
+ * <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
 public final class InternalApiBridge {
-    private InternalApiBridge() {
+    private InternalApiBridge() {}
-        // utility
-    }
 
     public static boolean canGiveContextToPoly(ExprContext exprContext, boolean lambdaOrMethodRef) {
         return exprContext.canGiveContextToPoly(lambdaOrMethodRef);

pmd-jsp/src/main/java/net/sourceforge/pmd/lang/jsp/ast/InternalApiBridge.java

@@ -8,13 +8,19 @@ import net.sourceforge.pmd.annotation.InternalApi;
 import net.sourceforge.pmd.lang.ast.impl.javacc.JavaccTokenDocument;
 
 /**
+ * Internal API.
+ *
+ * <p>Acts as a bridge between outer parts of PMD and the restricted access
+ * internal API of this package.
+ *
+ * <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
 public final class InternalApiBridge {
-    private InternalApiBridge() {
+    private InternalApiBridge() {}
-        // internal
-    }
 
     public static JavaccTokenDocument.TokenDocumentBehavior getJspTokenBehavior() {
         return JspParser.TOKEN_BEHAVIOR;

pmd-modelica/src/main/java/net/sourceforge/pmd/lang/modelica/ast/InternalApiBridge.java

@@ -10,6 +10,17 @@ import net.sourceforge.pmd.lang.modelica.resolver.ModelicaScope;
 import net.sourceforge.pmd.lang.modelica.resolver.internal.ResolutionContext;
 import net.sourceforge.pmd.lang.modelica.resolver.internal.Watchdog;
 
+/**
+ * Internal API.
+ *
+ * <p>Acts as a bridge between outer parts of PMD and the restricted access
+ * internal API of this package.
+ *
+ * <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
 public final class InternalApiBridge {
     private InternalApiBridge() {}

pmd-modelica/src/main/java/net/sourceforge/pmd/lang/modelica/resolver/InternalApiBridge.java

@@ -11,6 +11,17 @@ import net.sourceforge.pmd.lang.modelica.ast.Visibility;
 import net.sourceforge.pmd.lang.modelica.resolver.internal.ResolutionContext;
 import net.sourceforge.pmd.lang.modelica.resolver.internal.Watchdog;
 
+/**
+ * Internal API.
+ *
+ * <p>Acts as a bridge between outer parts of PMD and the restricted access
+ * internal API of this package.
+ *
+ * <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
 public final class InternalApiBridge {
     private InternalApiBridge() {}

pmd-plsql/src/main/java/net/sourceforge/pmd/lang/plsql/ast/InternalApiBridge.java

@@ -10,17 +10,20 @@ import net.sourceforge.pmd.lang.symboltable.NameDeclaration;
 import net.sourceforge.pmd.lang.symboltable.Scope;
 
 /**
- * Acts as a bridge between outer parts (e.g. symbol table) and the restricted
+ * Internal API.
- * access internal API of this package.
+ *
- * 
+ * <p>Acts as a bridge between outer parts of PMD and the restricted access
- * @apiNote  This is internal API.
+ * internal API of this package.
+ *
+ * <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
 public final class InternalApiBridge {
 
-    private InternalApiBridge() {
+    private InternalApiBridge() {}
-        
-    }
 
     public static void setScope(PLSQLNode node, Scope decl) {
         ((AbstractPLSQLNode) node).setScope(decl);

pmd-visualforce/src/main/java/net/sourceforge/pmd/lang/vf/ast/InternalApiBridge.java

@@ -8,14 +8,19 @@ import net.sourceforge.pmd.annotation.InternalApi;
 import net.sourceforge.pmd.lang.vf.DataType;
 
 /**
- * This is internal API, and can be changed at any time.
+ * Internal API.
+ *
+ * <p>Acts as a bridge between outer parts of PMD and the restricted access
+ * internal API of this package.
+ *
+ * <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
 public final class InternalApiBridge {
-
+    private InternalApiBridge() {}
-    private InternalApiBridge() {
-        // utility class
-    }
 
     public static void setDataType(VfTypedNode node, DataType dataType) {
         ((AbstractVFDataNode) node).setDataType(dataType);