Author: manaRH Date: 2012-06-07 06:58:39 -0400 (Thu, 07 Jun 2012) New Revision: 14865 Modified: branches/enterprise/WFK-2_0/seam-reference-guide/src/docbook/en-US/Controls.xml branches/enterprise/WFK-2_0/seam-reference-guide/src/docbook/en-US/I18n.xml Log: JBSEAM-4955 updated documentation for s custom converter and validator tags Modified: branches/enterprise/WFK-2_0/seam-reference-guide/src/docbook/en-US/Controls.xml =================================================================== --- branches/enterprise/WFK-2_0/seam-reference-guide/src/docbook/en-US/Controls.xml 2012-06-07 10:58:31 UTC (rev 14864) +++ branches/enterprise/WFK-2_0/seam-reference-guide/src/docbook/en-US/Controls.xml 2012-06-07 10:58:39 UTC (rev 14865) @@ -304,7 +304,7 @@ <section> <title>Converters and Validators</title> - <section> +<!-- <section> <title><literal>&lt;s:convertDateTime&gt;</literal></title> <para><emphasis>Description</emphasis></para> @@ -318,11 +318,14 @@ <s:convertDateTime type="both" dateStyle="full"/> </h:outputText>]]></programlisting> + <warning><para>This is not supported, use f:convertDateTime instead</para></warning> </section> <section> <title><literal>&lt;s:convertEntity&gt;</literal></title> - + + <warning><para>This is not supported, use <![CDATA[<f:converter converterId="your_converter" />]]> instead</para></warning> + <para><emphasis>Description</emphasis></para> <para> Assigns an entity converter to the current component. This is @@ -491,7 +494,7 @@ </h:outputText>]]></programlisting> </section> - + --> <section> <title><literal>&lt;s:validateEquality&gt;</literal></title> @@ -835,7 +838,7 @@ <section> <title>Seam Text</title> - <section> + <!-- <section> <title><literal>&lt;s:validateFormattedText&gt;</literal></title> <para><emphasis>Description</emphasis></para> @@ -848,7 +851,7 @@ None. </para> </section> - + --> <section> <title><literal>&lt;s:formattedText&gt;</literal></title> @@ -970,7 +973,8 @@ <programlisting role="XHTML"><![CDATA[<h:selectOneRadio id="radioList" layout="lineDirection" value="#{newPayment.paymentFrequency}"> - <s:convertEnum /> + <f:converter converterId="org.jboss.seam.ui.EnumConverter" /> + <f:converter id="" <s:enumItem enumValue="ONCE" label="Only Once" /> <s:enumItem enumValue="EVERY_MINUTE" label="Every Minute" /> <s:enumItem enumValue="HOURLY" label="Every Hour" /> Modified: branches/enterprise/WFK-2_0/seam-reference-guide/src/docbook/en-US/I18n.xml =================================================================== --- branches/enterprise/WFK-2_0/seam-reference-guide/src/docbook/en-US/I18n.xml 2012-06-07 10:58:31 UTC (rev 14864) +++ branches/enterprise/WFK-2_0/seam-reference-guide/src/docbook/en-US/I18n.xml 2012-06-07 10:58:39 UTC (rev 14865) @@ -335,6 +335,15 @@ and displayed as UTC, unless a timezone is explicitly specified using <literal> &lt;f:convertDateTime&gt;</literal>. This is an extremely inconvenient default behavior.</para> + + <note> + <para>You can use application parameter to set up different default time zone for JSF 2 in <filename>web.xml</filename>. + <programlisting role="XML">&lt;context-param&gt; + &lt;param-name&gt;javax.faces.DATETIMECONVERTER_DEFAULT_TIMEZONE_IS_SYSTEM_TIMEZONE&lt;/param-name&gt; + &lt;param-value>true&lt;/param-value&gt; + &lt;/context-param&gt;</programlisting> + </para> + </note> <para>Seam overrides this behavior, and defaults all dates and times to the Seam timezone. In addition, Seam provides the <literal>