[webbeans-commits] Webbeans SVN: r631 - in doc/trunk/reference: fr-FR/modules and 5 other directories.

webbeans-commits at lists.jboss.org webbeans-commits at lists.jboss.org
Sat Dec 20 17:17:05 EST 2008


Author: pete.muir at jboss.org
Date: 2008-12-20 17:17:05 -0500 (Sat, 20 Dec 2008)
New Revision: 631

Added:
   doc/trunk/reference/es-ES/modules/ri-spi.po
   doc/trunk/reference/fr-FR/modules/ri-spi.po
   doc/trunk/reference/it-IT/modules/ri-spi.po
   doc/trunk/reference/ja-JP/modules/ri-spi.po
   doc/trunk/reference/pot/modules/ri-spi.pot
   doc/trunk/reference/zh-CN/modules/ri-spi.po
Modified:
   doc/trunk/reference/es-ES/modules/ee.po
   doc/trunk/reference/es-ES/modules/producermethods.po
   doc/trunk/reference/es-ES/modules/ri.po
   doc/trunk/reference/fr-FR/modules/ee.po
   doc/trunk/reference/fr-FR/modules/producermethods.po
   doc/trunk/reference/fr-FR/modules/ri.po
   doc/trunk/reference/it-IT/modules/ee.po
   doc/trunk/reference/it-IT/modules/producermethods.po
   doc/trunk/reference/it-IT/modules/ri.po
   doc/trunk/reference/ja-JP/modules/ee.po
   doc/trunk/reference/ja-JP/modules/producermethods.po
   doc/trunk/reference/ja-JP/modules/ri.po
   doc/trunk/reference/pot/master.pot
   doc/trunk/reference/pot/modules/Book_Info.pot
   doc/trunk/reference/pot/modules/decorators.pot
   doc/trunk/reference/pot/modules/ee.pot
   doc/trunk/reference/pot/modules/events.pot
   doc/trunk/reference/pot/modules/example.pot
   doc/trunk/reference/pot/modules/extend.pot
   doc/trunk/reference/pot/modules/injection.pot
   doc/trunk/reference/pot/modules/interceptors.pot
   doc/trunk/reference/pot/modules/intro.pot
   doc/trunk/reference/pot/modules/next.pot
   doc/trunk/reference/pot/modules/part1.pot
   doc/trunk/reference/pot/modules/part2.pot
   doc/trunk/reference/pot/modules/part3.pot
   doc/trunk/reference/pot/modules/part4.pot
   doc/trunk/reference/pot/modules/producermethods.pot
   doc/trunk/reference/pot/modules/ri.pot
   doc/trunk/reference/pot/modules/scopescontexts.pot
   doc/trunk/reference/pot/modules/specialization.pot
   doc/trunk/reference/pot/modules/stereotypes.pot
   doc/trunk/reference/pot/modules/xml.pot
   doc/trunk/reference/zh-CN/modules/ee.po
   doc/trunk/reference/zh-CN/modules/producermethods.po
   doc/trunk/reference/zh-CN/modules/ri.po
Log:
po update

Modified: doc/trunk/reference/es-ES/modules/ee.po
===================================================================
--- doc/trunk/reference/es-ES/modules/ee.po	2008-12-20 19:00:18 UTC (rev 630)
+++ doc/trunk/reference/es-ES/modules/ee.po	2008-12-20 22:17:05 UTC (rev 631)
@@ -5,7 +5,7 @@
 msgstr ""
 "Project-Id-Version: master.xml \n"
 "Report-Msgid-Bugs-To: http://bugs.kde.org\n"
-"POT-Creation-Date: 2008-12-19 20:26+0000\n"
+"POT-Creation-Date: 2008-12-20 22:08+0000\n"
 "PO-Revision-Date: 2008-12-19 20:26+0000\n"
 "Last-Translator: Automatically generated\n"
 "Language-Team: none\n"
@@ -296,7 +296,7 @@
 #: ee.xml:100
 #, no-c-format
 msgid ""
-"The lifecycle of the injected JMS objects are completely controlled by the "
+"The lifecycle of the injected JMS objects is completely controlled by the "
 "Web Bean manager."
 msgstr ""
 

Modified: doc/trunk/reference/es-ES/modules/producermethods.po
===================================================================
--- doc/trunk/reference/es-ES/modules/producermethods.po	2008-12-20 19:00:18 UTC (rev 630)
+++ doc/trunk/reference/es-ES/modules/producermethods.po	2008-12-20 22:17:05 UTC (rev 631)
@@ -5,7 +5,7 @@
 msgstr ""
 "Project-Id-Version: master.xml \n"
 "Report-Msgid-Bugs-To: http://bugs.kde.org\n"
-"POT-Creation-Date: 2008-12-19 20:26+0000\n"
+"POT-Creation-Date: 2008-12-20 22:08+0000\n"
 "PO-Revision-Date: 2008-12-19 20:26+0000\n"
 "Last-Translator: Automatically generated\n"
 "Language-Team: none\n"
@@ -57,7 +57,8 @@
 "polymorphism with Web Beans. As we've seen, deployment types are a powerful "
 "solution to the problem of deployment-time polymorphism. But once the system "
 "is deployed, the Web Bean implementation is fixed. A producer method has no "
-"such limitation:</para> <programlisting><![CDATA[@SessionScoped\n"
+"such limitation:</para> <programlisting role=\"JAVA\"><![CDATA"
+"[@SessionScoped\n"
 "public class Preferences {\n"
 "    \n"
 "    private PaymentStrategyType paymentStrategy;\n"
@@ -75,12 +76,12 @@
 "    }\n"
 "    \n"
 "}]]></programlisting> <para>Consider an injection point:</para> "
-"<programlisting><![CDATA[@Preferred PaymentStrategy paymentStrat;]]></"
-"programlisting> <para>This injection point has the same type and binding "
-"annotations as the producer method, so it resolves to the producer method "
-"using the usual Web Beans injection rules. The producer method will be "
-"called by the Web Bean manager to obtain an instance to service this "
-"injection point.</para>."
+"<programlisting role=\"JAVA\"><![CDATA[@Preferred PaymentStrategy "
+"paymentStrat;]]></programlisting> <para>This injection point has the same "
+"type and binding annotations as the producer method, so it resolves to the "
+"producer method using the usual Web Beans injection rules. The producer "
+"method will be called by the Web Bean manager to obtain an instance to "
+"service this injection point.</para>."
 msgstr ""
 
 #. Tag: title

Added: doc/trunk/reference/es-ES/modules/ri-spi.po
===================================================================
--- doc/trunk/reference/es-ES/modules/ri-spi.po	                        (rev 0)
+++ doc/trunk/reference/es-ES/modules/ri-spi.po	2008-12-20 22:17:05 UTC (rev 631)
@@ -0,0 +1,275 @@
+# Language es-ES translations for master.xml package.
+# Automatically generated, 2008.
+#
+msgid ""
+msgstr ""
+"Project-Id-Version: master.xml \n"
+"Report-Msgid-Bugs-To: http://bugs.kde.org\n"
+"POT-Creation-Date: 2008-12-20 22:07+0000\n"
+"PO-Revision-Date: 2008-12-20 22:07+0000\n"
+"Last-Translator: Automatically generated\n"
+"Language-Team: none\n"
+"MIME-Version: 1.0\n"
+"Content-Type: text/plain; charset=UTF-8\n"
+"Content-Transfer-Encoding: 8bit\n"
+
+#. Tag: title
+#: ri-spi.xml:4
+#, no-c-format
+msgid "Integrating the Web Beans RI into other environments"
+msgstr ""
+
+#. Tag: para
+#: ri-spi.xml:6
+#, no-c-format
+msgid ""
+"Currently the Web Beans RI only runs in JBoss AS 5; integrating the RI into "
+"other EE environments (for example another application server like "
+"Glassfish), into a servlet container (like Tomcat), or with an Embedded "
+"EJB3.1 implementation is fairly easy. In this Appendix we will briefly "
+"discuss the steps needed."
+msgstr ""
+
+#. Tag: para
+#: ri-spi.xml:15
+#, no-c-format
+msgid ""
+"It should be possible to run Web Beans in an SE environment, but you'll to "
+"do more work, adding your own contexts and lifecycle. The Web Beans RI "
+"currently doesn't expose lifecycle extension points, so you would have to "
+"code directly against Web Beans RI classes."
+msgstr ""
+
+#. Tag: title
+#: ri-spi.xml:24
+#, no-c-format
+msgid "The Web Beans RI SPI"
+msgstr ""
+
+#. Tag: para
+#: ri-spi.xml:26
+#, no-c-format
+msgid ""
+"The Web Beans SPI is located in <literal>webbeans-ri-spi</literal> module, "
+"and packaged as <literal>webbeans-ri-spi.jar</literal>."
+msgstr ""
+
+#. Tag: para
+#: ri-spi.xml:31
+#, no-c-format
+msgid "Currently, the only SPI to implement is the bootstrap spi:"
+msgstr ""
+
+#. Tag: programlisting
+#: ri-spi.xml:35
+#, no-c-format
+msgid ""
+"<![CDATA[public interface WebBeanDiscovery {\n"
+"   /**\n"
+"    * Gets list of all classes in classpath archives with web-beans.xml "
+"files\n"
+"    * \n"
+"    * @return An iterable over the classes \n"
+"    */\n"
+"   public Iterable<Class<?>> discoverWebBeanClasses();\n"
+"   \n"
+"   /**\n"
+"    * Gets a list of all web-beans.xml files in the app classpath\n"
+"    * \n"
+"    * @return An iterable over the web-beans.xml files \n"
+"    */\n"
+"   public Iterable<URL> discoverWebBeansXml();\n"
+"   \n"
+"   /**\n"
+"    * Gets a descriptor for each EJB in the application\n"
+"    * \n"
+"    * @return The bean class to descriptor map \n"
+"    */\n"
+"   public Iterable<EjbDescriptor<?>> discoverEjbs();\n"
+"   \n"
+"}]]>"
+msgstr ""
+
+#. Tag: para
+#: ri-spi.xml:37
+#, no-c-format
+msgid ""
+"The discovery of Web Bean classes and <literal>web-bean.xml</literal> files "
+"is self-explanatory (the algorithm is described in Section 11.1 of the JSR-"
+"299 specification, and isn't repeated here)."
+msgstr ""
+
+#. Tag: para
+#: ri-spi.xml:43
+#, no-c-format
+msgid ""
+"The Web Beans RI also delegates EJB3 bean discovery to the container so that "
+"it doesn't have to scan for EJB3 annotations or parse <literal>ejb-jar.xml</"
+"literal>. For each EJB in the application an EJBDescriptor should be "
+"discovered:"
+msgstr ""
+
+#. Tag: programlisting
+#: ri-spi.xml:50
+#, no-c-format
+msgid ""
+"<![CDATA[public interface EjbDescriptor<T> {\n"
+"   \n"
+"   /**\n"
+"    * Gets the EJB type\n"
+"    * \n"
+"    * @return The EJB Bean class\n"
+"    */\n"
+"   public Class<T> getType();\n"
+"\n"
+"   /**\n"
+"    * Gets the local business interfaces of the EJB\n"
+"    * \n"
+"    * @return An iterator over the local business interfaces\n"
+"    */\n"
+"   public Iterable<BusinessInterfaceDescriptor<?>> getLocalBusinessInterfaces"
+"();\n"
+"   \n"
+"   /**\n"
+"    * Gets the remote business interfaces of the EJB\n"
+"    * \n"
+"    * @return An iterator over the remote business interfaces\n"
+"    */\n"
+"   public Iterable<BusinessInterfaceDescriptor<?>> "
+"getRemoteBusinessInterfaces();\n"
+"   \n"
+"   /**\n"
+"    * Get the remove methods of the EJB\n"
+"    * \n"
+"    * @return An iterator over the remove methods\n"
+"    */\n"
+"   public Iterable<MethodDescriptor> getRemoveMethods();\n"
+"\n"
+"   /**\n"
+"    * Indicates if the bean is stateless\n"
+"    * \n"
+"    * @return True if stateless, false otherwise\n"
+"    */\n"
+"   public boolean isStateless();\n"
+"\n"
+"   /**\n"
+"    * Indicates if the bean is a EJB 3.1 Singleton\n"
+"    * \n"
+"    * @return True if the bean is a singleton, false otherwise\n"
+"    */\n"
+"   public boolean isSingleton();\n"
+"\n"
+"   /**\n"
+"    * Indicates if the EJB is stateful\n"
+"    * \n"
+"    * @return True if the bean is stateful, false otherwise\n"
+"    */\n"
+"   public boolean isStateful();\n"
+"\n"
+"   /**\n"
+"    * Indicates if the EJB is and MDB\n"
+"    * \n"
+"    * @return True if the bean is an MDB, false otherwise\n"
+"    */\n"
+"   public boolean isMessageDriven();\n"
+"\n"
+"   /**\n"
+"    * Gets the EJB name\n"
+"    * \n"
+"    * @return The name\n"
+"    */\n"
+"   public String getEjbName();\n"
+"   \n"
+"   /**\n"
+"    * @return The JNDI string which can be used to lookup a proxy which \n"
+"    * implements all local business interfaces \n"
+"    * \n"
+"    */\n"
+"   public String getLocalJndiName();\n"
+"   \n"
+"}]]>"
+msgstr ""
+
+#. Tag: para
+#: ri-spi.xml:52
+#, no-c-format
+msgid ""
+"The contract described the JavaDoc is enough to implement an EJBDescriptor. "
+"In addition to these two interfaces, there is "
+"<literal>BusinessInterfaceDescriptor</literal> which represents a local "
+"business interface (encapsulating the interface class and jndi name), and "
+"<literal>MethodDescriptor</literal> which encapsulates the method name and "
+"parameter types (allowing it to be invoked on any instance of the EJB, proxy "
+"or otherwise)."
+msgstr ""
+
+#. Tag: para
+#: ri-spi.xml:62
+#, no-c-format
+msgid ""
+"The Web Beans RI can be told to load your implementation of "
+"<literal>WebBeanDiscovery</literal> using the property <literal>org.jboss."
+"webbeans.bootstrap.webBeanDiscovery</literal> with the fully qualified class "
+"name as the value. For example:"
+msgstr ""
+
+#. Tag: programlisting
+#: ri-spi.xml:69
+#, no-c-format
+msgid ""
+"org.jboss.webbeans.bootstrap.webBeanDiscovery=org.jboss.webbeans.integration."
+"jbossas.WebBeanDiscoveryImpl"
+msgstr ""
+
+#. Tag: para
+#: ri-spi.xml:71
+#, no-c-format
+msgid ""
+"The property can either be specified as a system property, or in a "
+"properties file <literal>META-INF/web-beans-ri.properties</literal>."
+msgstr ""
+
+#. Tag: title
+#: ri-spi.xml:79
+#, no-c-format
+msgid "The contract with the container"
+msgstr ""
+
+#. Tag: para
+#: ri-spi.xml:81
+#, no-c-format
+msgid ""
+"There are a number of requirements that the Web Beans RI places on the "
+"container for correct functioning that fall outside implementation of APIs"
+msgstr ""
+
+#. Tag: term
+#: ri-spi.xml:89
+#, no-c-format
+msgid "Classloader isolation"
+msgstr ""
+
+#. Tag: para
+#: ri-spi.xml:93
+#, no-c-format
+msgid ""
+"If you are integrating the Web Beans into an environment that supports "
+"deployment of applications, you must enable, automatically, or through user "
+"configuation, classloader isolation for each Web Beans application"
+msgstr ""
+
+#. Tag: term
+#: ri-spi.xml:102
+#, no-c-format
+msgid "The <literal>webbeans-ri.jar</literal>"
+msgstr ""
+
+#. Tag: para
+#: ri-spi.xml:106
+#, no-c-format
+msgid ""
+"If you are integrating the Web Beans into an environment that supports "
+"deployment of applications, you must insert the <literal>webbeans-ri.jar</"
+"literal> into the applications isolated classloader. It cannot be loaded "
+"from a shared classloader."
+msgstr ""

Modified: doc/trunk/reference/es-ES/modules/ri.po
===================================================================
--- doc/trunk/reference/es-ES/modules/ri.po	2008-12-20 19:00:18 UTC (rev 630)
+++ doc/trunk/reference/es-ES/modules/ri.po	2008-12-20 22:17:05 UTC (rev 631)
@@ -5,7 +5,7 @@
 msgstr ""
 "Project-Id-Version: master.xml \n"
 "Report-Msgid-Bugs-To: http://bugs.kde.org\n"
-"POT-Creation-Date: 2008-12-19 20:26+0000\n"
+"POT-Creation-Date: 2008-12-20 22:08+0000\n"
 "PO-Revision-Date: 2008-12-19 20:26+0000\n"
 "Last-Translator: Automatically generated\n"
 "Language-Team: none\n"
@@ -62,16 +62,31 @@
 msgstr ""
 
 #. Tag: para
-#: ri.xml:30
+#: ri.xml:31
 #, no-c-format
 msgid ""
+"Next, we need to tell Web Beans where JBoss is located. Edit <literal>jboss-"
+"as/build.properties</literal> and set the <literal>jboss.home</literal> "
+"property. For example:"
+msgstr ""
+
+#. Tag: programlisting
+#: ri.xml:37
+#, no-c-format
+msgid "jboss.home=/Applications/jboss-5.0.0.GA"
+msgstr ""
+
+#. Tag: para
+#: ri.xml:39
+#, no-c-format
+msgid ""
 "As Web Beans is a new piece of software, you need to update JBoss AS to run "
 "the Web Beans RI. Future versions of JBoss AS will include these updates, "
 "and this step won't be necessary."
 msgstr ""
 
 #. Tag: para
-#: ri.xml:37
+#: ri.xml:46
 #, no-c-format
 msgid ""
 "Currently, two updates are needed. Firstly, a new deployer, "
@@ -82,7 +97,7 @@
 msgstr ""
 
 #. Tag: para
-#: ri.xml:46
+#: ri.xml:55
 #, no-c-format
 msgid ""
 "To install the update, you'll need ant 1.7.0 installed, and the "
@@ -90,7 +105,7 @@
 msgstr ""
 
 #. Tag: programlisting
-#: ri.xml:51
+#: ri.xml:60
 #, no-c-format
 msgid ""
 "$ unzip apache-ant-1.7.0.zip\n"
@@ -98,7 +113,7 @@
 msgstr ""
 
 #. Tag: para
-#: ri.xml:53
+#: ri.xml:62
 #, no-c-format
 msgid ""
 "Then, you can install the update. The update script will use Maven to "
@@ -106,7 +121,7 @@
 msgstr ""
 
 #. Tag: programlisting
-#: ri.xml:58
+#: ri.xml:67
 #, no-c-format
 msgid ""
 "$ cd webbeans-1.0.0.ALPHA1/jboss-as\n"
@@ -114,26 +129,26 @@
 msgstr ""
 
 #. Tag: para
-#: ri.xml:60
+#: ri.xml:69
 #, no-c-format
 msgid "Now, you're ready to deploy your first example!"
 msgstr ""
 
 #. Tag: para
-#: ri.xml:65
+#: ri.xml:74
 #, no-c-format
 msgid ""
 "The build scripts for the examples offer a number of targets, these are:"
 msgstr ""
 
 #. Tag: para
-#: ri.xml:71
+#: ri.xml:80
 #, no-c-format
 msgid "<literal>ant restart</literal> - deploy the example in exploded format"
 msgstr ""
 
 #. Tag: para
-#: ri.xml:77
+#: ri.xml:86
 #, no-c-format
 msgid ""
 "<literal>ant explode</literal> - update an exploded example, without "
@@ -141,32 +156,32 @@
 msgstr ""
 
 #. Tag: para
-#: ri.xml:83
+#: ri.xml:92
 #, no-c-format
 msgid ""
 "<literal>ant deploy</literal> - deploy the example in compressed jar format"
 msgstr ""
 
 #. Tag: para
-#: ri.xml:88
+#: ri.xml:97
 #, no-c-format
 msgid "<literal>ant undeploy</literal> - remove the example from the server"
 msgstr ""
 
 #. Tag: para
-#: ri.xml:93
+#: ri.xml:102
 #, no-c-format
 msgid "<literal>ant clean</literal> - clean the example"
 msgstr ""
 
 #. Tag: para
-#: ri.xml:100
+#: ri.xml:109
 #, no-c-format
 msgid "To deploy the numberguess example:"
 msgstr ""
 
 #. Tag: programlisting
-#: ri.xml:104
+#: ri.xml:113
 #, no-c-format
 msgid ""
 "$ cd examples/numberguess\n"
@@ -174,7 +189,7 @@
 msgstr ""
 
 #. Tag: para
-#: ri.xml:106
+#: ri.xml:115
 #, no-c-format
 msgid ""
 "Wait for the application to deploy, and enjoy hours of fun at <ulink url="
@@ -182,7 +197,7 @@
 msgstr ""
 
 #. Tag: para
-#: ri.xml:111
+#: ri.xml:120
 #, no-c-format
 msgid ""
 "The Web Beans RI includes a second simple example that will translate your "
@@ -192,7 +207,7 @@
 msgstr ""
 
 #. Tag: programlisting
-#: ri.xml:118
+#: ri.xml:127
 #, no-c-format
 msgid ""
 "$ cd examples/traslator\n"
@@ -200,7 +215,7 @@
 msgstr ""
 
 #. Tag: para
-#: ri.xml:120
+#: ri.xml:129
 #, no-c-format
 msgid ""
 "Wait for the application to deploy, and visit <ulink url=\"http://"
@@ -208,13 +223,13 @@
 msgstr ""
 
 #. Tag: title
-#: ri.xml:126
+#: ri.xml:135
 #, no-c-format
 msgid "The numberguess example"
 msgstr ""
 
 #. Tag: para
-#: ri.xml:128
+#: ri.xml:137
 #, no-c-format
 msgid ""
 "In the numberguess application you get given 10 attempts to guess a number "
@@ -223,7 +238,7 @@
 msgstr ""
 
 #. Tag: para
-#: ri.xml:134
+#: ri.xml:143
 #, no-c-format
 msgid ""
 "The numberguess example is comprised of a number of Web Beans, configuration "
@@ -232,7 +247,7 @@
 msgstr ""
 
 #. Tag: para
-#: ri.xml:140
+#: ri.xml:149
 #, no-c-format
 msgid ""
 "All the configuration files for this example are located in <literal>WEB-INF/"
@@ -242,7 +257,7 @@
 msgstr ""
 
 #. Tag: programlisting
-#: ri.xml:148
+#: ri.xml:157
 #, no-c-format
 msgid ""
 "<![CDATA[<?xml version='1.0' encoding='UTF-8'?>\n"
@@ -260,7 +275,7 @@
 msgstr ""
 
 #. Tag: para
-#: ri.xml:150
+#: ri.xml:159
 #, no-c-format
 msgid ""
 "There is an empty <literal>web-beans.xml</literal> file, which marks this "
@@ -268,13 +283,13 @@
 msgstr ""
 
 #. Tag: para
-#: ri.xml:155
+#: ri.xml:164
 #, no-c-format
 msgid "Finally there is <literal>web.xml</literal>:"
 msgstr ""
 
 #. Tag: section
-#: ri.xml:157
+#: ri.xml:166
 #, no-c-format
 msgid ""
 "<programlistingco> <areaspec> <area id=\"faces.servlet\" coords=\"12\"/> "
@@ -400,7 +415,7 @@
 msgstr ""
 
 #. Tag: para
-#: ri.xml:270
+#: ri.xml:279
 #, no-c-format
 msgid ""
 "The example exists of 4 classes, the first two of which are binding types. "
@@ -409,7 +424,7 @@
 msgstr ""
 
 #. Tag: programlisting
-#: ri.xml:276
+#: ri.xml:285
 #, no-c-format
 msgid ""
 "<![CDATA[@Target( { TYPE, METHOD, PARAMETER, FIELD })\n"
@@ -420,7 +435,7 @@
 msgstr ""
 
 #. Tag: para
-#: ri.xml:278
+#: ri.xml:287
 #, no-c-format
 msgid ""
 "There is also the <literal>@MaxNumber</literal> binding type, used for "
@@ -428,7 +443,7 @@
 msgstr ""
 
 #. Tag: programlisting
-#: ri.xml:283
+#: ri.xml:292
 #, no-c-format
 msgid ""
 "<![CDATA[@Target( { TYPE, METHOD, PARAMETER, FIELD })\n"
@@ -440,7 +455,7 @@
 msgstr ""
 
 #. Tag: para
-#: ri.xml:285
+#: ri.xml:294
 #, no-c-format
 msgid ""
 "The <literal>Generator</literal> class is responsible for creating the "
@@ -449,7 +464,7 @@
 msgstr ""
 
 #. Tag: programlisting
-#: ri.xml:291
+#: ri.xml:300
 #, no-c-format
 msgid ""
 "<![CDATA[@ApplicationScoped\n"
@@ -478,7 +493,7 @@
 msgstr ""
 
 #. Tag: para
-#: ri.xml:293
+#: ri.xml:302
 #, no-c-format
 msgid ""
 "You'll notice that the <literal>Generator</literal> is application scoped; "
@@ -486,7 +501,7 @@
 msgstr ""
 
 #. Tag: para
-#: ri.xml:298
+#: ri.xml:307
 #, no-c-format
 msgid ""
 "The final Web Bean in the application is the session scoped <literal>Game</"
@@ -496,7 +511,7 @@
 msgstr ""
 
 #. Tag: para
-#: ri.xml:305
+#: ri.xml:314
 #, no-c-format
 msgid ""
 "You'll also note that we've used the <literal>@Named</literal> annotation, "
@@ -507,7 +522,7 @@
 msgstr ""
 
 #. Tag: programlisting
-#: ri.xml:313
+#: ri.xml:322
 #, no-c-format
 msgid ""
 "<![CDATA[@Named\n"
@@ -551,13 +566,13 @@
 msgstr ""
 
 #. Tag: title
-#: ri.xml:317
+#: ri.xml:326
 #, no-c-format
 msgid "The translator example"
 msgstr ""
 
 #. Tag: para
-#: ri.xml:319
+#: ri.xml:328
 #, no-c-format
 msgid ""
 "The translator example will take any sentences you enter, and translate them "
@@ -565,7 +580,7 @@
 msgstr ""
 
 #. Tag: para
-#: ri.xml:324
+#: ri.xml:333
 #, no-c-format
 msgid ""
 "The translator example is built as an ear, and contains EJBs and enterprise "
@@ -574,7 +589,7 @@
 msgstr ""
 
 #. Tag: para
-#: ri.xml:331
+#: ri.xml:340
 #, no-c-format
 msgid ""
 "EJB 3.1 and Jave EE 6 allow you to package EJBs in a war, which will make "
@@ -582,7 +597,7 @@
 msgstr ""
 
 #. Tag: para
-#: ri.xml:337
+#: ri.xml:346
 #, no-c-format
 msgid ""
 "First, let's take a look at the ear aggregator, which is located in "
@@ -592,7 +607,7 @@
 msgstr ""
 
 #. Tag: programlisting
-#: ri.xml:344
+#: ri.xml:353
 #, no-c-format
 msgid ""
 "<![CDATA[<plugin>\n"
@@ -615,7 +630,7 @@
 msgstr ""
 
 #. Tag: para
-#: ri.xml:346
+#: ri.xml:355
 #, no-c-format
 msgid ""
 "We're doing a couple of things here - firstly we set the context path, which "
@@ -625,7 +640,7 @@
 msgstr ""
 
 #. Tag: para
-#: ri.xml:354
+#: ri.xml:363
 #, no-c-format
 msgid ""
 "If you aren't using Maven to generate these files, you would need "
@@ -633,7 +648,7 @@
 msgstr ""
 
 #. Tag: programlisting
-#: ri.xml:359
+#: ri.xml:368
 #, no-c-format
 msgid ""
 "<![CDATA[<?xml version=\"1.0\" encoding=\"UTF-8\"?>\n"
@@ -647,13 +662,13 @@
 msgstr ""
 
 #. Tag: para
-#: ri.xml:361
+#: ri.xml:370
 #, no-c-format
 msgid "and <literal>META-INF/application.xml</literal>:"
 msgstr ""
 
 #. Tag: programlisting
-#: ri.xml:365
+#: ri.xml:374
 #, no-c-format
 msgid ""
 "<![CDATA[<?xml version=\"1.0\" encoding=\"UTF-8\"?>\n"
@@ -679,7 +694,7 @@
 msgstr ""
 
 #. Tag: para
-#: ri.xml:368
+#: ri.xml:377
 #, no-c-format
 msgid ""
 "Next, lets look at the war. Just as in the numberguess example, we have a "
@@ -689,7 +704,7 @@
 msgstr ""
 
 #. Tag: para
-#: ri.xml:375
+#: ri.xml:384
 #, no-c-format
 msgid ""
 "More intersting is the facelet used to translate text. Just as in the "
@@ -698,7 +713,7 @@
 msgstr ""
 
 #. Tag: programlisting
-#: ri.xml:381
+#: ri.xml:390
 #, no-c-format
 msgid ""
 "<![CDATA[<h:form id=\"NumberGuessMain\">\n"
@@ -731,7 +746,7 @@
 msgstr ""
 
 #. Tag: para
-#: ri.xml:383
+#: ri.xml:392
 #, no-c-format
 msgid ""
 "The user can enter some text in the lefthand textarea, and hit the translate "
@@ -739,7 +754,7 @@
 msgstr ""
 
 #. Tag: para
-#: ri.xml:388
+#: ri.xml:397
 #, no-c-format
 msgid ""
 "Finally, let's look at the ejb module, <literal>webbeans-translator-ejb</"
@@ -752,7 +767,7 @@
 msgstr ""
 
 #. Tag: programlisting
-#: ri.xml:400
+#: ri.xml:409
 #, no-c-format
 msgid ""
 "<![CDATA[<?xml version=\"1.0\" encoding=\"UTF-8\"?>\n"
@@ -781,7 +796,7 @@
 msgstr ""
 
 #. Tag: para
-#: ri.xml:402
+#: ri.xml:411
 #, no-c-format
 msgid ""
 "We've saved the most interesting bit to last, the code! The project has two "
@@ -793,7 +808,7 @@
 msgstr ""
 
 #. Tag: para
-#: ri.xml:412
+#: ri.xml:421
 #, no-c-format
 msgid ""
 "Both <literal>SentanceParser</literal> and <literal>TextTranslator</literal> "
@@ -802,7 +817,7 @@
 msgstr ""
 
 #. Tag: programlisting
-#: ri.xml:418
+#: ri.xml:427
 #, no-c-format
 msgid ""
 "<![CDATA[public class TextTranslator { \n"
@@ -818,7 +833,7 @@
 msgstr ""
 
 #. Tag: para
-#: ri.xml:420
+#: ri.xml:429
 #, no-c-format
 msgid ""
 "<literal>TextTranslator</literal> is a stateless bean (with a local business "
@@ -827,7 +842,7 @@
 msgstr ""
 
 #. Tag: para
-#: ri.xml:426
+#: ri.xml:435
 #, no-c-format
 msgid ""
 "Finally, there is UI orientated controller, that collects the text from the "
@@ -836,7 +851,7 @@
 msgstr ""
 
 #. Tag: programlisting
-#: ri.xml:432
+#: ri.xml:441
 #, no-c-format
 msgid ""
 "<![CDATA[@Stateful\n"
@@ -849,19 +864,19 @@
 msgstr ""
 
 #. Tag: para
-#: ri.xml:434
+#: ri.xml:443
 #, no-c-format
 msgid "The bean also has getters and setters for all the fields on the page."
 msgstr ""
 
 #. Tag: para
-#: ri.xml:438
+#: ri.xml:447
 #, no-c-format
 msgid "As this is a stateful session bean, we have to have a remove method:"
 msgstr ""
 
 #. Tag: programlisting
-#: ri.xml:442
+#: ri.xml:451
 #, no-c-format
 msgid ""
 "<![CDATA[   @Remove\n"
@@ -872,7 +887,7 @@
 msgstr ""
 
 #. Tag: para
-#: ri.xml:444
+#: ri.xml:453
 #, no-c-format
 msgid ""
 "The Web Beans manager will call the remove method for you when the bean is "
@@ -880,7 +895,7 @@
 msgstr ""
 
 #. Tag: para
-#: ri.xml:450
+#: ri.xml:459
 #, no-c-format
 msgid ""
 "That concludes our short tour of the Web Beans RI examples. For more on the "
@@ -890,7 +905,7 @@
 msgstr ""
 
 #. Tag: para
-#: ri.xml:456
+#: ri.xml:465
 #, no-c-format
 msgid ""
 "We need help in all areas - bug fixing, writing new features, writing "

Modified: doc/trunk/reference/fr-FR/modules/ee.po
===================================================================
--- doc/trunk/reference/fr-FR/modules/ee.po	2008-12-20 19:00:18 UTC (rev 630)
+++ doc/trunk/reference/fr-FR/modules/ee.po	2008-12-20 22:17:05 UTC (rev 631)
@@ -5,7 +5,7 @@
 msgstr ""
 "Project-Id-Version: master.xml \n"
 "Report-Msgid-Bugs-To: http://bugs.kde.org\n"
-"POT-Creation-Date: 2008-12-19 20:26+0000\n"
+"POT-Creation-Date: 2008-12-20 22:08+0000\n"
 "PO-Revision-Date: 2008-12-19 20:26+0000\n"
 "Last-Translator: Automatically generated\n"
 "Language-Team: none\n"
@@ -296,7 +296,7 @@
 #: ee.xml:100
 #, no-c-format
 msgid ""
-"The lifecycle of the injected JMS objects are completely controlled by the "
+"The lifecycle of the injected JMS objects is completely controlled by the "
 "Web Bean manager."
 msgstr ""
 

