cxf-commits mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From ericjohn...@apache.org
Subject svn commit: r705340 - in /cxf/trunk/rt: bindings/xml/src/main/resources/schemas/wsdl/ transports/http-jetty/src/main/resources/schemas/configuration/ transports/http/src/main/resources/schemas/configuration/ transports/http/src/main/resources/schemas/w...
Date Thu, 16 Oct 2008 19:54:17 GMT
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>



Mime
View raw message