Author: ericjohnson
Date: Thu Oct 16 12:54:16 2008
New Revision: 705340

URL: http://svn.apache.org/viewvc?rev=705340&view=rev
Log:
updated schema documentaiton

Modified:
    cxf/trunk/rt/bindings/xml/src/main/resources/schemas/wsdl/xml-binding.xsd
    
cxf/trunk/rt/transports/http-jetty/src/main/resources/schemas/configuration/http-jetty.xsd
    
cxf/trunk/rt/transports/http/src/main/resources/schemas/configuration/http-conf.xsd
    cxf/trunk/rt/transports/http/src/main/resources/schemas/wsdl/http-conf.xsd

Modified: 
cxf/trunk/rt/bindings/xml/src/main/resources/schemas/wsdl/xml-binding.xsd
URL: 
http://svn.apache.org/viewvc/cxf/trunk/rt/bindings/xml/src/main/resources/schemas/wsdl/xml-binding.xsd?rev=705340&r1=705339&r2=705340&view=diff
==============================================================================
--- cxf/trunk/rt/bindings/xml/src/main/resources/schemas/wsdl/xml-binding.xsd 
(original)
+++ cxf/trunk/rt/bindings/xml/src/main/resources/schemas/wsdl/xml-binding.xsd 
Thu Oct 16 12:54:16 2008
@@ -32,7 +32,11 @@
                        <xs:extension base="wsdl:tExtensibilityElement">
                                <xs:sequence />
                                <xs:attribute name="rootNode" type="xs:QName"
-                                       use="optional" />
+                                       use="optional">
+                                       <xs:annotation>
+                                               <xs:documentation>The QName of 
the root element used to wrap the message passed across the 
wire</xs:documentation>
+                                       </xs:annotation>
+                               </xs:attribute>
                        </xs:extension>
                </xs:complexContent>
        </xs:complexType>
@@ -46,7 +50,15 @@
                </xs:complexContent>
        </xs:complexType>
 
-       <xs:element name="body" type="xformat:XMLBindingMessageFormat" />
-       <xs:element name="binding" type="xformat:XMLFormatBinding"/>
+       <xs:element name="body" type="xformat:XMLBindingMessageFormat">
+               <xs:annotation>
+                       <xs:documentation>Specifies how the message body is 
mapped to an XML document.</xs:documentation>
+               </xs:annotation>
+       </xs:element>
+       <xs:element name="binding" type="xformat:XMLFormatBinding">
+               <xs:annotation>
+                       <xs:documentation>Specifies that the messages are 
mapped to XML documents</xs:documentation>
+               </xs:annotation>
+       </xs:element>
 
 </xs:schema>

Modified: 
cxf/trunk/rt/transports/http-jetty/src/main/resources/schemas/configuration/http-jetty.xsd
URL: 
http://svn.apache.org/viewvc/cxf/trunk/rt/transports/http-jetty/src/main/resources/schemas/configuration/http-jetty.xsd?rev=705340&r1=705339&r2=705340&view=diff
==============================================================================
--- 
cxf/trunk/rt/transports/http-jetty/src/main/resources/schemas/configuration/http-jetty.xsd
 (original)
+++ 
cxf/trunk/rt/transports/http-jetty/src/main/resources/schemas/configuration/http-jetty.xsd
 Thu Oct 16 12:54:16 2008
@@ -40,22 +40,46 @@
     
     <!-- Is this really supposed to be supperceeded by 
http-conf:HTTPListenerPolicy? -->
     <xs:complexType name="ThreadingParametersType">
-       <xs:attribute name="minThreads" type="xs:unsignedShort"/>
-       <xs:attribute name="maxThreads" type="xs:unsignedShort"/>
+       <xs:attribute name="minThreads" type="xs:unsignedShort">
+          <xs:annotation>
+             <xs:documentation>Specifies the minimum number of threads 
available to the Jetty instance for processing requests.</xs:documentation>
+          </xs:annotation>
+       </xs:attribute>
+       <xs:attribute name="maxThreads" type="xs:unsignedShort">
+                    <xs:annotation>
+             <xs:documentation>Specifies the maximum number of threads 
available to the Jetty instance for processing requests.</xs:documentation>
+          </xs:annotation>
+       </xs:attribute>
     </xs:complexType>
     
     <xs:complexType name="ThreadingParametersIdentifiedType">
        <xs:sequence>
