[jsr-314-open] clarification for unnamed insert

[Dan Allen]

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:

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.
>

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:

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.


I'd like to request that the first quoted block be added after this
statement.

-Dan

-- 
Dan Allen
Senior Software Engineer, Red Hat | Author of Seam in Action

http://mojavelinux.com
http://mojavelinux.com/seaminaction
http://in.relation.to/Bloggers/Dan

NOTE: While I make a strong effort to keep up with my email on a daily
basis, personal or other work matters can sometimes keep me away
from my email. If you contact me, but don't hear back for more than a week,
it is very likely that I am excessively backlogged or the message was
caught in the spam filters.  Please don't hesitate to resend a message if
you feel that it did not reach my attention.
-------------- next part --------------
An HTML attachment was scrubbed...
URL: http://lists.jboss.org/pipermail/jsr-314-open-mirror/attachments/20090618/426fbde2/attachment.html