From teiid-commits at lists.jboss.org Fri Nov  4 13:36:59 2011
Content-Type: multipart/mixed; boundary="===============1411726918831388332=="
MIME-Version: 1.0
From: teiid-commits at lists.jboss.org
To: teiid-commits at lists.jboss.org
Subject: [teiid-commits] teiid SVN: r3614 -
 trunk/documentation/developer-guide/src/main/docbook/en-US/content.
Date: Fri, 04 Nov 2011 13:36:59 -0400
Message-ID: <201111041736.pA4HaxX0005124@svn01.web.mwc.hst.phx2.redhat.com>

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

Author: rareddy
Date: 2011-11-04 13:36:58 -0400 (Fri, 04 Nov 2011)
New Revision: 3614

Modified:
   trunk/documentation/developer-guide/src/main/docbook/en-US/content/trans=
lator-api.xml
Log:
misc: fixing "code" tag

Modified: trunk/documentation/developer-guide/src/main/docbook/en-US/conten=
t/translator-api.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/documentation/developer-guide/src/main/docbook/en-US/content/tran=
slator-api.xml	2011-11-04 14:57:30 UTC (rev 3613)
+++ trunk/documentation/developer-guide/src/main/docbook/en-US/content/tran=
slator-api.xml	2011-11-04 17:36:58 UTC (rev 3614)
@@ -257,17 +257,27 @@
          =

 		<section>
 			<title>Asynchronous Executions</title>
-			<para>In some scenarios, a translator needs to execute
-				asynchronously and allow the executing thread to perform other work.  =
To allow this, you should Throw a <code>DataNotAvailableExecption</code> du=
ring a retrival method, rather than explicitly waiting or sleeping for the =
results. =

-				<note><para>A <code>DataNotAvailableException</code> should not be thr=
own by the execute method.</para><note>
-				The
-						<code>DataNotAvailableException</code> may take a delay parameter in=
 its
-						constructor to indicate how long the system should wait befor polling
-						for results.  Any non-negative value indicates a time until the next=
 polling should be performed.
-						The <code>DataNotAvailableException.NO_POLLING</code> exception (or =
any DataNotAvailableException with a negative delay) can be thrown to indic=
ate that =

-						the execution will call <code>ExecutionContext.dataAvailable<c/ode> =
to indicate processing should resume.
-			</para>
-			<note><para>Since the exection and the associated connection are not cl=
osed until the work has completed, care should be taken if using asynchrono=
us executions that hold a lot of state.</para></note>
+    <para>
+        In some scenarios, a translator needs to execute
+        asynchronously and allow the executing thread to perform other wor=
k. To allow this, you should Throw a
+        <code>DataNotAvailableExecption</code>
+        during a retrival method, rather than explicitly waiting or sleepi=
ng for the results.
+        <note>
+            <para>
+                A <code>DataNotAvailableException</code> should not be thr=
own by the execute method. The
+                <code>DataNotAvailableException</code> may take a delay pa=
rameter in its
+                constructor to indicate how long the system should wait be=
for polling
+                for results. Any non-negative value indicates a time until=
 the next polling should be performed.
+                The
+                <code>DataNotAvailableException.NO_POLLING</code>
+                exception (or any DataNotAvailableException with a negativ=
e delay) can be thrown to indicate that
+                the execution will call <code>ExecutionContext.dataAvailab=
le</code> to indicate processing should resume.
+           </para>
+       </note>
+    </para>
+    <note>
+        <para>Since the exection and the associated connection are not clo=
sed until the work has completed, care should be taken if using asynchronou=
s executions that hold a lot of state.</para>
+    </note>
 		</section>
         =

 		<section>


--===============1411726918831388332==--