From e97ca3ac3c1281936b7c5a0054c6352fa6c7bb9d Mon Sep 17 00:00:00 2001
From: dgelessus <dgelessus@users.noreply.github.com>
Date: Mon, 6 May 2024 23:13:42 +0200
Subject: [PATCH] Expand Javadoc for generated deprecated Lexer.unread method

To fix downstream Javadoc warnings about missing param/throws info.
---
 src/main/java/org/sablecc/sablecc/lexer/Lexer.java | 2 ++
 src/main/resources/org/sablecc/sablecc/lexer.txt   | 2 ++
 2 files changed, 4 insertions(+)

diff --git a/src/main/java/org/sablecc/sablecc/lexer/Lexer.java b/src/main/java/org/sablecc/sablecc/lexer/Lexer.java
index 43c6fda..e446b38 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 5960c9f..156e5fc 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
-- 
GitLab