-         <xs:element name="threadingParameters" 
type="tns:ThreadingParametersType"/>
+         <xs:element name="threadingParameters" 
type="tns:ThreadingParametersType">
+            <xs:annotation>
+               <xs:documentation>Specifies the thread pool properties for the 
parameter set.</xs:documentation>
+            </xs:annotation>
+         </xs:element>
        </xs:sequence>
-         <xs:attribute name="id" type="xs:string"/>
+         <xs:attribute name="id" type="xs:string">
+             <xs:annotation>
+                <xs:documentation>Specifies a unique identifier by which the 
property set can be referred.</xs:documentation>
+             </xs:annotation>
+         </xs:attribute>
     </xs:complexType>
     
     <xs:complexType name="TLSServerParametersIdentifiedType">
        <xs:sequence>
-          <xs:element name="tlsServerParameters" 
type="sec:TLSServerParametersType"/>
+          <xs:element name="tlsServerParameters" 
type="sec:TLSServerParametersType">
+             <xs:annotation>
+                <xs:documentation>Specifies the properties for the parameter 
set.</xs:documentation>
+             </xs:annotation>
+          </xs:element>
        </xs:sequence>
-          <xs:attribute name="id" type="xs:string"/>
+          <xs:attribute name="id" type="xs:string">
+             <xs:annotation>
+                <xs:documentation>Specifies a unique identifier by which the 
property set can be referred.</xs:documentation>
+             </xs:annotation>
+          </xs:attribute>
     </xs:complexType>
     
     <xs:complexType name="ParametersRefType">
@@ -66,40 +90,79 @@
        <xs:sequence>
          <xs:choice minOccurs="0" maxOccurs="1">
           <xs:element name="tlsServerParameters" 
-                      type="sec:TLSServerParametersType"/>
+                      type="sec:TLSServerParametersType">
+             <xs:annotation>
+                <xs:documentation>Specifies an instance of the security 
parameters for the Jetty instance.</xs:documentation>
+             </xs:annotation>
+          </xs:element>
           <xs:element name="tlsServerParametersRef"
-                      type="tns:ParametersRefType"/>
+                      type="tns:ParametersRefType">
+             <xs:annotation>
+                <xs:documentation>Specifies a reference to a reusable set of 
security parameters.</xs:documentation>
+             </xs:annotation>
+          </xs:element>
          </xs:choice>
          <xs:choice minOccurs="0" maxOccurs="1">
           <xs:element name="threadingParameters" 
-                      type="tns:ThreadingParametersType"/>
+                      type="tns:ThreadingParametersType">
+             <xs:annotation>
+                <xs:documentation>Specifies an instance of the threading 
configuration use for the Jetty engine.</xs:documentation>
+             </xs:annotation>
+          </xs:element>
           <xs:element name="threadingParametersRef"
-                      type="tns:ParametersRefType"/>
+                      type="tns:ParametersRefType">
+             <xs:annotation>
+                <xs:documentation>Specifies a reference to a reusable set of 
threading parameters.</xs:documentation>
+             </xs:annotation>
+          </xs:element>
          </xs:choice>         
          <xs:element name="connector" type="xsd:anyType" minOccurs="0"/>
          <xs:element name="handlers" type="xsd:anyType" minOccurs="0"/>
          <xs:element name="sessionSupport" type="xsd:boolean" minOccurs="0"/>
          <xs:element name="reuseAddress" type="xsd:boolean" minOccurs="0" />   
       
        </xs:sequence>
-          <xs:attribute name="port" type="xs:int" use="required"/>
+          <xs:attribute name="port" type="xs:int" use="required">
+             <xs:annotation>
+                <xs:documentation>Specifies the port used by the Jetty 
instance.
+                You can specify a value of 0 for the port attribute. Any 
threading 
+                properties specified in an engine element with its port 
attribute
+                set to 0 are used as the configuration for all Jetty listeners 
that are not explicitly configured.</xs:documentation>
+             </xs:annotation>
+          </xs:attribute>
     </xs:complexType>
     
     <xs:complexType name="JettyHTTPServerEngineFactoryConfigType">
        <xs:sequence>
            <xs:element name="identifiedTLSServerParameters" 
                        type="tns:TLSServerParametersIdentifiedType"
