[jbossws-commits] JBossWS SVN: r15861 - stack/native/trunk/modules/dist/src/main/doc.

[jbossws-commits at lists.jboss.org]

Author: alessio.soldano at jboss.com
Date: 2012-03-05 06:01:44 -0500 (Mon, 05 Mar 2012)
New Revision: 15861

Modified:
   stack/native/trunk/modules/dist/src/main/doc/Revision_History.xml
   stack/native/trunk/modules/dist/src/main/doc/chapter-3-JAX_WS_User_Guide.xml
   stack/native/trunk/modules/dist/src/main/doc/chapter-5-JBoss_Modules.xml
Log:
Updating doc


Modified: stack/native/trunk/modules/dist/src/main/doc/Revision_History.xml
===================================================================
--- stack/native/trunk/modules/dist/src/main/doc/Revision_History.xml	2012-03-05 10:52:38 UTC (rev 15860)
+++ stack/native/trunk/modules/dist/src/main/doc/Revision_History.xml	2012-03-05 11:01:44 UTC (rev 15861)
@@ -32,6 +32,20 @@
           </simplelist>
         </revdescription>
       </revision>
+      <revision>
+        <revnumber>4.0.2</revnumber>
+        <date>Mon Mar 05 2012</date>
+        <author>
+          <firstname>Alessio</firstname>
+          <surname>Soldano</surname>
+          <email>alessio.soldano at jboss.com</email>
+        </author>
+        <revdescription>
+          <simplelist>
+            <member>JBossWS-Native 4.0.2 documentation</member>
+          </simplelist>
+        </revdescription>
+      </revision>
     </revhistory>
   </simpara>
 </appendix>

Modified: stack/native/trunk/modules/dist/src/main/doc/chapter-3-JAX_WS_User_Guide.xml
===================================================================
--- stack/native/trunk/modules/dist/src/main/doc/chapter-3-JAX_WS_User_Guide.xml	2012-03-05 10:52:38 UTC (rev 15860)
+++ stack/native/trunk/modules/dist/src/main/doc/chapter-3-JAX_WS_User_Guide.xml	2012-03-05 11:01:44 UTC (rev 15861)
@@ -360,7 +360,7 @@
         <section id="sid-3866716_JAX-WSUserGuide-WebServiceRefcustomization">
           
           <title>WebServiceRef customization</title>
-          <para>Starting from jboss-5.0.x we offer a number of overrides and extensions to the WebServiceRef annotation. These include</para>
+          <para>We offer a number of overrides and extensions to the WebServiceRef annotation. These include</para>
           <itemizedlist>
             <listitem>
               <para>define the port that should be used to resolve a container-managed port</para>
@@ -409,8 +409,9 @@
           </informalexample>
           <para>
             For details please see
-            <emphasis role="italics">service-ref_5_0.dtd</emphasis>
-            in the jboss docs directory.
+            <emphasis role="italics">
+              <ulink url="http://www.jboss.org/j2ee/dtd/service-ref_5_0.dtd">service-ref_5_0.dtd</ulink>
+            </emphasis>
           </para>
         </section>
       </section>

Modified: stack/native/trunk/modules/dist/src/main/doc/chapter-5-JBoss_Modules.xml
===================================================================
--- stack/native/trunk/modules/dist/src/main/doc/chapter-5-JBoss_Modules.xml	2012-03-05 10:52:38 UTC (rev 15860)
+++ stack/native/trunk/modules/dist/src/main/doc/chapter-5-JBoss_Modules.xml	2012-03-05 11:01:44 UTC (rev 15861)
@@ -54,10 +54,6 @@
           <programlisting>Dependencies: com.sun.xml.bind services export</programlisting>
         </informalexample>
       </section>
-    </section>
-    <section id="sid-4784150_JBossModules-">
-      
-      <title/>
       <section id="sid-4784150_JBossModules-UsingApacheCXF">
         
         <title>Using Apache CXF</title>
@@ -71,10 +67,14 @@
         </informalexample>
         <para>However, please note that would not come with any JBossWS-CXF customizations nor additional extensions. For this reason, and generally speaking for simplifying user configuration, a client side aggregation module is available with all the WS dependencies users might need.</para>
       </section>
+      <section id="sid-4784150_JBossModules-ClientsideWSaggregationmodule">
+        
+        <title>Client side WS aggregation module</title>
+      </section>
     </section>
-    <section id="sid-4784150_JBossModules-ClientsideWSaggregationmodule">
+    <section id="sid-4784150_JBossModules-">
       
-      <title>Client side WS aggregation module</title>
+      <title/>
       <para>Whenever you simply want to use all the JBoss Web Services  feature/functionalities, you can set a dependency to the convenient  client module.</para>
       <informalexample>
         <programlisting>Dependencies: org.jboss.ws.cxf.jbossws-cxf-client services export</programlisting>
@@ -116,5 +116,19 @@
           module. So either create that manually in the application server or use the JBossWS-CXF installation scripts for doing that.
         </para>
       </section>
+      <section id="sid-4784150_JBossModules-Annotationscanning">
+        
+        <title>Annotation scanning</title>
+        <para>
+          The application server uses an annotation index for detecting JAX-WS endpoints in user deployments. When declaring WS endpoints whose class belongs to a different module (for instance referring that in the
+          <code>web.xml</code>
+          descriptor), be sure to have an
+          <code>annotations</code>
+          type dependency in place. Without that, your endpoints would simply be ignored as they won't appear as annotated classes to the webservices subsystem.
+        </para>
+        <informalexample>
+          <programlisting>Dependencies: org.foo annotations</programlisting>
+        </informalexample>
+      </section>
     </section>
   </chapter>