Modified: doc/trunk/reference/fr-FR/modules/producermethods.po
===================================================================
--- doc/trunk/reference/fr-FR/modules/producermethods.po	2008-12-20 19:00:18 UTC (rev 630)
+++ doc/trunk/reference/fr-FR/modules/producermethods.po	2008-12-20 22:17:05 UTC (rev 631)
@@ -5,7 +5,7 @@
 msgstr ""
 "Project-Id-Version: master.xml \n"
 "Report-Msgid-Bugs-To: http://bugs.kde.org\n"
-"POT-Creation-Date: 2008-12-19 20:26+0000\n"
+"POT-Creation-Date: 2008-12-20 22:08+0000\n"
 "PO-Revision-Date: 2008-12-19 20:26+0000\n"
 "Last-Translator: Automatically generated\n"
 "Language-Team: none\n"
@@ -57,7 +57,8 @@
 "polymorphism with Web Beans. As we've seen, deployment types are a powerful "
 "solution to the problem of deployment-time polymorphism. But once the system "
 "is deployed, the Web Bean implementation is fixed. A producer method has no "
-"such limitation:</para> <programlisting><![CDATA[@SessionScoped\n"
+"such limitation:</para> <programlisting role=\"JAVA\"><![CDATA"
+"[@SessionScoped\n"
 "public class Preferences {\n"
 "    \n"
 "    private PaymentStrategyType paymentStrategy;\n"
@@ -75,12 +76,12 @@
 "    }\n"
 "    \n"
 "}]]></programlisting> <para>Consider an injection point:</para> "
-"<programlisting><![CDATA[@Preferred PaymentStrategy paymentStrat;]]></"
-"programlisting> <para>This injection point has the same type and binding "
-"annotations as the producer method, so it resolves to the producer method "
-"using the usual Web Beans injection rules. The producer method will be "
-"called by the Web Bean manager to obtain an instance to service this "
-"injection point.</para>."
+"<programlisting role=\"JAVA\"><![CDATA[@Preferred PaymentStrategy "
+"paymentStrat;]]></programlisting> <para>This injection point has the same "
+"type and binding annotations as the producer method, so it resolves to the "
+"producer method using the usual Web Beans injection rules. The producer "
+"method will be called by the Web Bean manager to obtain an instance to "
+"service this injection point.</para>."
 msgstr ""
 
 #. Tag: title

Added: doc/trunk/reference/fr-FR/modules/ri-spi.po
===================================================================
--- doc/trunk/reference/fr-FR/modules/ri-spi.po	                        (rev 0)
+++ doc/trunk/reference/fr-FR/modules/ri-spi.po	2008-12-20 22:17:05 UTC (rev 631)
@@ -0,0 +1,275 @@
+# Language fr-FR translations for master.xml package.
+# Automatically generated, 2008.
+#
+msgid ""
+msgstr ""
+"Project-Id-Version: master.xml \n"
+"Report-Msgid-Bugs-To: http://bugs.kde.org\n"
+"POT-Creation-Date: 2008-12-20 22:07+0000\n"
+"PO-Revision-Date: 2008-12-20 22:07+0000\n"
+"Last-Translator: Automatically generated\n"
+"Language-Team: none\n"
+"MIME-Version: 1.0\n"
+"Content-Type: text/plain; charset=UTF-8\n"
+"Content-Transfer-Encoding: 8bit\n"
+
+#. Tag: title
+#: ri-spi.xml:4
+#, no-c-format
+msgid "Integrating the Web Beans RI into other environments"
+msgstr ""
+
+#. Tag: para
+#: ri-spi.xml:6
+#, no-c-format
+msgid ""
+"Currently the Web Beans RI only runs in JBoss AS 5; integrating the RI into "
+"other EE environments (for example another application server like "
+"Glassfish), into a servlet container (like Tomcat), or with an Embedded "
+"EJB3.1 implementation is fairly easy. In this Appendix we will briefly "
+"discuss the steps needed."
+msgstr ""
+
+#. Tag: para
+#: ri-spi.xml:15
+#, no-c-format
+msgid ""
+"It should be possible to run Web Beans in an SE environment, but you'll to "
+"do more work, adding your own contexts and lifecycle. The Web Beans RI "
+"currently doesn't expose lifecycle extension points, so you would have to "
+"code directly against Web Beans RI classes."
+msgstr ""
+
+#. Tag: title
+#: ri-spi.xml:24
+#, no-c-format
+msgid "The Web Beans RI SPI"
+msgstr ""
+
+#. Tag: para
+#: ri-spi.xml:26
+#, no-c-format
+msgid ""
+"The Web Beans SPI is located in <literal>webbeans-ri-spi</literal> module, "
+"and packaged as <literal>webbeans-ri-spi.jar</literal>."
+msgstr ""
+
+#. Tag: para
+#: ri-spi.xml:31
+#, no-c-format
+msgid "Currently, the only SPI to implement is the bootstrap spi:"
+msgstr ""
+
+#. Tag: programlisting
+#: ri-spi.xml:35
+#, no-c-format
+msgid ""
+"<![CDATA[public interface WebBeanDiscovery {\n"
+"   /**\n"
+"    * Gets list of all classes in classpath archives with web-beans.xml "
+"files\n"
+"    * \n"
+"    * @return An iterable over the classes \n"
+"    */\n"
+"   public Iterable<Class<?>> discoverWebBeanClasses();\n"
+"   \n"
+"   /**\n"
+"    * Gets a list of all web-beans.xml files in the app classpath\n"
+"    * \n"
+"    * @return An iterable over the web-beans.xml files \n"
+"    */\n"
+"   public Iterable<URL> discoverWebBeansXml();\n"
+"   \n"
+"   /**\n"
+"    * Gets a descriptor for each EJB in the application\n"
+"    * \n"
+"    * @return The bean class to descriptor map \n"
+"    */\n"
+"   public Iterable<EjbDescriptor<?>> discoverEjbs();\n"
+"   \n"
+"}]]>"
+msgstr ""
+
+#. Tag: para
+#: ri-spi.xml:37
+#, no-c-format
+msgid ""
+"The discovery of Web Bean classes and <literal>web-bean.xml</literal> files "
+"is self-explanatory (the algorithm is described in Section 11.1 of the JSR-"
+"299 specification, and isn't repeated here)."
+msgstr ""
+
+#. Tag: para
+#: ri-spi.xml:43
+#, no-c-format
+msgid ""
+"The Web Beans RI also delegates EJB3 bean discovery to the container so that "
+"it doesn't have to scan for EJB3 annotations or parse <literal>ejb-jar.xml</"
+"literal>. For each EJB in the application an EJBDescriptor should be "
+"discovered:"
+msgstr ""
+
+#. Tag: programlisting
+#: ri-spi.xml:50
+#, no-c-format
+msgid ""
+"<![CDATA[public interface EjbDescriptor<T> {\n"
+"   \n"
+"   /**\n"
+"    * Gets the EJB type\n"
+"    * \n"
+"    * @return The EJB Bean class\n"
+"    */\n"
+"   public Class<T> getType();\n"
+"\n"
+"   /**\n"
+"    * Gets the local business interfaces of the EJB\n"
+"    * \n"
+"    * @return An iterator over the local business interfaces\n"
+"    */\n"
+"   public Iterable<BusinessInterfaceDescriptor<?>> getLocalBusinessInterfaces"
+"();\n"
+"   \n"
+"   /**\n"
+"    * Gets the remote business interfaces of the EJB\n"
+"    * \n"
+"    * @return An iterator over the remote business interfaces\n"
+"    */\n"
+"   public Iterable<BusinessInterfaceDescriptor<?>> "
+"getRemoteBusinessInterfaces();\n"
+"   \n"
+"   /**\n"
+"    * Get the remove methods of the EJB\n"
+"    * \n"
+"    * @return An iterator over the remove methods\n"
+"    */\n"
+"   public Iterable<MethodDescriptor> getRemoveMethods();\n"
+"\n"
+"   /**\n"
+"    * Indicates if the bean is stateless\n"
+"    * \n"
+"    * @return True if stateless, false otherwise\n"
+"    */\n"
+"   public boolean isStateless();\n"
+"\n"
+"   /**\n"
+"    * Indicates if the bean is a EJB 3.1 Singleton\n"
+"    * \n"
+"    * @return True if the bean is a singleton, false otherwise\n"
+"    */\n"
+"   public boolean isSingleton();\n"
+"\n"
+"   /**\n"
+"    * Indicates if the EJB is stateful\n"
+"    * \n"
+"    * @return True if the bean is stateful, false otherwise\n"
+"    */\n"
+"   public boolean isStateful();\n"
+"\n"
+"   /**\n"
+"    * Indicates if the EJB is and MDB\n"
+"    * \n"
+"    * @return True if the bean is an MDB, false otherwise\n"
+"    */\n"
+"   public boolean isMessageDriven();\n"
+"\n"
+"   /**\n"
+"    * Gets the EJB name\n"
+"    * \n"
+"    * @return The name\n"
+"    */\n"
+"   public String getEjbName();\n"
+"   \n"
+"   /**\n"
+"    * @return The JNDI string which can be used to lookup a proxy which \n"
+"    * implements all local business interfaces \n"
+"    * \n"
+"    */\n"
+"   public String getLocalJndiName();\n"
+"   \n"
+"}]]>"
+msgstr ""
+
+#. Tag: para
+#: ri-spi.xml:52
+#, no-c-format
+msgid ""
+"The contract described the JavaDoc is enough to implement an EJBDescriptor. "
+"In addition to these two interfaces, there is "
+"<literal>BusinessInterfaceDescriptor</literal> which represents a local "
+"business interface (encapsulating the interface class and jndi name), and "
+"<literal>MethodDescriptor</literal> which encapsulates the method name and "
+"parameter types (allowing it to be invoked on any instance of the EJB, proxy "
+"or otherwise)."
+msgstr ""
+
+#. Tag: para
+#: ri-spi.xml:62
+#, no-c-format
+msgid ""
+"The Web Beans RI can be told to load your implementation of "
+"<literal>WebBeanDiscovery</literal> using the property <literal>org.jboss."
+"webbeans.bootstrap.webBeanDiscovery</literal> with the fully qualified class "
+"name as the value. For example:"
+msgstr ""
+
+#. Tag: programlisting
+#: ri-spi.xml:69
+#, no-c-format
+msgid ""
+"org.jboss.webbeans.bootstrap.webBeanDiscovery=org.jboss.webbeans.integration."
+"jbossas.WebBeanDiscoveryImpl"
+msgstr ""
+
+#. Tag: para
+#: ri-spi.xml:71
+#, no-c-format
+msgid ""
+"The property can either be specified as a system property, or in a "
+"properties file <literal>META-INF/web-beans-ri.properties</literal>."
+msgstr ""
+
+#. Tag: title
+#: ri-spi.xml:79
+#, no-c-format
+msgid "The contract with the container"
+msgstr ""
+
+#. Tag: para
+#: ri-spi.xml:81
+#, no-c-format
+msgid ""
+"There are a number of requirements that the Web Beans RI places on the "
+"container for correct functioning that fall outside implementation of APIs"
+msgstr ""
+
+#. Tag: term
+#: ri-spi.xml:89
+#, no-c-format
+msgid "Classloader isolation"
+msgstr ""
+
+#. Tag: para
+#: ri-spi.xml:93
+#, no-c-format
+msgid ""
+"If you are integrating the Web Beans into an environment that supports "
+"deployment of applications, you must enable, automatically, or through user "
+"configuation, classloader isolation for each Web Beans application"
+msgstr ""
+
+#. Tag: term
+#: ri-spi.xml:102
+#, no-c-format
+msgid "The <literal>webbeans-ri.jar</literal>"
+msgstr ""
+
+#. Tag: para
+#: ri-spi.xml:106
+#, no-c-format
+msgid ""
+"If you are integrating the Web Beans into an environment that supports "
+"deployment of applications, you must insert the <literal>webbeans-ri.jar</"
+"literal> into the applications isolated classloader. It cannot be loaded "
+"from a shared classloader."
+msgstr ""

Modified: doc/trunk/reference/fr-FR/modules/ri.po
===================================================================
--- doc/trunk/reference/fr-FR/modules/ri.po	2008-12-20 19:00:18 UTC (rev 630)
+++ doc/trunk/reference/fr-FR/modules/ri.po	2008-12-20 22:17:05 UTC (rev 631)
@@ -5,7 +5,7 @@
 msgstr ""
 "Project-Id-Version: master.xml \n"
 "Report-Msgid-Bugs-To: http://bugs.kde.org\n"
-"POT-Creation-Date: 2008-12-19 20:26+0000\n"
+"POT-Creation-Date: 2008-12-20 22:08+0000\n"
 "PO-Revision-Date: 2008-12-19 20:26+0000\n"
 "Last-Translator: Automatically generated\n"
 "Language-Team: none\n"
@@ -62,16 +62,31 @@
 msgstr ""
 
 #. Tag: para
-#: ri.xml:30
+#: ri.xml:31
 #, no-c-format
 msgid ""
+"Next, we need to tell Web Beans where JBoss is located. Edit <literal>jboss-"
+"as/build.properties</literal> and set the <literal>jboss.home</literal> "
+"property. For example:"
+msgstr ""
+
+#. Tag: programlisting
+#: ri.xml:37
+#, no-c-format
+msgid "jboss.home=/Applications/jboss-5.0.0.GA"
+msgstr ""
+
+#. Tag: para
+#: ri.xml:39
+#, no-c-format
+msgid ""
 "As Web Beans is a new piece of software, you need to update JBoss AS to run "
 "the Web Beans RI. Future versions of JBoss AS will include these updates, "
 "and this step won't be necessary."
 msgstr ""
 
 #. Tag: para
-#: ri.xml:37
+#: ri.xml:46
 #, no-c-format
 msgid ""
 "Currently, two updates are needed. Firstly, a new deployer, "
@@ -82,7 +97,7 @@
 msgstr ""
 
 #. Tag: para
-#: ri.xml:46
+#: ri.xml:55
 #, no-c-format
 msgid ""
 "To install the update, you'll need ant 1.7.0 installed, and the "
@@ -90,7 +105,7 @@
 msgstr ""
 
 #. Tag: programlisting
-#: ri.xml:51
+#: ri.xml:60
 #, no-c-format
 msgid ""
 "$ unzip apache-ant-1.7.0.zip\n"
@@ -98,7 +113,7 @@
 msgstr ""
 
 #. Tag: para
-#: ri.xml:53
+#: ri.xml:62
 #, no-c-format
 msgid ""
 "Then, you can install the update. The update script will use Maven to "
@@ -106,7 +121,7 @@
 msgstr ""
 
 #. Tag: programlisting
-#: ri.xml:58
+#: ri.xml:67
 #, no-c-format
 msgid ""
 "$ cd webbeans-1.0.0.ALPHA1/jboss-as\n"
@@ -114,26 +129,26 @@
 msgstr ""
 
 #. Tag: para
-#: ri.xml:60
+#: ri.xml:69
 #, no-c-format
 msgid "Now, you're ready to deploy your first example!"
 msgstr ""
 
 #. Tag: para
-#: ri.xml:65
+#: ri.xml:74
 #, no-c-format
 msgid ""
 "The build scripts for the examples offer a number of targets, these are:"
 msgstr ""
 
 #. Tag: para
-#: ri.xml:71
+#: ri.xml:80
 #, no-c-format
 msgid "<literal>ant restart</literal> - deploy the example in exploded format"
 msgstr ""
 
 #. Tag: para
-#: ri.xml:77
+#: ri.xml:86
 #, no-c-format
 msgid ""
 "<literal>ant explode</literal> - update an exploded example, without "
@@ -141,32 +156,32 @@
 msgstr ""
 
 #. Tag: para
-#: ri.xml:83
+#: ri.xml:92
 #, no-c-format
 msgid ""
 "<literal>ant deploy</literal> - deploy the example in compressed jar format"
 msgstr ""
 
 #. Tag: para
-#: ri.xml:88
+#: ri.xml:97
 #, no-c-format
 msgid "<literal>ant undeploy</literal> - remove the example from the server"
 msgstr ""
 
 #. Tag: para
-#: ri.xml:93
+#: ri.xml:102
 #, no-c-format
 msgid "<literal>ant clean</literal> - clean the example"
 msgstr ""
 
 #. Tag: para
-#: ri.xml:100
+#: ri.xml:109
 #, no-c-format
 msgid "To deploy the numberguess example:"
 msgstr ""
 
 #. Tag: programlisting
-#: ri.xml:104
+#: ri.xml:113
 #, no-c-format
 msgid ""
 "$ cd examples/numberguess\n"
@@ -174,7 +189,7 @@
 msgstr ""
 
 #. Tag: para
-#: ri.xml:106
+#: ri.xml:115
 #, no-c-format
 msgid ""
 "Wait for the application to deploy, and enjoy hours of fun at <ulink url="
@@ -182,7 +197,7 @@
 msgstr ""
 
 #. Tag: para
-#: ri.xml:111
+#: ri.xml:120
 #, no-c-format
 msgid ""
 "The Web Beans RI includes a second simple example that will translate your "
@@ -192,7 +207,7 @@
 msgstr ""
 
 #. Tag: programlisting
-#: ri.xml:118
+#: ri.xml:127
 #, no-c-format
 msgid ""
 "$ cd examples/traslator\n"
@@ -200,7 +215,7 @@
 msgstr ""
 
 #. Tag: para
-#: ri.xml:120
+#: ri.xml:129
 #, no-c-format
 msgid ""
 "Wait for the application to deploy, and visit <ulink url=\"http://"
@@ -208,13 +223,13 @@
 msgstr ""
 
 #. Tag: title
-#: ri.xml:126
+#: ri.xml:135
 #, no-c-format
 msgid "The numberguess example"
 msgstr ""
 
 #. Tag: para
-#: ri.xml:128
+#: ri.xml:137
 #, no-c-format
 msgid ""
 "In the numberguess application you get given 10 attempts to guess a number "
@@ -223,7 +238,7 @@
 msgstr ""
 
 #. Tag: para
-#: ri.xml:134
+#: ri.xml:143
 #, no-c-format
 msgid ""
 "The numberguess example is comprised of a number of Web Beans, configuration "
@@ -232,7 +247,7 @@
 msgstr ""
 
 #. Tag: para
-#: ri.xml:140
+#: ri.xml:149
 #, no-c-format
 msgid ""
 "All the configuration files for this example are located in <literal>WEB-INF/"
@@ -242,7 +257,7 @@
 msgstr ""
 
 #. Tag: programlisting
-#: ri.xml:148
+#: ri.xml:157
 #, no-c-format
 msgid ""
 "<![CDATA[<?xml version='1.0' encoding='UTF-8'?>\n"
@@ -260,7 +275,7 @@
 msgstr ""
 
 #. Tag: para
-#: ri.xml:150
+#: ri.xml:159
 #, no-c-format
 msgid ""
 "There is an empty <literal>web-beans.xml</literal> file, which marks this "
@@ -268,13 +283,13 @@
 msgstr ""
 
 #. Tag: para
-#: ri.xml:155
+#: ri.xml:164
 #, no-c-format
 msgid "Finally there is <literal>web.xml</literal>:"
 msgstr ""
 
 #. Tag: section
-#: ri.xml:157
+#: ri.xml:166
 #, no-c-format
 msgid ""
 "<programlistingco> <areaspec> <area id=\"faces.servlet\" coords=\"12\"/> "
@@ -400,7 +415,7 @@
 msgstr ""
 
 #. Tag: para
-#: ri.xml:270
+#: ri.xml:279
 #, no-c-format
 msgid ""
 "The example exists of 4 classes, the first two of which are binding types. "
@@ -409,7 +424,7 @@
 msgstr ""
 
 #. Tag: programlisting
-#: ri.xml:276
+#: ri.xml:285
 #, no-c-format
 msgid ""
 "<![CDATA[@Target( { TYPE, METHOD, PARAMETER, FIELD })\n"
@@ -420,7 +435,7 @@
 msgstr ""
 
 #. Tag: para
-#: ri.xml:278
+#: ri.xml:287
 #, no-c-format
 msgid ""
 "There is also the <literal>@MaxNumber</literal> binding type, used for "
@@ -428,7 +443,7 @@
 msgstr ""
 
 #. Tag: programlisting
-#: ri.xml:283
+#: ri.xml:292
 #, no-c-format
 msgid ""
 "<![CDATA[@Target( { TYPE, METHOD, PARAMETER, FIELD })\n"
@@ -440,7 +455,7 @@
 msgstr ""
 
 #. Tag: para
-#: ri.xml:285
+#: ri.xml:294
 #, no-c-format
 msgid ""
 "The <literal>Generator</literal> class is responsible for creating the "
@@ -449,7 +464,7 @@
 msgstr ""
 
 #. Tag: programlisting
-#: ri.xml:291
+#: ri.xml:300
 #, no-c-format
 msgid ""
 "<![CDATA[@ApplicationScoped\n"
@@ -478,7 +493,7 @@
 msgstr ""
 
 #. Tag: para
-#: ri.xml:293
+#: ri.xml:302
 #, no-c-format
 msgid ""
 "You'll notice that the <literal>Generator</literal> is application scoped; "
@@ -486,7 +501,7 @@
 msgstr ""
 
 #. Tag: para
-#: ri.xml:298
+#: ri.xml:307
 #, no-c-format
 msgid ""
 "The final Web Bean in the application is the session scoped <literal>Game</"
@@ -496,7 +511,7 @@
 msgstr ""
 
 #. Tag: para
-#: ri.xml:305
+#: ri.xml:314
 #, no-c-format
 msgid ""
 "You'll also note that we've used the <literal>@Named</literal> annotation, "
@@ -507,7 +522,7 @@
 msgstr ""
 
 #. Tag: programlisting
-#: ri.xml:313
+#: ri.xml:322
 #, no-c-format
 msgid ""
 "<![CDATA[@Named\n"
@@ -551,13 +566,13 @@
 msgstr ""
 
 #. Tag: title
-#: ri.xml:317
+#: ri.xml:326
 #, no-c-format
 msgid "The translator example"
 msgstr ""
 
 #. Tag: para
-#: ri.xml:319
+#: ri.xml:328
 #, no-c-format
 msgid ""
 "The translator example will take any sentences you enter, and translate them "
@@ -565,7 +580,7 @@
 msgstr ""
 
 #. Tag: para
-#: ri.xml:324
+#: ri.xml:333
 #, no-c-format
 msgid ""
 "The translator example is built as an ear, and contains EJBs and enterprise "
@@ -574,7 +589,7 @@
 msgstr ""
 
 #. Tag: para
-#: ri.xml:331
+#: ri.xml:340
 #, no-c-format
 msgid ""
 "EJB 3.1 and Jave EE 6 allow you to package EJBs in a war, which will make "
@@ -582,7 +597,7 @@
 msgstr ""
 
 #. Tag: para
-#: ri.xml:337
+#: ri.xml:346
 #, no-c-format
 msgid ""
 "First, let's take a look at the ear aggregator, which is located in "
@@ -592,7 +607,7 @@
 msgstr ""
 
 #. Tag: programlisting
-#: ri.xml:344
+#: ri.xml:353
 #, no-c-format
 msgid ""
 "<![CDATA[<plugin>\n"
@@ -615,7 +630,7 @@
 msgstr ""
 
 #. Tag: para
-#: ri.xml:346
+#: ri.xml:355
 #, no-c-format
 msgid ""
 "We're doing a couple of things here - firstly we set the context path, which "
@@ -625,7 +640,7 @@
 msgstr ""
 
 #. Tag: para
-#: ri.xml:354
+#: ri.xml:363
 #, no-c-format
 msgid ""
 "If you aren't using Maven to generate these files, you would need "
@@ -633,7 +648,7 @@
 msgstr ""
 
 #. Tag: programlisting
-#: ri.xml:359
+#: ri.xml:368
 #, no-c-format
 msgid ""
 "<![CDATA[<?xml version=\"1.0\" encoding=\"UTF-8\"?>\n"
@@ -647,13 +662,13 @@
 msgstr ""
 
 #. Tag: para
-#: ri.xml:361
+#: ri.xml:370
 #, no-c-format
 msgid "and <literal>META-INF/application.xml</literal>:"
 msgstr ""
 
 #. Tag: programlisting
-#: ri.xml:365
+#: ri.xml:374
 #, no-c-format
 msgid ""
 "<![CDATA[<?xml version=\"1.0\" encoding=\"UTF-8\"?>\n"
@@ -679,7 +694,7 @@
 msgstr ""
 
 #. Tag: para
-#: ri.xml:368
+#: ri.xml:377
 #, no-c-format
 msgid ""
 "Next, lets look at the war. Just as in the numberguess example, we have a "
@@ -689,7 +704,7 @@
 msgstr ""
 
 #. Tag: para
-#: ri.xml:375
+#: ri.xml:384
 #, no-c-format
 msgid ""
 "More intersting is the facelet used to translate text. Just as in the "
@@ -698,7 +713,7 @@
 msgstr ""
 
 #. Tag: programlisting
-#: ri.xml:381
+#: ri.xml:390
 #, no-c-format
 msgid ""
 "<![CDATA[<h:form id=\"NumberGuessMain\">\n"
@@ -731,7 +746,7 @@
 msgstr ""
 
 #. Tag: para
-#: ri.xml:383
+#: ri.xml:392
 #, no-c-format
 msgid ""
 "The user can enter some text in the lefthand textarea, and hit the translate "
@@ -739,7 +754,7 @@
 msgstr ""
 
 #. Tag: para
-#: ri.xml:388
+#: ri.xml:397
 #, no-c-format
 msgid ""
 "Finally, let's look at the ejb module, <literal>webbeans-translator-ejb</"
@@ -752,7 +767,7 @@
 msgstr ""
 
 #. Tag: programlisting
-#: ri.xml:400
+#: ri.xml:409
 #, no-c-format
 msgid ""
 "<![CDATA[<?xml version=\"1.0\" encoding=\"UTF-8\"?>\n"
@@ -781,7 +796,7 @@
 msgstr ""
 
 #. Tag: para
-#: ri.xml:402
+#: ri.xml:411
 #, no-c-format
 msgid ""
 "We've saved the most interesting bit to last, the code! The project has two "
@@ -793,7 +808,7 @@
 msgstr ""
 
 #. Tag: para
-#: ri.xml:412
+#: ri.xml:421
 #, no-c-format
 msgid ""
 "Both <literal>SentanceParser</literal> and <literal>TextTranslator</literal> "
@@ -802,7 +817,7 @@
 msgstr ""
 
 #. Tag: programlisting
-#: ri.xml:418
+#: ri.xml:427
 #, no-c-format
 msgid ""
 "<![CDATA[public class TextTranslator { \n"
@@ -818,7 +833,7 @@
 msgstr ""
 
 #. Tag: para
-#: ri.xml:420
+#: ri.xml:429
 #, no-c-format
 msgid ""
 "<literal>TextTranslator</literal> is a stateless bean (with a local business "
@@ -827,7 +842,7 @@
 msgstr ""
 
 #. Tag: para
-#: ri.xml:426
+#: ri.xml:435
 #, no-c-format
 msgid ""
 "Finally, there is UI orientated controller, that collects the text from the "
@@ -836,7 +851,7 @@
 msgstr ""
 
 #. Tag: programlisting
-#: ri.xml:432
+#: ri.xml:441
 #, no-c-format
 msgid ""
 "<![CDATA[@Stateful\n"
@@ -849,19 +864,19 @@
 msgstr ""
 
 #. Tag: para
-#: ri.xml:434
+#: ri.xml:443
 #, no-c-format
 msgid "The bean also has getters and setters for all the fields on the page."
 msgstr ""
 
 #. Tag: para
-#: ri.xml:438
+#: ri.xml:447
 #, no-c-format
 msgid "As this is a stateful session bean, we have to have a remove method:"
 msgstr ""
 
 #. Tag: programlisting
-#: ri.xml:442
+#: ri.xml:451
 #, no-c-format
 msgid ""
 "<![CDATA[   @Remove\n"
@@ -872,7 +887,7 @@
 msgstr ""
 
 #. Tag: para
-#: ri.xml:444
+#: ri.xml:453
 #, no-c-format
 msgid ""
 "The Web Beans manager will call the remove method for you when the bean is "
@@ -880,7 +895,7 @@
 msgstr ""
 
 #. Tag: para
-#: ri.xml:450
+#: ri.xml:459
 #, no-c-format
 msgid ""
 "That concludes our short tour of the Web Beans RI examples. For more on the "
@@ -890,7 +905,7 @@
 msgstr ""
 
 #. Tag: para
-#: ri.xml:456
+#: ri.xml:465
 #, no-c-format
 msgid ""
 "We need help in all areas - bug fixing, writing new features, writing "

Modified: doc/trunk/reference/it-IT/modules/ee.po
===================================================================
--- doc/trunk/reference/it-IT/modules/ee.po	2008-12-20 19:00:18 UTC (rev 630)
+++ doc/trunk/reference/it-IT/modules/ee.po	2008-12-20 22:17:05 UTC (rev 631)
@@ -5,7 +5,7 @@
 msgstr ""
 "Project-Id-Version: master.xml\n"
 "Report-Msgid-Bugs-To: http://bugs.kde.org\n"
-"POT-Creation-Date: 2008-12-19 20:26+0000\n"
+"POT-Creation-Date: 2008-12-20 22:08+0000\n"
 "PO-Revision-Date: 2008-12-20 13:47+0100\n"
 "Last-Translator: Nicola Benaglia <nico.benaz at gmail.com>\n"
 "Language-Team: none\n"
@@ -22,8 +22,18 @@
 #. Tag: para
 #: ee.xml:6
 #, no-c-format
-msgid "Web Beans is fully integrated into the Java EE environment. Web Beans have access to Java EE resources and JPA persistence contexts. They may be used in Unified EL expressions in JSF and JSP pages. They may even be injected into some objects, such as Servlets and Message-Driven Beans, which are not Web Beans."
-msgstr "Web Beans è pienamente integrata nell'ambiente Java EE. Web Beans ha accesso alle risorse Java EE ed ai contesti di persistenza JPA. I Web Beans possono essere usati in espressioni Unified EL dentro pagine JSF e JSP. Possono anche essere iniettati negli oggetti, come Servlet e Message-Driven Beans, che non sono Web Beans."
+msgid ""
+"Web Beans is fully integrated into the Java EE environment. Web Beans have "
+"access to Java EE resources and JPA persistence contexts. They may be used "
+"in Unified EL expressions in JSF and JSP pages. They may even be injected "
+"into some objects, such as Servlets and Message-Driven Beans, which are not "
+"Web Beans."
+msgstr ""
+"Web Beans è pienamente integrata nell'ambiente Java EE. Web Beans ha accesso "
+"alle risorse Java EE ed ai contesti di persistenza JPA. I Web Beans possono "
+"essere usati in espressioni Unified EL dentro pagine JSF e JSP. Possono "
+"anche essere iniettati negli oggetti, come Servlet e Message-Driven Beans, "
+"che non sono Web Beans."
 
 #. Tag: title
 #: ee.xml:12
@@ -34,8 +44,17 @@
 #. Tag: para
 #: ee.xml:14
 #, no-c-format
-msgid "All simple and enterprise Web Beans may take advantage of Java EE dependency injection using <literal>@Resource</literal>, <literal>@EJB</literal> and <literal>@PersistenceContext</literal>. We've already seen a couple of examples of this, though we didn't pay much attention at the time:"
-msgstr "Tutti i Web Beans sia semplici che enterprise si avvantaggiano della dependency injection di Java EE usando <literal>@Resource</literal>, <literal>@EJB</literal> e <literal>@PersistenceContext</literal>. Abbiamo già visto un paio di esempi a riguardo, sebbene non ci siamo soffermati molto a suo tempo."
+msgid ""
+"All simple and enterprise Web Beans may take advantage of Java EE dependency "
+"injection using <literal>@Resource</literal>, <literal>@EJB</literal> and "
+"<literal>@PersistenceContext</literal>. We've already seen a couple of "
+"examples of this, though we didn't pay much attention at the time:"
+msgstr ""
+"Tutti i Web Beans sia semplici che enterprise si avvantaggiano della "
+"dependency injection di Java EE usando <literal>@Resource</literal>, "
+"<literal>@EJB</literal> e <literal>@PersistenceContext</literal>. Abbiamo "
+"già visto un paio di esempi a riguardo, sebbene non ci siamo soffermati "
+"molto a suo tempo."
 
 #. Tag: programlisting
 #: ee.xml:19
@@ -46,7 +65,8 @@
 "\n"
 "    @Resource Transaction transaction;\n"
 "\n"
-"    @AroundInvoke public Object manageTransaction(InvocationContext ctx) { ... }\n"
+"    @AroundInvoke public Object manageTransaction(InvocationContext ctx) "
+"{ ... }\n"
 "    \n"
 "}]]>"
 msgstr ""
@@ -55,7 +75,8 @@
 "\n"
 "    @Resource Transaction transaction;\n"
 "\n"
-"    @AroundInvoke public Object manageTransaction(InvocationContext ctx) { ... }\n"
+"    @AroundInvoke public Object manageTransaction(InvocationContext ctx) "
+"{ ... }\n"
 "    \n"
 "}]]>"
 
@@ -86,14 +107,27 @@
 #. Tag: para
 #: ee.xml:23
 #, no-c-format
-msgid "The Java EE <literal>@PostConstruct</literal> and <literal>@PreDestroy</literal> callbacks are also supported for all simple and enterprise Web Beans. The <literal>@PostConstruct</literal> method is called after <emphasis>all</emphasis> injection has been performed."
-msgstr "Le chiamate Java EE <literal>@PostConstruct</literal> e <literal>@PreDestroy</literal> vengono anche supportate per tutti i Web Beans (semplici e enterprise). Il metodo <literal>@PostConstruct</literal> viene chiamato dopo che <emphasis>tutta</emphasis> l'injection è stata eseguita."
+msgid ""
+"The Java EE <literal>@PostConstruct</literal> and <literal>@PreDestroy</"
+"literal> callbacks are also supported for all simple and enterprise Web "
+"Beans. The <literal>@PostConstruct</literal> method is called after "
+"<emphasis>all</emphasis> injection has been performed."
+msgstr ""
+"Le chiamate Java EE <literal>@PostConstruct</literal> e "
+"<literal>@PreDestroy</literal> vengono anche supportate per tutti i Web "
+"Beans (semplici e enterprise). Il metodo <literal>@PostConstruct</literal> "
+"viene chiamato dopo che <emphasis>tutta</emphasis> l'injection è stata "
+"eseguita."
 
 #. Tag: para
 #: ee.xml:28
 #, no-c-format
