diff --git a/docs/pages/release_notes.md b/docs/pages/release_notes.md
index 4f08b71536..4587ebc64f 100644
--- a/docs/pages/release_notes.md
+++ b/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
diff --git a/pmd-core/src/main/java/net/sourceforge/pmd/lang/ParserOptions.java b/pmd-core/src/main/java/net/sourceforge/pmd/lang/ParserOptions.java
index e379d05e5f..1a5d5b20fc 100644
--- a/pmd-core/src/main/java/net/sourceforge/pmd/lang/ParserOptions.java
+++ b/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() {
diff --git a/pmd-core/src/main/java/net/sourceforge/pmd/lang/rule/ParametricRuleViolation.java b/pmd-core/src/main/java/net/sourceforge/pmd/lang/rule/ParametricRuleViolation.java
index 2936a05b78..a41319dfac 100644
--- a/pmd-core/src/main/java/net/sourceforge/pmd/lang/rule/ParametricRuleViolation.java
+++ b/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;