There is an important feature of Facelets composition templates--unnamed insert--which I feel needs clarification in the pdldocs. The feature can be described as follows:<br><br><blockquote style="border-left: 1px solid rgb(204, 204, 204); margin: 0pt 0pt 0pt 0.8ex; padding-left: 1ex;" class="gmail_quote">
The name attribute of the ui:insert tag is optional. When this attribute is excluded, the text that is inserted is any markup within the associated ui:composition, ui:component, ui:decorate, or ui:fragment that falls outside of a ui:define tag.<br>
</blockquote><br>The pdldocs state that the name attribute on ui:insert is optional, but does not specify the behavior when it is excluded. In fact, the documentation misleads the developer by stating the following at the top of the ui:insert page:<br>
<br><blockquote style="border-left: 1px solid rgb(204, 204, 204); margin: 0pt 0pt 0pt 0.8ex; padding-left: 1ex;" class="gmail_quote">Inserts content into a template. That content is defined—with the ui:define tag— in either a ui:composition, ui:component, ui:decorate, or ui:fragment.</blockquote>
<div><br>I'd like to request that the first quoted block be added after this statement.<br><br>-Dan<br><br></div>-- <br>Dan Allen<br>Senior Software Engineer, Red Hat | Author of Seam in Action<br><br><a href="http://mojavelinux.com">http://mojavelinux.com</a><br>
<a href="http://mojavelinux.com/seaminaction">http://mojavelinux.com/seaminaction</a><br><a href="http://in.relation.to/Bloggers/Dan">http://in.relation.to/Bloggers/Dan</a><br><br>NOTE: While I make a strong effort to keep up with my email on a daily<br>
basis, personal or other work matters can sometimes keep me away<br>from my email. If you contact me, but don't hear back for more than a week,<br>it is very likely that I am excessively backlogged or the message was<br>
caught in the spam filters. Please don't hesitate to resend a message if<br>you feel that it did not reach my attention.<br>