-msgid "There is one restriction to be aware of here: <literal>@PersistenceContext(type=EXTENDED)</literal> is not supported for simple Web Beans."
-msgstr "C'è una restrizione di cui essere informati: <literal>@PersistenceContext(type=EXTENDED)</literal> non è supportato per i Web Beans semplici."
+msgid ""
+"There is one restriction to be aware of here: <literal>@PersistenceContext"
+"(type=EXTENDED)</literal> is not supported for simple Web Beans."
+msgstr ""
+"C'è una restrizione di cui essere informati: <literal>@PersistenceContext"
+"(type=EXTENDED)</literal> non è supportato per i Web Beans semplici."
 
 #. Tag: title
 #: ee.xml:35
@@ -104,8 +138,13 @@
 #. Tag: para
 #: ee.xml:37
 #, no-c-format
-msgid "It's easy to use a Web Bean from a Servlet in Java EE 6. Simply inject the Web Bean using Web Beans field or initializer method injection."
-msgstr "E' facile utilizzare i Web Beans da un Servlet in Java EE 6. Semplicemente si inietti il Web Bean utilizzando l'injection del campo Web Bean o del metodo inizializzatore."
+msgid ""
+"It's easy to use a Web Bean from a Servlet in Java EE 6. Simply inject the "
+"Web Bean using Web Beans field or initializer method injection."
+msgstr ""
+"E' facile utilizzare i Web Beans da un Servlet in Java EE 6. Semplicemente "
+"si inietti il Web Bean utilizzando l'injection del campo Web Bean o del "
+"metodo inizializzatore."
 
 #. Tag: programlisting
 #: ee.xml:40
@@ -117,7 +156,8 @@
 "    @Current Login login;\n"
 "\n"
 "    @Override\n"
-"    public void service(HttpServletRequest request, HttpServletResponse response)\n"
+"    public void service(HttpServletRequest request, HttpServletResponse "
+"response)\n"
 "        throws ServletException, IOException {\n"
 "        credentials.setUsername( request.getAttribute(\"username\") ):\n"
 "        credentials.setPassword( request.getAttribute(\"password\") ):\n"
@@ -138,7 +178,8 @@
 "    @Current Login login;\n"
 "\n"
 "    @Override\n"
-"    public void service(HttpServletRequest request, HttpServletResponse response)\n"
+"    public void service(HttpServletRequest request, HttpServletResponse "
+"response)\n"
 "        throws ServletException, IOException {\n"
 "        credentials.setUsername( request.getAttribute(\"username\") ):\n"
 "        credentials.setPassword( request.getAttribute(\"password\") ):\n"
@@ -156,8 +197,14 @@
 #. Tag: para
 #: ee.xml:42
 #, no-c-format
-msgid "The Web Beans client proxy takes care of routing method invocations from the Servlet to the correct instances of <literal>Credentials</literal> and <literal>Login</literal> for the current request and HTTP session."
-msgstr "Il client proxy Web Beans si occupa di instradare le invocazioni dei metodi da un Servlet alle corrette istanze di <literal>Credentials</literal> e <literal>Login</literal> per la richiesta corrente e la sessione HTTP."
+msgid ""
+"The Web Beans client proxy takes care of routing method invocations from the "
+"Servlet to the correct instances of <literal>Credentials</literal> and "
+"<literal>Login</literal> for the current request and HTTP session."
+msgstr ""
+"Il client proxy Web Beans si occupa di instradare le invocazioni dei metodi "
+"da un Servlet alle corrette istanze di <literal>Credentials</literal> e "
+"<literal>Login</literal> per la richiesta corrente e la sessione HTTP."
 
 #. Tag: title
 #: ee.xml:49
@@ -168,15 +215,29 @@
 #. Tag: para
 #: ee.xml:51
 #, no-c-format
-msgid "Web Beans injection applies to all EJBs, even when they aren't under the control of the Web Bean manager (if they were obtained by direct JNDI lookup, or injection using <literal>@EJB</literal>, for example. In particular, you can use Web Beans injection in Message-Driven Beans, which are not considered Web Beans because you can't inject them."
-msgstr "L'injection dei Web Beans si applica a tutti gli EJB3, perfino quando non sono sotto il controllo del manager Web Bean (per esempio se sono stati ottenuti da ricerca JNDI diretta, o injection usando <literal>@EJB</literal>) In particolaresi può usare l'injection di Web Beans nei Message-Driven Beans, che non sono considerati Web Beans poiché non possono essere iniettati."
+msgid ""
+"Web Beans injection applies to all EJBs, even when they aren't under the "
+"control of the Web Bean manager (if they were obtained by direct JNDI "
+"lookup, or injection using <literal>@EJB</literal>, for example. In "
+"particular, you can use Web Beans injection in Message-Driven Beans, which "
+"are not considered Web Beans because you can't inject them."
+msgstr ""
+"L'injection dei Web Beans si applica a tutti gli EJB3, perfino quando non "
+"sono sotto il controllo del manager Web Bean (per esempio se sono stati "
+"ottenuti da ricerca JNDI diretta, o injection usando <literal>@EJB</"
+"literal>) In particolaresi può usare l'injection di Web Beans nei Message-"
+"Driven Beans, che non sono considerati Web Beans poiché non possono essere "
+"iniettati."
 
 # Web Beans interceptor bindings =?
 #. Tag: para
 #: ee.xml:57
 #, no-c-format
-msgid "You can even use Web Beans interceptor bindings for Message-Driven Beans."
-msgstr "Si possono perfino associare degli interceptor Web Beans ai Message-Driven Beans."
+msgid ""
+"You can even use Web Beans interceptor bindings for Message-Driven Beans."
+msgstr ""
+"Si possono perfino associare degli interceptor Web Beans ai Message-Driven "
+"Beans."
 
 #. Tag: programlisting
 #: ee.xml:59
@@ -209,8 +270,17 @@
 #. Tag: para
 #: ee.xml:61
 #, no-c-format
-msgid "Thus, receiving messages is super-easy in a Web Beans environment. But beware that there is no session or conversation context available when a message is delivered to a Message-Driven Bean. Only <literal>@RequestScoped</literal> and <literal>@ApplicationScoped</literal> Web Beans are available."
-msgstr "Quindi ricevere i messaggi è veramente facile in ambiente Web Beans. Ma attenzione che non è disponibile alcun contesto di sessione o conversazione quando il messaggio viene consegnato al Message-Driven Bean. Solamente i Web Beans <literal>@RequestScoped</literal> and <literal>@ApplicationScoped</literal> sono disponibili."
+msgid ""
+"Thus, receiving messages is super-easy in a Web Beans environment. But "
+"beware that there is no session or conversation context available when a "
+"message is delivered to a Message-Driven Bean. Only <literal>@RequestScoped</"
+"literal> and <literal>@ApplicationScoped</literal> Web Beans are available."
+msgstr ""
+"Quindi ricevere i messaggi è veramente facile in ambiente Web Beans. Ma "
+"attenzione che non è disponibile alcun contesto di sessione o conversazione "
+"quando il messaggio viene consegnato al Message-Driven Bean. Solamente i Web "
+"Beans <literal>@RequestScoped</literal> and <literal>@ApplicationScoped</"
+"literal> sono disponibili."
 
 #. Tag: para
 #: ee.xml:66
@@ -227,14 +297,38 @@
 #. Tag: para
 #: ee.xml:73
 #, no-c-format
-msgid "Sending messages using JMS can be quite complex, because of the number of different objects you need to deal with. For queues we have <literal>Queue</literal>, <literal>QueueConnectionFactory</literal>, <literal>QueueConnection</literal>, <literal>QueueSession</literal> and <literal>QueueSender</literal>. For topics we have <literal>Topic</literal>, <literal>TopicConnectionFactory</literal>, <literal>TopicConnection</literal>, <literal>TopicSession</literal> and <literal>TopicPublisher</literal>. Each of these objects has its own lifecycle and threading model that we need to worry about."
-msgstr "La spedizione dei messaggi usando JMS può essere abbastanza complessa, a causa del numero di oggetti differenti da trattare. Per le code si hanno <literal>Queue</literal>, <literal>QueueConnectionFactory</literal>, <literal>QueueConnection</literal>, <literal>QueueSession</literal> e <literal>QueueSender</literal>. Per i topic si hanno <literal>Topic</literal>, <literal>TopicConnectionFactory</literal>, <literal>TopicConnection</literal>, <literal>TopicSession</literal> e <literal>TopicPublisher</literal>. Ciascuno di questi oggetti ha il proprio ciclo di vita e modello di thread di cui bisogna (pre)occuparsi."
+msgid ""
+"Sending messages using JMS can be quite complex, because of the number of "
+"different objects you need to deal with. For queues we have <literal>Queue</"
+"literal>, <literal>QueueConnectionFactory</literal>, "
+"<literal>QueueConnection</literal>, <literal>QueueSession</literal> and "
+"<literal>QueueSender</literal>. For topics we have <literal>Topic</literal>, "
+"<literal>TopicConnectionFactory</literal>, <literal>TopicConnection</"
+"literal>, <literal>TopicSession</literal> and <literal>TopicPublisher</"
+"literal>. Each of these objects has its own lifecycle and threading model "
+"that we need to worry about."
+msgstr ""
+"La spedizione dei messaggi usando JMS può essere abbastanza complessa, a "
+"causa del numero di oggetti differenti da trattare. Per le code si hanno "
+"<literal>Queue</literal>, <literal>QueueConnectionFactory</literal>, "
+"<literal>QueueConnection</literal>, <literal>QueueSession</literal> e "
+"<literal>QueueSender</literal>. Per i topic si hanno <literal>Topic</"
+"literal>, <literal>TopicConnectionFactory</literal>, "
+"<literal>TopicConnection</literal>, <literal>TopicSession</literal> e "
+"<literal>TopicPublisher</literal>. Ciascuno di questi oggetti ha il proprio "
+"ciclo di vita e modello di thread di cui bisogna (pre)occuparsi."
 
 #. Tag: para
 #: ee.xml:82
 #, no-c-format
-msgid "Web Beans takes care of all this for us. All we need to do is declare the queue or topic in <literal>web-beans.xml</literal>, specifying an associated binding type and connection factory."
-msgstr "I Web Beans si prendono cura di tutto questo per noi. Tutto ciò che occorre fare è dichiarare la coda od il topic in <literal>web-beans.xml</literal>, specificando un "
+msgid ""
+"Web Beans takes care of all this for us. All we need to do is declare the "
+"queue or topic in <literal>web-beans.xml</literal>, specifying an associated "
+"binding type and connection factory."
+msgstr ""
+"I Web Beans si prendono cura di tutto questo per noi. Tutto ciò che occorre "
+"fare è dichiarare la coda od il topic in <literal>web-beans.xml</literal>, "
+"specificando un "
 
 #. Tag: programlisting
 #: ee.xml:86
@@ -242,13 +336,15 @@
 msgid ""
 "<![CDATA[<Queue>\n"
 "    <destination>java:comp/env/jms/OrderQueue</destination>\n"
-"    <connectionFactory>java:comp/env/jms/QueueConnectionFactory</connectionFactory>\n"
+"    <connectionFactory>java:comp/env/jms/QueueConnectionFactory</"
+"connectionFactory>\n"
 "    <myapp:OrderProcessor/>    \n"
 "</Queue>]]>"
 msgstr ""
 "<![CDATA[<Queue>\n"
 "    <destination>java:comp/env/jms/OrderQueue</destination>\n"
-"    <connectionFactory>java:comp/env/jms/QueueConnectionFactory</connectionFactory>\n"
+"    <connectionFactory>java:comp/env/jms/QueueConnectionFactory</"
+"connectionFactory>\n"
 "    <myapp:OrderProcessor/>    \n"
 "</Queue>]]>"
 
@@ -258,21 +354,33 @@
 msgid ""
 "<![CDATA[<Topic>\n"
 "    <destination>java:comp/env/jms/StockPrices</destination>\n"
-"    <connectionFactory>java:comp/env/jms/TopicConnectionFactory</connectionFactory>\n"
+"    <connectionFactory>java:comp/env/jms/TopicConnectionFactory</"
+"connectionFactory>\n"
 "    <myapp:StockPrices/>    \n"
 "</Topic>]]>"
 msgstr ""
 "<![CDATA[<Topic>\n"
 "    <destination>java:comp/env/jms/StockPrices</destination>\n"
-"    <connectionFactory>java:comp/env/jms/TopicConnectionFactory</connectionFactory>\n"
+"    <connectionFactory>java:comp/env/jms/TopicConnectionFactory</"
+"connectionFactory>\n"
 "    <myapp:StockPrices/>    \n"
 "</Topic>]]>"
 
 #. Tag: para
 #: ee.xml:90
 #, no-c-format
-msgid "Now we can just inject the <literal>Queue</literal>, <literal>QueueConnection</literal>, <literal>QueueSession</literal> or <literal>QueueSender</literal> for a queue, or the <literal>Topic</literal>, <literal>TopicConnection</literal>, <literal>TopicSession</literal> or <literal>TopicPublisher</literal> for a topic."
-msgstr "Ora è possibile iniettare <literal>Queue</literal>, <literal>QueueConnection</literal>, <literal>QueueSession</literal> o <literal>QueueSender</literal> per una coda, oppure <literal>Topic</literal>, <literal>TopicConnection</literal>, <literal>TopicSession</literal> o <literal>TopicPublisher</literal> per un topic."
+msgid ""
+"Now we can just inject the <literal>Queue</literal>, "
+"<literal>QueueConnection</literal>, <literal>QueueSession</literal> or "
+"<literal>QueueSender</literal> for a queue, or the <literal>Topic</literal>, "
+"<literal>TopicConnection</literal>, <literal>TopicSession</literal> or "
+"<literal>TopicPublisher</literal> for a topic."
+msgstr ""
+"Ora è possibile iniettare <literal>Queue</literal>, "
+"<literal>QueueConnection</literal>, <literal>QueueSession</literal> o "
+"<literal>QueueSender</literal> per una coda, oppure <literal>Topic</"
+"literal>, <literal>TopicConnection</literal>, <literal>TopicSession</"
+"literal> o <literal>TopicPublisher</literal> per un topic."
 
 #. Tag: programlisting
 #: ee.xml:96
@@ -316,9 +424,13 @@
 
 #. Tag: para
 #: ee.xml:100
-#, no-c-format
-msgid "The lifecycle of the injected JMS objects are completely controlled by the Web Bean manager."
-msgstr "Il ciclo di vita degli oggetti JMS iniettati è interamente controllato dal manager Web Bean."
+#, fuzzy, no-c-format
+msgid ""
+"The lifecycle of the injected JMS objects is completely controlled by the "
+"Web Bean manager."
+msgstr ""
+"Il ciclo di vita degli oggetti JMS iniettati è interamente controllato dal "
+"manager Web Bean."
 
 #. Tag: title
 #: ee.xml:106
@@ -329,12 +441,33 @@
 #. Tag: para
 #: ee.xml:108
 #, no-c-format
-msgid "Web Beans doesn't define any special deployment archive. You can package Web Beans in JARs, EJB-JARs or WARs&#151;any deployment location in the application classpath. However, each archive that contains Web Beans must include a file named <literal>web-beans.xml</literal> in the <literal>META-INF</literal> or <literal>WEB-INF</literal> directory. The file may be empty. Web Beans deployed in archives that do not have a <literal>web-beans.xml</literal> file will not be available for use in the application."
-msgstr "Web Beans non definisce nessuno archivio speciale per il deploy. Si può impacchettare i Web Beans in JAR, EJB-JAR o WAR&#151;qualsiasi locazione di deploy nel classpath dell'applicazione. Comunque ciascun archivio che contiene Web Beans devi includere un file chiamato <literal>web-beans.xml</literal> nella directory <literal>META-INF</literal> o <literal>WEB-INF</literal>. Il file può essere vuoto. I Web Beans collocati negli archivi che non hanno un file <literal>web-beans.xml</literal> non saranno disponibili per l'uso nell'applicazione."
+msgid ""
+"Web Beans doesn't define any special deployment archive. You can package Web "
+"Beans in JARs, EJB-JARs or WARs&#151;any deployment location in the "
+"application classpath. However, each archive that contains Web Beans must "
+"include a file named <literal>web-beans.xml</literal> in the <literal>META-"
+"INF</literal> or <literal>WEB-INF</literal> directory. The file may be "
+"empty. Web Beans deployed in archives that do not have a <literal>web-beans."
+"xml</literal> file will not be available for use in the application."
+msgstr ""
+"Web Beans non definisce nessuno archivio speciale per il deploy. Si può "
+"impacchettare i Web Beans in JAR, EJB-JAR o WAR&#151;qualsiasi locazione di "
+"deploy nel classpath dell'applicazione. Comunque ciascun archivio che "
+"contiene Web Beans devi includere un file chiamato <literal>web-beans.xml</"
+"literal> nella directory <literal>META-INF</literal> o <literal>WEB-INF</"
+"literal>. Il file può essere vuoto. I Web Beans collocati negli archivi che "
+"non hanno un file <literal>web-beans.xml</literal> non saranno disponibili "
+"per l'uso nell'applicazione."
 
 #. Tag: para
 #: ee.xml:116
 #, no-c-format
-msgid "For Java SE execution, Web Beans may be deployed in any location in which EJBs may be deployed for execution by the embeddable EJB Lite container. Again, each location must contain a <literal>web-beans.xml</literal> file."
-msgstr "Per l'esecuzione in Java SE, Web Beans può essere deployato in un qualsiasi posto nel quale gli EJB siano stati messi per essere eseguito da un embeddable EJB Lite container.  Di nuovo ogni locazioni deve contenere un file <literal>web-beans.xml</literal>."
-
+msgid ""
+"For Java SE execution, Web Beans may be deployed in any location in which "
+"EJBs may be deployed for execution by the embeddable EJB Lite container. "
+"Again, each location must contain a <literal>web-beans.xml</literal> file."
+msgstr ""
+"Per l'esecuzione in Java SE, Web Beans può essere deployato in un qualsiasi "
+"posto nel quale gli EJB siano stati messi per essere eseguito da un "
+"embeddable EJB Lite container.  Di nuovo ogni locazioni deve contenere un "
+"file <literal>web-beans.xml</literal>."

Modified: doc/trunk/reference/it-IT/modules/producermethods.po
===================================================================
--- doc/trunk/reference/it-IT/modules/producermethods.po	2008-12-20 19:00:18 UTC (rev 630)
+++ doc/trunk/reference/it-IT/modules/producermethods.po	2008-12-20 22:17:05 UTC (rev 631)
@@ -5,7 +5,7 @@
 msgstr ""
 "Project-Id-Version: master.xml\n"
 "Report-Msgid-Bugs-To: http://bugs.kde.org\n"
-"POT-Creation-Date: 2008-12-19 20:26+0000\n"
+"POT-Creation-Date: 2008-12-20 22:08+0000\n"
 "PO-Revision-Date: 2008-12-20 15:57+0100\n"
 "Last-Translator: Nicola Benaglia <nico.benaz at gmail.com>\n"
 "Language-Team: none\n"
@@ -23,7 +23,12 @@
 #. Tag: para
 #: producermethods.xml:7
 #, no-c-format
-msgid "Producer methods let us overcome certain limitations that arise when the Web Bean manager, instead of the application, is responsible for instantiating objects. They're also the easiest way to integrate objects which are not Web Beans into the Web Beans environment. (We'll meet a second approach in <xref linkend=\"xml\"/>.)"
+msgid ""
+"Producer methods let us overcome certain limitations that arise when the Web "
+"Bean manager, instead of the application, is responsible for instantiating "
+"objects. They're also the easiest way to integrate objects which are not Web "
+"Beans into the Web Beans environment. (We'll meet a second approach in <xref "
+"linkend=\"xml\"/>.)"
 msgstr ""
 
 #. Tag: para
@@ -36,7 +41,25 @@
 #: producermethods.xml:12
 #, no-c-format
 msgid ""
-"<blockquote> <para>A Web Beans producer method acts as a source of objects to be injected, where:</para> <itemizedlist> <listitem> <para>the objects to be injected are not required to be instances of Web Beans,</para> </listitem> <listitem> <para>the concrete type of the objects to be injected may vary at runtime or</para> </listitem> <listitem> <para>the objects require some custom initialization that is not performed by the Web Bean constructor</para> </listitem> </itemizedlist> </blockquote> <para>For example, producer methods let us:</para> <itemizedlist> <listitem> <para>expose a JPA entity as a Web Bean,</para> </listitem> <listitem> <para>expose any JDK class as a Web Bean,</para> </listitem> <listitem> <para>define multiple Web Beans, with different scopes or initialization, for the same implementation class, or</para> </listitem> <listitem> <para>vary the implementation of an API type at runtime.</para> </listitem> </itemizedlist> <para>In particular, producer met!
 hods let us use runtime polymorphism with Web Beans. As we've seen, deployment types are a powerful solution to the problem of deployment-time polymorphism. But once the system is deployed, the Web Bean implementation is fixed. A producer method has no such limitation:</para> <programlisting><![CDATA[@SessionScoped\n"
+"<blockquote> <para>A Web Beans producer method acts as a source of objects "
+"to be injected, where:</para> <itemizedlist> <listitem> <para>the objects to "
+"be injected are not required to be instances of Web Beans,</para> </"
+"listitem> <listitem> <para>the concrete type of the objects to be injected "
+"may vary at runtime or</para> </listitem> <listitem> <para>the objects "
+"require some custom initialization that is not performed by the Web Bean "
+"constructor</para> </listitem> </itemizedlist> </blockquote> <para>For "
+"example, producer methods let us:</para> <itemizedlist> <listitem> "
+"<para>expose a JPA entity as a Web Bean,</para> </listitem> <listitem> "
+"<para>expose any JDK class as a Web Bean,</para> </listitem> <listitem> "
+"<para>define multiple Web Beans, with different scopes or initialization, "
+"for the same implementation class, or</para> </listitem> <listitem> "
+"<para>vary the implementation of an API type at runtime.</para> </listitem> "
+"</itemizedlist> <para>In particular, producer methods let us use runtime "
+"polymorphism with Web Beans. As we've seen, deployment types are a powerful "
+"solution to the problem of deployment-time polymorphism. But once the system "
+"is deployed, the Web Bean implementation is fixed. A producer method has no "
+"such limitation:</para> <programlisting role=\"JAVA\"><![CDATA"
+"[@SessionScoped\n"
 "public class Preferences {\n"
 "    \n"
 "    private PaymentStrategyType paymentStrategy;\n"
@@ -53,7 +76,13 @@
 "        } \n"
 "    }\n"
 "    \n"
-"}]]></programlisting> <para>Consider an injection point:</para> <programlisting><![CDATA[@Preferred PaymentStrategy paymentStrat;]]></programlisting> <para>This injection point has the same type and binding annotations as the producer method, so it resolves to the producer method using the usual Web Beans injection rules. The producer method will be called by the Web Bean manager to obtain an instance to service this injection point.</para>."
+"}]]></programlisting> <para>Consider an injection point:</para> "
+"<programlisting role=\"JAVA\"><![CDATA[@Preferred PaymentStrategy "
+"paymentStrat;]]></programlisting> <para>This injection point has the same "
+"type and binding annotations as the producer method, so it resolves to the "
+"producer method using the usual Web Beans injection rules. The producer "
+"method will be called by the Web Bean manager to obtain an instance to "
+"service this injection point.</para>."
 msgstr ""
 
 #. Tag: title
@@ -65,13 +94,20 @@
 #. Tag: para
 #: producermethods.xml:70
 #, no-c-format
-msgid "The scope of the producer method defaults to <literal>@Dependent</literal>, and so it will be called <emphasis>every time</emphasis> the Web Bean manager injects this field or any other field that resolves to the same producer method. Thus, there could be multiple instances of the <literal>PaymentStrategy</literal> object for each user session."
+msgid ""
+"The scope of the producer method defaults to <literal>@Dependent</literal>, "
+"and so it will be called <emphasis>every time</emphasis> the Web Bean "
+"manager injects this field or any other field that resolves to the same "
+"producer method. Thus, there could be multiple instances of the "
+"<literal>PaymentStrategy</literal> object for each user session."
 msgstr ""
 
 #. Tag: para
 #: producermethods.xml:75
 #, no-c-format
-msgid "To change this behavior, we can add a <literal>@SessionScoped</literal> annotation to the method."
+msgid ""
+"To change this behavior, we can add a <literal>@SessionScoped</literal> "
+"annotation to the method."
 msgstr ""
 
 #. Tag: programlisting
@@ -91,7 +127,10 @@
 #. Tag: para
 #: producermethods.xml:80
 #, no-c-format
-msgid "Now, when the producer method is called, the returned <literal>PaymentStrategy</literal> will be bound to the session context. The producer method won't be called again in the same session."
+msgid ""
+"Now, when the producer method is called, the returned "
+"<literal>PaymentStrategy</literal> will be bound to the session context. The "
+"producer method won't be called again in the same session."
 msgstr ""
 
 #. Tag: title
@@ -103,13 +142,20 @@
 #. Tag: para
 #: producermethods.xml:89
 #, no-c-format
-msgid "There's one potential problem with the code above. The implementations of <literal>CreditCardPaymentStrategy</literal> are instantiated using the Java <literal>new</literal> operator. Objects instantiated directly by the application can't take advantage of dependency injection and don't have interceptors."
+msgid ""
+"There's one potential problem with the code above. The implementations of "
+"<literal>CreditCardPaymentStrategy</literal> are instantiated using the Java "
+"<literal>new</literal> operator. Objects instantiated directly by the "
+"application can't take advantage of dependency injection and don't have "
+"interceptors."
 msgstr ""
 
 #. Tag: para
 #: producermethods.xml:94
 #, no-c-format
-msgid "If this isn't what we want we can use dependency injection into the producer method to obtain Web Bean instances:"
+msgid ""
+"If this isn't what we want we can use dependency injection into the producer "
+"method to obtain Web Bean instances:"
 msgstr ""
 
 #. Tag: programlisting
@@ -143,19 +189,34 @@
 #. Tag: para
 #: producermethods.xml:99
 #, no-c-format
-msgid "Wait, what if <literal>CreditCardPaymentStrategy</literal> is a request scoped Web Bean? Then the producer method has the effect of \"promoting\" the current request scoped instance into session scope. This is almost certainly a bug! The request scoped object will be destroyed by the Web Bean manager before the session ends, but the reference to the object will be left \"hanging\" in the session scope. This error will <emphasis>not</emphasis> be detected by the Web Bean manager, so please take extra care when returning Web Bean instances from producer methods!"
+msgid ""
+"Wait, what if <literal>CreditCardPaymentStrategy</literal> is a request "
+"scoped Web Bean? Then the producer method has the effect of \"promoting\" "
+"the current request scoped instance into session scope. This is almost "
+"certainly a bug! The request scoped object will be destroyed by the Web Bean "
+"manager before the session ends, but the reference to the object will be "
+"left \"hanging\" in the session scope. This error will <emphasis>not</"
+"emphasis> be detected by the Web Bean manager, so please take extra care "
+"when returning Web Bean instances from producer methods!"
 msgstr ""
 
 #. Tag: para
 #: producermethods.xml:107
 #, no-c-format
-msgid "There's at least three ways we could go about fixing this bug. We could change the scope of the <literal>CreditCardPaymentStrategy</literal> implementation, but this would affect other clients of that Web Bean. A better option would be to change the scope of the producer method to <literal>@Dependent</literal> or <literal>@RequestScoped</literal>."
+msgid ""
+"There's at least three ways we could go about fixing this bug. We could "
+"change the scope of the <literal>CreditCardPaymentStrategy</literal> "
+"implementation, but this would affect other clients of that Web Bean. A "
+"better option would be to change the scope of the producer method to "
+"<literal>@Dependent</literal> or <literal>@RequestScoped</literal>."
 msgstr ""
 
 #. Tag: para
 #: producermethods.xml:113
 #, no-c-format
-msgid "But a more common solution is to use the special <literal>@New</literal> binding annotation."
+msgid ""
+"But a more common solution is to use the special <literal>@New</literal> "
+"binding annotation."
 msgstr ""
 
 #. Tag: title
@@ -175,9 +236,11 @@
 #, no-c-format
 msgid ""
 "<![CDATA[@Produces @Preferred @SessionScoped\n"
-"public PaymentStrategy getPaymentStrategy(@New CreditCardPaymentStrategy ccps,\n"
+"public PaymentStrategy getPaymentStrategy(@New CreditCardPaymentStrategy "
+"ccps,\n"
 "                                          @New ChequePaymentStrategy cps,\n"
-"                                          @New PayPalPaymentStrategy ppps) {\n"
+"                                          @New PayPalPaymentStrategy ppps) "
+"{\n"
 "    switch (paymentStrategy) {\n"
 "        case CREDIT_CARD: return ccps;\n"
 "        case CHEQUE: return cps;\n"
@@ -187,9 +250,11 @@
 "}]]>"
 msgstr ""
 "<![CDATA[@Produces @Preferred @SessionScoped\n"
-"public PaymentStrategy getPaymentStrategy(@New CreditCardPaymentStrategy ccps,\n"
+"public PaymentStrategy getPaymentStrategy(@New CreditCardPaymentStrategy "
+"ccps,\n"
 "                                          @New ChequePaymentStrategy cps,\n"
-"                                          @New PayPalPaymentStrategy ppps) {\n"
+"                                          @New PayPalPaymentStrategy ppps) "
+"{\n"
 "    switch (paymentStrategy) {\n"
 "        case CREDIT_CARD: return ccps;\n"
 "        case CHEQUE: return cps;\n"
@@ -201,6 +266,11 @@
 #. Tag: para
 #: producermethods.xml:125
 #, no-c-format
-msgid "Then a new <emphasis>dependent</emphasis> instance of <literal>CreditCardPaymentStrategy</literal> will be created, passed to the producer method, returned by the producer method and finally bound to the session context. The dependent object won't be destroyed until the <literal>Preferences</literal> object is destroyed, at the end of the session."
+msgid ""
+"Then a new <emphasis>dependent</emphasis> instance of "
+"<literal>CreditCardPaymentStrategy</literal> will be created, passed to the "
+"producer method, returned by the producer method and finally bound to the "
+"session context. The dependent object won't be destroyed until the "
+"<literal>Preferences</literal> object is destroyed, at the end of the "
+"session."
 msgstr ""
-

