[seam-commits] Seam SVN: r9326 - trunk/doc/Seam_Reference_Guide/en-US.

[seam-commits at lists.jboss.org]

Author: norman.richards at jboss.com
Date: 2008-10-14 20:23:15 -0400 (Tue, 14 Oct 2008)
New Revision: 9326

Modified:
   trunk/doc/Seam_Reference_Guide/en-US/Components.xml
   trunk/doc/Seam_Reference_Guide/en-US/Concepts.xml
Log:
JBSEAM-2563

Modified: trunk/doc/Seam_Reference_Guide/en-US/Components.xml
===================================================================
--- trunk/doc/Seam_Reference_Guide/en-US/Components.xml	2008-10-14 23:41:26 UTC (rev 9325)
+++ trunk/doc/Seam_Reference_Guide/en-US/Components.xml	2008-10-15 00:23:15 UTC (rev 9326)
@@ -17,15 +17,7 @@
         of the built in components on your own class using 
         <literal>@Name</literal>.
     </para>
-    
-    <para>
-        Note also that even though all the built in components use a
-        qualified name, most of them are aliased to unqualified names by
-        default. These aliases specify <literal>auto-create="true"</literal>,
-        so you do not need to use <literal>create=true</literal> when
-        injecting built-in components by their unqualified name.
-    </para>
-    
+
     <section>
         <title>Context injection components</title>
         <para>

Modified: trunk/doc/Seam_Reference_Guide/en-US/Concepts.xml
===================================================================
--- trunk/doc/Seam_Reference_Guide/en-US/Concepts.xml	2008-10-14 23:41:26 UTC (rev 9325)
+++ trunk/doc/Seam_Reference_Guide/en-US/Concepts.xml	2008-10-15 00:23:15 UTC (rev 9326)
@@ -545,10 +545,40 @@
             <programlisting role="XML"><![CDATA[<factory name="loginAction" scope="STATELESS" value="#{com.jboss.myapp.loginAction}"/>]]></programlisting>
 
             <para> 
-                All of the built-in Seam components have qualified names, but most of them are aliased to a simple
-                name by the <literal>components.xml</literal> file included in the Seam jar. 
+                All of the built-in Seam components have qualified names but can be accessed through 
+                their unqualified names due to the namespace import feature of Seam. 
+                The <literal>components.xml</literal> file included in the Seam JAR defines the following
+                namespaces.
             </para>
-
+            
+<programlisting>&lt;components xmlns=&quot;http://jboss.com/products/seam/components&quot;&gt;
+    
+    &lt;import&gt;org.jboss.seam.core&lt;/import&gt;
+    &lt;import&gt;org.jboss.seam.cache&lt;/import&gt;
+    &lt;import&gt;org.jboss.seam.transaction&lt;/import&gt;
+    &lt;import&gt;org.jboss.seam.framework&lt;/import&gt;
+    &lt;import&gt;org.jboss.seam.web&lt;/import&gt;
+    &lt;import&gt;org.jboss.seam.faces&lt;/import&gt;
+    &lt;import&gt;org.jboss.seam.international&lt;/import&gt;
+    &lt;import&gt;org.jboss.seam.theme&lt;/import&gt;
+    &lt;import&gt;org.jboss.seam.pageflow&lt;/import&gt;
+    &lt;import&gt;org.jboss.seam.bpm&lt;/import&gt;
+    &lt;import&gt;org.jboss.seam.jms&lt;/import&gt;
+    &lt;import&gt;org.jboss.seam.mail&lt;/import&gt;
+    &lt;import&gt;org.jboss.seam.security&lt;/import&gt;
+    &lt;import&gt;org.jboss.seam.security.management&lt;/import&gt;  
+    &lt;import&gt;org.jboss.seam.security.permission&lt;/import&gt;
+    &lt;import&gt;org.jboss.seam.captcha&lt;/import&gt;
+    &lt;import&gt;org.jboss.seam.excel.exporter&lt;/import&gt;
+    &lt;!-- ... ---&gt;
+&lt;/components&gt;
+</programlisting>   
+            
+            <para>
+                When attempting to resolve an unqualified name, Seam will check each of those namespaces, in order.
+                You can include additional namespaces in your application's <literal>components.xml</literal> file
+                for application-specific namespaces.
+            </para>
         </sect2>
 
         <sect2>