diff --git a/docs/pages/release_notes.md b/docs/pages/release_notes.md index b8f8783555..de2569ac87 100644 --- a/docs/pages/release_notes.md +++ b/docs/pages/release_notes.md @@ -18,6 +18,15 @@ This is a {{ site.pmd.release_type }} release. ### API Changes +#### Deprecated APIs + +##### Internal API + +Those APIs are not intended to be used by clients, and will be hidden or removed with PMD 7.0.0. +You can identify them with the `@InternalApi` annotation. You'll also get a deprecation warning. + +* {% jdoc vm::lang.vm.VmTokenManager %} + ### External Contributions {% endtocmaker %} diff --git a/pmd-vm/src/main/java/net/sourceforge/pmd/lang/vm/VmParser.java b/pmd-vm/src/main/java/net/sourceforge/pmd/lang/vm/VmParser.java index 69276ba09c..4fa9ab1225 100644 --- a/pmd-vm/src/main/java/net/sourceforge/pmd/lang/vm/VmParser.java +++ b/pmd-vm/src/main/java/net/sourceforge/pmd/lang/vm/VmParser.java @@ -10,6 +10,7 @@ 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; diff --git a/pmd-vm/src/main/java/net/sourceforge/pmd/lang/vm/VmTokenManager.java b/pmd-vm/src/main/java/net/sourceforge/pmd/lang/vm/VmTokenManager.java index 55669a4bd6..0ae645a238 100644 --- a/pmd-vm/src/main/java/net/sourceforge/pmd/lang/vm/VmTokenManager.java +++ b/pmd-vm/src/main/java/net/sourceforge/pmd/lang/vm/VmTokenManager.java @@ -6,11 +6,21 @@ package net.sourceforge.pmd.lang.vm; import java.io.Reader; +import net.sourceforge.pmd.annotation.InternalApi; +import net.sourceforge.pmd.lang.LanguageVersionHandler; +import net.sourceforge.pmd.lang.Parser; import net.sourceforge.pmd.lang.TokenManager; import net.sourceforge.pmd.lang.ast.AbstractTokenManager; import net.sourceforge.pmd.lang.vm.ast.VmParserTokenManager; import net.sourceforge.pmd.lang.vm.util.VelocityCharStream; +/** + * + * @deprecated This is internal API, use {@link Parser#getTokenManager(String, Reader)} via + * {@link LanguageVersionHandler#getParser(ParserOptions)}. + */ +@Deprecated +@InternalApi public class VmTokenManager implements TokenManager { private final VmParserTokenManager vmParserTokenManager;