Added: doc/trunk/reference/it-IT/modules/ri-spi.po
===================================================================
--- doc/trunk/reference/it-IT/modules/ri-spi.po	                        (rev 0)
+++ doc/trunk/reference/it-IT/modules/ri-spi.po	2008-12-20 22:17:05 UTC (rev 631)
@@ -0,0 +1,275 @@
+# Language it-IT translations for master.xml package.
+# Automatically generated, 2008.
+#
+msgid ""
+msgstr ""
+"Project-Id-Version: master.xml \n"
+"Report-Msgid-Bugs-To: http://bugs.kde.org\n"
+"POT-Creation-Date: 2008-12-20 22:07+0000\n"
+"PO-Revision-Date: 2008-12-20 22:07+0000\n"
+"Last-Translator: Automatically generated\n"
+"Language-Team: none\n"
+"MIME-Version: 1.0\n"
+"Content-Type: text/plain; charset=UTF-8\n"
+"Content-Transfer-Encoding: 8bit\n"
+
+#. Tag: title
+#: ri-spi.xml:4
+#, no-c-format
+msgid "Integrating the Web Beans RI into other environments"
+msgstr ""
+
+#. Tag: para
+#: ri-spi.xml:6
+#, no-c-format
+msgid ""
+"Currently the Web Beans RI only runs in JBoss AS 5; integrating the RI into "
+"other EE environments (for example another application server like "
+"Glassfish), into a servlet container (like Tomcat), or with an Embedded "
+"EJB3.1 implementation is fairly easy. In this Appendix we will briefly "
+"discuss the steps needed."
+msgstr ""
+
+#. Tag: para
+#: ri-spi.xml:15
+#, no-c-format
+msgid ""
+"It should be possible to run Web Beans in an SE environment, but you'll to "
+"do more work, adding your own contexts and lifecycle. The Web Beans RI "
+"currently doesn't expose lifecycle extension points, so you would have to "
+"code directly against Web Beans RI classes."
+msgstr ""
+
+#. Tag: title
+#: ri-spi.xml:24
+#, no-c-format
+msgid "The Web Beans RI SPI"
+msgstr ""
+
+#. Tag: para
+#: ri-spi.xml:26
+#, no-c-format
+msgid ""
+"The Web Beans SPI is located in <literal>webbeans-ri-spi</literal> module, "
+"and packaged as <literal>webbeans-ri-spi.jar</literal>."
+msgstr ""
+
+#. Tag: para
+#: ri-spi.xml:31
+#, no-c-format
+msgid "Currently, the only SPI to implement is the bootstrap spi:"
+msgstr ""
+
+#. Tag: programlisting
+#: ri-spi.xml:35
+#, no-c-format
+msgid ""
+"<![CDATA[public interface WebBeanDiscovery {\n"
+"   /**\n"
+"    * Gets list of all classes in classpath archives with web-beans.xml "
+"files\n"
+"    * \n"
+"    * @return An iterable over the classes \n"
+"    */\n"
+"   public Iterable<Class<?>> discoverWebBeanClasses();\n"
+"   \n"
+"   /**\n"
+"    * Gets a list of all web-beans.xml files in the app classpath\n"
+"    * \n"
+"    * @return An iterable over the web-beans.xml files \n"
+"    */\n"
+"   public Iterable<URL> discoverWebBeansXml();\n"
+"   \n"
+"   /**\n"
+"    * Gets a descriptor for each EJB in the application\n"
+"    * \n"
+"    * @return The bean class to descriptor map \n"
+"    */\n"
+"   public Iterable<EjbDescriptor<?>> discoverEjbs();\n"
+"   \n"
+"}]]>"
+msgstr ""
+
+#. Tag: para
+#: ri-spi.xml:37
+#, no-c-format
+msgid ""
+"The discovery of Web Bean classes and <literal>web-bean.xml</literal> files "
+"is self-explanatory (the algorithm is described in Section 11.1 of the JSR-"
+"299 specification, and isn't repeated here)."
+msgstr ""
+
+#. Tag: para
+#: ri-spi.xml:43
+#, no-c-format
+msgid ""
+"The Web Beans RI also delegates EJB3 bean discovery to the container so that "
+"it doesn't have to scan for EJB3 annotations or parse <literal>ejb-jar.xml</"
+"literal>. For each EJB in the application an EJBDescriptor should be "
+"discovered:"
+msgstr ""
+
+#. Tag: programlisting
+#: ri-spi.xml:50
+#, no-c-format
+msgid ""
+"<![CDATA[public interface EjbDescriptor<T> {\n"
+"   \n"
+"   /**\n"
+"    * Gets the EJB type\n"
+"    * \n"
+"    * @return The EJB Bean class\n"
+"    */\n"
+"   public Class<T> getType();\n"
+"\n"
+"   /**\n"
+"    * Gets the local business interfaces of the EJB\n"
+"    * \n"
+"    * @return An iterator over the local business interfaces\n"
+"    */\n"
+"   public Iterable<BusinessInterfaceDescriptor<?>> getLocalBusinessInterfaces"
+"();\n"
+"   \n"
+"   /**\n"
+"    * Gets the remote business interfaces of the EJB\n"
+"    * \n"
+"    * @return An iterator over the remote business interfaces\n"
+"    */\n"
+"   public Iterable<BusinessInterfaceDescriptor<?>> "
+"getRemoteBusinessInterfaces();\n"
+"   \n"
+"   /**\n"
+"    * Get the remove methods of the EJB\n"
+"    * \n"
+"    * @return An iterator over the remove methods\n"
+"    */\n"
+"   public Iterable<MethodDescriptor> getRemoveMethods();\n"
+"\n"
+"   /**\n"
+"    * Indicates if the bean is stateless\n"
+"    * \n"
+"    * @return True if stateless, false otherwise\n"
+"    */\n"
+"   public boolean isStateless();\n"
+"\n"
+"   /**\n"
+"    * Indicates if the bean is a EJB 3.1 Singleton\n"
+"    * \n"
+"    * @return True if the bean is a singleton, false otherwise\n"
+"    */\n"
+"   public boolean isSingleton();\n"
+"\n"
+"   /**\n"
+"    * Indicates if the EJB is stateful\n"
+"    * \n"
+"    * @return True if the bean is stateful, false otherwise\n"
+"    */\n"
+"   public boolean isStateful();\n"
+"\n"
+"   /**\n"
+"    * Indicates if the EJB is and MDB\n"
+"    * \n"
+"    * @return True if the bean is an MDB, false otherwise\n"
+"    */\n"
+"   public boolean isMessageDriven();\n"
+"\n"
+"   /**\n"
+"    * Gets the EJB name\n"
+"    * \n"
+"    * @return The name\n"
+"    */\n"
+"   public String getEjbName();\n"
+"   \n"
+"   /**\n"
+"    * @return The JNDI string which can be used to lookup a proxy which \n"
+"    * implements all local business interfaces \n"
+"    * \n"
+"    */\n"
+"   public String getLocalJndiName();\n"
+"   \n"
+"}]]>"
+msgstr ""
+
+#. Tag: para
+#: ri-spi.xml:52
+#, no-c-format
+msgid ""
+"The contract described the JavaDoc is enough to implement an EJBDescriptor. "
+"In addition to these two interfaces, there is "
+"<literal>BusinessInterfaceDescriptor</literal> which represents a local "
+"business interface (encapsulating the interface class and jndi name), and "
+"<literal>MethodDescriptor</literal> which encapsulates the method name and "
+"parameter types (allowing it to be invoked on any instance of the EJB, proxy "
+"or otherwise)."
+msgstr ""
+
+#. Tag: para
+#: ri-spi.xml:62
+#, no-c-format
+msgid ""
+"The Web Beans RI can be told to load your implementation of "
+"<literal>WebBeanDiscovery</literal> using the property <literal>org.jboss."
+"webbeans.bootstrap.webBeanDiscovery</literal> with the fully qualified class "
+"name as the value. For example:"
+msgstr ""
+
+#. Tag: programlisting
+#: ri-spi.xml:69
+#, no-c-format
+msgid ""
+"org.jboss.webbeans.bootstrap.webBeanDiscovery=org.jboss.webbeans.integration."
+"jbossas.WebBeanDiscoveryImpl"
+msgstr ""
+
+#. Tag: para
+#: ri-spi.xml:71
+#, no-c-format
+msgid ""
+"The property can either be specified as a system property, or in a "
+"properties file <literal>META-INF/web-beans-ri.properties</literal>."
+msgstr ""
+
+#. Tag: title
+#: ri-spi.xml:79
+#, no-c-format
+msgid "The contract with the container"
+msgstr ""
+
+#. Tag: para
+#: ri-spi.xml:81
+#, no-c-format
+msgid ""
+"There are a number of requirements that the Web Beans RI places on the "
+"container for correct functioning that fall outside implementation of APIs"
+msgstr ""
+
+#. Tag: term
+#: ri-spi.xml:89
+#, no-c-format
+msgid "Classloader isolation"
+msgstr ""
+
+#. Tag: para
+#: ri-spi.xml:93
+#, no-c-format
+msgid ""
+"If you are integrating the Web Beans into an environment that supports "
+"deployment of applications, you must enable, automatically, or through user "
+"configuation, classloader isolation for each Web Beans application"
+msgstr ""
+
+#. Tag: term
+#: ri-spi.xml:102
+#, no-c-format
+msgid "The <literal>webbeans-ri.jar</literal>"
+msgstr ""
+
+#. Tag: para
+#: ri-spi.xml:106
+#, no-c-format
+msgid ""
+"If you are integrating the Web Beans into an environment that supports "
+"deployment of applications, you must insert the <literal>webbeans-ri.jar</"
+"literal> into the applications isolated classloader. It cannot be loaded "
+"from a shared classloader."
+msgstr ""

Modified: doc/trunk/reference/it-IT/modules/ri.po
===================================================================
--- doc/trunk/reference/it-IT/modules/ri.po	2008-12-20 19:00:18 UTC (rev 630)
+++ doc/trunk/reference/it-IT/modules/ri.po	2008-12-20 22:17:05 UTC (rev 631)
@@ -5,7 +5,7 @@
 msgstr ""
 "Project-Id-Version: master.xml\n"
 "Report-Msgid-Bugs-To: http://bugs.kde.org\n"
-"POT-Creation-Date: 2008-12-19 20:26+0000\n"
+"POT-Creation-Date: 2008-12-20 22:08+0000\n"
 "PO-Revision-Date: 2008-12-20 14:01+0100\n"
 "Last-Translator: Nicola Benaglia <nico.benaz at gmail.com>\n"
 "Language-Team: none\n"
@@ -22,13 +22,19 @@
 #. Tag: para
 #: ri.xml:6
 #, no-c-format
-msgid "The Web Beans RI comes with a two examples, <literal>webbeans-numberguess</literal> (a war example, containing only simple beans) and <literal>webbeans-translator</literal> (an ear example, containing enterprise beans)."
+msgid ""
+"The Web Beans RI comes with a two examples, <literal>webbeans-numberguess</"
+"literal> (a war example, containing only simple beans) and <literal>webbeans-"
+"translator</literal> (an ear example, containing enterprise beans)."
 msgstr ""
 
 #. Tag: para
 #: ri.xml:13
 #, no-c-format
-msgid "Currently, the Web Beans RI only runs on JBoss Application Server 5. You'll need to download JBoss AS 5.0.0.GA from <ulink url=\"http://www.jboss.org/jbossas/downloads/\">jboss.org</ulink>, and unzip it. For example:"
+msgid ""
+"Currently, the Web Beans RI only runs on JBoss Application Server 5. You'll "
+"need to download JBoss AS 5.0.0.GA from <ulink url=\"http://www.jboss.org/"
+"jbossas/downloads/\">jboss.org</ulink>, and unzip it. For example:"
 msgstr ""
 
 #. Tag: programlisting
@@ -44,7 +50,9 @@
 #. Tag: para
 #: ri.xml:22
 #, no-c-format
-msgid "Next, download the Web Beans RI from <ulink url=\"http://seamframework.org/WebBeans\">seamframework.org</ulink>, and unzip it. For example"
+msgid ""
+"Next, download the Web Beans RI from <ulink url=\"http://seamframework.org/"
+"WebBeans\">seamframework.org</ulink>, and unzip it. For example"
 msgstr ""
 
 #. Tag: programlisting
@@ -58,25 +66,50 @@
 "$ unzip ~/webbeans-1.0.0.ALPHA1.zip]]>"
 
 #. Tag: para
-#: ri.xml:30
+#: ri.xml:31
 #, no-c-format
-msgid "As Web Beans is a new piece of software, you need to update JBoss AS to run the Web Beans RI. Future versions of JBoss AS will include these updates, and this step won't be necessary."
+msgid ""
+"Next, we need to tell Web Beans where JBoss is located. Edit <literal>jboss-"
+"as/build.properties</literal> and set the <literal>jboss.home</literal> "
+"property. For example:"
 msgstr ""
 
-#. Tag: para
+#. Tag: programlisting
 #: ri.xml:37
 #, no-c-format
-msgid "Currently, two updates are needed. Firstly, a new deployer, <literal>webbeans.deployer</literal> is added. This adds supports for Web Bean archives to JBoss AS, and allows the Web Beans RI to query the EJB3 container and discover which EJBs are installed in your application. Secondly, an update to JBoss EJB3 is needed."
+msgid "jboss.home=/Applications/jboss-5.0.0.GA"
 msgstr ""
 
 #. Tag: para
+#: ri.xml:39
+#, no-c-format
+msgid ""
+"As Web Beans is a new piece of software, you need to update JBoss AS to run "
+"the Web Beans RI. Future versions of JBoss AS will include these updates, "
+"and this step won't be necessary."
+msgstr ""
+
+#. Tag: para
 #: ri.xml:46
 #, no-c-format
-msgid "To install the update, you'll need ant 1.7.0 installed, and the <literal>ANT_HOME</literal> environment variable set. For example:"
+msgid ""
+"Currently, two updates are needed. Firstly, a new deployer, "
+"<literal>webbeans.deployer</literal> is added. This adds supports for Web "
+"Bean archives to JBoss AS, and allows the Web Beans RI to query the EJB3 "
+"container and discover which EJBs are installed in your application. "
+"Secondly, an update to JBoss EJB3 is needed."
 msgstr ""
 
+#. Tag: para
+#: ri.xml:55
+#, no-c-format
+msgid ""
+"To install the update, you'll need ant 1.7.0 installed, and the "
+"<literal>ANT_HOME</literal> environment variable set. For example:"
+msgstr ""
+
 #. Tag: programlisting
-#: ri.xml:51
+#: ri.xml:60
 #, no-c-format
 msgid ""
 "$ unzip apache-ant-1.7.0.zip\n"
@@ -86,13 +119,15 @@
 "$ export ANT_HOME=~/apache-ant-1.7.0"
 
 #. Tag: para
-#: ri.xml:53
+#: ri.xml:62
 #, no-c-format
-msgid "Then, you can install the update. The update script will use Maven to download the Web Beans and EJB3 automatically."
+msgid ""
+"Then, you can install the update. The update script will use Maven to "
+"download the Web Beans and EJB3 automatically."
 msgstr ""
 
 #. Tag: programlisting
-#: ri.xml:58
+#: ri.xml:67
 #, no-c-format
 msgid ""
 "$ cd webbeans-1.0.0.ALPHA1/jboss-as\n"
@@ -102,55 +137,59 @@
 "$ ant update"
 
 #. Tag: para
-#: ri.xml:60
+#: ri.xml:69
 #, no-c-format
 msgid "Now, you're ready to deploy your first example!"
 msgstr ""
 
 #. Tag: para
-#: ri.xml:65
+#: ri.xml:74
 #, no-c-format
-msgid "The build scripts for the examples offer a number of targets, these are:"
+msgid ""
+"The build scripts for the examples offer a number of targets, these are:"
 msgstr ""
 
 #. Tag: para
-#: ri.xml:71
+#: ri.xml:80
 #, no-c-format
 msgid "<literal>ant restart</literal> - deploy the example in exploded format"
 msgstr ""
 
 #. Tag: para
-#: ri.xml:77
+#: ri.xml:86
 #, no-c-format
-msgid "<literal>ant explode</literal> - update an exploded example, without restarting the deployment"
+msgid ""
+"<literal>ant explode</literal> - update an exploded example, without "
+"restarting the deployment"
 msgstr ""
 
 #. Tag: para
-#: ri.xml:83
+#: ri.xml:92
 #, no-c-format
-msgid "<literal>ant deploy</literal> - deploy the example in compressed jar format"
+msgid ""
+"<literal>ant deploy</literal> - deploy the example in compressed jar format"
 msgstr ""
 
 #. Tag: para
-#: ri.xml:88
+#: ri.xml:97
 #, no-c-format
 msgid "<literal>ant undeploy</literal> - remove the example from the server"
 msgstr ""
 
 #. Tag: para
-#: ri.xml:93
+#: ri.xml:102
 #, no-c-format
 msgid "<literal>ant clean</literal> - clean the example"
 msgstr ""
 
 #. Tag: para
-#: ri.xml:100
+#: ri.xml:109
 #, no-c-format
 msgid "To deploy the numberguess example:"
 msgstr ""
 
 #. Tag: programlisting
-#: ri.xml:104
+#: ri.xml:113
 #, no-c-format
 msgid ""
 "$ cd examples/numberguess\n"
@@ -160,19 +199,25 @@
 "ant deploy"
 
 #. Tag: para
-#: ri.xml:106
+#: ri.xml:115
 #, no-c-format
-msgid "Wait for the application to deploy, and enjoy hours of fun at <ulink url=\"http://localhost:8080/webbeans-numberguess\"></ulink>!"
+msgid ""
+"Wait for the application to deploy, and enjoy hours of fun at <ulink url="
+"\"http://localhost:8080/webbeans-numberguess\"></ulink>!"
 msgstr ""
 
 #. Tag: para
-#: ri.xml:111
+#: ri.xml:120
 #, no-c-format
-msgid "The Web Beans RI includes a second simple example that will translate your text into Latin. The numberguess example is a war example, and uses only simple beans; the translator example is an ear example, and includes enterprise beans, packaged in an EJB module. To try it out:"
+msgid ""
+"The Web Beans RI includes a second simple example that will translate your "
+"text into Latin. The numberguess example is a war example, and uses only "
+"simple beans; the translator example is an ear example, and includes "
+"enterprise beans, packaged in an EJB module. To try it out:"
 msgstr ""
 
 #. Tag: programlisting
-#: ri.xml:118
+#: ri.xml:127
 #, no-c-format
 msgid ""
 "$ cd examples/traslator\n"
@@ -182,44 +227,57 @@
 "ant deploy"
 
 #. Tag: para
-#: ri.xml:120
+#: ri.xml:129
 #, no-c-format
-msgid "Wait for the application to deploy, and visit <ulink url=\"http://localhost:8080/webbeans-translator\"></ulink>!"
+msgid ""
+"Wait for the application to deploy, and visit <ulink url=\"http://"
+"localhost:8080/webbeans-translator\"></ulink>!"
 msgstr ""
 
 #. Tag: title
-#: ri.xml:126
+#: ri.xml:135
 #, no-c-format
 msgid "The numberguess example"
 msgstr "Esempio di indovina-numeri"
 
 #. Tag: para
-#: ri.xml:128
+#: ri.xml:137
 #, no-c-format
-msgid "In the numberguess application you get given 10 attempts to guess a number between 1 and 100. After each attempt, you will be told whether you are too high, or too low."
+msgid ""
+"In the numberguess application you get given 10 attempts to guess a number "
+"between 1 and 100. After each attempt, you will be told whether you are too "
+"high, or too low."
 msgstr ""
 
 #. Tag: para
-#: ri.xml:134
+#: ri.xml:143
 #, no-c-format
-msgid "The numberguess example is comprised of a number of Web Beans, configuration files, and Facelet JSF pages, packaged as a war. Let's start with the configuration files."
+msgid ""
+"The numberguess example is comprised of a number of Web Beans, configuration "
+"files, and Facelet JSF pages, packaged as a war. Let's start with the "
+"configuration files."
 msgstr ""
 
 #. Tag: para
-#: ri.xml:140
+#: ri.xml:149
 #, no-c-format
-msgid "All the configuration files for this example are located in <literal>WEB-INF/</literal>, which is stored in <literal>WebContent</literal> in the source tree. First, we have <literal>faces-config.xml</literal>, in which we tell JSF to use Facelets:"
+msgid ""
+"All the configuration files for this example are located in <literal>WEB-INF/"
+"</literal>, which is stored in <literal>WebContent</literal> in the source "
+"tree. First, we have <literal>faces-config.xml</literal>, in which we tell "
+"JSF to use Facelets:"
 msgstr ""
 
 #. Tag: programlisting
-#: ri.xml:148
+#: ri.xml:157
 #, no-c-format
 msgid ""
 "<![CDATA[<?xml version='1.0' encoding='UTF-8'?>\n"
 "<faces-config version=\"1.2\"\n"
 "              xmlns=\"http://java.sun.com/xml/ns/javaee\"\n"
 "              xmlns:xsi=\"http://www.w3.org/2001/XMLSchema-instance\"\n"
-"              xsi:schemaLocation=\"http://java.sun.com/xml/ns/javaee http://java.sun.com/xml/ns/javaee/web-facesconfig_1_2.xsd\">\n"
+"              xsi:schemaLocation=\"http://java.sun.com/xml/ns/javaee http://"
+"java.sun.com/xml/ns/javaee/web-facesconfig_1_2.xsd\">\n"
 "    \n"
 "    <application>\n"
 "        <view-handler>com.sun.facelets.FaceletViewHandler</view-handler>\n"
@@ -231,7 +289,8 @@
 "<faces-config version=\"1.2\"\n"
 "              xmlns=\"http://java.sun.com/xml/ns/javaee\"\n"
 "              xmlns:xsi=\"http://www.w3.org/2001/XMLSchema-instance\"\n"
-"              xsi:schemaLocation=\"http://java.sun.com/xml/ns/javaee http://java.sun.com/xml/ns/javaee/web-facesconfig_1_2.xsd\">\n"
+"              xsi:schemaLocation=\"http://java.sun.com/xml/ns/javaee http://"
+"java.sun.com/xml/ns/javaee/web-facesconfig_1_2.xsd\">\n"
 "    \n"
 "    <application>\n"
 "        <view-handler>com.sun.facelets.FaceletViewHandler</view-handler>\n"
@@ -240,27 +299,34 @@
 "</faces-config>]]>"
 
 #. Tag: para
-#: ri.xml:150
+#: ri.xml:159
 #, no-c-format
-msgid "There is an empty <literal>web-beans.xml</literal> file, which marks this application as a Web Beans application."
+msgid ""
+"There is an empty <literal>web-beans.xml</literal> file, which marks this "
+"application as a Web Beans application."
 msgstr ""
 
 #. Tag: para
-#: ri.xml:155
+#: ri.xml:164
 #, no-c-format
 msgid "Finally there is <literal>web.xml</literal>:"
 msgstr ""
 
 #. Tag: section
-#: ri.xml:157
+#: ri.xml:166
 #, no-c-format
 msgid ""
-"<programlistingco> <areaspec> <area id=\"faces.servlet\" coords=\"12\"/> <area id=\"faces.servlet.mapping\" coords=\"18\"/> <area id=\"faces.default.suffix\" coords=\"23\"/> <area id=\"session.timeout\" coords=\"28\"/> <area id=\"webbeans.listener\" coords=\"32\"/> </areaspec> <programlisting><![CDATA[<?xml version=\"1.0\" encoding=\"UTF-8\"?>\n"
+"<programlistingco> <areaspec> <area id=\"faces.servlet\" coords=\"12\"/> "
+"<area id=\"faces.servlet.mapping\" coords=\"18\"/> <area id=\"faces.default."
+"suffix\" coords=\"23\"/> <area id=\"session.timeout\" coords=\"28\"/> <area "
+"id=\"webbeans.listener\" coords=\"32\"/> </areaspec> <programlisting><![CDATA"
+"[<?xml version=\"1.0\" encoding=\"UTF-8\"?>\n"
 "\n"
 "<web-app version=\"2.5\"\n"
 "    xmlns=\"http://java.sun.com/xml/ns/javaee\"\n"
 "    xmlns:xsi=\"http://www.w3.org/2001/XMLSchema-instance\"\n"
-"    xsi:schemaLocation=\"http://java.sun.com/xml/ns/javaee http://java.sun.com/xml/ns/javaee/web-app_2_5.xsd\">\n"
+"    xsi:schemaLocation=\"http://java.sun.com/xml/ns/javaee http://java.sun."
+"com/xml/ns/javaee/web-app_2_5.xsd\">\n"
 "   \n"
 "   <display-name>Web Beans Numbergues example</display-name>\n"
 "\n"
@@ -287,10 +353,31 @@
 "   </session-config>\n"
 "   \n"
 "    <listener>\n"
-"       <listener-class>org.jboss.webbeans.servlet.WebBeansListener</listener-class>\n"
+"       <listener-class>org.jboss.webbeans.servlet.WebBeansListener</listener-"
+"class>\n"
 "    </listener>\n"
 "\n"
-"</web-app>]]></programlisting> <calloutlist> <callout arearefs=\"faces.servlet\"> <para> Enable and load the JSF servlet </para> </callout> <callout arearefs=\"faces.servlet.mapping\"> <para> Configure requests to <literal>.jsf</literal> pages to be handled by JSF </para> </callout> <callout arearefs=\"faces.default.suffix\"> <para> Tell JSF that we will be giving our source files (facelets) an extension of <literal>.jsf</literal> </para> </callout> <callout arearefs=\"session.timeout\"> <para> Configure a session timeout of 10 minutes </para> </callout> <callout arearefs=\"webbeans.listener\"> <para> Configure the Web Beans listener, so that Web Beans services can be used in the servlet request </para> </callout> </calloutlist> </programlistingco> <note> <para> The only configuration required by the Web Beans RI in <literal>web.xml</literal> is to add the Web Beans listener. </para> <para> Whilst this demo is a JSF demo, you can use the Web Beans RI with any Servlet based!
  web framework; just configure the Web Beans listener. </para> </note> <para> Let's take a look at the Facelet view: </para> <programlistingco> <areaspec> <area id=\"template\" coords=\"8\"/> <area id=\"messages\" coords=\"12\"/> <area id=\"instructions\" coords=\"19\"/> <area id=\"guess\" coords=\"25\"/> <area id=\"validator\" coords=\"29\"/> <area id=\"submit\" coords=\"32\"/> </areaspec> <programlisting><![CDATA[<!DOCTYPE html PUBLIC \"-//W3C//DTD XHTML 1.0 Transitional//EN\" \"http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd\">\n"
+"</web-app>]]></programlisting> <calloutlist> <callout arearefs=\"faces."
+"servlet\"> <para> Enable and load the JSF servlet </para> </callout> "
+"<callout arearefs=\"faces.servlet.mapping\"> <para> Configure requests to "
+"<literal>.jsf</literal> pages to be handled by JSF </para> </callout> "
+"<callout arearefs=\"faces.default.suffix\"> <para> Tell JSF that we will be "
+"giving our source files (facelets) an extension of <literal>.jsf</literal> </"
+"para> </callout> <callout arearefs=\"session.timeout\"> <para> Configure a "
+"session timeout of 10 minutes </para> </callout> <callout arearefs="
+"\"webbeans.listener\"> <para> Configure the Web Beans listener, so that Web "
+"Beans services can be used in the servlet request </para> </callout> </"
+"calloutlist> </programlistingco> <note> <para> The only configuration "
+"required by the Web Beans RI in <literal>web.xml</literal> is to add the Web "
+"Beans listener. </para> <para> Whilst this demo is a JSF demo, you can use "
+"the Web Beans RI with any Servlet based web framework; just configure the "
+"Web Beans listener. </para> </note> <para> Let's take a look at the Facelet "
+"view: </para> <programlistingco> <areaspec> <area id=\"template\" coords=\"8"
+"\"/> <area id=\"messages\" coords=\"12\"/> <area id=\"instructions\" coords="
+"\"19\"/> <area id=\"guess\" coords=\"25\"/> <area id=\"validator\" coords="
+"\"29\"/> <area id=\"submit\" coords=\"32\"/> </areaspec> <programlisting><!"
+"[CDATA[<!DOCTYPE html PUBLIC \"-//W3C//DTD XHTML 1.0 Transitional//EN\" "
+"\"http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd\">\n"
 "<html xmlns=\"http://www.w3.org/1999/xhtml\"\n"
 "    xmlns:ui=\"http://java.sun.com/jsf/facelets\"\n"
 "    xmlns:h=\"http://java.sun.com/jsf/html\"\n"
@@ -303,12 +390,15 @@
 "       <h:form id=\"NumberGuessMain\">\n"
 "          <div style=\"color: red\">\n"
 "             <h:messages id=\"messages\" globalOnly=\"false\"/>\n"
-"             <h:outputText id=\"Higher\" value=\"Higher!\" rendered=\"#{game.number gt game.guess}\"/>\n"
-"             <h:outputText id=\"Lower\" value=\"Lower!\" rendered=\"#{game.number lt game.guess}\"/>\n"
+"             <h:outputText id=\"Higher\" value=\"Higher!\" rendered=\"#{game."
+"number gt game.guess}\"/>\n"
+"             <h:outputText id=\"Lower\" value=\"Lower!\" rendered=\"#{game."
+"number lt game.guess}\"/>\n"
 "          </div>\n"
 "   \n"
 "          <div>\n"
-"             I'm thinking of a number between #{game.smallest} and #{game.biggest}.\n"
+"             I'm thinking of a number between #{game.smallest} and #{game."
+"biggest}.\n"
 "             You have #{game.remainingGuesses} guesses.\n"
 "          </div>\n"
 "     \n"
@@ -329,14 +419,35 @@
 "       </h:form>\n"
 "    </ui:define>\n"
 "  </ui:composition>\n"
-"</html>]]></programlisting> <calloutlist> <callout arearefs=\"template\"> <para> Facelets is a templating language for JSF, here we are wrapping our page in a template which defines the header. </para> </callout> <callout arearefs=\"messages\"> <para> There are a number of messages which can be sent to the user, \"Higher!\", \"Lower!\" and \"Correct!\" </para> </callout> <callout arearefs=\"instructions\"> <para> As the user guesses, the range of numbers they can guess gets smaller - this sentance changes to make sure they know what range to guess in. </para> </callout> <callout arearefs=\"guess\"> <para> This input field is bound to a Web Bean, using the value expression. </para> </callout> <callout arearefs=\"validator\"> <para> A range validator is used to make sure the user doesn't accidentally input a number outside of the range in which they can guess - if the validator wasn't here, the user might use up a guess on an out of range number. </para> </callout> <callout !
 arearefs=\"submit\"> <para> And, of course, there must be a way for the user to send their guess to the server. Here we bind to an action method on the Web Bean. </para> </callout> </calloutlist> </programlistingco>"
+"</html>]]></programlisting> <calloutlist> <callout arearefs=\"template\"> "
+"<para> Facelets is a templating language for JSF, here we are wrapping our "
+"page in a template which defines the header. </para> </callout> <callout "
+"arearefs=\"messages\"> <para> There are a number of messages which can be "
+"sent to the user, \"Higher!\", \"Lower!\" and \"Correct!\" </para> </"
+"callout> <callout arearefs=\"instructions\"> <para> As the user guesses, the "
+"range of numbers they can guess gets smaller - this sentance changes to make "
+"sure they know what range to guess in. </para> </callout> <callout arearefs="
+"\"guess\"> <para> This input field is bound to a Web Bean, using the value "
+"expression. </para> </callout> <callout arearefs=\"validator\"> <para> A "
+"range validator is used to make sure the user doesn't accidentally input a "
+"number outside of the range in which they can guess - if the validator "
+"wasn't here, the user might use up a guess on an out of range number. </"
+"para> </callout> <callout arearefs=\"submit\"> <para> And, of course, there "
+"must be a way for the user to send their guess to the server. Here we bind "
+"to an action method on the Web Bean. </para> </callout> </calloutlist> </"
+"programlistingco>"
 msgstr ""
-"<programlistingco> <areaspec> <area id=\"faces.servlet\" coords=\"12\"/> <area id=\"faces.servlet.mapping\" coords=\"18\"/> <area id=\"faces.default.suffix\" coords=\"23\"/> <area id=\"session.timeout\" coords=\"28\"/> <area id=\"webbeans.listener\" coords=\"32\"/> </areaspec> <programlisting><![CDATA[<?xml version=\"1.0\" encoding=\"UTF-8\"?>\n"
+"<programlistingco> <areaspec> <area id=\"faces.servlet\" coords=\"12\"/> "
+"<area id=\"faces.servlet.mapping\" coords=\"18\"/> <area id=\"faces.default."
+"suffix\" coords=\"23\"/> <area id=\"session.timeout\" coords=\"28\"/> <area "
+"id=\"webbeans.listener\" coords=\"32\"/> </areaspec> <programlisting><![CDATA"
+"[<?xml version=\"1.0\" encoding=\"UTF-8\"?>\n"
 "\n"
 "<web-app version=\"2.5\"\n"
 "    xmlns=\"http://java.sun.com/xml/ns/javaee\"\n"
 "    xmlns:xsi=\"http://www.w3.org/2001/XMLSchema-instance\"\n"
-"    xsi:schemaLocation=\"http://java.sun.com/xml/ns/javaee http://java.sun.com/xml/ns/javaee/web-app_2_5.xsd\">\n"
+"    xsi:schemaLocation=\"http://java.sun.com/xml/ns/javaee http://java.sun."
+"com/xml/ns/javaee/web-app_2_5.xsd\">\n"
 "   \n"
 "   <display-name>Web Beans Numbergues example</display-name>\n"
 "\n"
@@ -363,10 +474,31 @@
 "   </session-config>\n"
 "   \n"
 "    <listener>\n"
-"       <listener-class>org.jboss.webbeans.servlet.WebBeansListener</listener-class>\n"
+"       <listener-class>org.jboss.webbeans.servlet.WebBeansListener</listener-"
+"class>\n"
 "    </listener>\n"
 "\n"
-"</web-app>]]></programlisting> <calloutlist> <callout arearefs=\"faces.servlet\"> <para> Enable and load the JSF servlet </para> </callout> <callout arearefs=\"faces.servlet.mapping\"> <para> Configure requests to <literal>.jsf</literal> pages to be handled by JSF </para> </callout> <callout arearefs=\"faces.default.suffix\"> <para> Tell JSF that we will be giving our source files (facelets) an extension of <literal>.jsf</literal> </para> </callout> <callout arearefs=\"session.timeout\"> <para> Configure a session timeout of 10 minutes </para> </callout> <callout arearefs=\"webbeans.listener\"> <para> Configure the Web Beans listener, so that Web Beans services can be used in the servlet request </para> </callout> </calloutlist> </programlistingco> <note> <para> The only configuration required by the Web Beans RI in <literal>web.xml</literal> is to add the Web Beans listener. </para> <para> Whilst this demo is a JSF demo, you can use the Web Beans RI with any Servlet based!
  web framework; just configure the Web Beans listener. </para> </note> <para> Let's take a look at the Facelet view: </para> <programlistingco> <areaspec> <area id=\"template\" coords=\"8\"/> <area id=\"messages\" coords=\"12\"/> <area id=\"instructions\" coords=\"19\"/> <area id=\"guess\" coords=\"25\"/> <area id=\"validator\" coords=\"29\"/> <area id=\"submit\" coords=\"32\"/> </areaspec> <programlisting><![CDATA[<!DOCTYPE html PUBLIC \"-//W3C//DTD XHTML 1.0 Transitional//EN\" \"http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd\">\n"
+"</web-app>]]></programlisting> <calloutlist> <callout arearefs=\"faces."
+"servlet\"> <para> Enable and load the JSF servlet </para> </callout> "
+"<callout arearefs=\"faces.servlet.mapping\"> <para> Configure requests to "
+"<literal>.jsf</literal> pages to be handled by JSF </para> </callout> "
+"<callout arearefs=\"faces.default.suffix\"> <para> Tell JSF that we will be "
+"giving our source files (facelets) an extension of <literal>.jsf</literal> </"
+"para> </callout> <callout arearefs=\"session.timeout\"> <para> Configure a "
+"session timeout of 10 minutes </para> </callout> <callout arearefs="
+"\"webbeans.listener\"> <para> Configure the Web Beans listener, so that Web "
+"Beans services can be used in the servlet request </para> </callout> </"
+"calloutlist> </programlistingco> <note> <para> The only configuration "
+"required by the Web Beans RI in <literal>web.xml</literal> is to add the Web "
+"Beans listener. </para> <para> Whilst this demo is a JSF demo, you can use "
+"the Web Beans RI with any Servlet based web framework; just configure the "
+"Web Beans listener. </para> </note> <para> Let's take a look at the Facelet "
+"view: </para> <programlistingco> <areaspec> <area id=\"template\" coords=\"8"
+"\"/> <area id=\"messages\" coords=\"12\"/> <area id=\"instructions\" coords="
+"\"19\"/> <area id=\"guess\" coords=\"25\"/> <area id=\"validator\" coords="
+"\"29\"/> <area id=\"submit\" coords=\"32\"/> </areaspec> <programlisting><!"
+"[CDATA[<!DOCTYPE html PUBLIC \"-//W3C//DTD XHTML 1.0 Transitional//EN\" "
+"\"http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd\">\n"
 "<html xmlns=\"http://www.w3.org/1999/xhtml\"\n"
 "    xmlns:ui=\"http://java.sun.com/jsf/facelets\"\n"
 "    xmlns:h=\"http://java.sun.com/jsf/html\"\n"
