Deprecate generated parser implementations

docs/pages/release_notes.md

@@ -17,6 +17,15 @@ This is a {{ site.pmd.release_type }} release.
 ### 🐛 Fixed Issues
 
 ### 🚨 API Changes
+* pmd-jsp
+  * {%jdoc jsp::lang.jsp.ast.JspParserImpl %} is deprecated now. It should have been package-private
+    because this is an implementation class that should not be used directly.
+* pmd-velocity
+  * {%jdoc velocity::lang.velocity.ast.VtlParserImpl %} is deprecated now. It should have been package-private
+    because this is an implementation class that should not be used directly.
+* pmd-visualforce
+  * {%jdoc visualforce::lang.visualforce.ast.VfParserImpl %} is deprecated now. It should have been package-private
+    because this is an implementation class that should not be used directly.
 
 ### ✨ External Contributions
 

pmd-jsp/etc/grammar/Jsp.jjt

@@ -33,7 +33,10 @@ package net.sourceforge.pmd.lang.jsp.ast;
 /**
  * JSP Parser for PMD.
  * @author Pieter, Application Engineers NV/SA, http://www.ae.be
+ * @deprecated Since 7.5.0. JspParserImpl should have been package private because this is an implementation class
+ * that should not be used directly.
  */
+@Deprecated
 public class JspParserImpl {
 
 

pmd-plsql/etc/grammar/PLSQL.jjt

@@ -176,7 +176,7 @@ import java.util.ArrayList;
 import java.util.List;
 
 /**
- * @deprecated PLSQLParserImpl should have been package private because this is an implementation class
+ * @deprecated Since 7.3.0. PLSQLParserImpl should have been package private because this is an implementation class
  * that should not be used directly.
  */
 @Deprecated

pmd-velocity/etc/grammar/Vtl.jjt

@@ -58,7 +58,10 @@ import net.sourceforge.pmd.lang.ast.impl.javacc.JavaccToken;
  * @author <a href="mailto:geirm@optonline.net">Geir Magnusson Jr.</a>
  * @author <a href="hps@intermeta.de">Henning P. Schmiedehausen</a>
  * @version $Id$
-*/
+ * @deprecated Since 7.5.0. VtlParserImpl should have been package private because this is an implementation class
+ * that should not be used directly.
+ */
+@Deprecated
 public class VtlParserImpl
 {
   private void throwParseException(String message) {

pmd-visualforce/etc/grammar/Vf.jjt

@@ -13,6 +13,11 @@ options {
 PARSER_BEGIN(VfParserImpl)
 package net.sourceforge.pmd.lang.visualforce.ast;
 
+/**
+ * @deprecated Since 7.5.0. VfParserImpl should have been package private because this is an implementation class
+ * that should not be used directly.
+ */
+@Deprecated
 public class VfParserImpl {