comments
diff --git a/api/src/main/java/javax/faces/component/UIComponentBase.java b/api/src/main/java/javax/faces/component/UIComponentBase.java
index 832182f..03fea97 100755
--- a/api/src/main/java/javax/faces/component/UIComponentBase.java
+++ b/api/src/main/java/javax/faces/component/UIComponentBase.java
@@ -82,7 +82,11 @@
             = "javax.faces.component.UIComponentBase.SHARED_STRING_BUILDER";
 
     static final int RESET_MODE_OFF = 0;
+    // A soft reset clears the "transient" state or those internal attributes used by the component
+    // but it does not clear the "delta" state.
     static final int RESET_MODE_SOFT = 1;
+    // A hard reset destroy both the "transient" state and the "delta" state. If the component cannot be reset,
+    // saveState() should return a non null value.
     static final int RESET_MODE_HARD = 2;
 
     private _ComponentAttributesMap _attributesMap = null;