-                       minOccurs="0" maxOccurs="unbounded"/>
+                       minOccurs="0" maxOccurs="unbounded">
+              <xs:annotation>
+                 <xs:documentation>Specifies a reusable set of properties for 
securing an HTTP service provider.</xs:documentation>
+              </xs:annotation>
+           </xs:element>
            <xs:element name="identifiedThreadingParameters"
                        type="tns:ThreadingParametersIdentifiedType"
-                       minOccurs="0" maxOccurs="unbounded"/>
+                       minOccurs="0" maxOccurs="unbounded">
+              <xs:annotation>
+                 <xs:documentation>Specifies a reusable set of properties for 
controlling a Jetty instance's thread pool.</xs:documentation>
+              </xs:annotation>
+           </xs:element>
            <xs:element name="engine" 
                        type="tns:JettyHTTPServerEngineConfigType" 
-                       minOccurs="0" maxOccurs="unbounded"/>
+                       minOccurs="0" maxOccurs="unbounded">
+              <xs:annotation>
+                 <xs:documentation>Specifies the configuration for a 
particular Jetty runtime instance.</xs:documentation>
+              </xs:annotation>
+           </xs:element>
        </xs:sequence>
        <xs:attribute name="bus" type="xs:string" default="cxf"/>
        <xs:attribute name="id" type="xs:ID" use="optional"/>
     </xs:complexType>
     
     <xs:element name="engine-factory" 
-                type="tns:JettyHTTPServerEngineFactoryConfigType"/>
+                type="tns:JettyHTTPServerEngineFactoryConfigType">
+       <xs:annotation>
+          <xs:documentation>Contains the configuration for a Jetty 
instance.</xs:documentation>
+       </xs:annotation>
+    </xs:element>
  </xs:schema>

Modified: 
cxf/trunk/rt/transports/http/src/main/resources/schemas/configuration/http-conf.xsd
URL: 
http://svn.apache.org/viewvc/cxf/trunk/rt/transports/http/src/main/resources/schemas/configuration/http-conf.xsd?rev=705340&r1=705339&r2=705340&view=diff
==============================================================================
--- 
cxf/trunk/rt/transports/http/src/main/resources/schemas/configuration/http-conf.xsd
 (original)
+++ 
cxf/trunk/rt/transports/http/src/main/resources/schemas/configuration/http-conf.xsd
 Thu Oct 16 12:54:16 2008
@@ -59,16 +59,16 @@
                 <xs:element ref="http-conf:client" minOccurs="0">
                    <xs:annotation>
                      <xs:documentation>
-                       This element holds the parameters that configure
-                       the client side of an Http connection.
+                       Holds the parameters that configure
+                       a client-side HTTP connection.
                      </xs:documentation>
                    </xs:annotation>
                 </xs:element>
                 <xs:element ref="http-conf:authorization" minOccurs="0">
                    <xs:annotation>
                      <xs:documentation>
-                       This element holds the parameters that configure
-                       the Basic Authentication that will be premptively
+                       Holds the parameters that configure
+                       the Basic Authentication that will be preemptively
                        used. Note, supplying a Basic Auth Supplier object
                        is the preferred approach.
                      </xs:documentation>
@@ -77,8 +77,8 @@
                 <xs:element ref="http-conf:proxyAuthorization" minOccurs="0">
                    <xs:annotation>
                      <xs:documentation>
-                       This element holds the parameters that configure
-                       the Basic Authentication for an outgoing Http
+                       Holds the parameters that configure
+                       the Basic Authentication for an outgoing HTTP
                        Proxy Server.
                      </xs:documentation>
                    </xs:annotation>
@@ -86,9 +86,9 @@
                 <xs:element ref="http-conf:tlsClientParameters" minOccurs="0">
                    <xs:annotation>
                      <xs:documentation>
-                       This element holds the parameters that configure
-                       the underlying SSL/TLS JSSE client side 
-                       of an Https connection.
+                       Holds the parameters that configure
+                       the underlying SSL/TLS JSSE client-side 
+                       of an HTTPS connection.
                      </xs:documentation>
                    </xs:annotation>
                 </xs:element>
@@ -96,9 +96,9 @@
                                        minOccurs="0" maxOccurs="1">
                    <xs:annotation>
                      <xs:documentation>
-                       This element holds the bean reference or class name
+                       Holds the bean reference or class name
                        of an object that supplies Basic Auth information
