Author: shane.bryzak(a)jboss.com Date: 2008-04-12 22:16:21 -0400 (Sat, 12 Apr 2008) New Revision: 7911 Modified: trunk/doc/reference/en/modules/controls.xml Log: JBSEAM-2789, fixed corrupt sections Modified: trunk/doc/reference/en/modules/controls.xml =================================================================== --- trunk/doc/reference/en/modules/controls.xml 2008-04-13 01:06:47 UTC (rev 7910) +++ trunk/doc/reference/en/modules/controls.xml 2008-04-13 02:16:21 UTC (rev 7911) @@ -248,7 +248,9 @@ <para> The converter works with any managed entity which has an <literal>@Id</literal> annotation - - either simple or composite. + either simple or composite. The converter should be able to find the items declared in the + JSF controls (the currently selected, and the items available for selection), otherwise + you will receive a validation error. </para> <para><emphasis>Attributes</emphasis></para> @@ -295,6 +297,12 @@ <f:converter converterId="myEntityConverter" /> </h:selectOneMenu>]]></programlisting> + <para> + If a page uses more than one entity manager for rendering, the + above standard reference to the converter is obligatory. Otherwise + the converter's entity loader might show unexpected behavior. + </para> + <para><emphasis>Usage</emphasis></para> <programlisting><![CDATA[<h:selectOneMenu value="#{person.continent}" required="true"> <s:selectItems value="#{continents.resultList}" var="continent" @@ -312,6 +320,27 @@ <entry valign="top"> <para><emphasis>Description</emphasis></para> + + <para> + Assigns an enum converter to the current component. This is primarily + useful for radio button and dropdown controls. + </para> + <para><emphasis>Attributes</emphasis></para> + <para> + None. + </para> + <para><emphasis>Usage</emphasis></para> + <programlisting><![CDATA[<h:selectOneMenu value="#{person.honorific}"> + <s:selectItems value="#{honorifics}" var="honorific" + label="#{honorific.label}" + noSelectionLabel="Please select" /> + <s:convertEnum /> +</h:selectOneMenu>]]></programlisting> + </entry> + </row> + + <row> + <entry valign="top"> <para><literal>&lt;s:convertAtomicBoolean&gt;</literal></para> </entry> <entry valign="top"> @@ -367,26 +396,6 @@ </h:outputText>]]></programlisting> </entry> </row> - - <row> - <entry valign="top"> - <para> - Assigns an enum converter to the current component. This is primarily - useful for radio button and dropdown controls. - </para> - <para><emphasis>Attributes</emphasis></para> - <para> - None. - </para> - <para><emphasis>Usage</emphasis></para> - <programlisting><![CDATA[<h:selectOneMenu value="#{person.honorific}"> - <s:selectItems value="#{honorifics}" var="honorific" - label="#{honorific.label}" - noSelectionLabel="Please select" /> - <s:convertEnum /> -</h:selectOneMenu>]]></programlisting> - </entry> - </row> <row> <entry valign="top">