From d2d881f23777d245a9416ee3fce71dbef7b5f3c7 Mon Sep 17 00:00:00 2001
From: Calixte Bonsart <calixte@bonsart.fr>
Date: Tue, 21 Apr 2026 16:39:57 -0400
Subject: [PATCH] Issue #451: add JavadocType to checkstyle config

---
 config/checkstyle-checks.xml                    |  4 ++++
 .../core/config/meta/RuleMetadata.java          | 17 +++++++++++++++++
 2 files changed, 21 insertions(+)

diff --git a/config/checkstyle-checks.xml b/config/checkstyle-checks.xml
index 9e9f0fe18..ea26192f8 100644
--- a/config/checkstyle-checks.xml
+++ b/config/checkstyle-checks.xml
@@ -606,6 +606,10 @@
             <property name="scope" value="public"/>
         </module>
         <module name="JavadocTagContinuationIndentation"/>
+        <module name="JavadocType">
+            <!-- avoid errors on tag '@noinspection' -->
+            <property name="allowUnknownTags" value="true"/>
+        </module>
         <module name="SingleLineJavadoc"/>
 
         <!-- Metrics -->
diff --git a/net.sf.eclipsecs.core/src/net/sf/eclipsecs/core/config/meta/RuleMetadata.java b/net.sf.eclipsecs.core/src/net/sf/eclipsecs/core/config/meta/RuleMetadata.java
index 0cc90a9e7..dbd11ecd7 100644
--- a/net.sf.eclipsecs.core/src/net/sf/eclipsecs/core/config/meta/RuleMetadata.java
+++ b/net.sf.eclipsecs.core/src/net/sf/eclipsecs/core/config/meta/RuleMetadata.java
@@ -26,6 +26,23 @@
 
 /**
  * This class contains the metadata that describes a check rule.
+ *
+ * @param identity
+ *          the identity of the rule (name, internal name, etc.)
+ * @param defaultSeverity
+ *          the default severity level
+ * @param hidden
+ *          <code>true</code> if the rule should be hidden from the user
+ * @param hasSeverity
+ *          <code>true</code> if the rule has a severity level
+ * @param deletable
+ *          <code>true</code> if the rule is deletable
+ * @param isSingleton
+ *          <code>true</code> if the rule is a singleton
+ * @param messageKeys
+ *          the message keys supported by the rule
+ * @param configPropMetadata
+ *          the property metadata for the rule
  */
 public record RuleMetadata(RuleIdentity identity, Severity defaultSeverity, boolean hidden,
         boolean hasSeverity, boolean deletable, boolean isSingleton, List<String> messageKeys,