From f6d6c4c241ad18b62719b216f0983874057712fe Mon Sep 17 00:00:00 2001
From: Bauke Scholtz <balusc@gmail.com>
Date: Sat, 21 Dec 2024 10:31:42 -0400
Subject: [PATCH] Deprecate h:form prependId attribute without replacement
 https://github.com/jakartaee/faces/issues/1972

---
 api/src/main/java/jakarta/faces/component/UIForm.java | 6 ++++++
 api/src/main/vdldoc/faces.html.taglib.xml             | 6 ++++++
 2 files changed, 12 insertions(+)

diff --git a/api/src/main/java/jakarta/faces/component/UIForm.java b/api/src/main/java/jakarta/faces/component/UIForm.java
index a153a417d3..a47a372981 100644
--- a/api/src/main/java/jakarta/faces/component/UIForm.java
+++ b/api/src/main/java/jakarta/faces/component/UIForm.java
@@ -70,7 +70,9 @@ enum PropertyKeys {
          * <p>
          * The prependId flag.
          * </p>
+         * @deprecated This attribute breaks the {@link UIComponent#findComponent(String)}.
          */
+        @Deprecated(since = "5.0", forRemoval = true)
         prependId,
 
         /**
@@ -146,7 +148,9 @@ public void setSubmitted(boolean submitted) {
      * Is the id prepended.
      *
      * @return <code>true</code> if it is, <code>false</code> otherwise.
+     * @deprecated This attribute breaks the {@link UIComponent#findComponent(String)}.
      */
+    @Deprecated(since = "5.0", forRemoval = true)
     public boolean isPrependId() {
         return (Boolean) getStateHelper().eval(PropertyKeys.prependId, true);
     }
@@ -155,7 +159,9 @@ public boolean isPrependId() {
      * Set whether the id should be prepended.
      * 
      * @param prependId <code>true</code> if it is, <code>false</code> otherwise.
+     * @deprecated This attribute breaks the {@link UIComponent#findComponent(String)}.
      */
+    @Deprecated(since = "5.0", forRemoval = true)
     public void setPrependId(boolean prependId) {
         getStateHelper().put(PropertyKeys.prependId, prependId);
     }
diff --git a/api/src/main/vdldoc/faces.html.taglib.xml b/api/src/main/vdldoc/faces.html.taglib.xml
index e3c2ec8a67..95a37fbec8 100644
--- a/api/src/main/vdldoc/faces.html.taglib.xml
+++ b/api/src/main/vdldoc/faces.html.taglib.xml
@@ -3356,9 +3356,15 @@
         </attribute>
         <attribute>
             <description>
+                <![CDATA[
+                <strong>
+                    The use of this attribute has been <a href="https://github.com/jakartaee/faces/issues/1972">deprecated</a> in Faces 5.0, without replacement.
+                </strong>
+                <br/><br/>
                 Flag indicating whether or not this form should prepend its id
                 to its descendent's id during the clientId generation process.
                 If this flag is not set, the default value is true.
+                ]]>
             </description>
             <name>prependId</name>
             <required>false</required>