Fix Javadoc doclint WARNING messages on Java 17.

2 files changed, 21 insertions, 5 deletions

diff --git a/src/main/java/org/apache/commons/lang3/time/FastDateFormat.java b/src/main/java/org/apache/commons/lang3/time/FastDateFormat.java
index ecc7f6420..893b477dc 100644
--- a/src/main/java/org/apache/commons/lang3/time/FastDateFormat.java
+++ b/src/main/java/org/apache/commons/lang3/time/FastDateFormat.java
@@ -106,7 +106,10 @@ public class FastDateFormat extends Format implements DateParser, DatePrinter {
         }
     };
 
+    /** Our fast printer. */
     private final FastDatePrinter printer;
+
+    /** Our fast parser. */
     private final FastDateParser parser;
 
     /**
diff --git a/src/main/java/org/apache/commons/lang3/time/FastDateParser.java b/src/main/java/org/apache/commons/lang3/time/FastDateParser.java
index fea334711..8b70a257a 100644
--- a/src/main/java/org/apache/commons/lang3/time/FastDateParser.java
+++ b/src/main/java/org/apache/commons/lang3/time/FastDateParser.java
@@ -83,19 +83,32 @@ public class FastDateParser implements DateParser, Serializable {
 
     static final Locale JAPANESE_IMPERIAL = new Locale("ja", "JP", "JP");
 
-    // defining fields
+    /** Input pattern. */
     private final String pattern;
+
+    /** Input TimeZone. */
     private final TimeZone timeZone;
+    
+    /** Input Locale. */
     private final Locale locale;
+    
+    /**
+     * Century from Date.
+     */
     private final int century;
+
+    /**
+     * Start year from Date.
+     */
     private final int startYear;
 
-    // derived fields
+    /** Initialized from Calendar. */
     private transient List<StrategyAndWidth> patterns;
 
-    // comparator used to sort regex alternatives
-    // alternatives should be ordered longer first, and shorter last. ('february' before 'feb')
-    // all entries must be lowercase by locale.
+    /**
+     * comparator used to sort regex alternatives. Alternatives should be ordered longer first, and shorter last.
+     * ('february' before 'feb'). All entries must be lower-case by locale.
+     */
     private static final Comparator<String> LONGER_FIRST_LOWERCASE = Comparator.reverseOrder();
 
     /**