@@ -379,12 +511,15 @@
 "       <h:form id=\"NumberGuessMain\">\n"
 "          <div style=\"color: red\">\n"
 "             <h:messages id=\"messages\" globalOnly=\"false\"/>\n"
-"             <h:outputText id=\"Higher\" value=\"Higher!\" rendered=\"#{game.number gt game.guess}\"/>\n"
-"             <h:outputText id=\"Lower\" value=\"Lower!\" rendered=\"#{game.number lt game.guess}\"/>\n"
+"             <h:outputText id=\"Higher\" value=\"Higher!\" rendered=\"#{game."
+"number gt game.guess}\"/>\n"
+"             <h:outputText id=\"Lower\" value=\"Lower!\" rendered=\"#{game."
+"number lt game.guess}\"/>\n"
 "          </div>\n"
 "   \n"
 "          <div>\n"
-"             I'm thinking of a number between #{game.smallest} and #{game.biggest}.\n"
+"             I'm thinking of a number between #{game.smallest} and #{game."
+"biggest}.\n"
 "             You have #{game.remainingGuesses} guesses.\n"
 "          </div>\n"
 "     \n"
@@ -405,16 +540,35 @@
 "       </h:form>\n"
 "    </ui:define>\n"
 "  </ui:composition>\n"
-"</html>]]></programlisting> <calloutlist> <callout arearefs=\"template\"> <para> Facelets is a templating language for JSF, here we are wrapping our page in a template which defines the header. </para> </callout> <callout arearefs=\"messages\"> <para> There are a number of messages which can be sent to the user, \"Higher!\", \"Lower!\" and \"Correct!\" </para> </callout> <callout arearefs=\"instructions\"> <para> As the user guesses, the range of numbers they can guess gets smaller - this sentance changes to make sure they know what range to guess in. </para> </callout> <callout arearefs=\"guess\"> <para> This input field is bound to a Web Bean, using the value expression. </para> </callout> <callout arearefs=\"validator\"> <para> A range validator is used to make sure the user doesn't accidentally input a number outside of the range in which they can guess - if the validator wasn't here, the user might use up a guess on an out of range number. </para> </callout> <callout !
 arearefs=\"submit\"> <para> And, of course, there must be a way for the user to send their guess to the server. Here we bind to an action method on the Web Bean. </para> </callout> </calloutlist> </programlistingco>"
+"</html>]]></programlisting> <calloutlist> <callout arearefs=\"template\"> "
+"<para> Facelets is a templating language for JSF, here we are wrapping our "
+"page in a template which defines the header. </para> </callout> <callout "
+"arearefs=\"messages\"> <para> There are a number of messages which can be "
+"sent to the user, \"Higher!\", \"Lower!\" and \"Correct!\" </para> </"
+"callout> <callout arearefs=\"instructions\"> <para> As the user guesses, the "
+"range of numbers they can guess gets smaller - this sentance changes to make "
+"sure they know what range to guess in. </para> </callout> <callout arearefs="
+"\"guess\"> <para> This input field is bound to a Web Bean, using the value "
+"expression. </para> </callout> <callout arearefs=\"validator\"> <para> A "
+"range validator is used to make sure the user doesn't accidentally input a "
+"number outside of the range in which they can guess - if the validator "
+"wasn't here, the user might use up a guess on an out of range number. </"
+"para> </callout> <callout arearefs=\"submit\"> <para> And, of course, there "
+"must be a way for the user to send their guess to the server. Here we bind "
+"to an action method on the Web Bean. </para> </callout> </calloutlist> </"
+"programlistingco>"
 
 #. Tag: para
-#: ri.xml:270
+#: ri.xml:279
 #, no-c-format
-msgid "The example exists of 4 classes, the first two of which are binding types. First, there is the <literal>@Random</literal> binding type, used for injecting a random number:"
+msgid ""
+"The example exists of 4 classes, the first two of which are binding types. "
+"First, there is the <literal>@Random</literal> binding type, used for "
+"injecting a random number:"
 msgstr ""
 
 #. Tag: programlisting
-#: ri.xml:276
+#: ri.xml:285
 #, no-c-format
 msgid ""
 "<![CDATA[@Target( { TYPE, METHOD, PARAMETER, FIELD })\n"
@@ -430,13 +584,15 @@
 "public @interface Random {}]]>"
 
 #. Tag: para
-#: ri.xml:278
+#: ri.xml:287
 #, no-c-format
-msgid "There is also the <literal>@MaxNumber</literal> binding type, used for injecting the maximum number that can be injected:"
+msgid ""
+"There is also the <literal>@MaxNumber</literal> binding type, used for "
+"injecting the maximum number that can be injected:"
 msgstr ""
 
 #. Tag: programlisting
-#: ri.xml:283
+#: ri.xml:292
 #, no-c-format
 msgid ""
 "<![CDATA[@Target( { TYPE, METHOD, PARAMETER, FIELD })\n"
@@ -454,19 +610,23 @@
 "]]>"
 
 #. Tag: para
-#: ri.xml:285
+#: ri.xml:294
 #, no-c-format
-msgid "The <literal>Generator</literal> class is responsible for creating the random number, via a producer method. It also exposes the maximum possible number via a producer method:"
+msgid ""
+"The <literal>Generator</literal> class is responsible for creating the "
+"random number, via a producer method. It also exposes the maximum possible "
+"number via a producer method:"
 msgstr ""
 
 #. Tag: programlisting
-#: ri.xml:291
+#: ri.xml:300
 #, no-c-format
 msgid ""
 "<![CDATA[@ApplicationScoped\n"
 "public class Generator {\n"
 "   \n"
-"   private java.util.Random random = new java.util.Random( System.currentTimeMillis() );\n"
+"   private java.util.Random random = new java.util.Random( System."
+"currentTimeMillis() );\n"
 "   \n"
 "   private int maxNumber = 100;\n"
 "   \n"
@@ -489,7 +649,8 @@
 "<![CDATA[@ApplicationScoped\n"
 "public class Generator {\n"
 "   \n"
-"   private java.util.Random random = new java.util.Random( System.currentTimeMillis() );\n"
+"   private java.util.Random random = new java.util.Random( System."
+"currentTimeMillis() );\n"
 "   \n"
 "   private int maxNumber = 100;\n"
 "   \n"
@@ -510,25 +671,36 @@
 "}]]>"
 
 #. Tag: para
-#: ri.xml:293
+#: ri.xml:302
 #, no-c-format
-msgid "You'll notice that the <literal>Generator</literal> is application scoped; therefore we don't get a different random each time."
+msgid ""
+"You'll notice that the <literal>Generator</literal> is application scoped; "
+"therefore we don't get a different random each time."
 msgstr ""
 
 #. Tag: para
-#: ri.xml:298
+#: ri.xml:307
 #, no-c-format
-msgid "The final Web Bean in the application is the session scoped <literal>Game</literal>. By making <literal>Game</literal> session scoped, you can only play the game once per browser session. You could easily add a reset button - a good exercise for the reader :-)"
+msgid ""
+"The final Web Bean in the application is the session scoped <literal>Game</"
+"literal>. By making <literal>Game</literal> session scoped, you can only "
+"play the game once per browser session. You could easily add a reset button "
+"- a good exercise for the reader :-)"
 msgstr ""
 
 #. Tag: para
-#: ri.xml:305
+#: ri.xml:314
 #, no-c-format
-msgid "You'll also note that we've used the <literal>@Named</literal> annotation, so that we can use the bean through EL in the JSF page. Finally, we've used constructor injection to initialize the game with a random number. And of course, we need to tell the player when they've won, so we give feedback with a <literal>FacesMessage</literal>."
+msgid ""
+"You'll also note that we've used the <literal>@Named</literal> annotation, "
+"so that we can use the bean through EL in the JSF page. Finally, we've used "
+"constructor injection to initialize the game with a random number. And of "
+"course, we need to tell the player when they've won, so we give feedback "
+"with a <literal>FacesMessage</literal>."
 msgstr ""
 
 #. Tag: programlisting
-#: ri.xml:313
+#: ri.xml:322
 #, no-c-format
 msgid ""
 "<![CDATA[@Named\n"
@@ -561,7 +733,8 @@
 "         smallest = guess + 1;\n"
 "      }\n"
 "      if (guess == number) {\n"
-"         FacesContext.getCurrentInstance().addMessage(null, new FacesMessage(\"Correct!\"));\n"
+"         FacesContext.getCurrentInstance().addMessage(null, new FacesMessage"
+"(\"Correct!\"));\n"
 "      }\n"
 "      remainingGuesses--;\n"
 "      return null;\n"
@@ -599,7 +772,8 @@
 "         smallest = guess + 1;\n"
 "      }\n"
 "      if (guess == number) {\n"
-"         FacesContext.getCurrentInstance().addMessage(null, new FacesMessage(\"Correct!\"));\n"
+"         FacesContext.getCurrentInstance().addMessage(null, new FacesMessage"
+"(\"Correct!\"));\n"
 "      }\n"
 "      remainingGuesses--;\n"
 "      return null;\n"
@@ -608,37 +782,50 @@
 "}]]>"
 
 #. Tag: title
-#: ri.xml:317
+#: ri.xml:326
 #, no-c-format
 msgid "The translator example"
 msgstr "Esempio di traduttore"
 
 #. Tag: para
-#: ri.xml:319
+#: ri.xml:328
 #, no-c-format
-msgid "The translator example will take any sentences you enter, and translate them to Latin."
-msgstr "L'esempio del traduttore prende le frasi che vengono inserite e le traduce in latino."
+msgid ""
+"The translator example will take any sentences you enter, and translate them "
+"to Latin."
+msgstr ""
+"L'esempio del traduttore prende le frasi che vengono inserite e le traduce "
+"in latino."
 
 #. Tag: para
-#: ri.xml:324
+#: ri.xml:333
 #, no-c-format
-msgid "The translator example is built as an ear, and contains EJBs and enterprise beans. As a result, it's structure is more complex than the numberguess example."
+msgid ""
+"The translator example is built as an ear, and contains EJBs and enterprise "
+"beans. As a result, it's structure is more complex than the numberguess "
+"example."
 msgstr ""
 
 #. Tag: para
-#: ri.xml:331
+#: ri.xml:340
 #, no-c-format
-msgid "EJB 3.1 and Jave EE 6 allow you to package EJBs in a war, which will make this structure much simpler!"
+msgid ""
+"EJB 3.1 and Jave EE 6 allow you to package EJBs in a war, which will make "
+"this structure much simpler!"
 msgstr ""
 
 #. Tag: para
-#: ri.xml:337
+#: ri.xml:346
 #, no-c-format
-msgid "First, let's take a look at the ear aggregator, which is located in <literal>webbeans-translator-ear</literal> module. Maven automatically generates the <literal>application.xml</literal> and <literal>jboss-app.xml</literal> for us:"
+msgid ""
+"First, let's take a look at the ear aggregator, which is located in "
+"<literal>webbeans-translator-ear</literal> module. Maven automatically "
+"generates the <literal>application.xml</literal> and <literal>jboss-app.xml</"
+"literal> for us:"
 msgstr ""
 
 #. Tag: programlisting
-#: ri.xml:344
+#: ri.xml:353
 #, no-c-format
 msgid ""
 "<![CDATA[<plugin>\n"
@@ -653,7 +840,8 @@
 "         </webModule>\n"
 "      </modules>\n"
 "      <jboss>\n"
-"         <loader-repository>webbeans.jboss.org:loader=webbeans-translator</loader-repository>\n"
+"         <loader-repository>webbeans.jboss.org:loader=webbeans-translator</"
+"loader-repository>\n"
 "      </jboss>\n"
 "   </configuration>\n"
 "</plugin>]]>"
@@ -670,25 +858,32 @@
 "         </webModule>\n"
 "      </modules>\n"
 "      <jboss>\n"
-"         <loader-repository>webbeans.jboss.org:loader=webbeans-translator</loader-repository>\n"
+"         <loader-repository>webbeans.jboss.org:loader=webbeans-translator</"
+"loader-repository>\n"
 "      </jboss>\n"
 "   </configuration>\n"
 "</plugin>]]>"
 
 #. Tag: para
-#: ri.xml:346
+#: ri.xml:355
 #, no-c-format
-msgid "We're doing a couple of things here - firstly we set the context path, which gives us a nice url (<ulink url=\"http://localhost:8080/webbeans-translator\">http://localhost:8080/webbeans-translator</ulink>) and we also enable class loader isolation for JBoss AS."
+msgid ""
+"We're doing a couple of things here - firstly we set the context path, which "
+"gives us a nice url (<ulink url=\"http://localhost:8080/webbeans-translator"
+"\">http://localhost:8080/webbeans-translator</ulink>) and we also enable "
+"class loader isolation for JBoss AS."
 msgstr ""
 
 #. Tag: para
-#: ri.xml:354
+#: ri.xml:363
 #, no-c-format
-msgid "If you aren't using Maven to generate these files, you would need <literal>META-INF/jboss-app.xml</literal>:"
+msgid ""
+"If you aren't using Maven to generate these files, you would need "
+"<literal>META-INF/jboss-app.xml</literal>:"
 msgstr ""
 
 #. Tag: programlisting
-#: ri.xml:359
+#: ri.xml:368
 #, no-c-format
 msgid ""
 "<![CDATA[<?xml version=\"1.0\" encoding=\"UTF-8\"?>\n"
@@ -696,7 +891,8 @@
 "    PUBLIC \"-//JBoss//DTD J2EE Application 4.2//EN\"\n"
 "    \"http://www.jboss.org/j2ee/dtd/jboss-app_4_2.dtd\">\n"
 "<jboss-app>\n"
-"  <loader-repository>webbeans.jboss.org:loader=webbeans-translator</loader-repository>\n"
+"  <loader-repository>webbeans.jboss.org:loader=webbeans-translator</loader-"
+"repository>\n"
 "</jboss-app>]]>"
 msgstr ""
 "<![CDATA[<?xml version=\"1.0\" encoding=\"UTF-8\"?>\n"
@@ -704,26 +900,29 @@
 "    PUBLIC \"-//JBoss//DTD J2EE Application 4.2//EN\"\n"
 "    \"http://www.jboss.org/j2ee/dtd/jboss-app_4_2.dtd\">\n"
 "<jboss-app>\n"
-"  <loader-repository>webbeans.jboss.org:loader=webbeans-translator</loader-repository>\n"
+"  <loader-repository>webbeans.jboss.org:loader=webbeans-translator</loader-"
+"repository>\n"
 "</jboss-app>]]>"
 
 #. Tag: para
-#: ri.xml:361
+#: ri.xml:370
 #, no-c-format
 msgid "and <literal>META-INF/application.xml</literal>:"
 msgstr "e <literal>META-INF/application.xml</literal>:"
 
 #. Tag: programlisting
-#: ri.xml:365
+#: ri.xml:374
 #, no-c-format
 msgid ""
 "<![CDATA[<?xml version=\"1.0\" encoding=\"UTF-8\"?>\n"
 "<application xmlns=\"http://java.sun.com/xml/ns/javaee\" \n"
 "             xmlns:xsi=\"http://www.w3.org/2001/XMLSchema-instance\"\n"
-"             xsi:schemaLocation=\"http://java.sun.com/xml/ns/javaee http://java.sun.com/xml/ns/javaee/application_5.xsd\"\n"
+"             xsi:schemaLocation=\"http://java.sun.com/xml/ns/javaee http://"
+"java.sun.com/xml/ns/javaee/application_5.xsd\"\n"
 "             version=\"5\">\n"
 "  <display-name>webbeans-translator-ear</display-name>\n"
-"  <description>Ear Example for the reference implementation of JSR 299: Web Beans</description>\n"
+"  <description>Ear Example for the reference implementation of JSR 299: Web "
+"Beans</description>\n"
 "  \n"
 "  <module>\n"
 "    <web>\n"
@@ -739,10 +938,12 @@
 "<![CDATA[<?xml version=\"1.0\" encoding=\"UTF-8\"?>\n"
 "<application xmlns=\"http://java.sun.com/xml/ns/javaee\" \n"
 "             xmlns:xsi=\"http://www.w3.org/2001/XMLSchema-instance\"\n"
-"             xsi:schemaLocation=\"http://java.sun.com/xml/ns/javaee http://java.sun.com/xml/ns/javaee/application_5.xsd\"\n"
+"             xsi:schemaLocation=\"http://java.sun.com/xml/ns/javaee http://"
+"java.sun.com/xml/ns/javaee/application_5.xsd\"\n"
 "             version=\"5\">\n"
 "  <display-name>webbeans-translator-ear</display-name>\n"
-"  <description>Ear Example for the reference implementation of JSR 299: Web Beans</description>\n"
+"  <description>Ear Example for the reference implementation of JSR 299: Web "
+"Beans</description>\n"
 "  \n"
 "  <module>\n"
 "    <web>\n"
@@ -756,19 +957,26 @@
 "</application>]]>"
 
 #. Tag: para
-#: ri.xml:368
+#: ri.xml:377
 #, no-c-format
-msgid "Next, lets look at the war. Just as in the numberguess example, we have a <literal>faces-config.xml</literal> (to enabled Facelets) and a <literal>web.xml</literal> (to enable JSF and attach Web Beans services to the servlet container) in <literal>WebContent/WEB-INF</literal>."
+msgid ""
+"Next, lets look at the war. Just as in the numberguess example, we have a "
+"<literal>faces-config.xml</literal> (to enabled Facelets) and a <literal>web."
+"xml</literal> (to enable JSF and attach Web Beans services to the servlet "
+"container) in <literal>WebContent/WEB-INF</literal>."
 msgstr ""
 
 #. Tag: para
-#: ri.xml:375
+#: ri.xml:384
 #, no-c-format
-msgid "More intersting is the facelet used to translate text. Just as in the numberguess example we have a template, which surrounds the form (ommitted here for brevity):"
+msgid ""
+"More intersting is the facelet used to translate text. Just as in the "
+"numberguess example we have a template, which surrounds the form (ommitted "
+"here for brevity):"
 msgstr ""
 
 #. Tag: programlisting
-#: ri.xml:381
+#: ri.xml:390
 #, no-c-format
 msgid ""
 "<![CDATA[<h:form id=\"NumberGuessMain\">\n"
@@ -784,7 +992,8 @@
 "      </tr>\n"
 "      <tr>\n"
 "         <td>\n"
-"            <h:inputTextarea id=\"text\" value=\"#{translator.text}\" required=\"true\" rows=\"5\" cols=\"80\" />\n"
+"            <h:inputTextarea id=\"text\" value=\"#{translator.text}\" "
+"required=\"true\" rows=\"5\" cols=\"80\" />\n"
 "         </td>\n"
 "         <td>\n"
 "            <h:outputText value=\"#{translator.translatedText}\" />\n"
@@ -792,7 +1001,8 @@
 "      </tr>\n"
 "   </table>\n"
 "   <div>\n"
-"      <h:commandButton id=\"button\" value=\"Translate\" action=\"#{translator.translate}\"/>\n"
+"      <h:commandButton id=\"button\" value=\"Translate\" action=\"#"
+"{translator.translate}\"/>\n"
 "   </div>\n"
 "   \n"
 "</h:form>]]>"
@@ -810,7 +1020,8 @@
 "      </tr>\n"
 "      <tr>\n"
 "         <td>\n"
-"            <h:inputTextarea id=\"text\" value=\"#{translator.text}\" required=\"true\" rows=\"5\" cols=\"80\" />\n"
+"            <h:inputTextarea id=\"text\" value=\"#{translator.text}\" "
+"required=\"true\" rows=\"5\" cols=\"80\" />\n"
 "         </td>\n"
 "         <td>\n"
 "            <h:outputText value=\"#{translator.translatedText}\" />\n"
@@ -818,43 +1029,56 @@
 "      </tr>\n"
 "   </table>\n"
 "   <div>\n"
-"      <h:commandButton id=\"button\" value=\"Translate\" action=\"#{translator.translate}\"/>\n"
+"      <h:commandButton id=\"button\" value=\"Translate\" action=\"#"
+"{translator.translate}\"/>\n"
 "   </div>\n"
 "   \n"
 "</h:form>]]>"
 
 #. Tag: para
-#: ri.xml:383
+#: ri.xml:392
 #, no-c-format
-msgid "The user can enter some text in the lefthand textarea, and hit the translate button to see the result to the right."
+msgid ""
+"The user can enter some text in the lefthand textarea, and hit the translate "
+"button to see the result to the right."
 msgstr ""
 
 #. Tag: para
-#: ri.xml:388
+#: ri.xml:397
 #, no-c-format
-msgid "Finally, let's look at the ejb module, <literal>webbeans-translator-ejb</literal>. There are two configuration files in <literal>src/main/resources/META-INF</literal>, an empty <literal>web-beans.xml</literal>, used to mark the archive as containing Web Beans, and <literal>ejb-jar.xml</literal>. Web Beans provides injection and initializtion services for all EJBs, and uses <literal>ejb-jar.xml</literal> to enable this, you'll need this in any EJB project which uses Web Beans:"
+msgid ""
+"Finally, let's look at the ejb module, <literal>webbeans-translator-ejb</"
+"literal>. There are two configuration files in <literal>src/main/resources/"
+"META-INF</literal>, an empty <literal>web-beans.xml</literal>, used to mark "
+"the archive as containing Web Beans, and <literal>ejb-jar.xml</literal>. Web "
+"Beans provides injection and initializtion services for all EJBs, and uses "
+"<literal>ejb-jar.xml</literal> to enable this, you'll need this in any EJB "
+"project which uses Web Beans:"
 msgstr ""
 
 #. Tag: programlisting
-#: ri.xml:400
+#: ri.xml:409
 #, no-c-format
 msgid ""
 "<![CDATA[<?xml version=\"1.0\" encoding=\"UTF-8\"?>\n"
 "<ejb-jar xmlns=\"http://java.sun.com/xml/ns/javaee\" \n"
 "         xmlns:xsi=\"http://www.w3.org/2001/XMLSchema-instance\" \n"
-"         xsi:schemaLocation=\"http://java.sun.com/xml/ns/javaee http://java.sun.com/xml/ns/javaee/ejb-jar_3_0.xsd\"\n"
+"         xsi:schemaLocation=\"http://java.sun.com/xml/ns/javaee http://java."
+"sun.com/xml/ns/javaee/ejb-jar_3_0.xsd\"\n"
 "         version=\"3.0\">\n"
 "         \n"
 "   <interceptors>\n"
 "     <interceptor>\n"
-"       <interceptor-class>org.jboss.webbeans.ejb.SessionBeanInterceptor</interceptor-class>\n"
+"       <interceptor-class>org.jboss.webbeans.ejb.SessionBeanInterceptor</"
+"interceptor-class>\n"
 "     </interceptor>\n"
 "   </interceptors>\n"
 "   \n"
 "   <assembly-descriptor>\n"
 "      <interceptor-binding>\n"
 "         <ejb-name>*</ejb-name>\n"
-"         <interceptor-class>org.jboss.webbeans.ejb.SessionBeanInterceptor</interceptor-class>\n"
+"         <interceptor-class>org.jboss.webbeans.ejb.SessionBeanInterceptor</"
+"interceptor-class>\n"
 "      </interceptor-binding>\n"
 "   </assembly-descriptor>\n"
 "   \n"
@@ -863,38 +1087,50 @@
 "<![CDATA[<?xml version=\"1.0\" encoding=\"UTF-8\"?>\n"
 "<ejb-jar xmlns=\"http://java.sun.com/xml/ns/javaee\" \n"
 "         xmlns:xsi=\"http://www.w3.org/2001/XMLSchema-instance\" \n"
-"         xsi:schemaLocation=\"http://java.sun.com/xml/ns/javaee http://java.sun.com/xml/ns/javaee/ejb-jar_3_0.xsd\"\n"
+"         xsi:schemaLocation=\"http://java.sun.com/xml/ns/javaee http://java."
+"sun.com/xml/ns/javaee/ejb-jar_3_0.xsd\"\n"
 "         version=\"3.0\">\n"
 "         \n"
 "   <interceptors>\n"
 "     <interceptor>\n"
-"       <interceptor-class>org.jboss.webbeans.ejb.SessionBeanInterceptor</interceptor-class>\n"
+"       <interceptor-class>org.jboss.webbeans.ejb.SessionBeanInterceptor</"
+"interceptor-class>\n"
 "     </interceptor>\n"
 "   </interceptors>\n"
 "   \n"
 "   <assembly-descriptor>\n"
 "      <interceptor-binding>\n"
 "         <ejb-name>*</ejb-name>\n"
-"         <interceptor-class>org.jboss.webbeans.ejb.SessionBeanInterceptor</interceptor-class>\n"
+"         <interceptor-class>org.jboss.webbeans.ejb.SessionBeanInterceptor</"
+"interceptor-class>\n"
 "      </interceptor-binding>\n"
 "   </assembly-descriptor>\n"
 "   \n"
 "</ejb-jar>]]>"
 
 #. Tag: para
-#: ri.xml:402
+#: ri.xml:411
 #, no-c-format
-msgid "We've saved the most interesting bit to last, the code! The project has two simple beans, <literal>SentanceParser</literal> and <literal>TextTranslator</literal> and two enterprise beans, <literal>TanslatorControllerBean</literal> and <literal>SentenceTranslator</literal>. You should be getting quite familiar with what a Web Bean looks like by now, so we'll just highlight the most interesting bits here."
+msgid ""
+"We've saved the most interesting bit to last, the code! The project has two "
+"simple beans, <literal>SentanceParser</literal> and <literal>TextTranslator</"
+"literal> and two enterprise beans, <literal>TanslatorControllerBean</"
+"literal> and <literal>SentenceTranslator</literal>. You should be getting "
+"quite familiar with what a Web Bean looks like by now, so we'll just "
+"highlight the most interesting bits here."
 msgstr ""
 
 #. Tag: para
-#: ri.xml:412
+#: ri.xml:421
 #, no-c-format
-msgid "Both <literal>SentanceParser</literal> and <literal>TextTranslator</literal> are dependent beans, and <literal>TextTranslator</literal> uses constructor initialization:"
+msgid ""
+"Both <literal>SentanceParser</literal> and <literal>TextTranslator</literal> "
+"are dependent beans, and <literal>TextTranslator</literal> uses constructor "
+"initialization:"
 msgstr ""
 
 #. Tag: programlisting
-#: ri.xml:418
+#: ri.xml:427
 #, no-c-format
 msgid ""
 "<![CDATA[public class TextTranslator { \n"
@@ -902,7 +1138,8 @@
 "   private Translator sentenceTranslator; \n"
 "   \n"
 "   @Initializer\n"
-"   TextTranslator(SentenceParser sentenceParser, Translator sentenceTranslator) \n"
+"   TextTranslator(SentenceParser sentenceParser, Translator "
+"sentenceTranslator) \n"
 "   { \n"
 "      this.sentenceParser = sentenceParser; \n"
 "      this.sentenceTranslator = sentenceTranslator;]]>"
@@ -912,25 +1149,32 @@
 "   private Translator sentenceTranslator; \n"
 "   \n"
 "   @Initializer\n"
-"   TextTranslator(SentenceParser sentenceParser, Translator sentenceTranslator) \n"
+"   TextTranslator(SentenceParser sentenceParser, Translator "
+"sentenceTranslator) \n"
 "   { \n"
 "      this.sentenceParser = sentenceParser; \n"
 "      this.sentenceTranslator = sentenceTranslator;]]>"
 
 #. Tag: para
-#: ri.xml:420
+#: ri.xml:429
 #, no-c-format
-msgid "<literal>TextTranslator</literal> is a stateless bean (with a local business interface), where the magic happens - of course, we couldn't develop a full translator, but we gave it a good go!"
+msgid ""
+"<literal>TextTranslator</literal> is a stateless bean (with a local business "
+"interface), where the magic happens - of course, we couldn't develop a full "
+"translator, but we gave it a good go!"
 msgstr ""
 
 #. Tag: para
-#: ri.xml:426
+#: ri.xml:435
 #, no-c-format
-msgid "Finally, there is UI orientated controller, that collects the text from the user, and dispatches it to the translator. This is a request scoped, named, stateful session bean, which injects the translator."
+msgid ""
+"Finally, there is UI orientated controller, that collects the text from the "
+"user, and dispatches it to the translator. This is a request scoped, named, "
+"stateful session bean, which injects the translator."
 msgstr ""
 
 #. Tag: programlisting
-#: ri.xml:432
+#: ri.xml:441
 #, no-c-format
 msgid ""
 "<![CDATA[@Stateful\n"
@@ -950,19 +1194,19 @@
 "   @Current TextTranslator translator;]]>"
 
 #. Tag: para
-#: ri.xml:434
+#: ri.xml:443
 #, no-c-format
 msgid "The bean also has getters and setters for all the fields on the page."
 msgstr ""
 
 #. Tag: para
-#: ri.xml:438
+#: ri.xml:447
 #, no-c-format
 msgid "As this is a stateful session bean, we have to have a remove method:"
 msgstr ""
 
 #. Tag: programlisting
-#: ri.xml:442
+#: ri.xml:451
 #, no-c-format
 msgid ""
 "<![CDATA[   @Remove\n"
@@ -978,20 +1222,27 @@
 "   }]]>"
 
 #. Tag: para
-#: ri.xml:444
+#: ri.xml:453
 #, no-c-format
-msgid "The Web Beans manager will call the remove method for you when the bean is destroyed; in this case at the end of the request."
+msgid ""
+"The Web Beans manager will call the remove method for you when the bean is "
+"destroyed; in this case at the end of the request."
 msgstr ""
 
 #. Tag: para
-#: ri.xml:450
+#: ri.xml:459
 #, no-c-format
-msgid "That concludes our short tour of the Web Beans RI examples. For more on the RI, or to help out, please visit <ulink url=\"http://www.seamframework.org/WebBeans/Development\">http://www.seamframework.org/WebBeans/Development</ulink>."
+msgid ""
+"That concludes our short tour of the Web Beans RI examples. For more on the "
+"RI, or to help out, please visit <ulink url=\"http://www.seamframework.org/"
+"WebBeans/Development\">http://www.seamframework.org/WebBeans/Development</"
+"ulink>."
 msgstr ""
 
 #. Tag: para
-#: ri.xml:456
+#: ri.xml:465
 #, no-c-format
-msgid "We need help in all areas - bug fixing, writing new features, writing examples and translating this reference guide."
+msgid ""
+"We need help in all areas - bug fixing, writing new features, writing "
+"examples and translating this reference guide."
 msgstr ""
-

Modified: doc/trunk/reference/ja-JP/modules/ee.po
===================================================================
--- doc/trunk/reference/ja-JP/modules/ee.po	2008-12-20 19:00:18 UTC (rev 630)
+++ doc/trunk/reference/ja-JP/modules/ee.po	2008-12-20 22:17:05 UTC (rev 631)
@@ -5,7 +5,7 @@
 msgstr ""
 "Project-Id-Version: master.xml \n"
 "Report-Msgid-Bugs-To: http://bugs.kde.org\n"
-"POT-Creation-Date: 2008-12-19 20:26+0000\n"
+"POT-Creation-Date: 2008-12-20 22:08+0000\n"
 "PO-Revision-Date: 2008-12-19 20:26+0000\n"
 "Last-Translator: Automatically generated\n"
 "Language-Team: none\n"
@@ -296,7 +296,7 @@
 #: ee.xml:100
 #, no-c-format
 msgid ""
-"The lifecycle of the injected JMS objects are completely controlled by the "
+"The lifecycle of the injected JMS objects is completely controlled by the "
 "Web Bean manager."
 msgstr ""
 

Modified: doc/trunk/reference/ja-JP/modules/producermethods.po
===================================================================
--- doc/trunk/reference/ja-JP/modules/producermethods.po	2008-12-20 19:00:18 UTC (rev 630)
+++ doc/trunk/reference/ja-JP/modules/producermethods.po	2008-12-20 22:17:05 UTC (rev 631)
@@ -5,7 +5,7 @@
 msgstr ""
 "Project-Id-Version: master.xml \n"
 "Report-Msgid-Bugs-To: http://bugs.kde.org\n"
-"POT-Creation-Date: 2008-12-19 20:26+0000\n"
+"POT-Creation-Date: 2008-12-20 22:08+0000\n"
 "PO-Revision-Date: 2008-12-19 20:26+0000\n"
 "Last-Translator: Automatically generated\n"
 "Language-Team: none\n"
@@ -57,7 +57,8 @@
 "polymorphism with Web Beans. As we've seen, deployment types are a powerful "
 "solution to the problem of deployment-time polymorphism. But once the system "
 "is deployed, the Web Bean implementation is fixed. A producer method has no "
-"such limitation:</para> <programlisting><![CDATA[@SessionScoped\n"
+"such limitation:</para> <programlisting role=\"JAVA\"><![CDATA"
+"[@SessionScoped\n"
 "public class Preferences {\n"
 "    \n"
 "    private PaymentStrategyType paymentStrategy;\n"
@@ -75,12 +76,12 @@
 "    }\n"
 "    \n"
 "}]]></programlisting> <para>Consider an injection point:</para> "