-                       both prememptively and in response to a 401 Http
+                       both preemptively and in response to a 401 HTTP
                        Challenge. This class must extend the abstract class 
                        org.apache.cxf.transport.http.BasicAuthSupplier.
                      </xs:documentation>
@@ -108,10 +108,10 @@
                                        minOccurs="0" maxOccurs="1">
                    <xs:annotation>
                      <xs:documentation>
-                       This element holds the bean reference or class name
+                       Holds the bean reference or class name
                        of an object that checks the Http(s)URLConnection
                        that will establish trust for a connection with an
-                       Http(s) server, before any information is sent to the
+                       HTTP(S) server, before any information is sent to the
                        server, namely Basic Auth information. This class
                        must extend the abstract class
                        org.apache.cxf.transport.http.MessageTrustDecider. 
@@ -133,24 +133,24 @@
                    <xs:element ref="http-conf:server" minOccurs="0">
                       <xs:annotation>
                         <xs:documentation>
-                          This element holds the parameters that configure
-                          the server side of an Http connection.
+                          Holds the parameters that configure
+                          a server-side HTTP connection.
                         </xs:documentation>
                       </xs:annotation>
                    </xs:element>
                    <xs:element ref="http-conf:contextMatchStrategy" 
minOccurs="0">
                       <xs:annotation>
                         <xs:documentation>
-                          This element holds the parameters that configure
-                          the context match strategy for processing an Http 
request.
+                          Holds the parameters that configure
+                          the context match strategy for processing an HTTP 
request.
                         </xs:documentation>
                       </xs:annotation>
                    </xs:element>
                    <xs:element ref="http-conf:fixedParameterOrder" 
minOccurs="0">
                       <xs:annotation>
                         <xs:documentation>
-                          This element signifies whether the parameter order of
-                          an Http request handled by this destination is fixed.
+                          Signifies whether the parameter order of
+                          an HTTP request handled by this destination is fixed.
                         </xs:documentation>
                       </xs:annotation>
                    </xs:element>

Modified: 
cxf/trunk/rt/transports/http/src/main/resources/schemas/wsdl/http-conf.xsd
URL: 
http://svn.apache.org/viewvc/cxf/trunk/rt/transports/http/src/main/resources/schemas/wsdl/http-conf.xsd?rev=705340&r1=705339&r2=705340&view=diff
==============================================================================
--- cxf/trunk/rt/transports/http/src/main/resources/schemas/wsdl/http-conf.xsd 
(original)
+++ cxf/trunk/rt/transports/http/src/main/resources/schemas/wsdl/http-conf.xsd 
Thu Oct 16 12:54:16 2008
@@ -38,9 +38,7 @@
     
     <xs:complexType name="HTTPServerPolicy">
         <xs:annotation>
-            <xs:documentation>HTTP Server configuration properties.
-            Used for configuring a HTTP server port.
-            </xs:documentation>
+            <xs:documentation>Properties used for configuring a server-side 
HTTP prort</xs:documentation>
         </xs:annotation>
 
         <xs:complexContent>
@@ -57,8 +55,8 @@
                 <xs:attribute name="SuppressClientSendErrors" 
type="xs:boolean" use="optional" default="false">
                     <xs:annotation>
                         <xs:documentation>
-                        When set to no, exceptions will be thrown when an 
error is encountered 
-                        receiving a request from the client.  When set to yes 
these errors will 
+                        When set to false, exceptions will be thrown when an 
error is encountered 
+                        receiving a request from the client.  When set to true 
these errors will 
                         be suppressed.
                         </xs:documentation>
                     </xs:annotation>      
@@ -67,9 +65,9 @@
                 <xs:attribute name="SuppressClientReceiveErrors" 
type="xs:boolean" use="optional" default="false">
                     <xs:annotation>
                         <xs:documentation>
-                        When set to No, exceptions will be thrown when an 
error is encountered 
-                        sending a reply from to client.  When set to Yes these 
errors will be 
-                        suppressed.                     
+                        When set to false, exceptions will be thrown when an 
error is encountered 
+                        sending a reply from to client.  When set to true 
these errors will be 
+                        suppressed.
                         </xs:documentation>
                     </xs:annotation>      
                 </xs:attribute>
@@ -77,9 +75,9 @@
                 <xs:attribute name="HonorKeepAlive" type="xs:boolean" 
