[seam-commits] Seam SVN: r14827 - branches/community/Seam_2_3/seam-reference-guide/src/docbook/en-US.

[seam-commits at lists.jboss.org]

Author: manaRH
Date: 2012-06-04 07:15:42 -0400 (Mon, 04 Jun 2012)
New Revision: 14827

Modified:
   branches/community/Seam_2_3/seam-reference-guide/src/docbook/en-US/Controls.xml
   branches/community/Seam_2_3/seam-reference-guide/src/docbook/en-US/I18n.xml
Log:
JBSEAM-4955 updated documentation for s custom converter and validator tags

Modified: branches/community/Seam_2_3/seam-reference-guide/src/docbook/en-US/Controls.xml
===================================================================
--- branches/community/Seam_2_3/seam-reference-guide/src/docbook/en-US/Controls.xml	2012-06-04 10:22:04 UTC (rev 14826)
+++ branches/community/Seam_2_3/seam-reference-guide/src/docbook/en-US/Controls.xml	2012-06-04 11:15:42 UTC (rev 14827)
@@ -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/community/Seam_2_3/seam-reference-guide/src/docbook/en-US/I18n.xml
===================================================================
--- branches/community/Seam_2_3/seam-reference-guide/src/docbook/en-US/I18n.xml	2012-06-04 10:22:04 UTC (rev 14826)
+++ branches/community/Seam_2_3/seam-reference-guide/src/docbook/en-US/I18n.xml	2012-06-04 11:15:42 UTC (rev 14827)
@@ -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>