-"<programlisting><![CDATA[@Preferred PaymentStrategy paymentStrat;]]></"
-"programlisting> <para>This injection point has the same type and binding "
-"annotations as the producer method, so it resolves to the producer method "
-"using the usual Web Beans injection rules. The producer method will be "
-"called by the Web Bean manager to obtain an instance to service this "
-"injection point.</para>."
+"<programlisting role=\"JAVA\"><![CDATA[@Preferred PaymentStrategy "
+"paymentStrat;]]></programlisting> <para>This injection point has the same "
+"type and binding annotations as the producer method, so it resolves to the "
+"producer method using the usual Web Beans injection rules. The producer "
+"method will be called by the Web Bean manager to obtain an instance to "
+"service this injection point.</para>."
 msgstr ""
 
 #. Tag: title

Added: doc/trunk/reference/ja-JP/modules/ri-spi.po
===================================================================
--- doc/trunk/reference/ja-JP/modules/ri-spi.po	                        (rev 0)
+++ doc/trunk/reference/ja-JP/modules/ri-spi.po	2008-12-20 22:17:05 UTC (rev 631)
@@ -0,0 +1,275 @@
+# Language ja-JP translations for master.xml package.
+# Automatically generated, 2008.
+#
+msgid ""
+msgstr ""
+"Project-Id-Version: master.xml \n"
+"Report-Msgid-Bugs-To: http://bugs.kde.org\n"
+"POT-Creation-Date: 2008-12-20 22:07+0000\n"
+"PO-Revision-Date: 2008-12-20 22:07+0000\n"
+"Last-Translator: Automatically generated\n"
+"Language-Team: none\n"
+"MIME-Version: 1.0\n"
+"Content-Type: text/plain; charset=UTF-8\n"
+"Content-Transfer-Encoding: 8bit\n"
+
+#. Tag: title
+#: ri-spi.xml:4
+#, no-c-format
+msgid "Integrating the Web Beans RI into other environments"
+msgstr ""
+
+#. Tag: para
+#: ri-spi.xml:6
+#, no-c-format
+msgid ""
+"Currently the Web Beans RI only runs in JBoss AS 5; integrating the RI into "
+"other EE environments (for example another application server like "
+"Glassfish), into a servlet container (like Tomcat), or with an Embedded "
+"EJB3.1 implementation is fairly easy. In this Appendix we will briefly "
+"discuss the steps needed."
+msgstr ""
+
+#. Tag: para
+#: ri-spi.xml:15
+#, no-c-format
+msgid ""
+"It should be possible to run Web Beans in an SE environment, but you'll to "
+"do more work, adding your own contexts and lifecycle. The Web Beans RI "
+"currently doesn't expose lifecycle extension points, so you would have to "
+"code directly against Web Beans RI classes."
+msgstr ""
+
+#. Tag: title
+#: ri-spi.xml:24
+#, no-c-format
+msgid "The Web Beans RI SPI"
+msgstr ""
+
+#. Tag: para
+#: ri-spi.xml:26
+#, no-c-format
+msgid ""
+"The Web Beans SPI is located in <literal>webbeans-ri-spi</literal> module, "
+"and packaged as <literal>webbeans-ri-spi.jar</literal>."
+msgstr ""
+
+#. Tag: para
+#: ri-spi.xml:31
+#, no-c-format
+msgid "Currently, the only SPI to implement is the bootstrap spi:"
+msgstr ""
+
+#. Tag: programlisting
+#: ri-spi.xml:35
+#, no-c-format
+msgid ""
+"<![CDATA[public interface WebBeanDiscovery {\n"
+"   /**\n"
+"    * Gets list of all classes in classpath archives with web-beans.xml "
+"files\n"
+"    * \n"
+"    * @return An iterable over the classes \n"
+"    */\n"
+"   public Iterable<Class<?>> discoverWebBeanClasses();\n"
+"   \n"
+"   /**\n"
+"    * Gets a list of all web-beans.xml files in the app classpath\n"
+"    * \n"
+"    * @return An iterable over the web-beans.xml files \n"
+"    */\n"
+"   public Iterable<URL> discoverWebBeansXml();\n"
+"   \n"
+"   /**\n"
+"    * Gets a descriptor for each EJB in the application\n"
+"    * \n"
+"    * @return The bean class to descriptor map \n"
+"    */\n"
+"   public Iterable<EjbDescriptor<?>> discoverEjbs();\n"
+"   \n"
+"}]]>"
+msgstr ""
+
+#. Tag: para
+#: ri-spi.xml:37
+#, no-c-format
+msgid ""
+"The discovery of Web Bean classes and <literal>web-bean.xml</literal> files "
+"is self-explanatory (the algorithm is described in Section 11.1 of the JSR-"
+"299 specification, and isn't repeated here)."
+msgstr ""
+
+#. Tag: para
+#: ri-spi.xml:43
+#, no-c-format
+msgid ""
+"The Web Beans RI also delegates EJB3 bean discovery to the container so that "
+"it doesn't have to scan for EJB3 annotations or parse <literal>ejb-jar.xml</"
+"literal>. For each EJB in the application an EJBDescriptor should be "
+"discovered:"
+msgstr ""
+
+#. Tag: programlisting
+#: ri-spi.xml:50
+#, no-c-format
+msgid ""
+"<![CDATA[public interface EjbDescriptor<T> {\n"
+"   \n"
+"   /**\n"
+"    * Gets the EJB type\n"
+"    * \n"
+"    * @return The EJB Bean class\n"
+"    */\n"
+"   public Class<T> getType();\n"
+"\n"
+"   /**\n"
+"    * Gets the local business interfaces of the EJB\n"
+"    * \n"
+"    * @return An iterator over the local business interfaces\n"
+"    */\n"
+"   public Iterable<BusinessInterfaceDescriptor<?>> getLocalBusinessInterfaces"
+"();\n"
+"   \n"
+"   /**\n"
+"    * Gets the remote business interfaces of the EJB\n"
+"    * \n"
+"    * @return An iterator over the remote business interfaces\n"
+"    */\n"
+"   public Iterable<BusinessInterfaceDescriptor<?>> "
+"getRemoteBusinessInterfaces();\n"
+"   \n"
+"   /**\n"
+"    * Get the remove methods of the EJB\n"
+"    * \n"
+"    * @return An iterator over the remove methods\n"
+"    */\n"
+"   public Iterable<MethodDescriptor> getRemoveMethods();\n"
+"\n"
+"   /**\n"
+"    * Indicates if the bean is stateless\n"
+"    * \n"
+"    * @return True if stateless, false otherwise\n"
+"    */\n"
+"   public boolean isStateless();\n"
+"\n"
+"   /**\n"
+"    * Indicates if the bean is a EJB 3.1 Singleton\n"
+"    * \n"
+"    * @return True if the bean is a singleton, false otherwise\n"
+"    */\n"
+"   public boolean isSingleton();\n"
+"\n"
+"   /**\n"
+"    * Indicates if the EJB is stateful\n"
+"    * \n"
+"    * @return True if the bean is stateful, false otherwise\n"
+"    */\n"
+"   public boolean isStateful();\n"
+"\n"
+"   /**\n"
+"    * Indicates if the EJB is and MDB\n"
+"    * \n"
+"    * @return True if the bean is an MDB, false otherwise\n"
+"    */\n"
+"   public boolean isMessageDriven();\n"
+"\n"
+"   /**\n"
+"    * Gets the EJB name\n"
+"    * \n"
+"    * @return The name\n"
+"    */\n"
+"   public String getEjbName();\n"
+"   \n"
+"   /**\n"
+"    * @return The JNDI string which can be used to lookup a proxy which \n"
+"    * implements all local business interfaces \n"
+"    * \n"
+"    */\n"
+"   public String getLocalJndiName();\n"
+"   \n"
+"}]]>"
+msgstr ""
+
+#. Tag: para
+#: ri-spi.xml:52
+#, no-c-format
+msgid ""
+"The contract described the JavaDoc is enough to implement an EJBDescriptor. "
+"In addition to these two interfaces, there is "
+"<literal>BusinessInterfaceDescriptor</literal> which represents a local "
+"business interface (encapsulating the interface class and jndi name), and "
+"<literal>MethodDescriptor</literal> which encapsulates the method name and "
+"parameter types (allowing it to be invoked on any instance of the EJB, proxy "
+"or otherwise)."
+msgstr ""
+
+#. Tag: para
+#: ri-spi.xml:62
+#, no-c-format
+msgid ""
+"The Web Beans RI can be told to load your implementation of "
+"<literal>WebBeanDiscovery</literal> using the property <literal>org.jboss."
+"webbeans.bootstrap.webBeanDiscovery</literal> with the fully qualified class "
+"name as the value. For example:"
+msgstr ""
+
+#. Tag: programlisting
+#: ri-spi.xml:69
+#, no-c-format
+msgid ""
+"org.jboss.webbeans.bootstrap.webBeanDiscovery=org.jboss.webbeans.integration."
+"jbossas.WebBeanDiscoveryImpl"
+msgstr ""
+
+#. Tag: para
+#: ri-spi.xml:71
+#, no-c-format
+msgid ""
+"The property can either be specified as a system property, or in a "
+"properties file <literal>META-INF/web-beans-ri.properties</literal>."
+msgstr ""
+
+#. Tag: title
+#: ri-spi.xml:79
+#, no-c-format
+msgid "The contract with the container"
+msgstr ""
+
+#. Tag: para
+#: ri-spi.xml:81
+#, no-c-format
+msgid ""
+"There are a number of requirements that the Web Beans RI places on the "
+"container for correct functioning that fall outside implementation of APIs"
+msgstr ""
+
+#. Tag: term
+#: ri-spi.xml:89
+#, no-c-format
+msgid "Classloader isolation"
+msgstr ""
+
+#. Tag: para
+#: ri-spi.xml:93
+#, no-c-format
+msgid ""
+"If you are integrating the Web Beans into an environment that supports "
+"deployment of applications, you must enable, automatically, or through user "
+"configuation, classloader isolation for each Web Beans application"
+msgstr ""
+
+#. Tag: term
+#: ri-spi.xml:102
+#, no-c-format
+msgid "The <literal>webbeans-ri.jar</literal>"
+msgstr ""
+
+#. Tag: para
+#: ri-spi.xml:106
+#, no-c-format
+msgid ""
+"If you are integrating the Web Beans into an environment that supports "
+"deployment of applications, you must insert the <literal>webbeans-ri.jar</"
+"literal> into the applications isolated classloader. It cannot be loaded "
+"from a shared classloader."
+msgstr ""

Modified: doc/trunk/reference/ja-JP/modules/ri.po
===================================================================
--- doc/trunk/reference/ja-JP/modules/ri.po	2008-12-20 19:00:18 UTC (rev 630)
+++ doc/trunk/reference/ja-JP/modules/ri.po	2008-12-20 22:17:05 UTC (rev 631)
@@ -5,7 +5,7 @@
 msgstr ""
 "Project-Id-Version: master.xml \n"
 "Report-Msgid-Bugs-To: http://bugs.kde.org\n"
-"POT-Creation-Date: 2008-12-19 20:26+0000\n"
+"POT-Creation-Date: 2008-12-20 22:08+0000\n"
 "PO-Revision-Date: 2008-12-19 20:26+0000\n"
 "Last-Translator: Automatically generated\n"
 "Language-Team: none\n"
@@ -62,16 +62,31 @@
 msgstr ""
 
 #. Tag: para
-#: ri.xml:30
+#: ri.xml:31
 #, no-c-format
 msgid ""
+"Next, we need to tell Web Beans where JBoss is located. Edit <literal>jboss-"
+"as/build.properties</literal> and set the <literal>jboss.home</literal> "
+"property. For example:"
+msgstr ""
+
+#. Tag: programlisting
+#: ri.xml:37
+#, no-c-format
+msgid "jboss.home=/Applications/jboss-5.0.0.GA"
+msgstr ""
+
+#. Tag: para
+#: ri.xml:39
+#, no-c-format
+msgid ""
 "As Web Beans is a new piece of software, you need to update JBoss AS to run "
 "the Web Beans RI. Future versions of JBoss AS will include these updates, "
 "and this step won't be necessary."
 msgstr ""
 
 #. Tag: para
-#: ri.xml:37
+#: ri.xml:46
 #, no-c-format
 msgid ""
 "Currently, two updates are needed. Firstly, a new deployer, "
@@ -82,7 +97,7 @@
 msgstr ""
 
 #. Tag: para
-#: ri.xml:46
+#: ri.xml:55
 #, no-c-format
 msgid ""
 "To install the update, you'll need ant 1.7.0 installed, and the "
@@ -90,7 +105,7 @@
 msgstr ""
 
 #. Tag: programlisting
-#: ri.xml:51
+#: ri.xml:60
 #, no-c-format
 msgid ""
 "$ unzip apache-ant-1.7.0.zip\n"
@@ -98,7 +113,7 @@
 msgstr ""
 
 #. Tag: para
-#: ri.xml:53
+#: ri.xml:62
 #, no-c-format
 msgid ""
 "Then, you can install the update. The update script will use Maven to "
@@ -106,7 +121,7 @@
 msgstr ""
 
 #. Tag: programlisting
-#: ri.xml:58
+#: ri.xml:67
 #, no-c-format
 msgid ""
 "$ cd webbeans-1.0.0.ALPHA1/jboss-as\n"
@@ -114,26 +129,26 @@
 msgstr ""
 
 #. Tag: para
-#: ri.xml:60
+#: ri.xml:69
 #, no-c-format
 msgid "Now, you're ready to deploy your first example!"
 msgstr ""
 
 #. Tag: para
-#: ri.xml:65
+#: ri.xml:74
 #, no-c-format
 msgid ""
 "The build scripts for the examples offer a number of targets, these are:"
 msgstr ""
 
 #. Tag: para
-#: ri.xml:71
+#: ri.xml:80
 #, no-c-format
 msgid "<literal>ant restart</literal> - deploy the example in exploded format"
 msgstr ""
 
 #. Tag: para
-#: ri.xml:77
+#: ri.xml:86
 #, no-c-format
 msgid ""
 "<literal>ant explode</literal> - update an exploded example, without "
@@ -141,32 +156,32 @@
 msgstr ""
 
 #. Tag: para
-#: ri.xml:83
+#: ri.xml:92
 #, no-c-format
 msgid ""
 "<literal>ant deploy</literal> - deploy the example in compressed jar format"
 msgstr ""
 
 #. Tag: para
-#: ri.xml:88
+#: ri.xml:97
 #, no-c-format
 msgid "<literal>ant undeploy</literal> - remove the example from the server"
 msgstr ""
 
 #. Tag: para
-#: ri.xml:93
+#: ri.xml:102
 #, no-c-format
 msgid "<literal>ant clean</literal> - clean the example"
 msgstr ""
 
 #. Tag: para
-#: ri.xml:100
+#: ri.xml:109
 #, no-c-format
 msgid "To deploy the numberguess example:"
 msgstr ""
 
 #. Tag: programlisting
-#: ri.xml:104
+#: ri.xml:113
 #, no-c-format
 msgid ""
 "$ cd examples/numberguess\n"
@@ -174,7 +189,7 @@
 msgstr ""
 
 #. Tag: para
-#: ri.xml:106
+#: ri.xml:115
 #, no-c-format
 msgid ""
 "Wait for the application to deploy, and enjoy hours of fun at <ulink url="
@@ -182,7 +197,7 @@
 msgstr ""
 
 #. Tag: para
-#: ri.xml:111
+#: ri.xml:120
 #, no-c-format
 msgid ""
 "The Web Beans RI includes a second simple example that will translate your "
@@ -192,7 +207,7 @@
 msgstr ""
 
 #. Tag: programlisting
-#: ri.xml:118
+#: ri.xml:127
 #, no-c-format
 msgid ""
 "$ cd examples/traslator\n"
@@ -200,7 +215,7 @@
 msgstr ""
 
 #. Tag: para
-#: ri.xml:120
+#: ri.xml:129
 #, no-c-format
 msgid ""
 "Wait for the application to deploy, and visit <ulink url=\"http://"
@@ -208,13 +223,13 @@
 msgstr ""
 
 #. Tag: title
-#: ri.xml:126
+#: ri.xml:135
 #, no-c-format
 msgid "The numberguess example"
 msgstr ""
 
 #. Tag: para
-#: ri.xml:128
+#: ri.xml:137
 #, no-c-format
 msgid ""
 "In the numberguess application you get given 10 attempts to guess a number "
@@ -223,7 +238,7 @@
 msgstr ""
 
 #. Tag: para
-#: ri.xml:134
+#: ri.xml:143
 #, no-c-format
 msgid ""
 "The numberguess example is comprised of a number of Web Beans, configuration "
@@ -232,7 +247,7 @@
 msgstr ""
 
 #. Tag: para
-#: ri.xml:140
+#: ri.xml:149
 #, no-c-format
 msgid ""
 "All the configuration files for this example are located in <literal>WEB-INF/"
@@ -242,7 +257,7 @@
 msgstr ""
 
 #. Tag: programlisting
-#: ri.xml:148
+#: ri.xml:157
 #, no-c-format
 msgid ""
 "<![CDATA[<?xml version='1.0' encoding='UTF-8'?>\n"
@@ -260,7 +275,7 @@
 msgstr ""
 
 #. Tag: para
-#: ri.xml:150
+#: ri.xml:159
 #, no-c-format
 msgid ""
 "There is an empty <literal>web-beans.xml</literal> file, which marks this "
@@ -268,13 +283,13 @@
 msgstr ""
 
 #. Tag: para
-#: ri.xml:155
+#: ri.xml:164
 #, no-c-format
 msgid "Finally there is <literal>web.xml</literal>:"
 msgstr ""
 
 #. Tag: section
-#: ri.xml:157
+#: ri.xml:166
 #, no-c-format
 msgid ""
 "<programlistingco> <areaspec> <area id=\"faces.servlet\" coords=\"12\"/> "
@@ -400,7 +415,7 @@
 msgstr ""
 
 #. Tag: para
-#: ri.xml:270
+#: ri.xml:279
 #, no-c-format
 msgid ""
 "The example exists of 4 classes, the first two of which are binding types. "
@@ -409,7 +424,7 @@
 msgstr ""
 
 #. Tag: programlisting
-#: ri.xml:276
+#: ri.xml:285
 #, no-c-format
 msgid ""
 "<![CDATA[@Target( { TYPE, METHOD, PARAMETER, FIELD })\n"
@@ -420,7 +435,7 @@
 msgstr ""
 
 #. Tag: para
-#: ri.xml:278
+#: ri.xml:287
 #, no-c-format
 msgid ""
 "There is also the <literal>@MaxNumber</literal> binding type, used for "
@@ -428,7 +443,7 @@
 msgstr ""
 
 #. Tag: programlisting
-#: ri.xml:283
+#: ri.xml:292
 #, no-c-format
 msgid ""
 "<![CDATA[@Target( { TYPE, METHOD, PARAMETER, FIELD })\n"
@@ -440,7 +455,7 @@
 msgstr ""
 
 #. Tag: para
-#: ri.xml:285
+#: ri.xml:294
 #, no-c-format
 msgid ""
 "The <literal>Generator</literal> class is responsible for creating the "
@@ -449,7 +464,7 @@
 msgstr ""
 
 #. Tag: programlisting
-#: ri.xml:291
+#: ri.xml:300
 #, no-c-format
 msgid ""
 "<![CDATA[@ApplicationScoped\n"
@@ -478,7 +493,7 @@
 msgstr ""
 
 #. Tag: para
-#: ri.xml:293
+#: ri.xml:302
 #, no-c-format
 msgid ""
 "You'll notice that the <literal>Generator</literal> is application scoped; "
@@ -486,7 +501,7 @@
 msgstr ""
 
 #. Tag: para
-#: ri.xml:298
+#: ri.xml:307
 #, no-c-format
 msgid ""
 "The final Web Bean in the application is the session scoped <literal>Game</"
@@ -496,7 +511,7 @@
 msgstr ""
 
 #. Tag: para
-#: ri.xml:305
+#: ri.xml:314
 #, no-c-format
 msgid ""
 "You'll also note that we've used the <literal>@Named</literal> annotation, "
@@ -507,7 +522,7 @@
 msgstr ""
 
 #. Tag: programlisting
-#: ri.xml:313
+#: ri.xml:322
 #, no-c-format
 msgid ""
 "<![CDATA[@Named\n"
@@ -551,13 +566,13 @@
 msgstr ""
 
 #. Tag: title
-#: ri.xml:317
+#: ri.xml:326
 #, no-c-format
 msgid "The translator example"
 msgstr ""
 
 #. Tag: para
-#: ri.xml:319
+#: ri.xml:328
 #, no-c-format
 msgid ""
 "The translator example will take any sentences you enter, and translate them "
@@ -565,7 +580,7 @@
 msgstr ""
 
 #. Tag: para
-#: ri.xml:324
+#: ri.xml:333
 #, no-c-format
 msgid ""
 "The translator example is built as an ear, and contains EJBs and enterprise "
@@ -574,7 +589,7 @@
 msgstr ""
 
 #. Tag: para
-#: ri.xml:331
+#: ri.xml:340
 #, no-c-format
 msgid ""
 "EJB 3.1 and Jave EE 6 allow you to package EJBs in a war, which will make "
@@ -582,7 +597,7 @@
 msgstr ""
 
 #. Tag: para
-#: ri.xml:337
+#: ri.xml:346
 #, no-c-format
 msgid ""
 "First, let's take a look at the ear aggregator, which is located in "
@@ -592,7 +607,7 @@
 msgstr ""
 
 #. Tag: programlisting
-#: ri.xml:344
+#: ri.xml:353
 #, no-c-format
 msgid ""
 "<![CDATA[<plugin>\n"
@@ -615,7 +630,7 @@
 msgstr ""
 
 #. Tag: para
-#: ri.xml:346
+#: ri.xml:355
 #, no-c-format
 msgid ""
 "We're doing a couple of things here - firstly we set the context path, which "
@@ -625,7 +640,7 @@
 msgstr ""
 
 #. Tag: para
-#: ri.xml:354
+#: ri.xml:363
 #, no-c-format
 msgid ""
 "If you aren't using Maven to generate these files, you would need "
@@ -633,7 +648,7 @@
 msgstr ""
 
 #. Tag: programlisting
-#: ri.xml:359
+#: ri.xml:368
 #, no-c-format
 msgid ""
 "<![CDATA[<?xml version=\"1.0\" encoding=\"UTF-8\"?>\n"
@@ -647,13 +662,13 @@
 msgstr ""
 
 #. Tag: para
-#: ri.xml:361
+#: ri.xml:370
 #, no-c-format
 msgid "and <literal>META-INF/application.xml</literal>:"
 msgstr ""
 
 #. Tag: programlisting
-#: ri.xml:365
+#: ri.xml:374
 #, no-c-format
 msgid ""
 "<![CDATA[<?xml version=\"1.0\" encoding=\"UTF-8\"?>\n"
@@ -679,7 +694,7 @@
 msgstr ""
 
 #. Tag: para
-#: ri.xml:368
+#: ri.xml:377
 #, no-c-format
 msgid ""
 "Next, lets look at the war. Just as in the numberguess example, we have a "
@@ -689,7 +704,7 @@
 msgstr ""
 
 #. Tag: para
-#: ri.xml:375
+#: ri.xml:384
 #, no-c-format
 msgid ""
 "More intersting is the facelet used to translate text. Just as in the "
@@ -698,7 +713,7 @@
 msgstr ""
 
 #. Tag: programlisting
-#: ri.xml:381
+#: ri.xml:390
 #, no-c-format
 msgid ""
 "<![CDATA[<h:form id=\"NumberGuessMain\">\n"
@@ -731,7 +746,7 @@
 msgstr ""
 
 #. Tag: para
-#: ri.xml:383
+#: ri.xml:392
 #, no-c-format
 msgid ""
 "The user can enter some text in the lefthand textarea, and hit the translate "
@@ -739,7 +754,7 @@
 msgstr ""
 
 #. Tag: para
-#: ri.xml:388
+#: ri.xml:397
 #, no-c-format
 msgid ""
 "Finally, let's look at the ejb module, <literal>webbeans-translator-ejb</"
@@ -752,7 +767,7 @@
 msgstr ""
 
 #. Tag: programlisting
-#: ri.xml:400
+#: ri.xml:409
 #, no-c-format
 msgid ""
 "<![CDATA[<?xml version=\"1.0\" encoding=\"UTF-8\"?>\n"
@@ -781,7 +796,7 @@
 msgstr ""
 
 #. Tag: para
-#: ri.xml:402
+#: ri.xml:411
 #, no-c-format
 msgid ""
 "We've saved the most interesting bit to last, the code! The project has two "
@@ -793,7 +808,7 @@
 msgstr ""
 
 #. Tag: para
-#: ri.xml:412
+#: ri.xml:421
 #, no-c-format
 msgid ""
 "Both <literal>SentanceParser</literal> and <literal>TextTranslator</literal> "
@@ -802,7 +817,7 @@
 msgstr ""
 
 #. Tag: programlisting
-#: ri.xml:418
+#: ri.xml:427
 #, no-c-format
 msgid ""
 "<![CDATA[public class TextTranslator { \n"
@@ -818,7 +833,7 @@
 msgstr ""
 
 #. Tag: para
-#: ri.xml:420
+#: ri.xml:429
 #, no-c-format
 msgid ""
 "<literal>TextTranslator</literal> is a stateless bean (with a local business "
@@ -827,7 +842,7 @@
 msgstr ""
 
 #. Tag: para
-#: ri.xml:426
+#: ri.xml:435
 #, no-c-format
 msgid ""
 "Finally, there is UI orientated controller, that collects the text from the "
@@ -836,7 +851,7 @@
 msgstr ""
 
 #. Tag: programlisting
-#: ri.xml:432
+#: ri.xml:441
 #, no-c-format
 msgid ""
 "<![CDATA[@Stateful\n"
@@ -849,19 +864,19 @@
 msgstr ""
 
 #. Tag: para
-#: ri.xml:434
+#: ri.xml:443
 #, no-c-format
 msgid "The bean also has getters and setters for all the fields on the page."
 msgstr ""
 
 #. Tag: para
-#: ri.xml:438
+#: ri.xml:447
 #, no-c-format
 msgid "As this is a stateful session bean, we have to have a remove method:"
 msgstr ""
 
 #. Tag: programlisting
-#: ri.xml:442
+#: ri.xml:451
 #, no-c-format
 msgid ""
 "<![CDATA[   @Remove\n"
@@ -872,7 +887,7 @@
 msgstr ""
 
 #. Tag: para
-#: ri.xml:444
+#: ri.xml:453
 #, no-c-format
 msgid ""
 "The Web Beans manager will call the remove method for you when the bean is "
@@ -880,7 +895,7 @@
 msgstr ""
 
 #. Tag: para
-#: ri.xml:450
+#: ri.xml:459
 #, no-c-format
 msgid ""
 "That concludes our short tour of the Web Beans RI examples. For more on the "
@@ -890,7 +905,7 @@
 msgstr ""
 
 #. Tag: para
-#: ri.xml:456
+#: ri.xml:465
 #, no-c-format
 msgid ""
 "We need help in all areas - bug fixing, writing new features, writing "

Modified: doc/trunk/reference/pot/master.pot
===================================================================
--- doc/trunk/reference/pot/master.pot	2008-12-20 19:00:18 UTC (rev 630)
+++ doc/trunk/reference/pot/master.pot	2008-12-20 22:17:05 UTC (rev 631)
@@ -6,7 +6,7 @@
 msgstr ""
 "Project-Id-Version: PACKAGE VERSION\n"
 "Report-Msgid-Bugs-To: http://bugs.kde.org\n"
-"POT-Creation-Date: 2008-12-19 20:29+0000\n"
+"POT-Creation-Date: 2008-12-20 22:08+0000\n"
 "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n"
 "Last-Translator: FULL NAME <EMAIL at ADDRESS>\n"
 "Language-Team: LANGUAGE <kde-i18n-doc at kde.org>\n"

Modified: doc/trunk/reference/pot/modules/Book_Info.pot
===================================================================
--- doc/trunk/reference/pot/modules/Book_Info.pot	2008-12-20 19:00:18 UTC (rev 630)
+++ doc/trunk/reference/pot/modules/Book_Info.pot	2008-12-20 22:17:05 UTC (rev 631)
@@ -6,7 +6,7 @@
 msgstr ""
 "Project-Id-Version: PACKAGE VERSION\n"
 "Report-Msgid-Bugs-To: http://bugs.kde.org\n"
-"POT-Creation-Date: 2008-12-19 20:29+0000\n"
+"POT-Creation-Date: 2008-12-20 22:08+0000\n"
 "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n"
 "Last-Translator: FULL NAME <EMAIL at ADDRESS>\n"
 "Language-Team: LANGUAGE <kde-i18n-doc at kde.org>\n"

Modified: doc/trunk/reference/pot/modules/decorators.pot
===================================================================
--- doc/trunk/reference/pot/modules/decorators.pot	2008-12-20 19:00:18 UTC (rev 630)
+++ doc/trunk/reference/pot/modules/decorators.pot	2008-12-20 22:17:05 UTC (rev 631)
@@ -6,7 +6,7 @@
 msgstr ""
 "Project-Id-Version: PACKAGE VERSION\n"
 "Report-Msgid-Bugs-To: http://bugs.kde.org\n"
-"POT-Creation-Date: 2008-12-19 20:29+0000\n"
+"POT-Creation-Date: 2008-12-20 22:08+0000\n"
 "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n"
 "Last-Translator: FULL NAME <EMAIL at ADDRESS>\n"
 "Language-Team: LANGUAGE <kde-i18n-doc at kde.org>\n"

Modified: doc/trunk/reference/pot/modules/ee.pot
===================================================================
--- doc/trunk/reference/pot/modules/ee.pot	2008-12-20 19:00:18 UTC (rev 630)
+++ doc/trunk/reference/pot/modules/ee.pot	2008-12-20 22:17:05 UTC (rev 631)
@@ -6,7 +6,7 @@
 msgstr ""
 "Project-Id-Version: PACKAGE VERSION\n"
 "Report-Msgid-Bugs-To: http://bugs.kde.org\n"
-"POT-Creation-Date: 2008-12-19 20:29+0000\n"
+"POT-Creation-Date: 2008-12-20 22:08+0000\n"
 "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n"
 "Last-Translator: FULL NAME <EMAIL at ADDRESS>\n"
 "Language-Team: LANGUAGE <kde-i18n-doc at kde.org>\n"
@@ -297,7 +297,7 @@
 #: ee.xml:100
 #, no-c-format
 msgid ""
-"The lifecycle of the injected JMS objects are completely controlled by the "
+"The lifecycle of the injected JMS objects is completely controlled by the "
 "Web Bean manager."
 msgstr ""
 

Modified: doc/trunk/reference/pot/modules/events.pot
===================================================================
--- doc/trunk/reference/pot/modules/events.pot	2008-12-20 19:00:18 UTC (rev 630)
+++ doc/trunk/reference/pot/modules/events.pot	2008-12-20 22:17:05 UTC (rev 631)
@@ -6,7 +6,7 @@
 msgstr ""
 "Project-Id-Version: PACKAGE VERSION\n"
 "Report-Msgid-Bugs-To: http://bugs.kde.org\n"
-"POT-Creation-Date: 2008-12-19 20:29+0000\n"
+"POT-Creation-Date: 2008-12-20 22:08+0000\n"
 "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n"
 "Last-Translator: FULL NAME <EMAIL at ADDRESS>\n"
 "Language-Team: LANGUAGE <kde-i18n-doc at kde.org>\n"

Modified: doc/trunk/reference/pot/modules/example.pot
===================================================================
--- doc/trunk/reference/pot/modules/example.pot	2008-12-20 19:00:18 UTC (rev 630)
+++ doc/trunk/reference/pot/modules/example.pot	2008-12-20 22:17:05 UTC (rev 631)
@@ -6,7 +6,7 @@
 msgstr ""
 "Project-Id-Version: PACKAGE VERSION\n"
 "Report-Msgid-Bugs-To: http://bugs.kde.org\n"
-"POT-Creation-Date: 2008-12-19 20:29+0000\n"
+"POT-Creation-Date: 2008-12-20 22:08+0000\n"
 "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n"
 "Last-Translator: FULL NAME <EMAIL at ADDRESS>\n"
 "Language-Team: LANGUAGE <kde-i18n-doc at kde.org>\n"

Modified: doc/trunk/reference/pot/modules/extend.pot
===================================================================
--- doc/trunk/reference/pot/modules/extend.pot	2008-12-20 19:00:18 UTC (rev 630)
+++ doc/trunk/reference/pot/modules/extend.pot	2008-12-20 22:17:05 UTC (rev 631)
@@ -6,7 +6,7 @@
 msgstr ""
 "Project-Id-Version: PACKAGE VERSION\n"
 "Report-Msgid-Bugs-To: http://bugs.kde.org\n"
-"POT-Creation-Date: 2008-12-19 20:29+0000\n"
+"POT-Creation-Date: 2008-12-20 22:08+0000\n"
 "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n"
 "Last-Translator: FULL NAME <EMAIL at ADDRESS>\n"
 "Language-Team: LANGUAGE <kde-i18n-doc at kde.org>\n"

Modified: doc/trunk/reference/pot/modules/injection.pot
===================================================================
--- doc/trunk/reference/pot/modules/injection.pot	2008-12-20 19:00:18 UTC (rev 630)
+++ doc/trunk/reference/pot/modules/injection.pot	2008-12-20 22:17:05 UTC (rev 631)
@@ -6,7 +6,7 @@
 msgstr ""
 "Project-Id-Version: PACKAGE VERSION\n"
 "Report-Msgid-Bugs-To: http://bugs.kde.org\n"
-"POT-Creation-Date: 2008-12-19 20:29+0000\n"
+"POT-Creation-Date: 2008-12-20 22:08+0000\n"
 "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n"
 "Last-Translator: FULL NAME <EMAIL at ADDRESS>\n"
 "Language-Team: LANGUAGE <kde-i18n-doc at kde.org>\n"

