You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@myfaces.apache.org by lu...@apache.org on 2011/08/23 00:49:43 UTC
svn commit: r1160481 [2/2] - in /myfaces/shared/trunk_4.0.x/core/src/main:
java/org/apache/myfaces/shared/application/
java/org/apache/myfaces/shared/config/
java/org/apache/myfaces/shared/renderkit/
java/org/apache/myfaces/shared/renderkit/html/ java/...
Modified: myfaces/shared/trunk_4.0.x/core/src/main/java/org/apache/myfaces/shared/renderkit/html/HtmlTextRendererBase.java
URL: http://svn.apache.org/viewvc/myfaces/shared/trunk_4.0.x/core/src/main/java/org/apache/myfaces/shared/renderkit/html/HtmlTextRendererBase.java?rev=1160481&r1=1160480&r2=1160481&view=diff
==============================================================================
--- myfaces/shared/trunk_4.0.x/core/src/main/java/org/apache/myfaces/shared/renderkit/html/HtmlTextRendererBase.java (original)
+++ myfaces/shared/trunk_4.0.x/core/src/main/java/org/apache/myfaces/shared/renderkit/html/HtmlTextRendererBase.java Mon Aug 22 22:49:42 2011
@@ -101,36 +101,54 @@ public class HtmlTextRendererBase
escape = RendererUtils.getBooleanAttribute(component, org.apache.myfaces.shared.renderkit.JSFAttr.ESCAPE_ATTR,
true); //default is to escape
}
- renderOutputText(facesContext, component, text, escape);
- }
-
-
- public static void renderOutputText(FacesContext facesContext,
- UIComponent component,
- String text,
- boolean escape)
- throws IOException
- {
if (text != null)
{
ResponseWriter writer = facesContext.getResponseWriter();
boolean span = false;
- if(component.getId()!=null && !component.getId().startsWith(UIViewRoot.UNIQUE_ID_PREFIX))
+ if (isCommonPropertiesOptimizationEnabled(facesContext))
{
- span = true;
-
- writer.startElement(HTML.SPAN_ELEM, component);
-
- HtmlRendererUtils.writeIdIfNecessary(writer, component, facesContext);
-
- HtmlRendererUtils.renderHTMLAttributes(writer, component, HTML.COMMON_PASSTROUGH_ATTRIBUTES);
-
+ long commonPropertiesMarked = CommonPropertyUtils.getCommonPropertiesMarked(component);
+
+ if (commonPropertiesMarked > 0)
+ {
+ span = true;
+ writer.startElement(HTML.SPAN_ELEM, component);
+ HtmlRendererUtils.writeIdIfNecessary(writer, component, facesContext);
+ }
+ else if (CommonPropertyUtils.isIdRenderingNecessary(component))
+ {
+ span = true;
+ writer.startElement(HTML.SPAN_ELEM, component);
+ writer.writeAttribute(HTML.ID_ATTR, component.getClientId(facesContext), null);
+ }
+
+ CommonPropertyUtils.renderUniversalProperties(writer, commonPropertiesMarked, component);
+ CommonPropertyUtils.renderStyleProperties(writer, commonPropertiesMarked, component);
+
+ if (isRenderOutputEventAttributes())
+ {
+ HtmlRendererUtils.renderHTMLAttributes(writer, component, HTML.EVENT_HANDLER_ATTRIBUTES);
+ }
}
else
{
- span = HtmlRendererUtils.renderHTMLAttributesWithOptionalStartElement(writer,component,
- HTML.SPAN_ELEM,HTML.COMMON_PASSTROUGH_ATTRIBUTES);
+ if(component.getId()!=null && !component.getId().startsWith(UIViewRoot.UNIQUE_ID_PREFIX))
+ {
+ span = true;
+
+ writer.startElement(HTML.SPAN_ELEM, component);
+
+ HtmlRendererUtils.writeIdIfNecessary(writer, component, facesContext);
+
+ HtmlRendererUtils.renderHTMLAttributes(writer, component, HTML.COMMON_PASSTROUGH_ATTRIBUTES);
+
+ }
+ else
+ {
+ span = HtmlRendererUtils.renderHTMLAttributesWithOptionalStartElement(writer,component,
+ HTML.SPAN_ELEM,HTML.COMMON_PASSTROUGH_ATTRIBUTES);
+ }
}
if (escape)
@@ -150,6 +168,10 @@ public class HtmlTextRendererBase
}
}
+ protected boolean isRenderOutputEventAttributes()
+ {
+ return true;
+ }
protected void renderInput(FacesContext facesContext, UIComponent component)
throws IOException
@@ -189,11 +211,27 @@ public class HtmlTextRendererBase
HtmlRendererUtils.renderBehaviorizedOnchangeEventHandler(facesContext, writer, component, behaviors);
HtmlRendererUtils.renderBehaviorizedEventHandlers(facesContext, writer, component, behaviors);
HtmlRendererUtils.renderBehaviorizedFieldEventHandlersWithoutOnchange(facesContext, writer, component, behaviors);
- HtmlRendererUtils.renderHTMLAttributes(writer, component, HTML.INPUT_PASSTHROUGH_ATTRIBUTES_WITHOUT_DISABLED_AND_EVENTS);
+ if (isCommonPropertiesOptimizationEnabled(facesContext))
+ {
+ CommonPropertyUtils.renderInputPassthroughPropertiesWithoutDisabledAndEvents(writer,
+ CommonPropertyUtils.getCommonPropertiesMarked(component), component);
+ }
+ else
+ {
+ HtmlRendererUtils.renderHTMLAttributes(writer, component, HTML.INPUT_PASSTHROUGH_ATTRIBUTES_WITHOUT_DISABLED_AND_EVENTS);
+ }
}
else
{
- HtmlRendererUtils.renderHTMLAttributes(writer, component, HTML.INPUT_PASSTHROUGH_ATTRIBUTES_WITHOUT_DISABLED);
+ if (isCommonPropertiesOptimizationEnabled(facesContext))
+ {
+ CommonPropertyUtils.renderInputPassthroughPropertiesWithoutDisabled(writer,
+ CommonPropertyUtils.getCommonPropertiesMarked(component), component);
+ }
+ else
+ {
+ HtmlRendererUtils.renderHTMLAttributes(writer, component, HTML.INPUT_PASSTHROUGH_ATTRIBUTES_WITHOUT_DISABLED);
+ }
}
if (isDisabled(facesContext, component))
@@ -284,5 +322,55 @@ public class HtmlTextRendererBase
//subclasses may act on properties of the component
return HTML.INPUT_TYPE_TEXT;
}
-
+
+ public static void renderOutputText(FacesContext facesContext,
+ UIComponent component, String text, boolean escape)
+ throws IOException
+ {
+ if (text != null)
+ {
+ ResponseWriter writer = facesContext.getResponseWriter();
+ boolean span = false;
+
+ if (component.getId() != null
+ && !component.getId().startsWith(
+ UIViewRoot.UNIQUE_ID_PREFIX))
+ {
+ span = true;
+
+ writer.startElement(HTML.SPAN_ELEM, component);
+
+ HtmlRendererUtils.writeIdIfNecessary(writer, component,
+ facesContext);
+
+ HtmlRendererUtils.renderHTMLAttributes(writer, component,
+ HTML.COMMON_PASSTROUGH_ATTRIBUTES);
+
+ }
+ else
+ {
+ span = HtmlRendererUtils
+ .renderHTMLAttributesWithOptionalStartElement(writer,
+ component, HTML.SPAN_ELEM,
+ HTML.COMMON_PASSTROUGH_ATTRIBUTES);
+ }
+
+ if (escape)
+ {
+ if (log.isLoggable(Level.FINE))
+ log.fine("renderOutputText writing '" + text + "'");
+ writer.writeText(text,
+ org.apache.myfaces.shared.renderkit.JSFAttr.VALUE_ATTR);
+ }
+ else
+ {
+ writer.write(text);
+ }
+
+ if (span)
+ {
+ writer.endElement(org.apache.myfaces.shared.renderkit.html.HTML.SPAN_ELEM);
+ }
+ }
+ }
}
Modified: myfaces/shared/trunk_4.0.x/core/src/main/java/org/apache/myfaces/shared/renderkit/html/HtmlTextareaRendererBase.java
URL: http://svn.apache.org/viewvc/myfaces/shared/trunk_4.0.x/core/src/main/java/org/apache/myfaces/shared/renderkit/html/HtmlTextareaRendererBase.java?rev=1160481&r1=1160480&r2=1160481&view=diff
==============================================================================
--- myfaces/shared/trunk_4.0.x/core/src/main/java/org/apache/myfaces/shared/renderkit/html/HtmlTextareaRendererBase.java (original)
+++ myfaces/shared/trunk_4.0.x/core/src/main/java/org/apache/myfaces/shared/renderkit/html/HtmlTextareaRendererBase.java Mon Aug 22 22:49:42 2011
@@ -98,13 +98,31 @@ public class HtmlTextareaRendererBase
HtmlRendererUtils.renderBehaviorizedOnchangeEventHandler(facesContext, writer, uiComponent, behaviors);
HtmlRendererUtils.renderBehaviorizedEventHandlers(facesContext, writer, uiComponent, behaviors);
HtmlRendererUtils.renderBehaviorizedFieldEventHandlersWithoutOnchange(facesContext, writer, uiComponent, behaviors);
- HtmlRendererUtils.renderHTMLAttributes(writer, uiComponent, HTML.TEXTAREA_PASSTHROUGH_ATTRIBUTES_WITHOUT_DISABLED_AND_EVENTS);
+ if (isCommonPropertiesOptimizationEnabled(facesContext))
+ {
+ CommonPropertyUtils.renderCommonFieldPassthroughPropertiesWithoutDisabledAndEvents(writer,
+ CommonPropertyUtils.getCommonPropertiesMarked(uiComponent), uiComponent);
+ HtmlRendererUtils.renderHTMLAttributes(writer, uiComponent, HTML.TEXTAREA_ATTRIBUTES);
+ }
+ else
+ {
+ HtmlRendererUtils.renderHTMLAttributes(writer, uiComponent, HTML.TEXTAREA_PASSTHROUGH_ATTRIBUTES_WITHOUT_DISABLED_AND_EVENTS);
+ }
}
else
{
HtmlRendererUtils.writeIdIfNecessary(writer, uiComponent, facesContext);
writer.writeAttribute(HTML.NAME_ATTR, uiComponent.getClientId(facesContext), null);
- HtmlRendererUtils.renderHTMLAttributes(writer, uiComponent, HTML.TEXTAREA_PASSTHROUGH_ATTRIBUTES_WITHOUT_DISABLED);
+ if (isCommonPropertiesOptimizationEnabled(facesContext))
+ {
+ CommonPropertyUtils.renderCommonFieldPassthroughPropertiesWithoutDisabled(writer,
+ CommonPropertyUtils.getCommonPropertiesMarked(uiComponent), uiComponent);
+ HtmlRendererUtils.renderHTMLAttributes(writer, uiComponent, HTML.TEXTAREA_ATTRIBUTES);
+ }
+ else
+ {
+ HtmlRendererUtils.renderHTMLAttributes(writer, uiComponent, HTML.TEXTAREA_PASSTHROUGH_ATTRIBUTES_WITHOUT_DISABLED);
+ }
}
if (isDisabled(facesContext, uiComponent))
Modified: myfaces/shared/trunk_4.0.x/core/src/main/java/org/apache/myfaces/shared/resource/ResourceImpl.java
URL: http://svn.apache.org/viewvc/myfaces/shared/trunk_4.0.x/core/src/main/java/org/apache/myfaces/shared/resource/ResourceImpl.java?rev=1160481&r1=1160480&r2=1160481&view=diff
==============================================================================
--- myfaces/shared/trunk_4.0.x/core/src/main/java/org/apache/myfaces/shared/resource/ResourceImpl.java (original)
+++ myfaces/shared/trunk_4.0.x/core/src/main/java/org/apache/myfaces/shared/resource/ResourceImpl.java Mon Aug 22 22:49:42 2011
@@ -247,7 +247,11 @@ public class ResourceImpl extends Resour
path = path + "&stage=" + facesContext.getApplication().getProjectStage().toString();
}
}
-
+ if (_resourceMeta.getLocalePrefix() != null)
+ {
+ path = path + (useAmp ? '&' : '?') + "loc=" + _resourceMeta.getLocalePrefix();
+ useAmp = true;
+ }
return facesContext.getApplication().getViewHandler().getResourceURL(facesContext, path);
}
Modified: myfaces/shared/trunk_4.0.x/core/src/main/java/org/apache/myfaces/shared/util/StateUtils.java
URL: http://svn.apache.org/viewvc/myfaces/shared/trunk_4.0.x/core/src/main/java/org/apache/myfaces/shared/util/StateUtils.java?rev=1160481&r1=1160480&r2=1160481&view=diff
==============================================================================
--- myfaces/shared/trunk_4.0.x/core/src/main/java/org/apache/myfaces/shared/util/StateUtils.java (original)
+++ myfaces/shared/trunk_4.0.x/core/src/main/java/org/apache/myfaces/shared/util/StateUtils.java Mon Aug 22 22:49:42 2011
@@ -382,9 +382,9 @@ public final class StateUtils {
}
catch (Throwable e)
{
- if (log.isLoggable(Level.SEVERE))
+ if (log.isLoggable(Level.FINE))
{
- log.log(Level.SEVERE, "View State cannot be reconstructed", e);
+ log.log(Level.FINE, "View State cannot be reconstructed", e);
}
return null;
}
Modified: myfaces/shared/trunk_4.0.x/core/src/main/resources/META-INF/myfaces-metadata.xml
URL: http://svn.apache.org/viewvc/myfaces/shared/trunk_4.0.x/core/src/main/resources/META-INF/myfaces-metadata.xml?rev=1160481&r1=1160480&r2=1160481&view=diff
==============================================================================
--- myfaces/shared/trunk_4.0.x/core/src/main/resources/META-INF/myfaces-metadata.xml (original)
+++ myfaces/shared/trunk_4.0.x/core/src/main/resources/META-INF/myfaces-metadata.xml Mon Aug 22 22:49:42 2011
@@ -7480,7 +7480,8 @@ tree.
<webConfigParam>
<name>javax.faces.RESOURCE_EXCLUDES</name>
<fieldName>RESOURCE_EXCLUDES_PARAM_NAME</fieldName>
- <desc>no description</desc>
+ <desc>Space separated file extensions that will not be served by the default ResourceHandler implementation</desc>
+ <longDesc>Space separated file extensions that will not be served by the default ResourceHandler implementation.</longDesc>
<defaultValue>.class .jsp .jspx .properties .xhtml</defaultValue>
<sourceClassName>javax.faces.application.ResourceHandler</sourceClassName>
<since>2.0</since>
@@ -7488,7 +7489,7 @@ tree.
<webConfigParam>
<name>javax.faces.STATE_SAVING_METHOD</name>
<fieldName>STATE_SAVING_METHOD_PARAM_NAME</fieldName>
- <desc>Define the state method to be used</desc>
+ <desc>Define the state method to be used. There are two different options defined by the specification: 'client' and 'server' state.</desc>
<longDesc>
<![CDATA[
Define the state method to be used. There are two different options defined by the
@@ -7514,14 +7515,26 @@ token is embedded in the data rendered t
<webConfigParam>
<name>javax.faces.FULL_STATE_SAVING_VIEW_IDS</name>
<fieldName>FULL_STATE_SAVING_VIEW_IDS_PARAM_NAME</fieldName>
- <desc>no description</desc>
+ <desc>Indicate the viewId(s) separated by commas that should be saved and restored fully, without use Partial State Saving (PSS)</desc>
+ <longDesc>Indicate the viewId(s) separated by commas that should be saved and restored fully, without use Partial State Saving (PSS).</longDesc>
<sourceClassName>javax.faces.application.StateManager</sourceClassName>
<since>2.0</since>
</webConfigParam>
<webConfigParam>
<name>javax.faces.PARTIAL_STATE_SAVING</name>
<fieldName>PARTIAL_STATE_SAVING_PARAM_NAME</fieldName>
- <desc>no description</desc>
+ <desc>Enable or disable partial state saving algorithm</desc>
+ <longDesc>
+<![CDATA[
+Enable or disable partial state saving algorithm.
+
+<p>Partial State Saving algorithm allows to reduce the size of the state required to save a view,
+keeping track of the "delta" or differences between the view build by first time and the current
+state of the view.</p>
+<p>If the webapp faces-config file version is 2.0 or upper the default value is true, otherwise is false.</p>
+]]>
+ </longDesc>
+ <defaultValue>true (false with 1.2 webapps)</defaultValue>
<expectedValues>true,false</expectedValues>
<sourceClassName>javax.faces.application.StateManager</sourceClassName>
<since>2.0</since>
@@ -7529,8 +7542,10 @@ token is embedded in the data rendered t
<webConfigParam>
<name>javax.faces.DEFAULT_SUFFIX</name>
<fieldName>DEFAULT_SUFFIX_PARAM_NAME</fieldName>
- <desc>Indicate the default suffix to derive the file URI if extension mapping is used</desc>
- <longDesc>Indicate the default suffix to derive the file URI if extension mapping is used.</longDesc>
+ <desc>Indicate the default suffixes, separated by spaces to derive the default file URI
+used by JSF to create views and render pages</desc>
+ <longDesc>Indicate the default suffixes, separated by spaces to derive the default file URI
+used by JSF to create views and render pages.</longDesc>
<defaultValue>.xhtml .jsp</defaultValue>
<sourceClassName>javax.faces.application.ViewHandler</sourceClassName>
<since>1.1</since>
@@ -7538,7 +7553,8 @@ token is embedded in the data rendered t
<webConfigParam>
<name>javax.faces.FACELETS_SUFFIX</name>
<fieldName>FACELETS_SUFFIX_PARAM_NAME</fieldName>
- <desc>no description</desc>
+ <desc>The default extension used to handle facelets pages</desc>
+ <longDesc>The default extension used to handle facelets pages.</longDesc>
<defaultValue>.xhtml</defaultValue>
<sourceClassName>javax.faces.application.ViewHandler</sourceClassName>
<since>2.0</since>
@@ -7546,14 +7562,18 @@ token is embedded in the data rendered t
<webConfigParam>
<name>javax.faces.FACELETS_VIEW_MAPPINGS</name>
<fieldName>FACELETS_VIEW_MAPPINGS_PARAM_NAME</fieldName>
- <desc>no description</desc>
+ <desc>Set of extensions handled by facelets, separated by ';'</desc>
+ <longDesc>Set of extensions handled by facelets, separated by ';'.</longDesc>
<sourceClassName>javax.faces.application.ViewHandler</sourceClassName>
<since>2.0</since>
</webConfigParam>
<webConfigParam>
<name>javax.faces.VALIDATE_EMPTY_FIELDS</name>
<fieldName>VALIDATE_EMPTY_FIELDS_PARAM_NAME</fieldName>
- <desc>no description</desc>
+ <desc>Force validation on empty fields (By default is auto, which means it is only
+enabled when Bean Validation binaries are available on the current classpath)</desc>
+ <longDesc>Force validation on empty fields (By default is auto, which means it is only
+enabled when Bean Validation binaries are available on the current classpath).</longDesc>
<defaultValue>auto</defaultValue>
<expectedValues>auto, true, false</expectedValues>
<sourceClassName>javax.faces.component.UIInput</sourceClassName>
@@ -7562,10 +7582,14 @@ token is embedded in the data rendered t
<webConfigParam>
<name>javax.faces.INTERPRET_EMPTY_STRING_SUBMITTED_VALUES_AS_NULL</name>
<fieldName>EMPTY_VALUES_AS_NULL_PARAM_NAME</fieldName>
- <desc>-=Leonardo Uribe =- According to http://wiki</desc>
- <longDesc>-=Leonardo Uribe =- According to http://wiki.java.net/bin/view/Projects/Jsf2MR1ChangeLog
-this constant will be made public on 2.1. For now, since this param is handled in
-2.0, we should do it as well.</longDesc>
+ <desc>Submitted values are decoded as null values instead empty strings</desc>
+ <longDesc>
+<![CDATA[
+Submitted values are decoded as null values instead empty strings.
+
+<p>Note this param is ignored for components extending from UISelectOne/UISelectMany.</p>
+]]>
+ </longDesc>
<defaultValue>false</defaultValue>
<expectedValues>true, false</expectedValues>
<sourceClassName>javax.faces.component.UIInput</sourceClassName>
@@ -7615,7 +7639,7 @@ Attention: You do not need to put /WEB-I
<webConfigParam>
<name>org.apache.myfaces.ERROR_HANDLER</name>
<fieldName>ERROR_HANDLER_PARAMETER</fieldName>
- <desc>Since JSF 2</desc>
+ <desc>Deprecated: use JSF 2.0 ExceptionHandler</desc>
<longDesc>
<![CDATA[
Since JSF 2.0 there is a standard way to deal with unexpected Exceptions: the ExceptionHandler.
@@ -7637,7 +7661,8 @@ Furthermore, the init parameter only wor
<webConfigParam>
<name>org.apache.myfaces.CHECKED_VIEWID_CACHE_SIZE</name>
<fieldName>CHECKED_VIEWID_CACHE_SIZE_ATTRIBUTE</fieldName>
- <desc>no description</desc>
+ <desc>Controls the size of the cache used to "remember" if a view exists or not</desc>
+ <longDesc>Controls the size of the cache used to "remember" if a view exists or not.</longDesc>
<defaultValue>500</defaultValue>
<sourceClassName>org.apache.myfaces.shared.application.DefaultViewHandlerSupport</sourceClassName>
<since>2.0.2</since>
@@ -7645,7 +7670,10 @@ Furthermore, the init parameter only wor
<webConfigParam>
<name>org.apache.myfaces.CHECKED_VIEWID_CACHE_ENABLED</name>
<fieldName>CHECKED_VIEWID_CACHE_ENABLED_ATTRIBUTE</fieldName>
- <desc>no description</desc>
+ <desc>Enable or disable a cache used to "remember" if a view exists or not and reduce the impact of
+sucesive calls to ExternalContext</desc>
+ <longDesc>Enable or disable a cache used to "remember" if a view exists or not and reduce the impact of
+sucesive calls to ExternalContext.getResource().</longDesc>
<defaultValue>true</defaultValue>
<sourceClassName>org.apache.myfaces.shared.application.DefaultViewHandlerSupport</sourceClassName>
<since>2.0.2</since>
@@ -7715,7 +7743,7 @@ Default: "org.apache.myfaces.shared.rend
Follow the description on the MyFaces-Wiki-Performance page to enable
StreamingAddResource instead of DefaultAddResource if you want to
gain performance.</longDesc>
- <defaultValue>org.apache.myfaces.renderkit.html.util.DefaultAddResource</defaultValue>
+ <defaultValue>org.apache.myfaces. renderkit.html.util. DefaultAddResource</defaultValue>
<sourceClassName>org.apache.myfaces.shared.config.MyfacesConfig</sourceClassName>
<since>1.1</since>
</webConfigParam>
@@ -7840,10 +7868,19 @@ link (call to window.external.AutoComple
<webConfigParam>
<name>org.apache.myfaces.REFRESH_TRANSIENT_BUILD_ON_PSS</name>
<fieldName>INIT_PARAM_REFRESH_TRANSIENT_BUILD_ON_PSS</fieldName>
- <desc>This param is only valid when partial state saving is on</desc>
- <longDesc>This param is only valid when partial state saving is on.
-If this is set as true, the tag-handlers are reapplied like in facelets 1.1.x, allowing
-c:if work correctly to "toggle" components based on a value changed on invoke application phase.</longDesc>
+ <desc>Indicate if the facelet associated to the view should be reapplied when the view is refreshed</desc>
+ <longDesc>
+<![CDATA[
+Indicate if the facelet associated to the view should be reapplied when the view is refreshed. Default mode is "auto".
+
+<p>This param is only valid when partial state saving is on.
+If this is set as true, the tag-handlers are always reapplied before render view, like in facelets 1.1.x, allowing
+c:if work correctly to "toggle" components based on a value changed on invoke application phase.
+If the param is set as "auto", the implementation check if c:if, c:forEach,
+c:choose and ui:include with src=ELExpression is used on the page and if that so, mark the view
+to be refreshed.</p>
+]]>
+ </longDesc>
<defaultValue>auto</defaultValue>
<expectedValues>true,false,auto</expectedValues>
<sourceClassName>org.apache.myfaces.shared.config.MyfacesConfig</sourceClassName>
@@ -7852,11 +7889,19 @@ c:if work correctly to "toggle" componen
<webConfigParam>
<name>org.apache.myfaces.REFRESH_TRANSIENT_BUILD_ON_PSS_PRESERVE_STATE</name>
<fieldName>INIT_PARAM_REFRESH_TRANSIENT_BUILD_ON_PSS_PRESERVE_STATE</fieldName>
- <desc>This param is only valid when partial state saving is on</desc>
- <longDesc>This param is only valid when partial state saving is on.
+ <desc>Enable or disable a special mode that enable full state for parent components containing c:if, c:forEach,
+c:choose and ui:include with src=ELExpression</desc>
+ <longDesc>
+<![CDATA[
+Enable or disable a special mode that enable full state for parent components containing c:if, c:forEach,
+c:choose and ui:include with src=ELExpression. By default is disabled(false).
+
+<p>This param is only valid when partial state saving is on.
If this is set as true, parent components containing c:if, c:forEach,
-c:choose and ui:insert with src=ELExpression are marked to be restored fully, so state
-is preserved between request.</longDesc>
+c:choose and ui:include with src=ELExpression are marked to be restored fully, so state
+is preserved between request.</p>
+]]>
+ </longDesc>
<defaultValue>false</defaultValue>
<sourceClassName>org.apache.myfaces.shared.config.MyfacesConfig</sourceClassName>
<since>2.0</since>
@@ -7866,13 +7911,13 @@ is preserved between request.</longDesc>
<fieldName>INIT_PARAM_VALIDATE_XML</fieldName>
<desc>
<![CDATA[
-if set to <code>true</code>, tag library XML files and faces config XML files using schema
+If set to <code>true</code>, tag library XML files and faces config XML files using schema
will be validated during application start up
]]>
</desc>
<longDesc>
<![CDATA[
-if set to <code>true</code>, tag library XML files and faces config XML files using schema
+If set to <code>true</code>, tag library XML files and faces config XML files using schema
will be validated during application start up
]]>
</longDesc>