diff --git a/src/main/java/org/sablecc/sablecc/lexer/Lexer.java b/src/main/java/org/sablecc/sablecc/lexer/Lexer.java
index 43c6fda5dfab8fdd431b3ac2a5e0675e8e774f16..e446b3823080c43b29d0a49d1af1116a9e736f20 100644
--- a/src/main/java/org/sablecc/sablecc/lexer/Lexer.java
+++ b/src/main/java/org/sablecc/sablecc/lexer/Lexer.java
@@ -597,6 +597,8 @@ public class Lexer
      * @deprecated This method doesn't restore line/column info correctly in some cases
      *     (if a token begins in the middle of a CRLF newline pair).
      *     There is no planned replacement.
+     * @param token the token to push back onto the input
+     * @throws IOException when thrown by {@link PushbackReader#unread(int)}
      */
     @Deprecated
     protected void unread(Token token) throws IOException
diff --git a/src/main/resources/org/sablecc/sablecc/lexer.txt b/src/main/resources/org/sablecc/sablecc/lexer.txt
index 5960c9fcf0df41994e2db59ba37548956b7390e0..156e5fc65e249dbd2972cacb24bcc9f532a50c13 100644
--- a/src/main/resources/org/sablecc/sablecc/lexer.txt
+++ b/src/main/resources/org/sablecc/sablecc/lexer.txt
@@ -296,6 +296,8 @@ Macro:LexerBody
      * @deprecated This method doesn't restore line/column info correctly in some cases
      *     (if a token begins in the middle of a CRLF newline pair).
      *     There is no planned replacement.
+     * @param token the token to push back onto the input
+     * @throws IOException when thrown by {@link PushbackReader#unread(int)}
      */
     @Deprecated
     protected void unread(Token token) throws IOException