Modified: doc/trunk/reference/pot/modules/interceptors.pot
===================================================================
--- doc/trunk/reference/pot/modules/interceptors.pot	2008-12-20 19:00:18 UTC (rev 630)
+++ doc/trunk/reference/pot/modules/interceptors.pot	2008-12-20 22:17:05 UTC (rev 631)
@@ -6,7 +6,7 @@
 msgstr ""
 "Project-Id-Version: PACKAGE VERSION\n"
 "Report-Msgid-Bugs-To: http://bugs.kde.org\n"
-"POT-Creation-Date: 2008-12-19 20:29+0000\n"
+"POT-Creation-Date: 2008-12-20 22:08+0000\n"
 "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n"
 "Last-Translator: FULL NAME <EMAIL at ADDRESS>\n"
 "Language-Team: LANGUAGE <kde-i18n-doc at kde.org>\n"

Modified: doc/trunk/reference/pot/modules/intro.pot
===================================================================
--- doc/trunk/reference/pot/modules/intro.pot	2008-12-20 19:00:18 UTC (rev 630)
+++ doc/trunk/reference/pot/modules/intro.pot	2008-12-20 22:17:05 UTC (rev 631)
@@ -6,7 +6,7 @@
 msgstr ""
 "Project-Id-Version: PACKAGE VERSION\n"
 "Report-Msgid-Bugs-To: http://bugs.kde.org\n"
-"POT-Creation-Date: 2008-12-19 20:29+0000\n"
+"POT-Creation-Date: 2008-12-20 22:08+0000\n"
 "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n"
 "Last-Translator: FULL NAME <EMAIL at ADDRESS>\n"
 "Language-Team: LANGUAGE <kde-i18n-doc at kde.org>\n"

Modified: doc/trunk/reference/pot/modules/next.pot
===================================================================
--- doc/trunk/reference/pot/modules/next.pot	2008-12-20 19:00:18 UTC (rev 630)
+++ doc/trunk/reference/pot/modules/next.pot	2008-12-20 22:17:05 UTC (rev 631)
@@ -6,7 +6,7 @@
 msgstr ""
 "Project-Id-Version: PACKAGE VERSION\n"
 "Report-Msgid-Bugs-To: http://bugs.kde.org\n"
-"POT-Creation-Date: 2008-12-19 20:29+0000\n"
+"POT-Creation-Date: 2008-12-20 22:08+0000\n"
 "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n"
 "Last-Translator: FULL NAME <EMAIL at ADDRESS>\n"
 "Language-Team: LANGUAGE <kde-i18n-doc at kde.org>\n"

Modified: doc/trunk/reference/pot/modules/part1.pot
===================================================================
--- doc/trunk/reference/pot/modules/part1.pot	2008-12-20 19:00:18 UTC (rev 630)
+++ doc/trunk/reference/pot/modules/part1.pot	2008-12-20 22:17:05 UTC (rev 631)
@@ -6,7 +6,7 @@
 msgstr ""
 "Project-Id-Version: PACKAGE VERSION\n"
 "Report-Msgid-Bugs-To: http://bugs.kde.org\n"
-"POT-Creation-Date: 2008-12-19 20:29+0000\n"
+"POT-Creation-Date: 2008-12-20 22:08+0000\n"
 "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n"
 "Last-Translator: FULL NAME <EMAIL at ADDRESS>\n"
 "Language-Team: LANGUAGE <kde-i18n-doc at kde.org>\n"

Modified: doc/trunk/reference/pot/modules/part2.pot
===================================================================
--- doc/trunk/reference/pot/modules/part2.pot	2008-12-20 19:00:18 UTC (rev 630)
+++ doc/trunk/reference/pot/modules/part2.pot	2008-12-20 22:17:05 UTC (rev 631)
@@ -6,7 +6,7 @@
 msgstr ""
 "Project-Id-Version: PACKAGE VERSION\n"
 "Report-Msgid-Bugs-To: http://bugs.kde.org\n"
-"POT-Creation-Date: 2008-12-19 20:29+0000\n"
+"POT-Creation-Date: 2008-12-20 22:08+0000\n"
 "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n"
 "Last-Translator: FULL NAME <EMAIL at ADDRESS>\n"
 "Language-Team: LANGUAGE <kde-i18n-doc at kde.org>\n"

Modified: doc/trunk/reference/pot/modules/part3.pot
===================================================================
--- doc/trunk/reference/pot/modules/part3.pot	2008-12-20 19:00:18 UTC (rev 630)
+++ doc/trunk/reference/pot/modules/part3.pot	2008-12-20 22:17:05 UTC (rev 631)
@@ -6,7 +6,7 @@
 msgstr ""
 "Project-Id-Version: PACKAGE VERSION\n"
 "Report-Msgid-Bugs-To: http://bugs.kde.org\n"
-"POT-Creation-Date: 2008-12-19 20:29+0000\n"
+"POT-Creation-Date: 2008-12-20 22:08+0000\n"
 "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n"
 "Last-Translator: FULL NAME <EMAIL at ADDRESS>\n"
 "Language-Team: LANGUAGE <kde-i18n-doc at kde.org>\n"

Modified: doc/trunk/reference/pot/modules/part4.pot
===================================================================
--- doc/trunk/reference/pot/modules/part4.pot	2008-12-20 19:00:18 UTC (rev 630)
+++ doc/trunk/reference/pot/modules/part4.pot	2008-12-20 22:17:05 UTC (rev 631)
@@ -6,7 +6,7 @@
 msgstr ""
 "Project-Id-Version: PACKAGE VERSION\n"
 "Report-Msgid-Bugs-To: http://bugs.kde.org\n"
-"POT-Creation-Date: 2008-12-19 20:29+0000\n"
+"POT-Creation-Date: 2008-12-20 22:08+0000\n"
 "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n"
 "Last-Translator: FULL NAME <EMAIL at ADDRESS>\n"
 "Language-Team: LANGUAGE <kde-i18n-doc at kde.org>\n"

Modified: doc/trunk/reference/pot/modules/producermethods.pot
===================================================================
--- doc/trunk/reference/pot/modules/producermethods.pot	2008-12-20 19:00:18 UTC (rev 630)
+++ doc/trunk/reference/pot/modules/producermethods.pot	2008-12-20 22:17:05 UTC (rev 631)
@@ -6,7 +6,7 @@
 msgstr ""
 "Project-Id-Version: PACKAGE VERSION\n"
 "Report-Msgid-Bugs-To: http://bugs.kde.org\n"
-"POT-Creation-Date: 2008-12-19 20:29+0000\n"
+"POT-Creation-Date: 2008-12-20 22:08+0000\n"
 "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n"
 "Last-Translator: FULL NAME <EMAIL at ADDRESS>\n"
 "Language-Team: LANGUAGE <kde-i18n-doc at kde.org>\n"
@@ -58,7 +58,8 @@
 "polymorphism with Web Beans. As we've seen, deployment types are a powerful "
 "solution to the problem of deployment-time polymorphism. But once the system "
 "is deployed, the Web Bean implementation is fixed. A producer method has no "
-"such limitation:</para> <programlisting><![CDATA[@SessionScoped\n"
+"such limitation:</para> <programlisting role=\"JAVA\"><![CDATA"
+"[@SessionScoped\n"
 "public class Preferences {\n"
 "    \n"
 "    private PaymentStrategyType paymentStrategy;\n"
@@ -76,12 +77,12 @@
 "    }\n"
 "    \n"
 "}]]></programlisting> <para>Consider an injection point:</para> "
-"<programlisting><![CDATA[@Preferred PaymentStrategy paymentStrat;]]></"
-"programlisting> <para>This injection point has the same type and binding "
-"annotations as the producer method, so it resolves to the producer method "
-"using the usual Web Beans injection rules. The producer method will be "
-"called by the Web Bean manager to obtain an instance to service this "
-"injection point.</para>."
+"<programlisting role=\"JAVA\"><![CDATA[@Preferred PaymentStrategy "
+"paymentStrat;]]></programlisting> <para>This injection point has the same "
+"type and binding annotations as the producer method, so it resolves to the "
+"producer method using the usual Web Beans injection rules. The producer "
+"method will be called by the Web Bean manager to obtain an instance to "
+"service this injection point.</para>."
 msgstr ""
 
 #. Tag: title

Added: doc/trunk/reference/pot/modules/ri-spi.pot
===================================================================
--- doc/trunk/reference/pot/modules/ri-spi.pot	                        (rev 0)
+++ doc/trunk/reference/pot/modules/ri-spi.pot	2008-12-20 22:17:05 UTC (rev 631)
@@ -0,0 +1,276 @@
+# SOME DESCRIPTIVE TITLE.
+# FIRST AUTHOR <EMAIL at ADDRESS>, YEAR.
+#
+#, fuzzy
+msgid ""
+msgstr ""
+"Project-Id-Version: PACKAGE VERSION\n"
+"Report-Msgid-Bugs-To: http://bugs.kde.org\n"
+"POT-Creation-Date: 2008-12-20 22:08+0000\n"
+"PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n"
+"Last-Translator: FULL NAME <EMAIL at ADDRESS>\n"
+"Language-Team: LANGUAGE <kde-i18n-doc at kde.org>\n"
+"MIME-Version: 1.0\n"
+"Content-Type: application/x-xml2pot; charset=UTF-8\n"
+"Content-Transfer-Encoding: 8bit\n"
+
+#. Tag: title
+#: ri-spi.xml:4
+#, no-c-format
+msgid "Integrating the Web Beans RI into other environments"
+msgstr ""
+
+#. Tag: para
+#: ri-spi.xml:6
+#, no-c-format
+msgid ""
+"Currently the Web Beans RI only runs in JBoss AS 5; integrating the RI into "
+"other EE environments (for example another application server like "
+"Glassfish), into a servlet container (like Tomcat), or with an Embedded "
+"EJB3.1 implementation is fairly easy. In this Appendix we will briefly "
+"discuss the steps needed."
+msgstr ""
+
+#. Tag: para
+#: ri-spi.xml:15
+#, no-c-format
+msgid ""
+"It should be possible to run Web Beans in an SE environment, but you'll to "
+"do more work, adding your own contexts and lifecycle. The Web Beans RI "
+"currently doesn't expose lifecycle extension points, so you would have to "
+"code directly against Web Beans RI classes."
+msgstr ""
+
+#. Tag: title
+#: ri-spi.xml:24
+#, no-c-format
+msgid "The Web Beans RI SPI"
+msgstr ""
+
+#. Tag: para
+#: ri-spi.xml:26
+#, no-c-format
+msgid ""
+"The Web Beans SPI is located in <literal>webbeans-ri-spi</literal> module, "
+"and packaged as <literal>webbeans-ri-spi.jar</literal>."
+msgstr ""
+
+#. Tag: para
+#: ri-spi.xml:31
+#, no-c-format
+msgid "Currently, the only SPI to implement is the bootstrap spi:"
+msgstr ""
+
+#. Tag: programlisting
+#: ri-spi.xml:35
+#, no-c-format
+msgid ""
+"<![CDATA[public interface WebBeanDiscovery {\n"
+"   /**\n"
+"    * Gets list of all classes in classpath archives with web-beans.xml "
+"files\n"
+"    * \n"
+"    * @return An iterable over the classes \n"
+"    */\n"
+"   public Iterable<Class<?>> discoverWebBeanClasses();\n"
+"   \n"
+"   /**\n"
+"    * Gets a list of all web-beans.xml files in the app classpath\n"
+"    * \n"
+"    * @return An iterable over the web-beans.xml files \n"
+"    */\n"
+"   public Iterable<URL> discoverWebBeansXml();\n"
+"   \n"
+"   /**\n"
+"    * Gets a descriptor for each EJB in the application\n"
+"    * \n"
+"    * @return The bean class to descriptor map \n"
+"    */\n"
+"   public Iterable<EjbDescriptor<?>> discoverEjbs();\n"
+"   \n"
+"}]]>"
+msgstr ""
+
+#. Tag: para
+#: ri-spi.xml:37
+#, no-c-format
+msgid ""
+"The discovery of Web Bean classes and <literal>web-bean.xml</literal> files "
+"is self-explanatory (the algorithm is described in Section 11.1 of the JSR-"
+"299 specification, and isn't repeated here)."
+msgstr ""
+
+#. Tag: para
+#: ri-spi.xml:43
+#, no-c-format
+msgid ""
+"The Web Beans RI also delegates EJB3 bean discovery to the container so that "
+"it doesn't have to scan for EJB3 annotations or parse <literal>ejb-jar.xml</"
+"literal>. For each EJB in the application an EJBDescriptor should be "
+"discovered:"
+msgstr ""
+
+#. Tag: programlisting
+#: ri-spi.xml:50
+#, no-c-format
+msgid ""
+"<![CDATA[public interface EjbDescriptor<T> {\n"
+"   \n"
+"   /**\n"
+"    * Gets the EJB type\n"
+"    * \n"
+"    * @return The EJB Bean class\n"
+"    */\n"
+"   public Class<T> getType();\n"
+"\n"
+"   /**\n"
+"    * Gets the local business interfaces of the EJB\n"
+"    * \n"
+"    * @return An iterator over the local business interfaces\n"
+"    */\n"
+"   public Iterable<BusinessInterfaceDescriptor<?>> getLocalBusinessInterfaces"
+"();\n"
+"   \n"
+"   /**\n"
+"    * Gets the remote business interfaces of the EJB\n"
+"    * \n"
+"    * @return An iterator over the remote business interfaces\n"
+"    */\n"
+"   public Iterable<BusinessInterfaceDescriptor<?>> "
+"getRemoteBusinessInterfaces();\n"
+"   \n"
+"   /**\n"
+"    * Get the remove methods of the EJB\n"
+"    * \n"
+"    * @return An iterator over the remove methods\n"
+"    */\n"
+"   public Iterable<MethodDescriptor> getRemoveMethods();\n"
+"\n"
+"   /**\n"
+"    * Indicates if the bean is stateless\n"
+"    * \n"
+"    * @return True if stateless, false otherwise\n"
+"    */\n"
+"   public boolean isStateless();\n"
+"\n"
+"   /**\n"
+"    * Indicates if the bean is a EJB 3.1 Singleton\n"
+"    * \n"
+"    * @return True if the bean is a singleton, false otherwise\n"
+"    */\n"
+"   public boolean isSingleton();\n"
+"\n"
+"   /**\n"
+"    * Indicates if the EJB is stateful\n"
+"    * \n"
+"    * @return True if the bean is stateful, false otherwise\n"
+"    */\n"
+"   public boolean isStateful();\n"
+"\n"
+"   /**\n"
+"    * Indicates if the EJB is and MDB\n"
+"    * \n"
+"    * @return True if the bean is an MDB, false otherwise\n"
+"    */\n"
+"   public boolean isMessageDriven();\n"
+"\n"
+"   /**\n"
+"    * Gets the EJB name\n"
+"    * \n"
+"    * @return The name\n"
+"    */\n"
+"   public String getEjbName();\n"
+"   \n"
+"   /**\n"
+"    * @return The JNDI string which can be used to lookup a proxy which \n"
+"    * implements all local business interfaces \n"
+"    * \n"
+"    */\n"
+"   public String getLocalJndiName();\n"
+"   \n"
+"}]]>"
+msgstr ""
+
+#. Tag: para
+#: ri-spi.xml:52
+#, no-c-format
+msgid ""
+"The contract described the JavaDoc is enough to implement an EJBDescriptor. "
+"In addition to these two interfaces, there is "
+"<literal>BusinessInterfaceDescriptor</literal> which represents a local "
+"business interface (encapsulating the interface class and jndi name), and "
+"<literal>MethodDescriptor</literal> which encapsulates the method name and "
+"parameter types (allowing it to be invoked on any instance of the EJB, proxy "
+"or otherwise)."
+msgstr ""
+
+#. Tag: para
+#: ri-spi.xml:62
+#, no-c-format
+msgid ""
+"The Web Beans RI can be told to load your implementation of "
+"<literal>WebBeanDiscovery</literal> using the property <literal>org.jboss."
+"webbeans.bootstrap.webBeanDiscovery</literal> with the fully qualified class "
+"name as the value. For example:"
+msgstr ""
+
+#. Tag: programlisting
+#: ri-spi.xml:69
+#, no-c-format
+msgid ""
+"org.jboss.webbeans.bootstrap.webBeanDiscovery=org.jboss.webbeans.integration."
+"jbossas.WebBeanDiscoveryImpl"
+msgstr ""
+
+#. Tag: para
+#: ri-spi.xml:71
+#, no-c-format
+msgid ""
+"The property can either be specified as a system property, or in a "
+"properties file <literal>META-INF/web-beans-ri.properties</literal>."
+msgstr ""
+
+#. Tag: title
+#: ri-spi.xml:79
+#, no-c-format
+msgid "The contract with the container"
+msgstr ""
+
+#. Tag: para
+#: ri-spi.xml:81
+#, no-c-format
+msgid ""
+"There are a number of requirements that the Web Beans RI places on the "
+"container for correct functioning that fall outside implementation of APIs"
+msgstr ""
+
+#. Tag: term
+#: ri-spi.xml:89
+#, no-c-format
+msgid "Classloader isolation"
+msgstr ""
+
+#. Tag: para
+#: ri-spi.xml:93
+#, no-c-format
+msgid ""
+"If you are integrating the Web Beans into an environment that supports "
+"deployment of applications, you must enable, automatically, or through user "
+"configuation, classloader isolation for each Web Beans application"
+msgstr ""
+
+#. Tag: term
+#: ri-spi.xml:102
+#, no-c-format
+msgid "The <literal>webbeans-ri.jar</literal>"
+msgstr ""
+
+#. Tag: para
+#: ri-spi.xml:106
+#, no-c-format
+msgid ""
+"If you are integrating the Web Beans into an environment that supports "
+"deployment of applications, you must insert the <literal>webbeans-ri.jar</"
+"literal> into the applications isolated classloader. It cannot be loaded "
+"from a shared classloader."
+msgstr ""

Modified: doc/trunk/reference/pot/modules/ri.pot
===================================================================
--- doc/trunk/reference/pot/modules/ri.pot	2008-12-20 19:00:18 UTC (rev 630)
+++ doc/trunk/reference/pot/modules/ri.pot	2008-12-20 22:17:05 UTC (rev 631)
@@ -6,7 +6,7 @@
 msgstr ""
 "Project-Id-Version: PACKAGE VERSION\n"
 "Report-Msgid-Bugs-To: http://bugs.kde.org\n"
-"POT-Creation-Date: 2008-12-19 20:29+0000\n"
+"POT-Creation-Date: 2008-12-20 22:08+0000\n"
 "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n"
 "Last-Translator: FULL NAME <EMAIL at ADDRESS>\n"
 "Language-Team: LANGUAGE <kde-i18n-doc at kde.org>\n"
@@ -63,16 +63,31 @@
 msgstr ""
 
 #. Tag: para
-#: ri.xml:30
+#: ri.xml:31
 #, no-c-format
 msgid ""
+"Next, we need to tell Web Beans where JBoss is located. Edit <literal>jboss-"
+"as/build.properties</literal> and set the <literal>jboss.home</literal> "
+"property. For example:"
+msgstr ""
+
+#. Tag: programlisting
+#: ri.xml:37
+#, no-c-format
+msgid "jboss.home=/Applications/jboss-5.0.0.GA"
+msgstr ""
+
+#. Tag: para
+#: ri.xml:39
+#, no-c-format
+msgid ""
 "As Web Beans is a new piece of software, you need to update JBoss AS to run "
 "the Web Beans RI. Future versions of JBoss AS will include these updates, "
 "and this step won't be necessary."
 msgstr ""
 
 #. Tag: para
-#: ri.xml:37
+#: ri.xml:46
 #, no-c-format
 msgid ""
 "Currently, two updates are needed. Firstly, a new deployer, "
@@ -83,7 +98,7 @@
 msgstr ""
 
 #. Tag: para
-#: ri.xml:46
+#: ri.xml:55
 #, no-c-format
 msgid ""
 "To install the update, you'll need ant 1.7.0 installed, and the "
@@ -91,7 +106,7 @@
 msgstr ""
 
 #. Tag: programlisting
-#: ri.xml:51
+#: ri.xml:60
 #, no-c-format
 msgid ""
 "$ unzip apache-ant-1.7.0.zip\n"
@@ -99,7 +114,7 @@
 msgstr ""
 
 #. Tag: para
-#: ri.xml:53
+#: ri.xml:62
 #, no-c-format
 msgid ""
 "Then, you can install the update. The update script will use Maven to "
@@ -107,7 +122,7 @@
 msgstr ""
 
 #. Tag: programlisting
-#: ri.xml:58
+#: ri.xml:67
 #, no-c-format
 msgid ""
 "$ cd webbeans-1.0.0.ALPHA1/jboss-as\n"
@@ -115,26 +130,26 @@
 msgstr ""
 
 #. Tag: para
-#: ri.xml:60
+#: ri.xml:69
 #, no-c-format
 msgid "Now, you're ready to deploy your first example!"
 msgstr ""
 
 #. Tag: para
-#: ri.xml:65
+#: ri.xml:74
 #, no-c-format
 msgid ""
 "The build scripts for the examples offer a number of targets, these are:"
 msgstr ""
 
 #. Tag: para
-#: ri.xml:71
+#: ri.xml:80
 #, no-c-format
 msgid "<literal>ant restart</literal> - deploy the example in exploded format"
 msgstr ""
 
 #. Tag: para
-#: ri.xml:77
+#: ri.xml:86
 #, no-c-format
 msgid ""
 "<literal>ant explode</literal> - update an exploded example, without "
@@ -142,32 +157,32 @@
 msgstr ""
 
 #. Tag: para
-#: ri.xml:83
+#: ri.xml:92
 #, no-c-format
 msgid ""
 "<literal>ant deploy</literal> - deploy the example in compressed jar format"
 msgstr ""
 
 #. Tag: para
-#: ri.xml:88
+#: ri.xml:97
 #, no-c-format
 msgid "<literal>ant undeploy</literal> - remove the example from the server"
 msgstr ""
 
 #. Tag: para
-#: ri.xml:93
+#: ri.xml:102
 #, no-c-format
 msgid "<literal>ant clean</literal> - clean the example"
 msgstr ""
 
 #. Tag: para
-#: ri.xml:100
+#: ri.xml:109
 #, no-c-format
 msgid "To deploy the numberguess example:"
 msgstr ""
 
 #. Tag: programlisting
-#: ri.xml:104
+#: ri.xml:113
 #, no-c-format
 msgid ""
 "$ cd examples/numberguess\n"
@@ -175,7 +190,7 @@
 msgstr ""
 
 #. Tag: para
-#: ri.xml:106
+#: ri.xml:115
 #, no-c-format
 msgid ""
 "Wait for the application to deploy, and enjoy hours of fun at <ulink url="
@@ -183,7 +198,7 @@
 msgstr ""
 
 #. Tag: para
-#: ri.xml:111
+#: ri.xml:120
 #, no-c-format
 msgid ""
 "The Web Beans RI includes a second simple example that will translate your "
@@ -193,7 +208,7 @@
 msgstr ""
 
 #. Tag: programlisting
-#: ri.xml:118
+#: ri.xml:127
 #, no-c-format
 msgid ""
 "$ cd examples/traslator\n"
@@ -201,7 +216,7 @@
 msgstr ""
 
 #. Tag: para
-#: ri.xml:120
+#: ri.xml:129
 #, no-c-format
 msgid ""
 "Wait for the application to deploy, and visit <ulink url=\"http://"
@@ -209,13 +224,13 @@
 msgstr ""
 
 #. Tag: title
-#: ri.xml:126
+#: ri.xml:135
 #, no-c-format
 msgid "The numberguess example"
 msgstr ""
 
 #. Tag: para
-#: ri.xml:128
+#: ri.xml:137
 #, no-c-format
 msgid ""
 "In the numberguess application you get given 10 attempts to guess a number "
@@ -224,7 +239,7 @@
 msgstr ""
 
 #. Tag: para
-#: ri.xml:134
+#: ri.xml:143
 #, no-c-format
 msgid ""
 "The numberguess example is comprised of a number of Web Beans, configuration "
@@ -233,7 +248,7 @@
 msgstr ""
 
 #. Tag: para
-#: ri.xml:140
+#: ri.xml:149
 #, no-c-format
 msgid ""
 "All the configuration files for this example are located in <literal>WEB-INF/"
@@ -243,7 +258,7 @@
 msgstr ""
 
 #. Tag: programlisting
-#: ri.xml:148
+#: ri.xml:157
 #, no-c-format
 msgid ""
 "<![CDATA[<?xml version='1.0' encoding='UTF-8'?>\n"
@@ -261,7 +276,7 @@
 msgstr ""
 
 #. Tag: para
-#: ri.xml:150
+#: ri.xml:159
 #, no-c-format
 msgid ""
 "There is an empty <literal>web-beans.xml</literal> file, which marks this "
@@ -269,13 +284,13 @@
 msgstr ""
 
 #. Tag: para
-#: ri.xml:155
+#: ri.xml:164
 #, no-c-format
 msgid "Finally there is <literal>web.xml</literal>:"
 msgstr ""
 
 #. Tag: section
-#: ri.xml:157
+#: ri.xml:166
 #, no-c-format
 msgid ""
 "<programlistingco> <areaspec> <area id=\"faces.servlet\" coords=\"12\"/> "
@@ -401,7 +416,7 @@
 msgstr ""
 
 #. Tag: para
-#: ri.xml:270
+#: ri.xml:279
 #, no-c-format
 msgid ""
 "The example exists of 4 classes, the first two of which are binding types. "
@@ -410,7 +425,7 @@
 msgstr ""
 
 #. Tag: programlisting
-#: ri.xml:276
+#: ri.xml:285
 #, no-c-format
 msgid ""
 "<![CDATA[@Target( { TYPE, METHOD, PARAMETER, FIELD })\n"
@@ -421,7 +436,7 @@
 msgstr ""
 
 #. Tag: para
-#: ri.xml:278
+#: ri.xml:287
 #, no-c-format
 msgid ""
 "There is also the <literal>@MaxNumber</literal> binding type, used for "
@@ -429,7 +444,7 @@
 msgstr ""
 
 #. Tag: programlisting
-#: ri.xml:283
+#: ri.xml:292
 #, no-c-format
 msgid ""
 "<![CDATA[@Target( { TYPE, METHOD, PARAMETER, FIELD })\n"
@@ -441,7 +456,7 @@
 msgstr ""
 
 #. Tag: para
-#: ri.xml:285
+#: ri.xml:294
 #, no-c-format
 msgid ""
 "The <literal>Generator</literal> class is responsible for creating the "
@@ -450,7 +465,7 @@
 msgstr ""
 
 #. Tag: programlisting
-#: ri.xml:291
+#: ri.xml:300
 #, no-c-format
 msgid ""
 "<![CDATA[@ApplicationScoped\n"
@@ -479,7 +494,7 @@
 msgstr ""
 
 #. Tag: para
-#: ri.xml:293
+#: ri.xml:302
 #, no-c-format
 msgid ""
 "You'll notice that the <literal>Generator</literal> is application scoped; "
@@ -487,7 +502,7 @@
 msgstr ""
 
 #. Tag: para
-#: ri.xml:298
+#: ri.xml:307
 #, no-c-format
 msgid ""
 "The final Web Bean in the application is the session scoped <literal>Game</"
@@ -497,7 +512,7 @@
 msgstr ""
 
 #. Tag: para
-#: ri.xml:305
+#: ri.xml:314
 #, no-c-format
 msgid ""
 "You'll also note that we've used the <literal>@Named</literal> annotation, "
@@ -508,7 +523,7 @@
 msgstr ""
 
 #. Tag: programlisting
-#: ri.xml:313
+#: ri.xml:322
 #, no-c-format
 msgid ""
 "<![CDATA[@Named\n"
@@ -552,13 +567,13 @@
 msgstr ""
 
 #. Tag: title
-#: ri.xml:317
+#: ri.xml:326
 #, no-c-format
 msgid "The translator example"
 msgstr ""
 
 #. Tag: para
-#: ri.xml:319
+#: ri.xml:328
 #, no-c-format
 msgid ""
 "The translator example will take any sentences you enter, and translate them "
@@ -566,7 +581,7 @@
 msgstr ""
 
 #. Tag: para
-#: ri.xml:324
+#: ri.xml:333
 #, no-c-format
 msgid ""
 "The translator example is built as an ear, and contains EJBs and enterprise "
@@ -575,7 +590,7 @@
 msgstr ""
 
 #. Tag: para
-#: ri.xml:331
+#: ri.xml:340
 #, no-c-format
 msgid ""
 "EJB 3.1 and Jave EE 6 allow you to package EJBs in a war, which will make "
@@ -583,7 +598,7 @@
 msgstr ""
 
 #. Tag: para
-#: ri.xml:337
+#: ri.xml:346
 #, no-c-format
 msgid ""
 "First, let's take a look at the ear aggregator, which is located in "
@@ -593,7 +608,7 @@
 msgstr ""
 
 #. Tag: programlisting
-#: ri.xml:344
+#: ri.xml:353
 #, no-c-format
 msgid ""
 "<![CDATA[<plugin>\n"
@@ -616,7 +631,7 @@
 msgstr ""
 
 #. Tag: para
-#: ri.xml:346
+#: ri.xml:355
 #, no-c-format
 msgid ""
 "We're doing a couple of things here - firstly we set the context path, which "
@@ -626,7 +641,7 @@
 msgstr ""
 
 #. Tag: para
-#: ri.xml:354
+#: ri.xml:363
 #, no-c-format
 msgid ""
 "If you aren't using Maven to generate these files, you would need "
@@ -634,7 +649,7 @@
 msgstr ""
 
 #. Tag: programlisting
-#: ri.xml:359
+#: ri.xml:368
 #, no-c-format
 msgid ""
 "<![CDATA[<?xml version=\"1.0\" encoding=\"UTF-8\"?>\n"
@@ -648,13 +663,13 @@
 msgstr ""
 
 #. Tag: para
-#: ri.xml:361
+#: ri.xml:370
 #, no-c-format
 msgid "and <literal>META-INF/application.xml</literal>:"
 msgstr ""
 
 #. Tag: programlisting
-#: ri.xml:365
+#: ri.xml:374
 #, no-c-format
 msgid ""
 "<![CDATA[<?xml version=\"1.0\" encoding=\"UTF-8\"?>\n"
@@ -680,7 +695,7 @@
 msgstr ""
 
 #. Tag: para
-#: ri.xml:368
+#: ri.xml:377
 #, no-c-format
 msgid ""
 "Next, lets look at the war. Just as in the numberguess example, we have a "
@@ -690,7 +705,7 @@
 msgstr ""
 
 #. Tag: para
-#: ri.xml:375
+#: ri.xml:384
 #, no-c-format
 msgid ""
 "More intersting is the facelet used to translate text. Just as in the "
@@ -699,7 +714,7 @@
 msgstr ""
 
 #. Tag: programlisting
-#: ri.xml:381
+#: ri.xml:390
 #, no-c-format
 msgid ""
 "<![CDATA[<h:form id=\"NumberGuessMain\">\n"
@@ -732,7 +747,7 @@
 msgstr ""
 
 #. Tag: para
-#: ri.xml:383
+#: ri.xml:392
 #, no-c-format
 msgid ""
 "The user can enter some text in the lefthand textarea, and hit the translate "
@@ -740,7 +755,7 @@
 msgstr ""
 
 #. Tag: para
-#: ri.xml:388
+#: ri.xml:397
 #, no-c-format
 msgid ""
 "Finally, let's look at the ejb module, <literal>webbeans-translator-ejb</"
@@ -753,7 +768,7 @@
 msgstr ""
 
 #. Tag: programlisting
-#: ri.xml:400
+#: ri.xml:409
 #, no-c-format
 msgid ""
 "<![CDATA[<?xml version=\"1.0\" encoding=\"UTF-8\"?>\n"
@@ -782,7 +797,7 @@
 msgstr ""
 
 #. Tag: para
-#: ri.xml:402
+#: ri.xml:411
 #, no-c-format
 msgid ""
 "We've saved the most interesting bit to last, the code! The project has two "
@@ -794,7 +809,7 @@
 msgstr ""
 
 #. Tag: para
-#: ri.xml:412
+#: ri.xml:421
 #, no-c-format
 msgid ""
 "Both <literal>SentanceParser</literal> and <literal>TextTranslator</literal> "
@@ -803,7 +818,7 @@
 msgstr ""
 
 #. Tag: programlisting
-#: ri.xml:418
+#: ri.xml:427
 #, no-c-format
 msgid ""
 "<![CDATA[public class TextTranslator { \n"
@@ -819,7 +834,7 @@
 msgstr ""
 
 #. Tag: para
-#: ri.xml:420
+#: ri.xml:429
 #, no-c-format
 msgid ""
 "<literal>TextTranslator</literal> is a stateless bean (with a local business "
@@ -828,7 +843,7 @@
 msgstr ""
 
 #. Tag: para
-#: ri.xml:426
+#: ri.xml:435
 #, no-c-format
 msgid ""
 "Finally, there is UI orientated controller, that collects the text from the "
@@ -837,7 +852,7 @@
 msgstr ""
 
 #. Tag: programlisting
-#: ri.xml:432
+#: ri.xml:441
 #, no-c-format
 msgid ""
 "<![CDATA[@Stateful\n"
@@ -850,19 +865,19 @@
 msgstr ""
 
 #. Tag: para
-#: ri.xml:434
+#: ri.xml:443
 #, no-c-format
 msgid "The bean also has getters and setters for all the fields on the page."
 msgstr ""
 
 #. Tag: para
-#: ri.xml:438
+#: ri.xml:447
 #, no-c-format
 msgid "As this is a stateful session bean, we have to have a remove method:"
 msgstr ""
 
 #. Tag: programlisting
-#: ri.xml:442
+#: ri.xml:451
 #, no-c-format
 msgid ""
 "<![CDATA[   @Remove\n"
