(struts) 05/24: WW-5694 docs(validation): scope the deprecation banner to the validate attribute

[lu...@apache.org]

This is an automated email from the ASF dual-hosted git repository.

lukaszlenart pushed a commit to branch feature/WW-5695-html5-constraint-validation
in repository https://gitbox.apache.org/repos/asf/struts.git

commit 0e8b4b35939fd4dd4523eea56030b62ced72df65
Author: Lukasz Lenart <lu...@apache.org>
AuthorDate: Mon Aug 24 19:42:58 2026 +0200

    WW-5694 docs(validation): scope the deprecation banner to the validate attribute
    
    The javadoc SNIPPET block published on struts.apache.org read as a
    blanket deprecation of <s:form> itself, with no replacement mentioned.
    Reword and move the banner to the end of the javadoc snippet so it
    explicitly scopes the deprecation to the validate attribute and the
    client-side JS behind it; the form tag itself is not deprecated.
    
    Co-Authored-By: Claude Opus 5 <no...@anthropic.com>
---
 core/src/main/java/org/apache/struts2/components/Form.java | 4 +++-
 1 file changed, 3 insertions(+), 1 deletion(-)

diff --git a/core/src/main/java/org/apache/struts2/components/Form.java b/core/src/main/java/org/apache/struts2/components/Form.java
index 250c9b57d..f970efe56 100644
--- a/core/src/main/java/org/apache/struts2/components/Form.java
+++ b/core/src/main/java/org/apache/struts2/components/Form.java
@@ -48,7 +48,6 @@ import java.util.Set;
 
 /**
  * <!-- START SNIPPET: javadoc -->
- * <strong>Deprecated since 7.4.0 — use the html5 theme's constraint attributes instead. Removed in 8.0.0.</strong>
  * <p>
  * Renders HTML an input form.
  * </p>
@@ -78,6 +77,9 @@ import java.util.Set;
  * </li>
  * </ol>
  * <p>
+ * <strong>The client-side JS <code>validate</code> attribute is deprecated since 7.4.0 — use the html5 theme's
+ * constraint attributes instead. Removed in 8.0.0.</strong>
+ * </p>
  * <!-- END SNIPPET: javadoc -->
  *
  * <p><b>Examples</b></p>