[core] Add deprecations for ParametricRuleViolation and ParserOptions#suppressMarker

docs/pages/release_notes.md

@@ -38,6 +38,8 @@ You can identify them with the `@InternalApi` annotation. You'll also get a depr
 *   {% jdoc !!javascript::lang.ecmascript.Ecmascript3Parser %}
 *   {% jdoc !!javascript::lang.ecmascript.ast.EcmascriptParser#parserOptions %}
 *   {% jdoc !!javascript::lang.ecmascript.ast.EcmascriptParser#getSuppressMap() %}
+*   {% jdoc !!core::lang.rule.ParametricRuleViolation %}
+*   {% jdoc !!core::lang.ParserOptions#suppressMarker %}
 
 
 ### External Contributions

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

@@ -11,6 +11,10 @@ package net.sourceforge.pmd.lang;
  * {@link Object#hashCode()}.
  */
 public class ParserOptions {
+    /**
+     * @deprecated Use {@link #getSuppressMarker()} instead.
+     */
+    @Deprecated
     protected String suppressMarker;
 
     public String getSuppressMarker() {

pmd-core/src/main/java/net/sourceforge/pmd/lang/rule/ParametricRuleViolation.java

@@ -10,10 +10,16 @@ import java.util.regex.Pattern;
 import net.sourceforge.pmd.Rule;
 import net.sourceforge.pmd.RuleContext;
 import net.sourceforge.pmd.RuleViolation;
+import net.sourceforge.pmd.annotation.InternalApi;
 import net.sourceforge.pmd.lang.ast.Node;
 import net.sourceforge.pmd.properties.PropertyDescriptor;
 import net.sourceforge.pmd.util.StringUtil;
 
+/**
+ * @deprecated This is internal. Clients should exclusively use {@link RuleViolation}.
+ */
+@Deprecated
+@InternalApi
 public class ParametricRuleViolation<T extends Node> implements RuleViolation {
 
     protected final Rule rule;