Deprecate Lexer.nextList and related code

src/main/java/org/sablecc/sablecc/lexer/Lexer.java

@@ -27,8 +27,14 @@ public class Lexer
     private boolean eof;
     private final StringBuilder text = new StringBuilder();
 
+    @Deprecated
     private final Queue<IToken> nextList = new LinkedList<IToken>();
 
+    /**
+     * @deprecated Use {@link #token} to get, modify, replace, and/or delete the current token.
+     *     Injecting new tokens into the token stream will not be supported in the future.
+     */
+    @Deprecated
     public Queue<IToken> getNextList() {
         return nextList;
     }
@@ -38,6 +44,10 @@ public class Lexer
         // Do nothing
     }
 
+    /**
+     * @deprecated Override {@link #filter()} instead.
+     */
+    @Deprecated
     protected void filterWrap() throws LexerException, IOException
     {
         filter();
@@ -52,6 +62,7 @@ public class Lexer
         this.in = in;
     }
 
+    @SuppressWarnings("deprecation") // because of filterWrap and nextList
     public Token peek() throws LexerException, IOException
     {
         while(this.token == null)
@@ -63,6 +74,7 @@ public class Lexer
         return (Token) nextList.peek();
     }
 
+    @SuppressWarnings("deprecation") // because of filterWrap and nextList
     public Token next() throws LexerException, IOException
     {
         while(this.token == null)

src/main/resources/org/sablecc/sablecc/lexer.txt

@@ -51,8 +51,14 @@ public class Lexer
     private boolean eof;
     private final StringBuilder text = new StringBuilder();
 
+    @Deprecated
     private final Queue<IToken> nextList = new LinkedList<IToken>();
 
+    /**
+     * @deprecated Use {@link #token} to get, modify, replace, and/or delete the current token.
+     *     Injecting new tokens into the token stream will not be supported in the future.
+     */
+    @Deprecated
     public Queue<IToken> getNextList() {
         return nextList;
     }
@@ -62,6 +68,10 @@ public class Lexer
         // Do nothing
     }
 
+    /**
+     * @deprecated Override {@link #filter()} instead.
+     */
+    @Deprecated
     protected void filterWrap() throws LexerException, IOException
     {
         filter();
@@ -76,6 +86,7 @@ public class Lexer
         this.in = in;
     }
 
+    @SuppressWarnings("deprecation") // because of filterWrap and nextList
     public Token peek() throws LexerException, IOException
     {
         while(this.token == null)
@@ -87,6 +98,7 @@ public class Lexer
         return (Token) nextList.peek();
     }
 
+    @SuppressWarnings("deprecation") // because of filterWrap and nextList
     public Token next() throws LexerException, IOException
     {
         while(this.token == null)