You are viewing a plain text version of this content. The canonical link for it is here.
Posted to java-dev@axis.apache.org by to...@apache.org on 2004/06/17 11:49:40 UTC

cvs commit: ws-axis/site/src/documentation/content/xdocs/java requirements.ihtml reference.ihtml reading.ihtml integration-guide.ihtml install.ihtml developers-guide.ihtml

toshi       2004/06/17 02:49:40

  Modified:    site/src/documentation/content/xdocs/java requirements.ihtml
                        reference.ihtml reading.ihtml
                        integration-guide.ihtml install.ihtml
                        developers-guide.ihtml
  Log:
  for http://issues.apache.org/jira/browse/AXIS-1398
  
  Revision  Changes    Path
  1.3       +4 -4      ws-axis/site/src/documentation/content/xdocs/java/requirements.ihtml
  
  Index: requirements.ihtml
  ===================================================================
  RCS file: /home/cvs/ws-axis/site/src/documentation/content/xdocs/java/requirements.ihtml,v
  retrieving revision 1.2
  retrieving revision 1.3
  diff -u -r1.2 -r1.3
  --- requirements.ihtml	16 Oct 2003 21:44:08 -0000	1.2
  +++ requirements.ihtml	17 Jun 2004 09:49:39 -0000	1.3
  @@ -9,7 +9,7 @@
       small.red { color: red }
     </STYLE>
   
  -  <TITLE>Axis requirements &amp; status</TITLE>
  +  <TITLE>Axis requirements & status</TITLE>
   </HEAD>
   
   <BODY>
  @@ -1484,7 +1484,7 @@
           <TD><BR>
           <BR></TD>
   
  -        <TD valign="top"><B>NYI</B> - Lance &amp; HP
  +        <TD valign="top"><B>NYI</B> - Lance & HP
           contribution?<BR></TD>
   
           <TD><BR></TD>
  @@ -1525,7 +1525,7 @@
           <TD><BR>
           <BR></TD>
   
  -        <TD valign="top"><B>NYI</B> - Lance &amp; HP?<BR></TD>
  +        <TD valign="top"><B>NYI</B> - Lance & HP?<BR></TD>
   
           <TD><BR></TD>
   
  @@ -1929,7 +1929,7 @@
   
           <TD><BR></TD>
   
  -        <TD valign="top">getting there, with functional &amp; unit
  +        <TD valign="top">getting there, with functional & unit
           tests<BR></TD>
   
           <TD><BR></TD>
  
  
  
  1.7       +7 -7      ws-axis/site/src/documentation/content/xdocs/java/reference.ihtml
  
  Index: reference.ihtml
  ===================================================================
  RCS file: /home/cvs/ws-axis/site/src/documentation/content/xdocs/java/reference.ihtml,v
  retrieving revision 1.6
  retrieving revision 1.7
  diff -u -r1.6 -r1.7
  --- reference.ihtml	23 Mar 2004 22:09:36 -0000	1.6
  +++ reference.ihtml	17 Jun 2004 09:49:39 -0000	1.7
  @@ -315,7 +315,7 @@
   
     <P>A note about what it means to be referenced.  We cannot simply
     say:  start with the services, generate all bindings referenced
  -  by the service, generated all portTypes referenced by the
  +  by the service, generate all portTypes referenced by the
     referenced bindings, etc.  What if we're generating code from a
     WSDL file that only contains portTypes, messages, and types?  If
     WSDL2Java used service as an anchor, and there's no service in
  @@ -438,8 +438,8 @@
     -u, --use &lt;argument&gt;
       The use of items in the binding, either LITERAL or ENCODED
     -e, --extraClasses &lt;argument&gt;
  -    A space or comma separated list of class names to be added tO
  -    The type section.
  +    A space or comma separated list of class names to be added to
  +    the type section.
   Details:
      portType element name= &lt;--portTypeName value&gt; OR &lt;class-of-portType name&gt;
      binding  element name= &lt;--bindingName value&gt; OR &lt;--servicePortName value&gt;Soap
  @@ -475,11 +475,11 @@
     location attribute is assigned the specified value.</P>
   
     <P><B>-P, --portTypeName &lt;name&gt;</B><BR>
  -  Indicates the name to use use for the portType element. If not
  +  Indicates the name to use for the portType element. If not
     specified, the class-of-portType name is used.</P>
   
     <P><B>-b, --bindingName &lt;name&gt;</B><BR>
  -  Indicates the name to use use for the binding element. If not
  +  Indicates the name to use for the binding element. If not
     specified, the value of the --servicePortName + "SoapBinding" is
     used.</P>
   
  @@ -516,7 +516,7 @@
     Indicates the kind of WSDL to generate.  Accepted values are:</P>
   
     <UL>
  - <LI>All --- (default) Generates wsld containing both interface
  + <LI>All --- (default) Generates wsdl containing both interface
    and implementation WSDL constructs.</LI>
   
    <LI>Interface --- Generates a WSDL containing the interface
  @@ -582,7 +582,7 @@
     document. This is useful in the case where your service interface
     references a base class and you would like your WSDL to contain
     XML Schema type defintions for these other classes. The
  -  -extraClasses option can be specified duplicate times. Each
  +  --extraClasses option can be specified duplicate times. Each
     specification results in the additional classes being added to
     the list.</P>
   </TT>
  
  
  
  1.4       +1 -1      ws-axis/site/src/documentation/content/xdocs/java/reading.ihtml
  
  Index: reading.ihtml
  ===================================================================
  RCS file: /home/cvs/ws-axis/site/src/documentation/content/xdocs/java/reading.ihtml,v
  retrieving revision 1.3
  retrieving revision 1.4
  diff -u -r1.3 -r1.4
  --- reading.ihtml	18 Dec 2003 23:40:33 -0000	1.3
  +++ reading.ihtml	17 Jun 2004 09:49:39 -0000	1.4
  @@ -62,7 +62,7 @@
   
       <LI><A href=
       "http://macromedia.com/support/jrun/extend/using_web_services/">
  -    Axis in JRrun</A><BR>
  +    Axis in JRun</A><BR>
       Macromedia authored coverage of using Axis from inside
       JRun.</LI>
   
  
  
  
  1.4       +3 -3      ws-axis/site/src/documentation/content/xdocs/java/integration-guide.ihtml
  
  Index: integration-guide.ihtml
  ===================================================================
  RCS file: /home/cvs/ws-axis/site/src/documentation/content/xdocs/java/integration-guide.ihtml,v
  retrieving revision 1.3
  retrieving revision 1.4
  diff -u -r1.3 -r1.4
  --- integration-guide.ihtml	23 Oct 2003 12:36:33 -0000	1.3
  +++ integration-guide.ihtml	17 Jun 2004 09:49:39 -0000	1.4
  @@ -534,7 +534,7 @@
      <CODE>EngineConfigurationFactoryFinder(someContext)</CODE>
      and ensuring that the results are handed to Axis.&nbsp;
      <CODE>someContext</CODE> is key to how the factory finder
  -   locates the appropariate implementation of
  +   locates the appropriate implementation of
      EngineConfigurationFactory to be used, if any.
   
      <P>EngineConfigurationFactoryFinder works as follows:<BR>
  @@ -1246,7 +1246,7 @@
       javax.xml.PortType, etc); a generator for schema types;
       and a generator for the WSDL Definition itself.&nbsp;
       This last generator is used to generate anything that
  -    doesn't fit into the previous categories</P>
  +    doesn't fit into the previous categories.</P>
   
       <P>In addition to the getGeneratorMethods, the
       GeneratorFactory defines a generatorPass method which
  @@ -1636,7 +1636,7 @@
     option is "-g", rather an odd abbreviation, but "-s" is the
     abbreviation for --serverSide and "-S" is the abbreviation
     for --skeletonDeploy.&nbsp; Bummer.&nbsp; I just picked
  -  some other letter.</LI>
  +  some other letter.)</LI>
   
     <LI>createParser - we've got to provide a means by which
     the parent class can get our Parser extension.</LI>
  
  
  
  1.5       +9 -9      ws-axis/site/src/documentation/content/xdocs/java/install.ihtml
  
  Index: install.ihtml
  ===================================================================
  RCS file: /home/cvs/ws-axis/site/src/documentation/content/xdocs/java/install.ihtml,v
  retrieving revision 1.4
  retrieving revision 1.5
  diff -u -r1.4 -r1.5
  --- install.ihtml	23 Mar 2004 22:09:36 -0000	1.4
  +++ install.ihtml	17 Jun 2004 09:49:40 -0000	1.5
  @@ -233,7 +233,7 @@
   
     <H3>Tomcat 4.x and Java 1.4</H3>
   
  -  <P>Java 1.4 changed the rules as to to how packages beginning in
  +  <P>Java 1.4 changed the rules as to how packages beginning in
     java.* and javax.* get loaded. Specifically, they only get loaded
     from <I>endorsed</I> directories. jaxrpc.jar and saaj.jar contain
     javax packages, so they may not get picked up. If happyaxis.jsp
  @@ -289,7 +289,7 @@
   
     <P>From the start page, select <I>View the list of deployed Web
     services</I>. This will list all registered Web Services, unless
  -  the servlet is configured not to do so. On this page, You should
  +  the servlet is configured not to do so. On this page, you should
     be able to click on <I>(wsdl)</I> for each deployed Web service
     to make sure that your web service is up and running.</P>
   
  @@ -389,7 +389,7 @@
     via the Admin web service, which is usually done with the
     AdminClient program or the &lt;axis-admin&gt; Ant task. Both of
     these do the same thing: they run the Axis SOAP client to talk to
  -  the Axis adminstration service, which is a SOAP service in its
  +  the Axis administration service, which is a SOAP service in its
     own right. It's also a special SOAP service in one regard--it is
     restricted to local callers only (not remote access) and is
     password protected to stop random people from administrating your
  @@ -414,7 +414,7 @@
     application server, or by using a server-specific mechanism to
     restart a specific webapp.</P>
   
  -  <P><SPAN class="note">Note:</SPAN> If your web service uses the
  +  <P>Note: If your web service uses the
     simple authorization handlers provided with xml-axis (this is
     actually <U>not</U> recommended as these are merely illustrations
     of how to write a handler than intended for production use), then
  @@ -468,7 +468,7 @@
     <P>Unix users have to do something similar. Below we have
     installed AXIS into /usr/axis and are using the bash shell. See
     your shell's documentation for differences. To make variables
  -  permenate you will need to add them to your shell's startup (dot)
  +  permeate you will need to add them to your shell's startup (dot)
     files. Again, see your shell's documentation.</P>
     <PRE class="xml">
    set AXIS_HOME=/usr/axis<BR>
  @@ -547,7 +547,7 @@
     problems are foundational Java development skills--if you don't
     know how to do these things, learn them now!</P>
   
  -  <P><SPAN class="note">Note:</SPAN> You may need to replace
  +  <P>Note: You may need to replace
     localhost with your host name, and 8080 with the port number used
     by your web server. If you have renamed the web application to
     something other than "axis" change the URL appropriately.</P>
  @@ -596,7 +596,7 @@
    <LI>You should get back "55.25" as a result.</LI>
     </UL>
   
  -  <P><SPAN class="note">Note:</SPAN> Again, you may need to replace
  +  <P>Note: Again, you may need to replace
     localhost with your host name, and 8080 with the port number used
     by your web server. If you have renamed the web application to
     something other than "axis" change the URL appropriately.</P>
  @@ -709,12 +709,12 @@
   
    <LI>Consult the <A href=
    "http://nagoya.apache.org/wiki/apachewiki.cgi?AxisProjectPages">
  - Axis Wiki</A> For its Frequently Asked Questions (FAQ),
  + Axis Wiki</A> for its Frequently Asked Questions (FAQ),
    installation notes, interoperability issues lists, and other
    useful information.</LI>
   
    <LI>Don't email people for help directly, unless you know them.
  - It's rude and presumptious. Messages sent over the mail list
  + It's rude and presumptuous. Messages sent over the mail list
    benefit the whole community--both the original posters and
    people who search the list. Personal messages just take up the
    recipients time, and are unwelcome. Usually, if not ignored
  
  
  
  1.5       +5 -5      ws-axis/site/src/documentation/content/xdocs/java/developers-guide.ihtml
  
  Index: developers-guide.ihtml
  ===================================================================
  RCS file: /home/cvs/ws-axis/site/src/documentation/content/xdocs/java/developers-guide.ihtml,v
  retrieving revision 1.4
  retrieving revision 1.5
  diff -u -r1.4 -r1.5
  --- developers-guide.ihtml	23 Mar 2004 22:09:36 -0000	1.4
  +++ developers-guide.ihtml	17 Jun 2004 09:49:40 -0000	1.5
  @@ -271,7 +271,7 @@
       <LI style="list-style: none"><BR>
       &nbsp;</LI>
   
  -    <LI>warn - Use of deprecated APIs, poor use of API, Almost
  +    <LI>warn - Use of deprecated APIs, poor use of API, almost
       errors, other runtime situations that are undesirable or
       unexpected, but not necessarily "wrong". Expect these to be
       immediately visible on a console, and MUST be
  @@ -592,7 +592,7 @@
       reason. Code reviewers are invited to put on their vulture
       beaks and peck away...
   
  -      <P>There are a few corrollaries to this rule.</P>
  +      <P>There are a few corollaries to this rule.</P>
   
         <UL>
           <LI>
  @@ -1108,7 +1108,7 @@
   
     <P><BR>
     <FONT color="#000000">One way to build a test is to "cut and
  -  paste" and existing tests, and then modify the test to suit your
  +  paste" the existing tests, and then modify the test to suit your
     needs.  This approach is becoming more complicated as the
     different kinds of tests grow.</FONT></P>
   
  @@ -1147,7 +1147,7 @@
           harness. This file is operational without any additional
           changes.  Copy the *TestCase.java file into the same
           directory as your wsdl file.  (Ideally only the Java files
  -        that are changed need to be in your directory.  So this
  +        that are changed need to be in your directory.) So this
           file is not needed, but please make sure to modify your
           &lt;wsdl2java ...&gt; clause (described below) to emit a
           testcase.</FONT></LI>
  @@ -1439,7 +1439,7 @@
       <TT>http://localhost:&lt;port&gt;/axis/SOAPMonitor</TT>
     </BLOCKQUOTE>
   
  -  <P>. As you run your tests, the SOAP messages should appear in
  +  <P>As you run your tests, the SOAP messages should appear in
     the SOAP monitor window.</P>
   
     <P><CODE>SOAP Monitor</CODE> is described in more detail in the