use="optional" default="true">
                     <xs:annotation>
                         <xs:documentation>
-                        When set to Yes, the request socket will remain open 
after the reply is 
+                        When set to true, the request socket will remain open 
after the reply is 
                         sent to the client, if the client has requested 
keep-alive and is using 
-                        at least version 1.1 of HTTP.  If set to No, the 
socket will be closed 
+                        at least version 1.1 of HTTP.  If set to false, the 
socket will be closed 
                         after each reply is sent, even if the client requests 
the server to keep 
                         the connection alive.  Keep-Alive improves performance 
for the client 
                         requesting such behavior, but can limit overall 
scalability of the server 
@@ -91,7 +89,7 @@
                 <xs:attribute name="RedirectURL" type="xs:string" 
use="optional">
                     <xs:annotation>
                         <xs:documentation>
-                        to redirect the client to another url (if the 
ReplyCode and ReplyDescription 
+                        A URL to which clients are redirected (if the 
ReplyCode and ReplyDescription 
                         are not set, ReplyCode will be set to 302, and  
ReplyDescription will be set 
                         to 'Object Moved').
                         </xs:documentation>
@@ -111,8 +109,7 @@
                 <xs:attribute name="ContentLocation" type="xs:string" 
use="optional">
                     <xs:annotation>
                         <xs:documentation>
-                        to let the client know what the final url was for 
handling the 
-                        request (e.g., to inform that default.htm document was 
used.)
+                        Specifies the URL representing the resource used to 
satisfy the request(e.g., to inform that default.htm document was used.)
                         </xs:documentation>
                     </xs:annotation>      
                 </xs:attribute>
@@ -120,7 +117,7 @@
                 <xs:attribute name="ContentType" type="xs:string" 
use="optional">
                     <xs:annotation>
                         <xs:documentation>
-                        what MIME type this reply is.  Default is set by the 
binding.
+                        Specifies the MIME type used for responses.  The 
default is set by the binding.
                         </xs:documentation>
                     </xs:annotation>      
                 </xs:attribute>
@@ -128,7 +125,7 @@
                 <xs:attribute name="ContentEncoding" type="xs:string" 
use="optional">
                     <xs:annotation>
                         <xs:documentation>
-                        how this is encoded, if applicable
+                        Specifies any additional encoding applied to the 
response. Values are specified using IANA labels.
                         </xs:documentation>
                     </xs:annotation>      
                 </xs:attribute>
@@ -136,7 +133,7 @@
                 <xs:attribute name="ServerType" type="xs:string" 
use="optional">
                     <xs:annotation>
                         <xs:documentation>
-                        used to send a ServerType header to the client, if 
desired
+                        Specifies an optional value for the HTTP ServerType 
property.
                         </xs:documentation>
                     </xs:annotation>      
                 </xs:attribute>
@@ -146,9 +143,7 @@
 
     <xs:complexType name="HTTPClientPolicy">
         <xs:annotation>
-            <xs:documentation>HTTP client configuration properties.
-            Used for configuring a HTTP client port.
-            </xs:documentation>
+            <xs:documentation>Properties used to configure a client-side HTTP 
port</xs:documentation>
         </xs:annotation>
 
         <xs:complexContent>
@@ -157,7 +152,7 @@
                 <xs:attribute name="ConnectionTimeout" type="xs:unsignedInt" 
use="optional" default="30000">
                     <xs:annotation>
                         <xs:documentation>
-                        Send timeout in milliseconds, 0 is infinite
+                        Specifies the amount of time, in milliseconds, that 
the consumer will attempt to establish a connection before it times out. 0 is 
infinite.
                         </xs:documentation>
                     </xs:annotation>      
                 </xs:attribute>
@@ -165,7 +160,7 @@
                 <xs:attribute name="ReceiveTimeout" type="xs:unsignedInt" 
use="optional" default="60000">
                     <xs:annotation>
                         <xs:documentation>
-                        Receive timeout in milliseconds, 0 is infinite
+                        Specifies the amount of time, in milliseconds, that 
the consumer will wait for a response before it times out. 0 is infinite.
                         </xs:documentation>
                     </xs:annotation>      
                 </xs:attribute>
@@ -173,8 +168,7 @@
                 <xs:attribute name="AutoRedirect" type="xs:boolean" 
use="optional" default="false">
                     <xs:annotation>
                         <xs:documentation>
-                        Whether to automatically follow up when the server 
issues a redirection reply.  
-                        Default is No, so calling flow would handle this 
condition. 
+                       Specifies if the consumer will automatically follow a 
server issued redirection.
                         (name is not part of standard)
                         </xs:documentation>
                     </xs:annotation>      
@@ -183,9 +177,8 @@
                 <xs:attribute name="MaxRetransmits" type="xs:int" 
use="optional" default="-1">
                     <xs:annotation>
                         <xs:documentation>
-                        This attribute governs the amount of retransmits that 
-                        are allowed for redirects along with retransmits for 
-                        authorization. Each redirect may cause another 
+                        Specifies the maximum amount of retransmits that are 
allowed for redirects. Retransmits for 
+                        authorization is included in the retransmit count. 
Each redirect may cause another 
                         retransmit for a UNAUTHORIZED response code, ie. 401. 
                         Any negative number indicates unlimited retransmits,
                         although, loop protection is provided. 
@@ -198,8 +191,8 @@
                 <xs:attribute name="AllowChunking" type="xs:boolean" 
use="optional" default="true">
                     <xs:annotation>
                         <xs:documentation>
-                        If true, the client is free to use chunking streams if 
it wants to, but not 
-                        required.  Regular non-chunked requests are OK too.    
If false, the client 
+                        If true, the client is free to use chunking streams if 
it wants, but it is not 
+                        required to use chunking streams. If false, the client 
                         must use regular, non-chunked requests in all cases.
                         </xs:documentation>
                     </xs:annotation>      
@@ -207,8 +200,8 @@
                 <xs:attribute name="ChunkingThreshold" type="xs:int" 
use="optional" default="4096">
                     <xs:annotation>
                         <xs:documentation>
-                        If AllowChunking is true, this sets the threshold at 
which mesages start
-                        getting chunked.   Messages under this limit do not 
get chunked.
+                        If AllowChunking is true, this sets the threshold at 
which messages start
+                        getting chunked. Messages under this limit do not get 
chunked.
                         </xs:documentation>
                     </xs:annotation>      
                 </xs:attribute>
@@ -216,7 +209,7 @@
                 <xs:attribute name="Accept" type="xs:string" use="optional">
                     <xs:annotation>
                         <xs:documentation>
-                        What MIME types the client is prepared to handle 
(e.g., HTML, JPEG, GIF, etc.)
+                        Specifies the MIME types the client is prepared to 
handle (e.g., HTML, JPEG, GIF, etc.)
                         </xs:documentation>
                     </xs:annotation>      
                 </xs:attribute>
@@ -224,7 +217,7 @@
                 <xs:attribute name="AcceptLanguage" type="xs:string" 
use="optional">
                     <xs:annotation>
                         <xs:documentation>
-                        What language the client desires (e.g., English, 
French, etc.)
+                        Specifies the language the client desires (e.g., 
English, French, etc.)
                         </xs:documentation>
                     </xs:annotation>      
                 </xs:attribute>
@@ -232,7 +225,7 @@
                 <xs:attribute name="AcceptEncoding" type="xs:string" 
use="optional">
                     <xs:annotation>
                         <xs:documentation>
-                        What encoding the client is prepared to handle (e.g., 
gzip)
+                        Specifies the encoding the client is prepared to 
handle (e.g., gzip)
                         </xs:documentation>
                     </xs:annotation>      
                 </xs:attribute>
@@ -240,7 +233,7 @@
                 <xs:attribute name="ContentType" type="xs:string" 
use="optional">
                     <xs:annotation>
                         <xs:documentation>
-                        The content type of the stream being sent in a post 
request 
+                        Specifies the content type of the stream being sent in 
a post request. 
                         (this should be text/xml for web services, or can be 
set to 
                         application/x-www-form-urlencoded if the client is 
sending form data).
                         </xs:documentation>
@@ -250,10 +243,10 @@
                 <xs:attribute name="Host" type="xs:string" use="optional">
                     <xs:annotation>
                         <xs:documentation>
-                        what host the client intends (for virtual servers 
mapping to same IP)
-                        This is sent by default based upon the URL.  Certain 
DNS scenarios or
+                        Specifies the Internet host and port number of the 
resource on which the request is being invoked.
+                        This is sent by default based upon the URL. Certain 
DNS scenarios or
                         application designs may request you to set this, but 
typically it is
-                        not required).
+                        not required.
                         </xs:documentation>
                     </xs:annotation>      
                 </xs:attribute>
