diff --git a/src/docbkx/client.xml b/src/docbkx/client.xml
index b088bfd2..a59e3e0b 100644
--- a/src/docbkx/client.xml
+++ b/src/docbkx/client.xml
@@ -44,21 +44,50 @@
messageSenders properties of the
WebServiceTemplate class.
-
- There are two implementations of the WebServiceMessageSender
- interface for sending messages via HTTP. The default implementation is the
- HttpUrlConnectionMessageSender, which uses the facilities provided
- by Java itself. The alternative is the CommonsHttpMessageSender,
- which uses the
- Jakarta Commons HttpClient.
- Use the latter if you need more advanced and easy-to-use functionality (such as authentication,
- HTTP connection pooling, and so forth).
-
+
+ HTTP transports
+
+ There are two implementations of the WebServiceMessageSender
+ interface for sending messages via HTTP. The default implementation is the
+ HttpUrlConnectionMessageSender, which uses the facilities provided
+ by Java itself. The alternative is the CommonsHttpMessageSender,
+ which uses the
+ Jakarta Commons HttpClient.
+ Use the latter if you need more advanced and easy-to-use functionality (such as authentication,
+ HTTP connection pooling, and so forth).
+
+
+ To use the HTTP transport, either set the defaultUri to something like
+ http://example.com/services, or supply the uri parameter
+ for one of the methods.
+
+
+
+ JMS transport
+
+ For sending messages over JMS, Spring Web Services provides the
+ JmsMessageSender. This class uses the facilities of the Spring framework
+ to transform the WebServiceMessage into a JMS
+ BytesMessages, send it on its way on a
+ Queue or Topic, and receive a
+ response (if any).
+
+
+ To use the JmsMessageSender, you need to set the
+ defaultUri or uri to a JMS URI, which - at a
+ minimum - consists of the jms: prefix and a destination name. Some examples of
+ JMS URIs are: jms:SomeQueue,
+ jms:SomeTopic?priority=3&deliveryMode=NON_PERSISTENT, and
+ jms:RequestQueue?replyToName=ResponseName.
+ For more information on this URI syntax, refer to the class level Javadocs of the
+ JmsMessageSender.
+
+ Message factories
- In addition to a message sender, the WebServiceTemplate requires a Web
+ In addition to a message sender, the WebServiceTemplate requires a Web
service message factory. There are two message factories for SOAP:
SaajSoapMessageFactory and AxiomSoapMessageFactory.
If no message factory is specified (via the 'messageFactory' property),