From seam-commits at lists.jboss.org Mon Jun  4 07:15:43 2012
Content-Type: multipart/mixed; boundary="===============0079263297718956969=="
MIME-Version: 1.0
From: seam-commits at lists.jboss.org
To: seam-commits at lists.jboss.org
Subject: [seam-commits] Seam SVN: r14827 -
 branches/community/Seam_2_3/seam-reference-guide/src/docbook/en-US.
Date: Mon, 04 Jun 2012 07:15:42 -0400
Message-ID: <201206041115.q54BFgWi031005@svn01.web.mwc.hst.phx2.redhat.com>

--===============0079263297718956969==
Content-Type: text/plain; charset="utf-8"
MIME-Version: 1.0
Content-Transfer-Encoding: quoted-printable

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/Contr=
ols.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-U=
S/Controls.xml
=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=
=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=
=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D
--- branches/community/Seam_2_3/seam-reference-guide/src/docbook/en-US/Cont=
rols.xml	2012-06-04 10:22:04 UTC (rev 14826)
+++ branches/community/Seam_2_3/seam-reference-guide/src/docbook/en-US/Cont=
rols.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=3D"both" dateStyle=3D"full"/>
 </h:outputText>]]></programlisting>
    =

+         <warning><para>This is not supported, use f:convertDateTime inste=
ad</para></warning>
          </section>
    =

          <section>
             <title><literal>&lt;s:convertEntity&gt;</literal></title>
-   =

+            =

+            <warning><para>This is not supported, use <![CDATA[<f:converte=
r converterId=3D"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></tit=
le>
           =

             <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=3D"XHTML"><![CDATA[<h:selectOneRadio id=
=3D"radioList"
                   layout=3D"lineDirection"
                   value=3D"#{newPayment.paymentFrequency}">
-   <s:convertEnum />
+   <f:converter converterId=3D"org.jboss.seam.ui.EnumConverter" />
+   <f:converter id=3D""
    <s:enumItem enumValue=3D"ONCE"         label=3D"Only Once" />
    <s:enumItem enumValue=3D"EVERY_MINUTE" label=3D"Every Minute" />
    <s:enumItem enumValue=3D"HOURLY"       label=3D"Every Hour" />

Modified: branches/community/Seam_2_3/seam-reference-guide/src/docbook/en-U=
S/I18n.xml
=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=
=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=
=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D
--- 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 defaul=
t time zone for JSF 2 in <filename>web.xml</filename>.
+        <programlisting role=3D"XML">&lt;context-param&gt;
+    &lt;param-name&gt;javax.faces.DATETIMECONVERTER_DEFAULT_TIMEZONE_IS_SY=
STEM_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>


--===============0079263297718956969==--