Linking to the parent MyFaces compatibility case.

Actually assigning to Mircea this time. Now that the new deltaSubmit algorithm is done (ICE-6879), it needs to be verified that works with MyFaces as well.

The reason of this issue can be found in the MyFaces implementation of ui:include tag handler. ui:include facet is used by component-showcase to dynamically change the content of the demo panel when navigating between the different components. The tag handler tries to evaluate the expression bound to its "src" attribute during restore view phase, unfortunately the DeltaSubmitPhaseListener reconstructs the full set of parameters only before apply request value phase (which comes later than restore view). Because of this the "src" attribute expression is calculated using only the submitted parameters which don't make much sense yet for the used components. That is why the second click triggers the desired navigation, because the expression is calculated off the parameters that were reconstructed during the last request.

We currently rely on the old document to calculate the previous parameters, document saved in the view map. The old document (created during previous request) can be accessed only after the restore phase was executed. Unfortunately we cannot reconstruct the full set of parameters for the current request sooner (before restore phase) because we don't have the old document yet restored.
In conclusion we cannot fix this issue (for MyFaces) unless we save the old documents into a separate map which can be used to retrieve the old documents corresponding to the current view before the restore phase executes.

Need to record this issue in Myfaces bug tracking system. Mark this issue as "Won't fix". Mark this issue for "Documention" so that we list this as a known issue.

Add this to the list of know issues.

Issue recorded in MyFaces' bug tracking system: https://issues.apache.org/jira/browse/MYFACES-3271

Looks like that adding the following context parameter solves this issue:

<context-param>
<param-name>org.apache.myfaces.REFRESH_TRANSIENT_BUILD_ON_PSS</param-name>
<param-value>true</param-value>
</context-param>

For more information see https://issues.apache.org/jira/browse/MYFACES-3271 .