@@ -873,7 +888,7 @@
 msgstr ""
 
 #. Tag: para
-#: ri.xml:444
+#: ri.xml:453
 #, no-c-format
 msgid ""
 "The Web Beans manager will call the remove method for you when the bean is "
@@ -881,7 +896,7 @@
 msgstr ""
 
 #. Tag: para
-#: ri.xml:450
+#: ri.xml:459
 #, no-c-format
 msgid ""
 "That concludes our short tour of the Web Beans RI examples. For more on the "
@@ -891,7 +906,7 @@
 msgstr ""
 
 #. Tag: para
-#: ri.xml:456
+#: ri.xml:465
 #, no-c-format
 msgid ""
 "We need help in all areas - bug fixing, writing new features, writing "

Modified: doc/trunk/reference/pot/modules/scopescontexts.pot
===================================================================
--- doc/trunk/reference/pot/modules/scopescontexts.pot	2008-12-20 19:00:18 UTC (rev 630)
+++ doc/trunk/reference/pot/modules/scopescontexts.pot	2008-12-20 22:17:05 UTC (rev 631)
@@ -6,7 +6,7 @@
 msgstr ""
 "Project-Id-Version: PACKAGE VERSION\n"
 "Report-Msgid-Bugs-To: http://bugs.kde.org\n"
-"POT-Creation-Date: 2008-12-19 20:29+0000\n"
+"POT-Creation-Date: 2008-12-20 22:08+0000\n"
 "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n"
 "Last-Translator: FULL NAME <EMAIL at ADDRESS>\n"
 "Language-Team: LANGUAGE <kde-i18n-doc at kde.org>\n"

Modified: doc/trunk/reference/pot/modules/specialization.pot
===================================================================
--- doc/trunk/reference/pot/modules/specialization.pot	2008-12-20 19:00:18 UTC (rev 630)
+++ doc/trunk/reference/pot/modules/specialization.pot	2008-12-20 22:17:05 UTC (rev 631)
@@ -6,7 +6,7 @@
 msgstr ""
 "Project-Id-Version: PACKAGE VERSION\n"
 "Report-Msgid-Bugs-To: http://bugs.kde.org\n"
-"POT-Creation-Date: 2008-12-19 20:29+0000\n"
+"POT-Creation-Date: 2008-12-20 22:08+0000\n"
 "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n"
 "Last-Translator: FULL NAME <EMAIL at ADDRESS>\n"
 "Language-Team: LANGUAGE <kde-i18n-doc at kde.org>\n"

Modified: doc/trunk/reference/pot/modules/stereotypes.pot
===================================================================
--- doc/trunk/reference/pot/modules/stereotypes.pot	2008-12-20 19:00:18 UTC (rev 630)
+++ doc/trunk/reference/pot/modules/stereotypes.pot	2008-12-20 22:17:05 UTC (rev 631)
@@ -6,7 +6,7 @@
 msgstr ""
 "Project-Id-Version: PACKAGE VERSION\n"
 "Report-Msgid-Bugs-To: http://bugs.kde.org\n"
-"POT-Creation-Date: 2008-12-19 20:29+0000\n"
+"POT-Creation-Date: 2008-12-20 22:08+0000\n"
 "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n"
 "Last-Translator: FULL NAME <EMAIL at ADDRESS>\n"
 "Language-Team: LANGUAGE <kde-i18n-doc at kde.org>\n"

Modified: doc/trunk/reference/pot/modules/xml.pot
===================================================================
--- doc/trunk/reference/pot/modules/xml.pot	2008-12-20 19:00:18 UTC (rev 630)
+++ doc/trunk/reference/pot/modules/xml.pot	2008-12-20 22:17:05 UTC (rev 631)
@@ -6,7 +6,7 @@
 msgstr ""
 "Project-Id-Version: PACKAGE VERSION\n"
 "Report-Msgid-Bugs-To: http://bugs.kde.org\n"
-"POT-Creation-Date: 2008-12-19 20:29+0000\n"
+"POT-Creation-Date: 2008-12-20 22:08+0000\n"
 "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n"
 "Last-Translator: FULL NAME <EMAIL at ADDRESS>\n"
 "Language-Team: LANGUAGE <kde-i18n-doc at kde.org>\n"

Modified: doc/trunk/reference/zh-CN/modules/ee.po
===================================================================
--- doc/trunk/reference/zh-CN/modules/ee.po	2008-12-20 19:00:18 UTC (rev 630)
+++ doc/trunk/reference/zh-CN/modules/ee.po	2008-12-20 22:17:05 UTC (rev 631)
@@ -5,7 +5,7 @@
 msgstr ""
 "Project-Id-Version: master.xml \n"
 "Report-Msgid-Bugs-To: http://bugs.kde.org\n"
-"POT-Creation-Date: 2008-12-19 20:26+0000\n"
+"POT-Creation-Date: 2008-12-20 22:08+0000\n"
 "PO-Revision-Date: 2008-12-19 20:26+0000\n"
 "Last-Translator: Automatically generated\n"
 "Language-Team: none\n"
@@ -296,7 +296,7 @@
 #: ee.xml:100
 #, no-c-format
 msgid ""
-"The lifecycle of the injected JMS objects are completely controlled by the "
+"The lifecycle of the injected JMS objects is completely controlled by the "
 "Web Bean manager."
 msgstr ""
 

Modified: doc/trunk/reference/zh-CN/modules/producermethods.po
===================================================================
--- doc/trunk/reference/zh-CN/modules/producermethods.po	2008-12-20 19:00:18 UTC (rev 630)
+++ doc/trunk/reference/zh-CN/modules/producermethods.po	2008-12-20 22:17:05 UTC (rev 631)
@@ -5,7 +5,7 @@
 msgstr ""
 "Project-Id-Version: master.xml \n"
 "Report-Msgid-Bugs-To: http://bugs.kde.org\n"
-"POT-Creation-Date: 2008-12-19 20:26+0000\n"
+"POT-Creation-Date: 2008-12-20 22:08+0000\n"
 "PO-Revision-Date: 2008-12-19 20:26+0000\n"
 "Last-Translator: Automatically generated\n"
 "Language-Team: none\n"
@@ -57,7 +57,8 @@
 "polymorphism with Web Beans. As we've seen, deployment types are a powerful "
 "solution to the problem of deployment-time polymorphism. But once the system "
 "is deployed, the Web Bean implementation is fixed. A producer method has no "
-"such limitation:</para> <programlisting><![CDATA[@SessionScoped\n"
+"such limitation:</para> <programlisting role=\"JAVA\"><![CDATA"
+"[@SessionScoped\n"
 "public class Preferences {\n"
 "    \n"
 "    private PaymentStrategyType paymentStrategy;\n"
@@ -75,12 +76,12 @@
 "    }\n"
 "    \n"
 "}]]></programlisting> <para>Consider an injection point:</para> "
-"<programlisting><![CDATA[@Preferred PaymentStrategy paymentStrat;]]></"
-"programlisting> <para>This injection point has the same type and binding "
-"annotations as the producer method, so it resolves to the producer method "
-"using the usual Web Beans injection rules. The producer method will be "
-"called by the Web Bean manager to obtain an instance to service this "
-"injection point.</para>."
+"<programlisting role=\"JAVA\"><![CDATA[@Preferred PaymentStrategy "
+"paymentStrat;]]></programlisting> <para>This injection point has the same "
+"type and binding annotations as the producer method, so it resolves to the "
+"producer method using the usual Web Beans injection rules. The producer "
+"method will be called by the Web Bean manager to obtain an instance to "
+"service this injection point.</para>."
 msgstr ""
 
 #. Tag: title

Added: doc/trunk/reference/zh-CN/modules/ri-spi.po
===================================================================
--- doc/trunk/reference/zh-CN/modules/ri-spi.po	                        (rev 0)
+++ doc/trunk/reference/zh-CN/modules/ri-spi.po	2008-12-20 22:17:05 UTC (rev 631)
@@ -0,0 +1,275 @@
+# Language zh-CN translations for master.xml package.
+# Automatically generated, 2008.
+#
+msgid ""
+msgstr ""
+"Project-Id-Version: master.xml \n"
+"Report-Msgid-Bugs-To: http://bugs.kde.org\n"
+"POT-Creation-Date: 2008-12-20 22:07+0000\n"
+"PO-Revision-Date: 2008-12-20 22:07+0000\n"
+"Last-Translator: Automatically generated\n"
+"Language-Team: none\n"
+"MIME-Version: 1.0\n"
+"Content-Type: text/plain; charset=UTF-8\n"
+"Content-Transfer-Encoding: 8bit\n"
+
+#. Tag: title
+#: ri-spi.xml:4
+#, no-c-format
+msgid "Integrating the Web Beans RI into other environments"
+msgstr ""
+
+#. Tag: para
+#: ri-spi.xml:6
+#, no-c-format
+msgid ""
+"Currently the Web Beans RI only runs in JBoss AS 5; integrating the RI into "
+"other EE environments (for example another application server like "
+"Glassfish), into a servlet container (like Tomcat), or with an Embedded "
+"EJB3.1 implementation is fairly easy. In this Appendix we will briefly "
+"discuss the steps needed."
+msgstr ""
+
+#. Tag: para
+#: ri-spi.xml:15
+#, no-c-format
+msgid ""
+"It should be possible to run Web Beans in an SE environment, but you'll to "
+"do more work, adding your own contexts and lifecycle. The Web Beans RI "
+"currently doesn't expose lifecycle extension points, so you would have to "
+"code directly against Web Beans RI classes."
+msgstr ""
+
+#. Tag: title
+#: ri-spi.xml:24
+#, no-c-format
+msgid "The Web Beans RI SPI"
+msgstr ""
+
+#. Tag: para
+#: ri-spi.xml:26
+#, no-c-format
+msgid ""
+"The Web Beans SPI is located in <literal>webbeans-ri-spi</literal> module, "
+"and packaged as <literal>webbeans-ri-spi.jar</literal>."
+msgstr ""
+
+#. Tag: para
+#: ri-spi.xml:31
+#, no-c-format
+msgid "Currently, the only SPI to implement is the bootstrap spi:"
+msgstr ""
+
+#. Tag: programlisting
+#: ri-spi.xml:35
+#, no-c-format
+msgid ""
+"<![CDATA[public interface WebBeanDiscovery {\n"
+"   /**\n"
+"    * Gets list of all classes in classpath archives with web-beans.xml "
+"files\n"
+"    * \n"
+"    * @return An iterable over the classes \n"
+"    */\n"
+"   public Iterable<Class<?>> discoverWebBeanClasses();\n"
+"   \n"
+"   /**\n"
+"    * Gets a list of all web-beans.xml files in the app classpath\n"
+"    * \n"
+"    * @return An iterable over the web-beans.xml files \n"
+"    */\n"
+"   public Iterable<URL> discoverWebBeansXml();\n"
+"   \n"
+"   /**\n"
+"    * Gets a descriptor for each EJB in the application\n"
+"    * \n"
+"    * @return The bean class to descriptor map \n"
+"    */\n"
+"   public Iterable<EjbDescriptor<?>> discoverEjbs();\n"
+"   \n"
+"}]]>"
+msgstr ""
+
+#. Tag: para
+#: ri-spi.xml:37
+#, no-c-format
+msgid ""
+"The discovery of Web Bean classes and <literal>web-bean.xml</literal> files "
+"is self-explanatory (the algorithm is described in Section 11.1 of the JSR-"
+"299 specification, and isn't repeated here)."
+msgstr ""
+
+#. Tag: para
+#: ri-spi.xml:43
+#, no-c-format
+msgid ""
+"The Web Beans RI also delegates EJB3 bean discovery to the container so that "
+"it doesn't have to scan for EJB3 annotations or parse <literal>ejb-jar.xml</"
+"literal>. For each EJB in the application an EJBDescriptor should be "
+"discovered:"
+msgstr ""
+
+#. Tag: programlisting
+#: ri-spi.xml:50
+#, no-c-format
+msgid ""
+"<![CDATA[public interface EjbDescriptor<T> {\n"
+"   \n"
+"   /**\n"
+"    * Gets the EJB type\n"
+"    * \n"
+"    * @return The EJB Bean class\n"
+"    */\n"
+"   public Class<T> getType();\n"
+"\n"
+"   /**\n"
+"    * Gets the local business interfaces of the EJB\n"
+"    * \n"
+"    * @return An iterator over the local business interfaces\n"
+"    */\n"
+"   public Iterable<BusinessInterfaceDescriptor<?>> getLocalBusinessInterfaces"
+"();\n"
+"   \n"
+"   /**\n"
+"    * Gets the remote business interfaces of the EJB\n"
+"    * \n"
+"    * @return An iterator over the remote business interfaces\n"
+"    */\n"
+"   public Iterable<BusinessInterfaceDescriptor<?>> "
+"getRemoteBusinessInterfaces();\n"
+"   \n"
+"   /**\n"
+"    * Get the remove methods of the EJB\n"
+"    * \n"
+"    * @return An iterator over the remove methods\n"
+"    */\n"
+"   public Iterable<MethodDescriptor> getRemoveMethods();\n"
+"\n"
+"   /**\n"
+"    * Indicates if the bean is stateless\n"
+"    * \n"
+"    * @return True if stateless, false otherwise\n"
+"    */\n"
+"   public boolean isStateless();\n"
+"\n"
+"   /**\n"
+"    * Indicates if the bean is a EJB 3.1 Singleton\n"
+"    * \n"
+"    * @return True if the bean is a singleton, false otherwise\n"
+"    */\n"
+"   public boolean isSingleton();\n"
+"\n"
+"   /**\n"
+"    * Indicates if the EJB is stateful\n"
+"    * \n"
+"    * @return True if the bean is stateful, false otherwise\n"
+"    */\n"
+"   public boolean isStateful();\n"
+"\n"
+"   /**\n"
+"    * Indicates if the EJB is and MDB\n"
+"    * \n"
+"    * @return True if the bean is an MDB, false otherwise\n"
+"    */\n"
+"   public boolean isMessageDriven();\n"
+"\n"
+"   /**\n"
+"    * Gets the EJB name\n"
+"    * \n"
+"    * @return The name\n"
+"    */\n"
+"   public String getEjbName();\n"
+"   \n"
+"   /**\n"
+"    * @return The JNDI string which can be used to lookup a proxy which \n"
+"    * implements all local business interfaces \n"
+"    * \n"
+"    */\n"
+"   public String getLocalJndiName();\n"
+"   \n"
+"}]]>"
+msgstr ""
+
+#. Tag: para
+#: ri-spi.xml:52
+#, no-c-format
+msgid ""
+"The contract described the JavaDoc is enough to implement an EJBDescriptor. "
+"In addition to these two interfaces, there is "
+"<literal>BusinessInterfaceDescriptor</literal> which represents a local "
+"business interface (encapsulating the interface class and jndi name), and "
+"<literal>MethodDescriptor</literal> which encapsulates the method name and "
+"parameter types (allowing it to be invoked on any instance of the EJB, proxy "
+"or otherwise)."
+msgstr ""
+
+#. Tag: para
+#: ri-spi.xml:62
+#, no-c-format
+msgid ""
+"The Web Beans RI can be told to load your implementation of "
+"<literal>WebBeanDiscovery</literal> using the property <literal>org.jboss."
+"webbeans.bootstrap.webBeanDiscovery</literal> with the fully qualified class "
+"name as the value. For example:"
+msgstr ""
+
+#. Tag: programlisting
+#: ri-spi.xml:69
+#, no-c-format
+msgid ""
+"org.jboss.webbeans.bootstrap.webBeanDiscovery=org.jboss.webbeans.integration."
+"jbossas.WebBeanDiscoveryImpl"
+msgstr ""
+
+#. Tag: para
+#: ri-spi.xml:71
+#, no-c-format
+msgid ""
+"The property can either be specified as a system property, or in a "
+"properties file <literal>META-INF/web-beans-ri.properties</literal>."
+msgstr ""
+
+#. Tag: title
+#: ri-spi.xml:79
+#, no-c-format
+msgid "The contract with the container"
+msgstr ""
+
+#. Tag: para
+#: ri-spi.xml:81
+#, no-c-format
+msgid ""
+"There are a number of requirements that the Web Beans RI places on the "
+"container for correct functioning that fall outside implementation of APIs"
+msgstr ""
+
+#. Tag: term
+#: ri-spi.xml:89
+#, no-c-format
+msgid "Classloader isolation"
+msgstr ""
+
+#. Tag: para
+#: ri-spi.xml:93
+#, no-c-format
+msgid ""
+"If you are integrating the Web Beans into an environment that supports "
+"deployment of applications, you must enable, automatically, or through user "
+"configuation, classloader isolation for each Web Beans application"
+msgstr ""
+
+#. Tag: term
+#: ri-spi.xml:102
+#, no-c-format
+msgid "The <literal>webbeans-ri.jar</literal>"
+msgstr ""
+
+#. Tag: para
+#: ri-spi.xml:106
+#, no-c-format
+msgid ""
+"If you are integrating the Web Beans into an environment that supports "
+"deployment of applications, you must insert the <literal>webbeans-ri.jar</"
+"literal> into the applications isolated classloader. It cannot be loaded "
+"from a shared classloader."
+msgstr ""

Modified: doc/trunk/reference/zh-CN/modules/ri.po
===================================================================
--- doc/trunk/reference/zh-CN/modules/ri.po	2008-12-20 19:00:18 UTC (rev 630)
+++ doc/trunk/reference/zh-CN/modules/ri.po	2008-12-20 22:17:05 UTC (rev 631)
@@ -5,7 +5,7 @@
 msgstr ""
 "Project-Id-Version: master.xml \n"
 "Report-Msgid-Bugs-To: http://bugs.kde.org\n"
-"POT-Creation-Date: 2008-12-19 20:26+0000\n"
+"POT-Creation-Date: 2008-12-20 22:08+0000\n"
 "PO-Revision-Date: 2008-12-19 20:26+0000\n"
 "Last-Translator: Automatically generated\n"
 "Language-Team: none\n"
@@ -62,16 +62,31 @@
 msgstr ""
 
 #. Tag: para
-#: ri.xml:30
+#: ri.xml:31
 #, no-c-format
 msgid ""
+"Next, we need to tell Web Beans where JBoss is located. Edit <literal>jboss-"
+"as/build.properties</literal> and set the <literal>jboss.home</literal> "
+"property. For example:"
+msgstr ""
+
+#. Tag: programlisting
+#: ri.xml:37
+#, no-c-format
+msgid "jboss.home=/Applications/jboss-5.0.0.GA"
+msgstr ""
+
+#. Tag: para
+#: ri.xml:39
+#, no-c-format
+msgid ""
 "As Web Beans is a new piece of software, you need to update JBoss AS to run "
 "the Web Beans RI. Future versions of JBoss AS will include these updates, "
 "and this step won't be necessary."
 msgstr ""
 
 #. Tag: para
-#: ri.xml:37
+#: ri.xml:46
 #, no-c-format
 msgid ""
 "Currently, two updates are needed. Firstly, a new deployer, "
@@ -82,7 +97,7 @@
 msgstr ""
 
 #. Tag: para
-#: ri.xml:46
+#: ri.xml:55
 #, no-c-format
 msgid ""
 "To install the update, you'll need ant 1.7.0 installed, and the "
@@ -90,7 +105,7 @@
 msgstr ""
 
 #. Tag: programlisting
-#: ri.xml:51
+#: ri.xml:60
 #, no-c-format
 msgid ""
 "$ unzip apache-ant-1.7.0.zip\n"
@@ -98,7 +113,7 @@
 msgstr ""
 
 #. Tag: para
-#: ri.xml:53
+#: ri.xml:62
 #, no-c-format
 msgid ""
 "Then, you can install the update. The update script will use Maven to "
@@ -106,7 +121,7 @@
 msgstr ""
 
 #. Tag: programlisting
-#: ri.xml:58
+#: ri.xml:67
 #, no-c-format
 msgid ""
 "$ cd webbeans-1.0.0.ALPHA1/jboss-as\n"
@@ -114,26 +129,26 @@
 msgstr ""
 
 #. Tag: para
-#: ri.xml:60
+#: ri.xml:69
 #, no-c-format
 msgid "Now, you're ready to deploy your first example!"
 msgstr ""
 
 #. Tag: para
-#: ri.xml:65
+#: ri.xml:74
 #, no-c-format
 msgid ""
 "The build scripts for the examples offer a number of targets, these are:"
 msgstr ""
 
 #. Tag: para
-#: ri.xml:71
+#: ri.xml:80
 #, no-c-format
 msgid "<literal>ant restart</literal> - deploy the example in exploded format"
 msgstr ""
 
 #. Tag: para
-#: ri.xml:77
+#: ri.xml:86
 #, no-c-format
 msgid ""
 "<literal>ant explode</literal> - update an exploded example, without "
@@ -141,32 +156,32 @@
 msgstr ""
 
 #. Tag: para
-#: ri.xml:83
+#: ri.xml:92
 #, no-c-format
 msgid ""
 "<literal>ant deploy</literal> - deploy the example in compressed jar format"
 msgstr ""
 
 #. Tag: para
-#: ri.xml:88
+#: ri.xml:97
 #, no-c-format
 msgid "<literal>ant undeploy</literal> - remove the example from the server"
 msgstr ""
 
 #. Tag: para
-#: ri.xml:93
+#: ri.xml:102
 #, no-c-format
 msgid "<literal>ant clean</literal> - clean the example"
 msgstr ""
 
 #. Tag: para
-#: ri.xml:100
+#: ri.xml:109
 #, no-c-format
 msgid "To deploy the numberguess example:"
 msgstr ""
 
 #. Tag: programlisting
-#: ri.xml:104
+#: ri.xml:113
 #, no-c-format
 msgid ""
 "$ cd examples/numberguess\n"
@@ -174,7 +189,7 @@
 msgstr ""
 
 #. Tag: para
-#: ri.xml:106
+#: ri.xml:115
 #, no-c-format
 msgid ""
 "Wait for the application to deploy, and enjoy hours of fun at <ulink url="
@@ -182,7 +197,7 @@
 msgstr ""
 
 #. Tag: para
-#: ri.xml:111
+#: ri.xml:120
 #, no-c-format
 msgid ""
 "The Web Beans RI includes a second simple example that will translate your "
@@ -192,7 +207,7 @@
 msgstr ""
 
 #. Tag: programlisting
-#: ri.xml:118
+#: ri.xml:127
 #, no-c-format
 msgid ""
 "$ cd examples/traslator\n"
@@ -200,7 +215,7 @@
 msgstr ""
 
 #. Tag: para
-#: ri.xml:120
+#: ri.xml:129
 #, no-c-format
 msgid ""
 "Wait for the application to deploy, and visit <ulink url=\"http://"
@@ -208,13 +223,13 @@
 msgstr ""
 
 #. Tag: title
-#: ri.xml:126
+#: ri.xml:135
 #, no-c-format
 msgid "The numberguess example"
 msgstr ""
 
 #. Tag: para
-#: ri.xml:128
+#: ri.xml:137
 #, no-c-format
 msgid ""
 "In the numberguess application you get given 10 attempts to guess a number "
@@ -223,7 +238,7 @@
 msgstr ""
 
 #. Tag: para
-#: ri.xml:134
+#: ri.xml:143
 #, no-c-format
 msgid ""
 "The numberguess example is comprised of a number of Web Beans, configuration "
@@ -232,7 +247,7 @@
 msgstr ""
 
 #. Tag: para
-#: ri.xml:140
+#: ri.xml:149
 #, no-c-format
 msgid ""
 "All the configuration files for this example are located in <literal>WEB-INF/"
@@ -242,7 +257,7 @@
 msgstr ""
 
 #. Tag: programlisting
-#: ri.xml:148
+#: ri.xml:157
 #, no-c-format
 msgid ""
 "<![CDATA[<?xml version='1.0' encoding='UTF-8'?>\n"
@@ -260,7 +275,7 @@
 msgstr ""
 
 #. Tag: para
-#: ri.xml:150
+#: ri.xml:159
 #, no-c-format
 msgid ""
 "There is an empty <literal>web-beans.xml</literal> file, which marks this "
@@ -268,13 +283,13 @@
 msgstr ""
 
 #. Tag: para
-#: ri.xml:155
+#: ri.xml:164
 #, no-c-format
 msgid "Finally there is <literal>web.xml</literal>:"
 msgstr ""
 
 #. Tag: section
-#: ri.xml:157
+#: ri.xml:166
 #, no-c-format
 msgid ""
 "<programlistingco> <areaspec> <area id=\"faces.servlet\" coords=\"12\"/> "
@@ -400,7 +415,7 @@
 msgstr ""
 
 #. Tag: para
-#: ri.xml:270
+#: ri.xml:279
 #, no-c-format
 msgid ""
 "The example exists of 4 classes, the first two of which are binding types. "
@@ -409,7 +424,7 @@
 msgstr ""
 
 #. Tag: programlisting
-#: ri.xml:276
+#: ri.xml:285
 #, no-c-format
 msgid ""
 "<![CDATA[@Target( { TYPE, METHOD, PARAMETER, FIELD })\n"
@@ -420,7 +435,7 @@
 msgstr ""
 
 #. Tag: para
-#: ri.xml:278
+#: ri.xml:287
 #, no-c-format
 msgid ""
 "There is also the <literal>@MaxNumber</literal> binding type, used for "
@@ -428,7 +443,7 @@
 msgstr ""
 
 #. Tag: programlisting
-#: ri.xml:283
+#: ri.xml:292
 #, no-c-format
 msgid ""
 "<![CDATA[@Target( { TYPE, METHOD, PARAMETER, FIELD })\n"
@@ -440,7 +455,7 @@
 msgstr ""
 
 #. Tag: para
-#: ri.xml:285
+#: ri.xml:294
 #, no-c-format
 msgid ""
 "The <literal>Generator</literal> class is responsible for creating the "
@@ -449,7 +464,7 @@
 msgstr ""
 
 #. Tag: programlisting
-#: ri.xml:291
+#: ri.xml:300
 #, no-c-format
 msgid ""
 "<![CDATA[@ApplicationScoped\n"
@@ -478,7 +493,7 @@
 msgstr ""
 
 #. Tag: para
-#: ri.xml:293
+#: ri.xml:302
 #, no-c-format
 msgid ""
 "You'll notice that the <literal>Generator</literal> is application scoped; "
@@ -486,7 +501,7 @@
 msgstr ""
 
 #. Tag: para
-#: ri.xml:298
+#: ri.xml:307
 #, no-c-format
 msgid ""
 "The final Web Bean in the application is the session scoped <literal>Game</"
@@ -496,7 +511,7 @@
 msgstr ""
 
 #. Tag: para
-#: ri.xml:305
+#: ri.xml:314
 #, no-c-format
 msgid ""
 "You'll also note that we've used the <literal>@Named</literal> annotation, "
@@ -507,7 +522,7 @@
 msgstr ""
 
 #. Tag: programlisting
-#: ri.xml:313
+#: ri.xml:322
 #, no-c-format
 msgid ""
 "<![CDATA[@Named\n"
@@ -551,13 +566,13 @@
 msgstr ""
 
 #. Tag: title
-#: ri.xml:317
+#: ri.xml:326
 #, no-c-format
 msgid "The translator example"
 msgstr ""
 
 #. Tag: para
-#: ri.xml:319
+#: ri.xml:328
 #, no-c-format
 msgid ""
 "The translator example will take any sentences you enter, and translate them "
@@ -565,7 +580,7 @@
 msgstr ""
 
 #. Tag: para
-#: ri.xml:324
+#: ri.xml:333
 #, no-c-format
 msgid ""
 "The translator example is built as an ear, and contains EJBs and enterprise "
@@ -574,7 +589,7 @@
 msgstr ""
 
 #. Tag: para
-#: ri.xml:331
+#: ri.xml:340
 #, no-c-format
 msgid ""
 "EJB 3.1 and Jave EE 6 allow you to package EJBs in a war, which will make "
@@ -582,7 +597,7 @@
 msgstr ""
 
 #. Tag: para
-#: ri.xml:337
+#: ri.xml:346
 #, no-c-format
 msgid ""
 "First, let's take a look at the ear aggregator, which is located in "
@@ -592,7 +607,7 @@
 msgstr ""
 
 #. Tag: programlisting
-#: ri.xml:344
+#: ri.xml:353
 #, no-c-format
 msgid ""
 "<![CDATA[<plugin>\n"
@@ -615,7 +630,7 @@
 msgstr ""
 
 #. Tag: para
-#: ri.xml:346
+#: ri.xml:355
 #, no-c-format
 msgid ""
 "We're doing a couple of things here - firstly we set the context path, which "
@@ -625,7 +640,7 @@
 msgstr ""
 
 #. Tag: para
-#: ri.xml:354
+#: ri.xml:363
 #, no-c-format
 msgid ""
 "If you aren't using Maven to generate these files, you would need "
@@ -633,7 +648,7 @@
 msgstr ""
 
 #. Tag: programlisting
-#: ri.xml:359
+#: ri.xml:368
 #, no-c-format
 msgid ""
 "<![CDATA[<?xml version=\"1.0\" encoding=\"UTF-8\"?>\n"
@@ -647,13 +662,13 @@
 msgstr ""
 
 #. Tag: para
-#: ri.xml:361
+#: ri.xml:370
 #, no-c-format
 msgid "and <literal>META-INF/application.xml</literal>:"
 msgstr ""
 
 #. Tag: programlisting
-#: ri.xml:365
+#: ri.xml:374
 #, no-c-format
 msgid ""
 "<![CDATA[<?xml version=\"1.0\" encoding=\"UTF-8\"?>\n"
@@ -679,7 +694,7 @@
 msgstr ""
 
 #. Tag: para
-#: ri.xml:368
+#: ri.xml:377
 #, no-c-format
 msgid ""
 "Next, lets look at the war. Just as in the numberguess example, we have a "
@@ -689,7 +704,7 @@
 msgstr ""
 
 #. Tag: para
-#: ri.xml:375
+#: ri.xml:384
 #, no-c-format
 msgid ""
 "More intersting is the facelet used to translate text. Just as in the "
@@ -698,7 +713,7 @@
 msgstr ""
 
 #. Tag: programlisting
-#: ri.xml:381
+#: ri.xml:390
 #, no-c-format
 msgid ""
 "<![CDATA[<h:form id=\"NumberGuessMain\">\n"
@@ -731,7 +746,7 @@
 msgstr ""
 
 #. Tag: para
-#: ri.xml:383
+#: ri.xml:392
 #, no-c-format
 msgid ""
 "The user can enter some text in the lefthand textarea, and hit the translate "
@@ -739,7 +754,7 @@
 msgstr ""
 
 #. Tag: para
-#: ri.xml:388
+#: ri.xml:397
 #, no-c-format
 msgid ""
 "Finally, let's look at the ejb module, <literal>webbeans-translator-ejb</"
@@ -752,7 +767,7 @@
 msgstr ""
 
 #. Tag: programlisting
-#: ri.xml:400
+#: ri.xml:409
 #, no-c-format
 msgid ""
 "<![CDATA[<?xml version=\"1.0\" encoding=\"UTF-8\"?>\n"
@@ -781,7 +796,7 @@
 msgstr ""
 
 #. Tag: para
-#: ri.xml:402
+#: ri.xml:411
 #, no-c-format
 msgid ""
 "We've saved the most interesting bit to last, the code! The project has two "
@@ -793,7 +808,7 @@
 msgstr ""
 
 #. Tag: para
-#: ri.xml:412
+#: ri.xml:421
 #, no-c-format
 msgid ""
 "Both <literal>SentanceParser</literal> and <literal>TextTranslator</literal> "
@@ -802,7 +817,7 @@
 msgstr ""
 
 #. Tag: programlisting
-#: ri.xml:418
+#: ri.xml:427
 #, no-c-format
 msgid ""
 "<![CDATA[public class TextTranslator { \n"
@@ -818,7 +833,7 @@
 msgstr ""
 
 #. Tag: para
-#: ri.xml:420
+#: ri.xml:429
 #, no-c-format
 msgid ""
 "<literal>TextTranslator</literal> is a stateless bean (with a local business "
@@ -827,7 +842,7 @@
 msgstr ""
 
 #. Tag: para
-#: ri.xml:426
+#: ri.xml:435
 #, no-c-format
 msgid ""
 "Finally, there is UI orientated controller, that collects the text from the "
@@ -836,7 +851,7 @@
 msgstr ""
 
 #. Tag: programlisting
-#: ri.xml:432
+#: ri.xml:441
 #, no-c-format
 msgid ""
 "<![CDATA[@Stateful\n"
@@ -849,19 +864,19 @@
 msgstr ""
 
 #. Tag: para
-#: ri.xml:434
+#: ri.xml:443
 #, no-c-format
 msgid "The bean also has getters and setters for all the fields on the page."
 msgstr ""
 
 #. Tag: para
-#: ri.xml:438
+#: ri.xml:447
 #, no-c-format
 msgid "As this is a stateful session bean, we have to have a remove method:"
 msgstr ""
 
 #. Tag: programlisting
-#: ri.xml:442
+#: ri.xml:451
 #, no-c-format
 msgid ""
 "<![CDATA[   @Remove\n"
@@ -872,7 +887,7 @@
 msgstr ""
 
 #. Tag: para
-#: ri.xml:444
+#: ri.xml:453
 #, no-c-format
 msgid ""
 "The Web Beans manager will call the remove method for you when the bean is "
@@ -880,7 +895,7 @@
 msgstr ""
 
 #. Tag: para
-#: ri.xml:450
+#: ri.xml:459
 #, no-c-format
 msgid ""
 "That concludes our short tour of the Web Beans RI examples. For more on the "
@@ -890,7 +905,7 @@
 msgstr ""
 
 #. Tag: para
-#: ri.xml:456
+#: ri.xml:465
 #, no-c-format
 msgid ""
 "We need help in all areas - bug fixing, writing new features, writing "




More information about the weld-commits mailing list