@@ -261,13 +254,10 @@
                 <xs:attribute name="Connection" 
type="http-conf:connectionType" use="optional" default="Keep-Alive">
                     <xs:annotation>
                         <xs:documentation>
-                        The connection disposition.  If close the connection 
to the server is closed 
-                        after each request/response dialog; if Keep-Alive, the 
client requests the server 
+                        The connection disposition. If close the connection to 
the server is closed 
+                        after each request/response dialog. If Keep-Alive the 
client requests the server 
                         to keep the connection open, and if the server honors 
the keep alive request, 
-                        the connection is reused.  Many servers and proxies do 
not honor these requests.  
-                        Default is close.
-
-                        The server may choose not honor the keep alive request.
+                        the connection is reused. Many servers and proxies do 
not honor keep-alive requests.
                         </xs:documentation>
                     </xs:annotation>      
 
@@ -286,12 +276,10 @@
                 <xs:attribute name="Cookie" type="xs:string" use="optional">
                     <xs:annotation>
                         <xs:documentation>
-                        The cookie to send to the server
-                        
-                        some stateful session designs will use cookies to 
identify a session.
-                        If the cookie is static, you can supply it here.  If 
it is dynamic,
+                        Specifies a cookie to send to the server. Some 
stateful session designs will use cookies to identify a session.
+                        If the cookie is static, you can supply it here. If it 
is dynamic,
                         it will need to be set by the server on first access, 
