From seam-commits at lists.jboss.org Mon Oct 27 09:53:01 2008
Content-Type: multipart/mixed; boundary="===============7470914990585122383=="
MIME-Version: 1.0
From: seam-commits at lists.jboss.org
To: seam-commits at lists.jboss.org
Subject: [seam-commits] Seam SVN: r9434 - trunk/doc/Seam_Reference_Guide/en-US.
Date: Mon, 27 Oct 2008 09:53:01 -0400
Message-ID: <E1KuSWj-00073x-8T@committer01.frg.pub.inap.atl.jboss.com>

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

Author: manaRH
Date: 2008-10-27 09:53:01 -0400 (Mon, 27 Oct 2008)
New Revision: 9434

Modified:
   trunk/doc/Seam_Reference_Guide/en-US/Events.xml
Log:
mistake

Modified: trunk/doc/Seam_Reference_Guide/en-US/Events.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
--- trunk/doc/Seam_Reference_Guide/en-US/Events.xml	2008-10-27 13:41:08 UTC=
 (rev 9433)
+++ trunk/doc/Seam_Reference_Guide/en-US/Events.xml	2008-10-27 13:53:01 UTC=
 (rev 9434)
@@ -1071,6 +1071,44 @@
            also available, as <literal>org.jboss.seam.caughtException</lit=
eral>.
          </para>
          =

+         <section>
+             <title>Suppressing exception logging</title>
+             =

+             <para>
+                 For the exception handlers defined in <literal>pages.xml<=
/literal>, it is possible
+                 to declare the logging level at which the exception will =
be logged, or to even
+                 suppress the exception being logged altogether.  The attr=
ibutes <literal>log</literal>
+                 and <literal>logLevel</literal> can be used to control ex=
ception logging.  By setting =

+                 <literal>log=3D"false"</literal> as per the following exa=
mple, then no log message will
+                 be generated when the specified exception occurs:
+             </para>
+             =

+             <programlisting role=3D"XML"><![CDATA[    <exception class=3D=
"org.jboss.seam.security.NotLoggedInException" log=3D"false">
+        <redirect view-id=3D"/register.xhtml">
+            <message severity=3D"warn">You must be a member to use this fe=
ature</message>
+        </redirect>
+    </exception>]]></programlisting>
+    =

+             <para>
+                 If the <literal>log</literal> attribute is not specified,=
 then it defaults to <literal>true</literal>
+                 (i.e. the exception will be logged).  Alternatively, you =
can specify the <literal>logLevel</literal>
+                 to control at which log level the exception will be logge=
d:             =

+             </para>
+
+             <programlisting role=3D"XML"><![CDATA[    <exception class=3D=
"org.jboss.seam.security.NotLoggedInException" logLevel=3D"info">
+        <redirect view-id=3D"/register.xhtml">
+            <message severity=3D"warn">You must be a member to use this fe=
ature</message>
+        </redirect>
+    </exception>]]></programlisting>
+    =

+              <para>
+                  The acceptable values for <literal>logLevel</literal> ar=
e: <literal>fatal, error, warn, info, debug</literal> =

+                  or <literal>trace</literal>.  If the <literal>logLevel</=
literal> is not specified, or if an invalid value is
+                  configured, then it will default to <literal>error</lite=
ral>.              =

+              </para>
+         =

+         </section>
+
         </section>
         =

         <section>


--===============7470914990585122383==--