Deprecate tokManagers for more module

docs/pages/release_notes.md

@@ -78,6 +78,11 @@ implementations, and their corresponding Parser if it exists (in the same packag
 *   {% jdoc visualforce::lang.vf.VfTokenManager %}
 *   {% jdoc plsql::lang.plsql.PLSQLTokenManager %}
 *   {% jdoc jsp::lang.jsp.JspTokenManager %}
+*   {% jdoc modelica::lang.modelica.ModelicaTokenManager %}
+*   {% jdoc cpp::lang.cpp.CppTokenManager %}
+*   {% jdoc javascript::lang.ecmascript5.Ecmascript5TokenManager %}
+*   {% jdoc matlab::lang.matlab.MatlabTokenManager %}
+*   {% jdoc objectivec::lang.objectivec.ObjectiveCTokenManager %}
 
 
 ### External Contributions

pmd-cpp/src/main/java/net/sourceforge/pmd/lang/cpp/CppTokenManager.java

@@ -6,12 +6,17 @@ package net.sourceforge.pmd.lang.cpp;
 
 import java.io.Reader;
 
+import net.sourceforge.pmd.annotation.InternalApi;
 import net.sourceforge.pmd.lang.TokenManager;
 import net.sourceforge.pmd.lang.cpp.ast.CppParserTokenManager;
 
 /**
  * C++ Token Manager implementation.
+ *
+ * @deprecated This is internal API
  */
+@Deprecated
+@InternalApi
 public class CppTokenManager implements TokenManager {
     private final CppParserTokenManager tokenManager;
 

pmd-javascript/src/main/java/net/sourceforge/pmd/lang/ecmascript5/Ecmascript5TokenManager.java

@@ -6,13 +6,18 @@ package net.sourceforge.pmd.lang.ecmascript5;
 
 import java.io.Reader;
 
+import net.sourceforge.pmd.annotation.InternalApi;
 import net.sourceforge.pmd.lang.TokenManager;
 import net.sourceforge.pmd.lang.ast.SimpleCharStream;
 import net.sourceforge.pmd.lang.ecmascript5.ast.Ecmascript5ParserTokenManager;
 
 /**
  * Ecmascript 5 Token Manager implementation.
+ *
+ * @deprecated This is internal API
  */
+@Deprecated
+@InternalApi
 public class Ecmascript5TokenManager implements TokenManager {
     private final Ecmascript5ParserTokenManager tokenManager;
 

pmd-matlab/src/main/java/net/sourceforge/pmd/lang/matlab/MatlabTokenManager.java

@@ -6,13 +6,18 @@ package net.sourceforge.pmd.lang.matlab;
 
 import java.io.Reader;
 
+import net.sourceforge.pmd.annotation.InternalApi;
 import net.sourceforge.pmd.lang.TokenManager;
 import net.sourceforge.pmd.lang.ast.SimpleCharStream;
 import net.sourceforge.pmd.lang.matlab.ast.MatlabParserTokenManager;
 
 /**
  * Matlab Token Manager implementation.
+ *
+ * @deprecated This is internal API
  */
+@Deprecated
+@InternalApi
 public class MatlabTokenManager implements TokenManager {
     private final MatlabParserTokenManager tokenManager;
 

pmd-modelica/src/main/java/net/sourceforge/pmd/lang/modelica/ModelicaParser.java

@@ -8,7 +8,9 @@ import java.io.Reader;
 import java.util.HashMap;
 import java.util.Map;
 
+import net.sourceforge.pmd.annotation.InternalApi;
 import net.sourceforge.pmd.lang.AbstractParser;
+import net.sourceforge.pmd.lang.LanguageVersionHandler;
 import net.sourceforge.pmd.lang.ParserOptions;
 import net.sourceforge.pmd.lang.TokenManager;
 import net.sourceforge.pmd.lang.ast.AbstractTokenManager;
@@ -16,7 +18,11 @@ import net.sourceforge.pmd.lang.ast.Node;
 import net.sourceforge.pmd.lang.ast.ParseException;
 import net.sourceforge.pmd.lang.ast.SimpleCharStream;
 
-
+/**
+ * @deprecated This is internal API, use {@link LanguageVersionHandler#getParser(ParserOptions)}.
+ */
+@InternalApi
+@Deprecated
 public class ModelicaParser extends AbstractParser {
     public ModelicaParser(final ParserOptions parserOptions) {
         super(parserOptions);

pmd-modelica/src/main/java/net/sourceforge/pmd/lang/modelica/ModelicaTokenManager.java

@@ -6,13 +6,20 @@ package net.sourceforge.pmd.lang.modelica;
 
 import java.io.Reader;
 
+import net.sourceforge.pmd.annotation.InternalApi;
 import net.sourceforge.pmd.lang.TokenManager;
 import net.sourceforge.pmd.lang.ast.AbstractTokenManager;
 import net.sourceforge.pmd.lang.ast.SimpleCharStream;
 import net.sourceforge.pmd.lang.modelica.ast.ModelicaParserTokenManager;
 
 
+/**
+ * @deprecated This is internal API
+ */
+@Deprecated
+@InternalApi
 public class ModelicaTokenManager implements TokenManager {
+
     private final ModelicaParserTokenManager modelicaParserTokenManager;
 
     public ModelicaTokenManager(final Reader source) {

pmd-objectivec/src/main/java/net/sourceforge/pmd/lang/objectivec/ObjectiveCTokenManager.java

@@ -6,13 +6,18 @@ package net.sourceforge.pmd.lang.objectivec;
 
 import java.io.Reader;
 
+import net.sourceforge.pmd.annotation.InternalApi;
 import net.sourceforge.pmd.lang.TokenManager;
 import net.sourceforge.pmd.lang.ast.SimpleCharStream;
 import net.sourceforge.pmd.lang.objectivec.ast.ObjectiveCParserTokenManager;
 
 /**
  * Objective-C Token Manager implementation.
+ *
+ * @deprecated This is internal API
  */
+@Deprecated
+@InternalApi
 public class ObjectiveCTokenManager implements TokenManager {
     private final ObjectiveCParserTokenManager tokenManager;