and can be handled
-                        automatically by the runtime
+                        automatically by the runtime.
                         </xs:documentation>
                     </xs:annotation>      
                 </xs:attribute>
@@ -300,12 +288,9 @@
                     <xs:annotation>
                         <xs:documentation>
                         aka User-Agent
-                        
-                        some servers will optimize based upon the client 
sending the request.
-
-                        What to tell the server about what kind of browser we 
are (usually only 
+                        Specifies the type of browser is sending the request. 
This is usually only 
                         needed when sites have HTML customized to Netscape vs 
IE, etc, but can
-                        also be used to optimize for different SOAP stacks.)
+                        also be used to optimize for different SOAP stacks.
                         </xs:documentation>
                     </xs:annotation>      
                 </xs:attribute>
@@ -313,8 +298,7 @@
                 <xs:attribute name="Referer" type="xs:string" use="optional">
                     <xs:annotation>
                         <xs:documentation>
-                        What URL referred us to this URL
-                        
+                        Specifies the URL that referred us to this URL. This 
is 
                         sent automatically with auto redirect.
 
                         May allow the server to optimize processing based upon
@@ -327,8 +311,7 @@
                 <xs:attribute name="DecoupledEndpoint" type="xs:string" 
use="optional">
                     <xs:annotation>
                         <xs:documentation>
-                        Decoupled endpoint to accept incoming
-                       asynchronous responses.
+                        Specifies the URL of a decoupled endpoint for the 
receipt of responses over a separate provider-&gt;consumer connection.
                         </xs:documentation>
                     </xs:annotation>      
                 </xs:attribute>
@@ -337,23 +320,21 @@
                 <xs:attribute name="ProxyServer" type="xs:string" 
use="optional">
                     <xs:annotation>
                         <xs:documentation>
-                        Address of proxy server, if used 
-                        (proxy servers are a special kind of firewall)
-                             proxy.mycompany.com
+                        Specifies the address of proxy server if one is used.
                         </xs:documentation>
                     </xs:annotation>      
                 </xs:attribute>
                 <xs:attribute name="ProxyServerPort" type="xs:int" 
use="optional">
                     <xs:annotation>
                         <xs:documentation>
-                        Port number of proxy server.
+                        Specifies the port number used by the proxy server.
                         </xs:documentation>
                     </xs:annotation>      
                 </xs:attribute>
                 <xs:attribute name="ProxyServerType" 
type="http-conf:proxyServerType" use="optional" default="HTTP">
                     <xs:annotation>
                         <xs:documentation>
-                        Type of number of proxy server.
+                        Specifies the ype of the proxy server. Can be either 
HTTP or SOCKS.
                         </xs:documentation>
                     </xs:annotation>      
                 </xs:attribute>


Reply via email to