You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@qpid.apache.org by or...@apache.org on 2016/12/28 10:13:17 UTC

[04/49] qpid-site git commit: Update site for 6.0.6 release of Qpid for Java

http://git-wip-us.apache.org/repos/asf/qpid-site/blob/4ae9ccad/input/releases/qpid-java-6.0.6/jms-client-0-8/book/JMS-Client-0-8-Connection-URL.html.in
----------------------------------------------------------------------
diff --git a/input/releases/qpid-java-6.0.6/jms-client-0-8/book/JMS-Client-0-8-Connection-URL.html.in b/input/releases/qpid-java-6.0.6/jms-client-0-8/book/JMS-Client-0-8-Connection-URL.html.in
new file mode 100644
index 0000000..0115ef7
--- /dev/null
+++ b/input/releases/qpid-java-6.0.6/jms-client-0-8/book/JMS-Client-0-8-Connection-URL.html.in
@@ -0,0 +1,94 @@
+<div class="docbook"><div class="navheader"><table summary="Navigation header" width="100%"><tr><th align="center" colspan="3">Chapter&#160;7.&#160;Connection URLs</th></tr><tr><td align="left" width="20%"><a accesskey="p" href="JMS-Client-0-8-JNDI-Properties-Format-Destination.html">Prev</a>&#160;</td><th align="center" width="60%">&#160;</th><td align="right" width="20%">&#160;<a accesskey="n" href="JMS-Client-0-8-Binding-URL.html">Next</a></td></tr></table><hr /></div><div class="chapter"><div class="titlepage"><div><div><h1 class="title"><a id="JMS-Client-0-8-Connection-URL"></a>Chapter&#160;7.&#160;Connection URLs</h1></div></div></div><p> In JNDI properties, a Connection URL specifies options for a connection. The format for a
+		Connection URL is: </p><pre class="programlisting">amqp://[&lt;user&gt;:&lt;pass&gt;@][&lt;clientid&gt;]/[&lt;virtualhost&gt;][?&lt;option&gt;='&lt;value&gt;'[&amp;&lt;option&gt;='&lt;value&gt;']*]</pre><p> For instance, the following Connection URL specifies a user name, a password, a client
+		ID, a virtual host ("test"), a broker list with a single broker: a TCP host with the host
+		name <span class="quote">&#8220;<span class="quote">localhost</span>&#8221;</span> using port 5672: </p><pre class="programlisting">amqp://username:password@clientid/test?brokerlist='tcp://localhost:5672'</pre><div class="important" style="margin-left: 0.5in; margin-right: 0.5in;"><h3 class="title">Connection option quoting</h3><p>Take care with the quoting surrounding option values. Each option value
+				<span class="emphasis"><em>must</em></span> be surrounded with single quotes ('). </p></div><p>The Connection URL supports the following options:</p><div class="table"><a id="JMS-Client-0-8-Connection-URL-Options"></a><p class="title"><strong>Table&#160;7.1.&#160;Connection URL Options</strong></p><div class="table-contents"><table border="1" summary="Connection URL Options" width="100%"><colgroup><col /><col /><col /></colgroup><thead><tr><th> Option </th><th> Type </th><th> Description </th></tr></thead><tbody><tr><td><a id="JMS-Client-0-8-Connection-URL-ConnectionOptions-Brokerlist"></a> brokerlist </td><td> see below </td><td> List of one or more broker addresses. </td></tr><tr><td><a id="JMS-Client-0-8-Connection-URL-ConnectionOptions-Maxprefetch"></a> maxprefetch </td><td> integer </td><td>
+						<p> The maximum number of pre-fetched messages per Session. If not
+							specified, default value of 500 is used. </p>
+						<p> Note: You can also set the default per-session prefetch value on a
+							client-wide basis by configuring the client using <a class="link" href="JMS-Client-0-8-System-Properties.html" title="Chapter&#160;9.&#160;System Properties">Java system
+								properties.</a>
+						</p>
+					</td></tr><tr><td><a id="JMS-Client-0-8-Connection-URL-ConnectionOptions-SyncPublish"></a> sync_publish </td><td> String </td><td>
+					  <p>
+					    If the value is 'all' the client library waits for confirmation
+                        before returning from a send(), and if the send is unsuccessful the
+                        send() will throw a JMSException. (Note this option requires an
+                        extension to the AMQP protocol and will only work against a broker of
+                        the 0.32 release or later.)
+					  </p>
+					</td></tr><tr><td> sync_ack </td><td> Boolean </td><td> A sync command is sent after every acknowledgement to guarantee that it
+						has been received. </td></tr><tr><td><a id="JMS-Client-0-8-Connection-URL-ConnectionOptions-UseLegacyMap"></a> use_legacy_map_msg_format </td><td> Boolean </td><td> If you are using JMS Map messages and deploying a new client with any
+						JMS client older than 0.8 release, you must set this to true to ensure the
+						older clients can understand the map message encoding. </td></tr><tr><td><a id="JMS-Client-0-8-Connection-URL-ConnectionOptions-Failover"></a> failover </td><td> {'singlebroker' | 'roundrobin'
+						, | 'nofailover' |
+						'&lt;class&gt;'} </td><td>
+						<p> This option controls failover behaviour. The method
+								<code class="literal">singlebroker</code> uses only the first broker in the
+							list, <code class="literal">roundrobin</code> will try each broker given in the
+							broker list until a connection is established,
+								<code class="literal">nofailover</code>
+							disables all retry and failover logic. Any other value is interpreted as
+							a classname which must implement the
+								<code class="literal">org.apache.qpid.jms.failover.FailoverMethod</code>
+							interface. </p>
+						<p> The broker list options <code class="literal">retries</code> and
+								<code class="literal">connectdelay</code> (described below) determine the
+							number of times a connection to a broker will be retried and the
+							length of time to wait between successive connection attempts before
+							moving on to the next broker in the list. The failover option
+								<code class="literal">cyclecount</code> controls the number of times to loop
+							through the list of available brokers before finally giving up. </p>
+						<p> Defaults to <code class="literal">roundrobin</code> if the brokerlist contains
+							multiple brokers, or <code class="literal">singlebroker</code> otherwise. </p>
+					</td></tr><tr><td><a id="JMS-Client-0-8-Connection-URL-ConnectionOptions-CloseWhenNoRoute"></a> closeWhenNoRoute </td><td> boolean </td><td>
+						<p>See <a class="xref" href="JMS-Client-0-8-Client-Understanding-MessageProducer.html#JMS-Client-0-8-Client-Understanding-MessageProducer-CloseWhenNoRoute" title="5.5.2.&#160;Close When No Route">Section&#160;5.5.2, &#8220;Close When No Route&#8221;</a>.</p>
+					</td></tr><tr><td> ssl </td><td> boolean </td><td>
+						<p> If <code class="literal">ssl='true'</code>, use SSL for all broker connections.
+							Overrides any per-broker settings in the brokerlist (see below) entries.
+							If not specified, the brokerlist entry for each given broker is used to
+							determine whether SSL is used. </p>
+						<p> Introduced in version 0.22. </p>
+					</td></tr><tr><td><a id="JMS-Client-0-8-Connection-URL-ConnectionOptions-CompressMessages"></a>compressMessages</td><td>Boolean</td><td><p>Controls whether the client will compress messages before they they are sent.</p></td></tr><tr><td><a id="JMS-Client-0-8-Connection-URL-ConnectionOptions-MessageCompressionThresholdSize"></a>messageCompressionThresholdSize</td><td>Integer</td><td><p>The payload size beyond which the client will start to compress message payloads.</p></td></tr><tr><td><a id="JMS-Client-0-8-Connection-URL-ConnectionOptions-populateJMSXUserID"></a>populateJMSXUserID</td><td>boolean</td><td><p>Controls whether a MessageProducer will populate the JMSXUserID value for each sent message using the authenticated username from the connection.
+						It is set to true by default.</p></td></tr></tbody></table></div></div><br class="table-break" /><p> Broker lists are specified using a URL in this format: </p><pre class="programlisting">brokerlist='&lt;transport&gt;://&lt;host&gt;[:&lt;port&gt;][?&lt;param&gt;='&lt;value&gt;'[&amp;&lt;param&gt;='&lt;value&gt;']*]'</pre><p> For instance, this is a typical broker list: </p><pre class="programlisting">brokerlist='tcp://localhost:5672'</pre><p> A broker list can contain more than one broker address separated by semicolons (;). If so, the connection is made to
+		the first broker in the list that is available.
+		</p><div class="example"><a id="d0e1329"></a><p class="title"><strong>Example&#160;7.1.&#160;Broker Lists</strong></p><div class="example-contents"><p>A broker list can specify properties to be used when connecting to the broker. This
+			broker list specifies options for configuring heartbeating</p><pre class="programlisting">amqp://guest:guest@test/test?brokerlist='tcp://ip1:5672?heartbeat='5''</pre><p>This broker list specifies some SSL options</p><pre class="programlisting">amqp://guest:guest@test/test?brokerlist='tcp://ip1:5672?ssl='true'&amp;ssl_cert_alias='cert1''</pre><p> This broker list specifies two brokers using the connectdelay and retries broker
+			options. It also illustrates the failover connection URL property. </p><pre class="programlisting">amqp://guest:guest@/test?failover='roundrobin?cyclecount='2''
+	  &amp;brokerlist='tcp://ip1:5672?retries='5'&amp;connectdelay='2000';tcp://ip2:5672?retries='5'&amp;connectdelay='2000''
+	  </pre></div></div><br class="example-break" /><div class="important" style="margin-left: 0.5in; margin-right: 0.5in;"><h3 class="title">Broker option quoting</h3><p>Take care with the quoting surrounding broker option values. Each broker option value
+				<span class="emphasis"><em>must</em></span> be surrounded with their own single quotes ('). This is in
+			addition to the quotes surround the connection option value.</p></div><p>The following broker list options are supported.</p><div class="table"><a id="d0e1354"></a><p class="title"><strong>Table&#160;7.2.&#160;Broker List Options</strong></p><div class="table-contents"><table border="1" summary="Broker List Options" width="100%"><colgroup><col /><col /><col /></colgroup><thead><tr><th> Option </th><th> Type </th><th> Description </th></tr></thead><tbody><tr><td><a id="JMS-Client-0-8-Connection-URL-BrokerOptions-Heartbeat"></a> heartbeat </td><td> Long </td><td> Frequency of heartbeat messages (in seconds). A value of 0 disables
+						heartbeating. <p>For compatibility with old client configuration, option
+								<code class="varname">idle_timeout</code> (in milliseconds) is also
+							supported.</p>
+					</td></tr><tr><td> ssl </td><td> Boolean </td><td>
+						<p>If <code class="literal">ssl='true'</code>, the JMS client will encrypt the
+							connection to this broker using SSL.</p>
+						<p>This can also be set/overridden for all brokers using the Connection
+							URL option <code class="literal">ssl</code>.</p>
+					</td></tr><tr><td><a id="JMS-Client-0-8-Connection-URL-BrokerOptions-TrustStore"></a> trust_store </td><td> String </td><td> Path to trust store. Used when using SSL and the Broker's certificate is
+						signed by a private-CA (or a self-signed certificate),</td></tr><tr><td><a id="JMS-Client-0-8-Connection-URL-BrokerOptions-TrustStorePassword"></a> trust_store_password </td><td> String </td><td> Trust store password. Password used to open the trust store. </td></tr><tr><td><a id="JMS-Client-0-8-Connection-URL-BrokerOptions-TrustedCertsPath"></a> trusted_certs_path </td><td> String </td><td> Path to a file containing trusted peer certificates(in PEM or DER format).
+                                                Used when supplying the trust information for TLS client auth using PEM/DER
+                                                files rather than a Java KeyStore. </td></tr><tr><td><a id="JMS-Client-0-8-Connection-URL-BrokerOptions-KeyStore"></a> key_store </td><td> String </td><td> Path to key store . Used when using SSL and the client must authenticate
+						using client-auth. If the store contains more than one certificate,
+							<code class="literal">ssl_cert_alias</code> must be used to identify the
+						certificate that the client must present to the Broker.</td></tr><tr><td><a id="JMS-Client-0-8-Connection-URL-BrokerOptions-KeyStorePassword"></a> key_store_password </td><td> String </td><td> Key store password. Password used to open the key store. </td></tr><tr><td><a id="JMS-Client-0-8-Connection-URL-BrokerOptions-ClientCertPath"></a> client_cert_path </td><td> String </td><td> Path to the client certificate file (in PEM or DER format). Used as an
+                                                alternative to using a Java KeyStore to hold key information
+                                                for TLS client auth. When used, the <code class="literal">client_cert_priv_key_path</code>
+                                                must also be supplied. </td></tr><tr><td><a id="JMS-Client-0-8-Connection-URL-BrokerOptions-ClientCertPrivKeyPath"></a> client_cert_priv_key_path </td><td> String </td><td> Path to the client certificate private key file (in PEM or DER format).
+                                                Used when supplying the key information for TLS client auth using PEM/DER
+                                                files rather than a Java KeyStore. </td></tr><tr><td><a id="JMS-Client-0-8-Connection-URL-BrokerOptions-ClientCertsIntermediaryCertPath"></a> client_cert_intermediary_cert_path </td><td> String </td><td> Path to a file containing any intermediary certificates (in PEM or DER format).
+                                                Used when supplying the key information for TLS client auth using PEM/DER
+                                                files rather than a Java KeyStore. Only required where intermediary certificates
+                                                are required in the certificate chain. </td></tr><tr><td><a id="JMS-Client-0-8-Connection-URL-BrokerOptions-SslCertAlias"></a> ssl_cert_alias </td><td> String </td><td> If multiple certificates are present in the keystore, the alias will be
+						used to extract the correct certificate. </td></tr><tr><td> ssl_verify_hostname </td><td> Boolean </td><td> This option is used for turning on/off hostname verification when using SSL.
+                        It is set to 'true' by default. You can disable verification by setting it to 'false':
+							<code class="literal">ssl_verify_hostname='false'</code>.
+					</td></tr><tr><td><a id="JMS-Client-0-8-Connection-URL-BrokerOptions-Retries"></a> retries </td><td> Integer </td><td> The number of times to retry connection to each broker in the broker
+						list. Defaults to 1. </td></tr><tr><td><a id="JMS-Client-0-8-Connection-URL-BrokerOptions-ConnectDelay"></a> connectdelay </td><td> integer </td><td> Length of time (in milliseconds) to wait before attempting to reconnect.
+						Defaults to 0. </td></tr><tr><td><a id="JMS-Client-0-8-Connection-URL-BrokerOptions-ConnectTimeout"></a> connecttimeout </td><td> integer </td><td> Length of time (in milliseconds) to wait for the socket connection to
+						succeed. A value of 0 represents an infinite timeout, i.e. the connection
+						attempt will block until established or an error occurs. Defaults to 30000.
+					</td></tr><tr><td><a id="JMS-Client-0-8-Connection-URL-BrokerOptions-TcpNoDelay"></a> tcp_nodelay </td><td> Boolean </td><td> If <code class="literal">tcp_nodelay='true'</code>, TCP packet batching is
+						disabled. Defaults to true since Qpid 0.14. </td></tr></tbody></table></div></div><br class="table-break" /></div><div class="navfooter"><hr /><table summary="Navigation footer" width="100%"><tr><td align="left" width="40%"><a accesskey="p" href="JMS-Client-0-8-JNDI-Properties-Format-Destination.html">Prev</a>&#160;</td><td align="center" width="20%">&#160;</td><td align="right" width="40%">&#160;<a accesskey="n" href="JMS-Client-0-8-Binding-URL.html">Next</a></td></tr><tr><td align="left" valign="top" width="40%">6.4.&#160;Destination&#160;</td><td align="center" width="20%"><a accesskey="h" href="JMS-Client-Book.html">Home</a></td><td align="right" valign="top" width="40%">&#160;Chapter&#160;8.&#160;Binding URL</td></tr></table></div></div>
\ No newline at end of file

http://git-wip-us.apache.org/repos/asf/qpid-site/blob/4ae9ccad/input/releases/qpid-java-6.0.6/jms-client-0-8/book/JMS-Client-0-8-Document-Scope-And-Intended-Audience.html.in
----------------------------------------------------------------------
diff --git a/input/releases/qpid-java-6.0.6/jms-client-0-8/book/JMS-Client-0-8-Document-Scope-And-Intended-Audience.html.in b/input/releases/qpid-java-6.0.6/jms-client-0-8/book/JMS-Client-0-8-Document-Scope-And-Intended-Audience.html.in
new file mode 100644
index 0000000..a5f024b
--- /dev/null
+++ b/input/releases/qpid-java-6.0.6/jms-client-0-8/book/JMS-Client-0-8-Document-Scope-And-Intended-Audience.html.in
@@ -0,0 +1,18 @@
+<div class="docbook"><div class="navheader"><table summary="Navigation header" width="100%"><tr><th align="center" colspan="3">Chapter&#160;2.&#160;Document Scope And Intended Audience</th></tr><tr><td align="left" width="20%"><a accesskey="p" href="JMS-Client-0-8-Introduction.html">Prev</a>&#160;</td><th align="center" width="60%">&#160;</th><td align="right" width="20%">&#160;<a accesskey="n" href="JMS-Client-0-8-JMS-Getting-And-Dependencies.html">Next</a></td></tr></table><hr /></div><div class="chapter"><div class="titlepage"><div><div><h1 class="title"><a id="JMS-Client-0-8-Document-Scope-And-Intended-Audience"></a>Chapter&#160;2.&#160;Document Scope And Intended Audience</h1></div></div></div><p> The intended audience of this document is Java developers who are familiar with the JMS
+    specification. Readers are not required to know all the details of AMQP protocols. However, some
+    knowledge of AMQP basic concepts would be advantageous for reading of this document. </p><p> This document only covers the usage of 0-8, 0-9 and 0-9-1 AMQP protocols with Apache Qpid JMS
+    client for AMQP 0-9-1/0-10. The specifications for these protocols are available from the
+    <a class="link" href="http://www.amqp.org" target="_top">AMQP web site</a>. </p><p> The document covers some specific implementation details of JMS connections, sessions,
+    consumers and producers in <a class="xref" href="JMS-Client-0-8-Client-Understanding.html" title="Chapter&#160;5.&#160;Understanding the Client">Chapter&#160;5, <em>Understanding the Client</em></a>. It also
+    demonstrates how to write a simple point to point and simple publish/subscribe application using
+    the Client in <a class="xref" href="JMS-Client-0-8-Examples.html" title="Chapter&#160;4.&#160;Examples">Chapter&#160;4, <em>Examples</em></a>. </p><p>The Client supports various configuration options which can be set via JVM system
+    properties, connection URLs and JNDI configuration file. The setting of system properties is
+    described in <a class="xref" href="JMS-Client-0-8-System-Properties.html" title="Chapter&#160;9.&#160;System Properties">Chapter&#160;9, <em>System Properties</em></a>. The details of supported
+    options within the connection URLs are given in <a class="xref" href="JMS-Client-0-8-Connection-URL.html" title="Chapter&#160;7.&#160;Connection URLs">Chapter&#160;7, <em>Connection URLs</em></a>.
+    The details of JNDI properties format for the Apache Qpid JMS client for AMQP 0-9-1/0-10 is provided in
+    <a class="xref" href="JMS-Client-0-8-JNDI-Properties-Format.html" title="Chapter&#160;6.&#160;JNDI Properties Format">Chapter&#160;6, <em>JNDI Properties Format</em></a>. The Qpid destination URL format is covered
+    in <a class="xref" href="JMS-Client-0-8-Binding-URL.html" title="Chapter&#160;8.&#160;Binding URL">Chapter&#160;8, <em>Binding URL</em></a>. </p><p>The Client can be used for writing of JMS vendor neutral messaging applications.
+    However, in some cases it might be required to use specific AMQP features. Thus, the Client
+    provides the extended operation set to invoke those features. </p><p>
+    <a class="xref" href="JMS-Client-0-8-Logging.html" title="Chapter&#160;10.&#160;Logging">Chapter&#160;10, <em>Logging</em></a> provides the details about turning on client logging
+    which can help in debugging of various issues while developing the messaging applications. </p><p>The details about Client Exceptions are provided in <a class="xref" href="JMS-Client-0-8-Appendix-Exceptions.html" title="Appendix&#160;A.&#160;Exceptions">Appendix&#160;A, <em>Exceptions</em></a></p></div><div class="navfooter"><hr /><table summary="Navigation footer" width="100%"><tr><td align="left" width="40%"><a accesskey="p" href="JMS-Client-0-8-Introduction.html">Prev</a>&#160;</td><td align="center" width="20%">&#160;</td><td align="right" width="40%">&#160;<a accesskey="n" href="JMS-Client-0-8-JMS-Getting-And-Dependencies.html">Next</a></td></tr><tr><td align="left" valign="top" width="40%">Chapter&#160;1.&#160;Introduction&#160;</td><td align="center" width="20%"><a accesskey="h" href="JMS-Client-Book.html">Home</a></td><td align="right" valign="top" width="40%">&#160;Chapter&#160;3.&#160;Getting the Client And Dependencies</td></tr></table></div></div>
\ No newline at end of file

http://git-wip-us.apache.org/repos/asf/qpid-site/blob/4ae9ccad/input/releases/qpid-java-6.0.6/jms-client-0-8/book/JMS-Client-0-8-Examples-PubSub.html.in
----------------------------------------------------------------------
diff --git a/input/releases/qpid-java-6.0.6/jms-client-0-8/book/JMS-Client-0-8-Examples-PubSub.html.in b/input/releases/qpid-java-6.0.6/jms-client-0-8/book/JMS-Client-0-8-Examples-PubSub.html.in
new file mode 100644
index 0000000..a2233a1
--- /dev/null
+++ b/input/releases/qpid-java-6.0.6/jms-client-0-8/book/JMS-Client-0-8-Examples-PubSub.html.in
@@ -0,0 +1,73 @@
+<div class="docbook"><div class="navheader"><table summary="Navigation header" width="100%"><tr><th align="center" colspan="3">4.2.&#160;Publish/subscribe example</th></tr><tr><td align="left" width="20%"><a accesskey="p" href="JMS-Client-0-8-Examples.html">Prev</a>&#160;</td><th align="center" width="60%">Chapter&#160;4.&#160;Examples</th><td align="right" width="20%">&#160;<a accesskey="n" href="JMS-Client-0-8-Client-Understanding.html">Next</a></td></tr></table><hr /></div><div class="section"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a id="JMS-Client-0-8-Examples-PubSub"></a>4.2.&#160;Publish/subscribe example</h2></div></div></div><p>In this second example, we illustrate publish/subscribe messaging. Again, we create a
+			JNDI context using a properties file, use the context to lookup a connection factory,
+			create and start a connection, create a session, and lookup a destination (a topic) from
+			the JNDI context. Then we create a producer and two durable subscribers , send a message
+			with the producer. Both subscribers receive the same message.</p><div class="example"><a id="JMS-Client-0-8-Examples-PubSub-Java"></a><p class="title"><strong>Example&#160;4.3.&#160;JMS Example - Publish/subscribe Messaging</strong></p><div class="example-contents"><pre class="programlisting">
+import javax.jms.*;
+import javax.naming.Context;
+import javax.naming.InitialContext;
+
+import java.util.Properties;
+
+public class StocksExample {
+
+    public StocksExample() {
+    }
+
+    public static void main(String[] args) throws Exception {
+      StocksExample stocks = new StocksExample();
+      stocks.runTest();
+    }
+
+    private void runTest() throws Exception {
+      Properties properties = new Properties();
+      properties.load(this.getClass().getResourceAsStream("stocks.properties"));
+      Context context = new InitialContext(properties);
+
+      ConnectionFactory connectionFactory
+          = (ConnectionFactory) context.lookup("qpidConnectionFactory");
+      Connection connection = connectionFactory.createConnection();
+      connection.start();
+
+      Session session = connection.createSession(true, Session.SESSION_TRANSACTED);
+      Topic priceTopic = (Topic) context.lookup("myprices");                             <a class="co" href="JMS-Client-0-8-Examples-PubSub.html#callout-pubsub-destination" id="pubsub-java-destination"><span><img alt="1" border="0" src="images/callouts/1.png" /></span></a>
+
+      MessageConsumer subscriber1 = session.createDurableSubscriber(priceTopic, "sub1"); <a class="co" href="JMS-Client-0-8-Examples-PubSub.html#callout-pubsub-subscribers" id="pubsub-java-subscribers"><span><img alt="2" border="0" src="images/callouts/2.png" /></span></a>
+      MessageConsumer subscriber2 = session.createDurableSubscriber(priceTopic, "sub2" /*, "price &gt; 150", false*/ );
+      MessageProducer messageProducer = session.createProducer(priceTopic);
+
+      Message message = session.createMessage();
+      message.setStringProperty("instrument", "IBM");
+      message.setIntProperty("price", 100);
+      messageProducer.send(message);
+      session.commit();
+
+      message = subscriber1.receive(1000);
+      session.commit();
+      System.out.println("Subscriber 1 received : " + message);
+
+      message = subscriber2.receive(1000);
+      session.commit();
+      System.out.println("Subscriber 2 received : " + message);
+
+      session.unsubscribe("sub1");                                                       <a class="co" href="JMS-Client-0-8-Examples-PubSub.html#callout-pubsub-unsubscribe" id="pubsub-java-unsubscribe"><span><img alt="3" border="0" src="images/callouts/3.png" /></span></a>
+      session.unsubscribe("sub2");
+      connection.close();
+      context.close();
+    }
+}
+	</pre></div></div><br class="example-break" /><div class="calloutlist"><table border="0" summary="Callout list"><tr><td align="left" valign="top" width="5%"><p><a id="callout-pubsub-destination"></a><a href="#pubsub-java-destination"><span><img alt="1" border="0" src="images/callouts/1.png" /></span></a> </p></td><td align="left" valign="top"><p>Looks up a destination for the topic with JNDI name myprices.</p></td></tr><tr><td align="left" valign="top" width="5%"><p><a id="callout-pubsub-subscribers"></a><a href="#pubsub-java-subscribers"><span><img alt="2" border="0" src="images/callouts/2.png" /></span></a> </p></td><td align="left" valign="top"><p>Creates two durable subscribers, <code class="literal">sub1</code> and
+						<code class="literal">sub2</code>. Durable subscriptions retain messages for the
+					client even when the client is disconnected, until the subscription is
+					unsubscribed. Subscription 2 has a (commented out) message selector argument so
+					you can conveniently experiement with the effect of those. <a class="footnote" href="#ftn.d0e277" id="d0e277"><sup class="footnote">[2]</sup></a></p></td></tr><tr><td align="left" valign="top" width="5%"><p><a id="callout-pubsub-unsubscribe"></a><a href="#pubsub-java-unsubscribe"><span><img alt="3" border="0" src="images/callouts/3.png" /></span></a> </p></td><td align="left" valign="top"><p>Unsubscribes the two durable subscribers, permanently removing the knowledge
+					of the subscriptions from the system. An application would normally
+						<span class="emphasis"><em>NOT</em></span> do this. The typical use-case for durable
+					subsciption is one where the subscription exists over an extended period of
+					time.</p></td></tr></table></div><p>The contents of the <code class="literal">stocks.properties</code> file are shown below.</p><div class="example"><a id="JMS-Client-0-8-Examples-PubSub-PropertiesFile"></a><p class="title"><strong>Example&#160;4.4.&#160;JMS Example - Publish/subscribe Messaging - JNDI Properties</strong></p><div class="example-contents"><pre class="programlisting">
+java.naming.factory.initial = org.apache.qpid.jndi.PropertiesFileInitialContextFactory
+connectionfactory.qpidConnectionFactory = amqp://guest:guest@clientid/?brokerlist='tcp://localhost:5672'
+topic.myprices = prices <a class="co" href="JMS-Client-0-8-Examples-PubSub.html#callout-pubsub-properties-destination" id="pubsub-properties-destination"><span><img alt="1" border="0" src="images/callouts/1.png" /></span></a>
+	</pre></div></div><br class="example-break" /><div class="calloutlist"><table border="0" summary="Callout list"><tr><td align="left" valign="top" width="5%"><p><a id="callout-pubsub-properties-destination"></a><a href="#pubsub-properties-destination"><span><img alt="1" border="0" src="images/callouts/1.png" /></span></a> </p></td><td align="left" valign="top"><p>Defines a topic for which MessageProducers and/or MessageConsumers send and
+					receive messages. The format of this entry is described in <a class="xref" href="JMS-Client-0-8-JNDI-Properties-Format-Topic.html" title="6.3.&#160;Topic">Section&#160;6.3, &#8220;Topic&#8221;</a>.</p></td></tr></table></div><div class="footnotes"><br /><hr style="width:100; text-align:left;margin-left: 0" /><div class="footnote" id="ftn.d0e277"><p><a class="para" href="#d0e277"><sup class="para">[2] </sup></a>Each durable subscription is implemented as a queue on the Broker. See
+								<a class="xref" href="JMS-Client-0-8-Client-Understanding-MessageConsumer.html#JMS-Client-0-8-Client-Understanding-MessageConsumer-TopicSubscriptions" title="5.6.2.&#160;Topic Subscriptions">Section&#160;5.6.2, &#8220;Topic Subscriptions&#8221;</a> for details.</p></div></div></div><div class="navfooter"><hr /><table summary="Navigation footer" width="100%"><tr><td align="left" width="40%"><a accesskey="p" href="JMS-Client-0-8-Examples.html">Prev</a>&#160;</td><td align="center" width="20%"><a accesskey="u" href="JMS-Client-0-8-Examples.html">Up</a></td><td align="right" width="40%">&#160;<a accesskey="n" href="JMS-Client-0-8-Client-Understanding.html">Next</a></td></tr><tr><td align="left" valign="top" width="40%">Chapter&#160;4.&#160;Examples&#160;</td><td align="center" width="20%"><a accesskey="h" href="JMS-Client-Book.html">Home</a></td><td align="right" valign="top" width="40%">&#160;Chapter&#160;5.&#160;Understanding the Client</td></tr></table></div></div>
\ No newline at end of file

http://git-wip-us.apache.org/repos/asf/qpid-site/blob/4ae9ccad/input/releases/qpid-java-6.0.6/jms-client-0-8/book/JMS-Client-0-8-Examples.html.in
----------------------------------------------------------------------
diff --git a/input/releases/qpid-java-6.0.6/jms-client-0-8/book/JMS-Client-0-8-Examples.html.in b/input/releases/qpid-java-6.0.6/jms-client-0-8/book/JMS-Client-0-8-Examples.html.in
new file mode 100644
index 0000000..d642529
--- /dev/null
+++ b/input/releases/qpid-java-6.0.6/jms-client-0-8/book/JMS-Client-0-8-Examples.html.in
@@ -0,0 +1,75 @@
+<div class="docbook"><div class="navheader"><table summary="Navigation header" width="100%"><tr><th align="center" colspan="3">Chapter&#160;4.&#160;Examples</th></tr><tr><td align="left" width="20%"><a accesskey="p" href="JMS-Client-0-8-JMS-Getting-And-Dependencies-Dependencies.html">Prev</a>&#160;</td><th align="center" width="60%">&#160;</th><td align="right" width="20%">&#160;<a accesskey="n" href="JMS-Client-0-8-Examples-PubSub.html">Next</a></td></tr></table><hr /></div><div class="chapter"><div class="titlepage"><div><div><h1 class="title"><a id="JMS-Client-0-8-Examples"></a>Chapter&#160;4.&#160;Examples</h1></div></div></div><div class="toc"><p><strong>Table of Contents</strong></p><dl class="toc"><dt><span class="section"><a href="JMS-Client-0-8-Examples.html#JMS-Client-0-8-Examples-PTP">4.1. Point to point example</a></span></dt><dt><span class="section"><a href="JMS-Client-0-8-Examples-PubSub.html">4.2. Publish/subscribe example</a></span></dt></dl></div><p>The following p
 rograms shows how to send and receive messages using the Client.
+		The first program illustrates a <span class="emphasis"><em>point to point</em></span> example, the second, a
+		pubish/subscribe example. </p><p>Both examples show the use JNDI to obtain connection factory and destination objects which
+		the application needs. In this way the configuration is kept separate from the application
+		code itself.</p><p>The example code will be straightforward for anyone familiar with JMS. Readers in
+		need of an introduction are directed towards <a class="link" href="http://docs.oracle.com/javaee/6/tutorial/doc/bncdq.html" target="_top">Oracle's JMS
+			tutorial</a>.</p><div class="section"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a id="JMS-Client-0-8-Examples-PTP"></a>4.1.&#160;Point to point example</h2></div></div></div><p>In this example, we illustrate point to point messaging. We create a JNDI context
+			using a properties file, use the context to lookup a connection factory, create and
+			start a connection, create a session, and lookup a destination (a queue) from the JNDI
+			context. Then we create a producer and a consumer, send a message with the producer and
+			receive it with the consumer.</p><div class="example"><a id="JMS-Client-0-8-Examples-PTP-Java"></a><p class="title"><strong>Example&#160;4.1.&#160;JMS Example - Point to Point Messaging</strong></p><div class="example-contents"><pre class="programlisting">
+import javax.jms.*;
+import javax.naming.Context;
+import javax.naming.InitialContext;
+import java.util.Properties;
+
+public class Hello {
+
+    public Hello() {
+    }
+
+    public static void main(String[] args) throws Exception {
+        Hello hello = new Hello();
+        hello.runTest();
+    }
+
+    private void runTest() throws Exception {
+      Properties properties = new Properties();
+      properties.load(this.getClass().getResourceAsStream("helloworld.properties"));  <a class="co" href="JMS-Client-0-8-Examples.html#callout-ptp-properties" id="ptp-java-properties"><span><img alt="1" border="0" src="images/callouts/1.png" /></span></a>
+      Context context = new InitialContext(properties);                               <a class="co" href="JMS-Client-0-8-Examples.html#callout-ptp-context" id="ptp-java-context"><span><img alt="2" border="0" src="images/callouts/2.png" /></span></a>
+
+      ConnectionFactory connectionFactory
+          = (ConnectionFactory) context.lookup("qpidConnectionFactory");              <a class="co" href="JMS-Client-0-8-Examples.html#callout-ptp-connection-factory" id="ptp-java-connection-factory"><span><img alt="3" border="0" src="images/callouts/3.png" /></span></a>
+      Connection connection = connectionFactory.createConnection();                   <a class="co" href="JMS-Client-0-8-Examples.html#callout-ptp-connection" id="ptp-java-connection"><span><img alt="4" border="0" src="images/callouts/4.png" /></span></a>
+      connection.start();                                                             <a class="co" href="JMS-Client-0-8-Examples.html#callout-ptp-start" id="ptp-java-start"><span><img alt="5" border="0" src="images/callouts/5.png" /></span></a>
+
+      Session session = connection.createSession(true, Session.SESSION_TRANSACTED);   <a class="co" href="JMS-Client-0-8-Examples.html#callout-ptp-session" id="ptp-java-session"><span><img alt="6" border="0" src="images/callouts/6.png" /></span></a>
+      Queue queue = (Queue) context.lookup("myqueue");                                <a class="co" href="JMS-Client-0-8-Examples.html#callout-ptp-destination" id="ptp-java-destination"><span><img alt="7" border="0" src="images/callouts/7.png" /></span></a>
+
+      MessageConsumer messageConsumer = session.createConsumer(queue);                <a class="co" href="JMS-Client-0-8-Examples.html#callout-ptp-consumer" id="ptp-java-consumer"><span><img alt="8" border="0" src="images/callouts/8.png" /></span></a>
+      MessageProducer messageProducer = session.createProducer(queue);                <a class="co" href="JMS-Client-0-8-Examples.html#callout-ptp-producer" id="ptp-java-producer"><span><img alt="9" border="0" src="images/callouts/9.png" /></span></a>
+
+      TextMessage message = session.createTextMessage("Hello world!");                <a class="co" href="JMS-Client-0-8-Examples.html#callout-ptp-send" id="ptp-java-send"><span><img alt="10" border="0" src="images/callouts/10.png" /></span></a>
+      messageProducer.send(message);
+      session.commit();
+
+      message = (TextMessage)messageConsumer.receive();                               <a class="co" href="JMS-Client-0-8-Examples.html#callout-ptp-receive" id="ptp-java-receive"><span><img alt="11" border="0" src="images/callouts/11.png" /></span></a>
+      session.commit();
+      System.out.println(message.getText());
+
+      connection.close();                                                             <a class="co" href="JMS-Client-0-8-Examples.html#callout-ptp-close" id="ptp-java-close"><span><img alt="12" border="0" src="images/callouts/12.png" /></span></a>
+      context.close();                                                                <a class="co" href="JMS-Client-0-8-Examples.html#callout-ptp-jndi-close" id="ptp-java-jndi-close"><span><img alt="13" border="0" src="images/callouts/13.png" /></span></a>
+    }
+}
+	</pre></div></div><br class="example-break" /><div class="calloutlist"><table border="0" summary="Callout list"><tr><td align="left" valign="top" width="5%"><p><a id="callout-ptp-properties"></a><a href="#ptp-java-properties"><span><img alt="1" border="0" src="images/callouts/1.png" /></span></a> </p></td><td align="left" valign="top"><p>Loads the JNDI properties file, which specifies the connection factory, queues
+					and topics. See <a class="xref" href="JMS-Client-0-8-JNDI-Properties-Format.html" title="Chapter&#160;6.&#160;JNDI Properties Format">Chapter&#160;6, <em>JNDI Properties Format</em></a> for
+					details.</p></td></tr><tr><td align="left" valign="top" width="5%"><p><a id="callout-ptp-context"></a><a href="#ptp-java-context"><span><img alt="2" border="0" src="images/callouts/2.png" /></span></a> </p></td><td align="left" valign="top"><p>Creates the JNDI initial context.</p></td></tr><tr><td align="left" valign="top" width="5%"><p><a id="callout-ptp-connection-factory"></a><a href="#ptp-java-connection-factory"><span><img alt="3" border="0" src="images/callouts/3.png" /></span></a> </p></td><td align="left" valign="top"><p>Looks up a JMS connection factory for Qpid.</p></td></tr><tr><td align="left" valign="top" width="5%"><p><a id="callout-ptp-connection"></a><a href="#ptp-java-connection"><span><img alt="4" border="0" src="images/callouts/4.png" /></span></a> </p></td><td align="left" valign="top"><p>Creates a JMS connection. Creating the JMS connections establishes the
+					connection to the Broker.</p></td></tr><tr><td align="left" valign="top" width="5%"><p><a id="callout-ptp-start"></a><a href="#ptp-java-start"><span><img alt="5" border="0" src="images/callouts/5.png" /></span></a> </p></td><td align="left" valign="top"><p>Starts the connection, required for the consumption of messages.</p></td></tr><tr><td align="left" valign="top" width="5%"><p><a id="callout-ptp-session"></a><a href="#ptp-java-session"><span><img alt="6" border="0" src="images/callouts/6.png" /></span></a> </p></td><td align="left" valign="top"><p>Creates a transactional session.</p></td></tr><tr><td align="left" valign="top" width="5%"><p><a id="callout-ptp-destination"></a><a href="#ptp-java-destination"><span><img alt="7" border="0" src="images/callouts/7.png" /></span></a> </p></td><td align="left" valign="top"><p>Looks up a destination for the queue with JNDI name <span class="emphasis"><em>myqueue</em></span>.</p></td></tr><tr><td align="left" valign="top" width="5%"><
 p><a id="callout-ptp-consumer"></a><a href="#ptp-java-consumer"><span><img alt="8" border="0" src="images/callouts/8.png" /></span></a> </p></td><td align="left" valign="top"><p>Creates a consumer that reads messages from the queue<a class="footnote" href="#ftn.d0e191" id="d0e191"><sup class="footnote">[1]</sup></a>.</p></td></tr><tr><td align="left" valign="top" width="5%"><p><a id="callout-ptp-producer"></a><a href="#ptp-java-producer"><span><img alt="9" border="0" src="images/callouts/9.png" /></span></a> </p></td><td align="left" valign="top"><p>Creates a producer that sends messages to the queue.</p></td></tr><tr><td align="left" valign="top" width="5%"><p><a id="callout-ptp-send"></a><a href="#ptp-java-send"><span><img alt="10" border="0" src="images/callouts/10.png" /></span></a> </p></td><td align="left" valign="top"><p>Creates a new message of type <span class="emphasis"><em>javax.jms.TextMessage</em></span>, publishes the message and commits the
+					session.</p></td></tr><tr><td align="left" valign="top" width="5%"><p><a id="callout-ptp-receive"></a><a href="#ptp-java-receive"><span><img alt="11" border="0" src="images/callouts/11.png" /></span></a> </p></td><td align="left" valign="top"><p>Reads the next available message (awaiting indefinitely if necessary) and
+					commits the session.</p></td></tr><tr><td align="left" valign="top" width="5%"><p><a id="callout-ptp-close"></a><a href="#ptp-java-close"><span><img alt="12" border="0" src="images/callouts/12.png" /></span></a> </p></td><td align="left" valign="top"><p>Closes the Connection. All sessions owned by the Connection along with their
+					MessageConsumers and MessageProducers are automatically closed. The connection
+					to the Broker is closed as this point.</p></td></tr><tr><td align="left" valign="top" width="5%"><p><a id="callout-ptp-jndi-close"></a><a href="#ptp-java-jndi-close"><span><img alt="13" border="0" src="images/callouts/13.png" /></span></a> </p></td><td align="left" valign="top"><p>Closes the JNDI context.</p></td></tr></table></div><p>The contents of the <code class="literal">helloworld.properties</code> file are shown
+			below.</p><div class="example"><a id="JMS-Client-0-8-Examples-PTP-PropertiesFile"></a><p class="title"><strong>Example&#160;4.2.&#160;JMS Example - Point to Point Messaging - JNDI Properties</strong></p><div class="example-contents"><pre class="programlisting">
+java.naming.factory.initial = org.apache.qpid.jndi.PropertiesFileInitialContextFactory
+connectionfactory.qpidConnectionFactory = amqp://guest:guest@clientid/?brokerlist='tcp://localhost:5672' <a class="co" href="JMS-Client-0-8-Examples.html#callout-ptp-properties-connectionfactory" id="ptp-properties-connectionfactory"><span><img alt="1" border="0" src="images/callouts/1.png" /></span></a>
+queue.myqueue = queue1                                                                                   <a class="co" href="JMS-Client-0-8-Examples.html#callout-ptp-properties-destination" id="ptp-properties-destination"><span><img alt="2" border="0" src="images/callouts/2.png" /></span></a>
+	</pre></div></div><br class="example-break" /><div class="calloutlist"><table border="0" summary="Callout list"><tr><td align="left" valign="top" width="5%"><p><a id="callout-ptp-properties-connectionfactory"></a><a href="#ptp-properties-connectionfactory"><span><img alt="1" border="0" src="images/callouts/1.png" /></span></a> </p></td><td align="left" valign="top"><p>Defines a connection factory from which Connections can be created. The syntax
+					of a ConnectionURL is given in <a class="xref" href="JMS-Client-0-8-Connection-URL.html" title="Chapter&#160;7.&#160;Connection URLs">Chapter&#160;7, <em>Connection URLs</em></a>.</p></td></tr><tr><td align="left" valign="top" width="5%"><p><a id="callout-ptp-properties-destination"></a><a href="#ptp-properties-destination"><span><img alt="2" border="0" src="images/callouts/2.png" /></span></a> </p></td><td align="left" valign="top"><p>Defines a queue for which MessageProducers and/or MessageConsumers send and
+					receive messages. The format of these entries is described in <a class="xref" href="JMS-Client-0-8-JNDI-Properties-Format-Queue.html" title="6.2.&#160;Queue">Section&#160;6.2, &#8220;Queue&#8221;</a>.</p></td></tr></table></div></div><div class="footnotes"><br /><hr style="width:100; text-align:left;margin-left: 0" /><div class="footnote" id="ftn.d0e191"><p><a class="para" href="#d0e191"><sup class="para">[1] </sup></a>Creating consumer will automatically create the queue on the Broker
+							and bind it to an exchange. Specifically, in this case as the
+								<code class="literal">queue.</code> form is used in the JNDI properties the
+							effect will be to create a queue called <code class="literal">queue1</code> on the
+							Broker, and create a binding between the <code class="literal">amq.direct</code>
+							exchange and this queue using the queue's name. This process is
+							described in detail in <a class="xref" href="JMS-Client-0-8-Client-Understanding-MessageConsumer.html#JMS-Client-0-8-Client-Understanding-MessageConsumer-ConsumerSideEffect" title="5.6.1.&#160;Consumers have Exchange/Queue Declaration and Binding Side Effect">Section&#160;5.6.1, &#8220;Consumers have Exchange/Queue Declaration and Binding Side Effect&#8221;</a></p></div></div></div><div class="navfooter"><hr /><table summary="Navigation footer" width="100%"><tr><td align="left" width="40%"><a accesskey="p" href="JMS-Client-0-8-JMS-Getting-And-Dependencies-Dependencies.html">Prev</a>&#160;</td><td align="center" width="20%">&#160;</td><td align="right" width="40%">&#160;<a accesskey="n" href="JMS-Client-0-8-Examples-PubSub.html">Next</a></td></tr><tr><td align="left" valign="top" width="40%">3.2.&#160;Dependencies&#160;</td><td align="center" width="20%"><a accesskey="h" href="JMS-Client-Book.html">Home</a></td><td align="right" valign="top" width="40%">&#160;4.2.&#160;Publish
 /subscribe example</td></tr></table></div></div>
\ No newline at end of file

http://git-wip-us.apache.org/repos/asf/qpid-site/blob/4ae9ccad/input/releases/qpid-java-6.0.6/jms-client-0-8/book/JMS-Client-0-8-Introduction.html.in
----------------------------------------------------------------------
diff --git a/input/releases/qpid-java-6.0.6/jms-client-0-8/book/JMS-Client-0-8-Introduction.html.in b/input/releases/qpid-java-6.0.6/jms-client-0-8/book/JMS-Client-0-8-Introduction.html.in
new file mode 100644
index 0000000..86bbd01
--- /dev/null
+++ b/input/releases/qpid-java-6.0.6/jms-client-0-8/book/JMS-Client-0-8-Introduction.html.in
@@ -0,0 +1,10 @@
+<div class="docbook"><div class="navheader"><table summary="Navigation header" width="100%"><tr><th align="center" colspan="3">Chapter&#160;1.&#160;Introduction</th></tr><tr><td align="left" width="20%"><a accesskey="p" href="JMS-Client-Book.html">Prev</a>&#160;</td><th align="center" width="60%">&#160;</th><td align="right" width="20%">&#160;<a accesskey="n" href="JMS-Client-0-8-Document-Scope-And-Intended-Audience.html">Next</a></td></tr></table><hr /></div><div class="chapter"><div class="titlepage"><div><div><h1 class="title"><a id="JMS-Client-0-8-Introduction"></a>Chapter&#160;1.&#160;Introduction</h1></div></div></div><p>Apache Qpid JMS client for AMQP 0-9-1/0-10 is an implementation of <a class="link" href="http://download.oracle.com/otndocs/jcp/7195-jms-1.1-fr-spec-oth-JSpec/" target="_top">JMS specification
+      1.1</a>. It utilises an <a class="link" href="http://www.amqp.org" target="_top">AMQP</a> transport layer for the performing of messaging operations.
+    The client is intended to be used for writing of JMS compatible messaging applications. Such
+    applications can send and receive messages via any AMQP-compatible brokers like RabbitMQ,
+    Apache Qpid Broker for Java which supports AMQP protocols 0-8, 0-9, or 0-9-1.</p><p>The Client hides the details of AMQP transport implementation behind the JMS API.
+    Thus, the developers need only to be familiar with JMS API in order to use the client. However,
+    the knowledge of the basic concepts of AMQP protocols can help developers in writing reliable
+    and high-performant messaging application. </p><div class="important" style="margin-left: 0.5in; margin-right: 0.5in;"><h3 class="title">Using the Client with 0-10</h3><p>This book documents the behaviour of the Apache Qpid JMS client for AMQP 0-9-1/0-10 when used with the AMQP
+      protocols <span class="emphasis"><em>0-8, 0-9, and 0-9-1</em></span> only. For behaviour when using the Client
+      with AMQP 0-10 protocol, please refer to <a class="link" href="/releases/qpid-java-6.0.6/jms-client-0-10/book/" target="_top">Using AMQP 0-10 with the Apache Qpid JMS client for AMQP 0-9-1/0-10</a>.</p></div></div><div class="navfooter"><hr /><table summary="Navigation footer" width="100%"><tr><td align="left" width="40%"><a accesskey="p" href="JMS-Client-Book.html">Prev</a>&#160;</td><td align="center" width="20%">&#160;</td><td align="right" width="40%">&#160;<a accesskey="n" href="JMS-Client-0-8-Document-Scope-And-Intended-Audience.html">Next</a></td></tr><tr><td align="left" valign="top" width="40%">Apache Qpid JMS Client for AMQP protocols 0-8, 0-9 and 0-9-1&#160;</td><td align="center" width="20%"><a accesskey="h" href="JMS-Client-Book.html">Home</a></td><td align="right" valign="top" width="40%">&#160;Chapter&#160;2.&#160;Document Scope And Intended Audience</td></tr></table></div></div>
\ No newline at end of file

http://git-wip-us.apache.org/repos/asf/qpid-site/blob/4ae9ccad/input/releases/qpid-java-6.0.6/jms-client-0-8/book/JMS-Client-0-8-JMS-Getting-And-Dependencies-Dependencies.html.in
----------------------------------------------------------------------
diff --git a/input/releases/qpid-java-6.0.6/jms-client-0-8/book/JMS-Client-0-8-JMS-Getting-And-Dependencies-Dependencies.html.in b/input/releases/qpid-java-6.0.6/jms-client-0-8/book/JMS-Client-0-8-JMS-Getting-And-Dependencies-Dependencies.html.in
new file mode 100644
index 0000000..35b88ec
--- /dev/null
+++ b/input/releases/qpid-java-6.0.6/jms-client-0-8/book/JMS-Client-0-8-JMS-Getting-And-Dependencies-Dependencies.html.in
@@ -0,0 +1,3 @@
+<div class="docbook"><div class="navheader"><table summary="Navigation header" width="100%"><tr><th align="center" colspan="3">3.2.&#160;Dependencies</th></tr><tr><td align="left" width="20%"><a accesskey="p" href="JMS-Client-0-8-JMS-Getting-And-Dependencies.html">Prev</a>&#160;</td><th align="center" width="60%">Chapter&#160;3.&#160;Getting the Client And Dependencies</th><td align="right" width="20%">&#160;<a accesskey="n" href="JMS-Client-0-8-Examples.html">Next</a></td></tr></table><hr /></div><div class="section"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a id="JMS-Client-0-8-JMS-Getting-And-Dependencies-Dependencies"></a>3.2.&#160;Dependencies</h2></div></div></div><p>The Client has minimal set of external dependencies. </p><p> It requires: </p><div class="itemizedlist"><ul class="itemizedlist" style="list-style-type: disc; "><li class="listitem"><p>JDK 1.7 or higher.</p></li><li class="listitem"><p>JMS 1.1 specification (such as geronimo-jms_1.1_s
 pec JAR)</p></li><li class="listitem"><p><a class="link" href="http://www.slf4j.org" target="_top">Apache SLF4J</a> (slf4j-api-x.y.z JAR)</p></li></ul></div><p>
+    </p><p>The use of SLF4J means that application authors are free to plug in any logging framework
+      for which an SLF4J binding exists. </p></div><div class="navfooter"><hr /><table summary="Navigation footer" width="100%"><tr><td align="left" width="40%"><a accesskey="p" href="JMS-Client-0-8-JMS-Getting-And-Dependencies.html">Prev</a>&#160;</td><td align="center" width="20%"><a accesskey="u" href="JMS-Client-0-8-JMS-Getting-And-Dependencies.html">Up</a></td><td align="right" width="40%">&#160;<a accesskey="n" href="JMS-Client-0-8-Examples.html">Next</a></td></tr><tr><td align="left" valign="top" width="40%">Chapter&#160;3.&#160;Getting the Client And Dependencies&#160;</td><td align="center" width="20%"><a accesskey="h" href="JMS-Client-Book.html">Home</a></td><td align="right" valign="top" width="40%">&#160;Chapter&#160;4.&#160;Examples</td></tr></table></div></div>
\ No newline at end of file

http://git-wip-us.apache.org/repos/asf/qpid-site/blob/4ae9ccad/input/releases/qpid-java-6.0.6/jms-client-0-8/book/JMS-Client-0-8-JMS-Getting-And-Dependencies.html.in
----------------------------------------------------------------------
diff --git a/input/releases/qpid-java-6.0.6/jms-client-0-8/book/JMS-Client-0-8-JMS-Getting-And-Dependencies.html.in b/input/releases/qpid-java-6.0.6/jms-client-0-8/book/JMS-Client-0-8-JMS-Getting-And-Dependencies.html.in
new file mode 100644
index 0000000..f9c3d1a
--- /dev/null
+++ b/input/releases/qpid-java-6.0.6/jms-client-0-8/book/JMS-Client-0-8-JMS-Getting-And-Dependencies.html.in
@@ -0,0 +1,11 @@
+<div class="docbook"><div class="navheader"><table summary="Navigation header" width="100%"><tr><th align="center" colspan="3">Chapter&#160;3.&#160;Getting the Client And Dependencies</th></tr><tr><td align="left" width="20%"><a accesskey="p" href="JMS-Client-0-8-Document-Scope-And-Intended-Audience.html">Prev</a>&#160;</td><th align="center" width="60%">&#160;</th><td align="right" width="20%">&#160;<a accesskey="n" href="JMS-Client-0-8-JMS-Getting-And-Dependencies-Dependencies.html">Next</a></td></tr></table><hr /></div><div class="chapter"><div class="titlepage"><div><div><h1 class="title"><a id="JMS-Client-0-8-JMS-Getting-And-Dependencies"></a>Chapter&#160;3.&#160;Getting the Client And Dependencies</h1></div></div></div><div class="toc"><p><strong>Table of Contents</strong></p><dl class="toc"><dt><span class="section"><a href="JMS-Client-0-8-JMS-Getting-And-Dependencies.html#JMS-Client-0-8-JMS-Getting-And-Dependencies-Getting">3.1. Getting the Client</a></span></dt><dt><span cl
 ass="section"><a href="JMS-Client-0-8-JMS-Getting-And-Dependencies-Dependencies.html">3.2. Dependencies</a></span></dt></dl></div><div class="section"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a id="JMS-Client-0-8-JMS-Getting-And-Dependencies-Getting"></a>3.1.&#160;Getting the Client</h2></div></div></div><p>The Apache Qpid JMS client for AMQP 0-9-1/0-10 is available as a bundle or from Maven repositories.</p><p>The bundle (a .tar.gz) includes the Client itself (formed by two JAR: qpid-client
+      and qpid-common) together with slf4j-api, and geronimo-jms_1.1_spec. There is also a qpid-all
+      JAR artifact that, for convenience, includes a manifest classpath that references the other
+      JARs. The bundle is available from <a class="link" href="http://qpid.apache.org/download.html" target="_top">the Apache Qpid project web site</a>.</p><p>The Client is also available from Maven repositories. Add the following
+      dependency:</p><pre class="screen">
+    &lt;dependency&gt;
+      &lt;groupId&gt;org.apache.qpid&lt;/groupId&gt;
+      &lt;artifactId&gt;qpid-client&lt;/artifactId&gt;
+      &lt;version&gt;6.0.6&lt;/version&gt;
+    &lt;/dependency&gt;
+    </pre><p><a class="xref" href="JMS-Client-0-8-Appendix-Maven.html" title="Appendix&#160;B.&#160;Minimal Maven POM">Appendix&#160;B, <em>Minimal Maven POM</em></a> illustrates a minimal Maven POM required to use the Qpid Client.</p></div></div><div class="navfooter"><hr /><table summary="Navigation footer" width="100%"><tr><td align="left" width="40%"><a accesskey="p" href="JMS-Client-0-8-Document-Scope-And-Intended-Audience.html">Prev</a>&#160;</td><td align="center" width="20%">&#160;</td><td align="right" width="40%">&#160;<a accesskey="n" href="JMS-Client-0-8-JMS-Getting-And-Dependencies-Dependencies.html">Next</a></td></tr><tr><td align="left" valign="top" width="40%">Chapter&#160;2.&#160;Document Scope And Intended Audience&#160;</td><td align="center" width="20%"><a accesskey="h" href="JMS-Client-Book.html">Home</a></td><td align="right" valign="top" width="40%">&#160;3.2.&#160;Dependencies</td></tr></table></div></div>
\ No newline at end of file

http://git-wip-us.apache.org/repos/asf/qpid-site/blob/4ae9ccad/input/releases/qpid-java-6.0.6/jms-client-0-8/book/JMS-Client-0-8-JNDI-Properties-Format-Destination.html.in
----------------------------------------------------------------------
diff --git a/input/releases/qpid-java-6.0.6/jms-client-0-8/book/JMS-Client-0-8-JNDI-Properties-Format-Destination.html.in b/input/releases/qpid-java-6.0.6/jms-client-0-8/book/JMS-Client-0-8-JNDI-Properties-Format-Destination.html.in
new file mode 100644
index 0000000..548eb6f
--- /dev/null
+++ b/input/releases/qpid-java-6.0.6/jms-client-0-8/book/JMS-Client-0-8-JNDI-Properties-Format-Destination.html.in
@@ -0,0 +1,3 @@
+<div class="docbook"><div class="navheader"><table summary="Navigation header" width="100%"><tr><th align="center" colspan="3">6.4.&#160;Destination</th></tr><tr><td align="left" width="20%"><a accesskey="p" href="JMS-Client-0-8-JNDI-Properties-Format-Topic.html">Prev</a>&#160;</td><th align="center" width="60%">Chapter&#160;6.&#160;JNDI Properties Format</th><td align="right" width="20%">&#160;<a accesskey="n" href="JMS-Client-0-8-Connection-URL.html">Next</a></td></tr></table><hr /></div><div class="section"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a id="JMS-Client-0-8-JNDI-Properties-Format-Destination"></a>6.4.&#160;Destination</h2></div></div></div><p><code class="literal">destination.</code><span class="emphasis"><em>name</em></span> declares either a <a class="link" href="http://docs.oracle.com/javaee/6/api/javax/jms/Queue.html" target="_top">Queue</a> or <a class="link" href="http://docs.oracle.com/javaee/6/api/javax/jms/Topic.html" target="_to
 p">Topic</a> (depending on the class) with the
+      given JNDI name. The value must be a Binding URL.</p><p>See <a class="xref" href="JMS-Client-0-8-Binding-URL.html" title="Chapter&#160;8.&#160;Binding URL">Chapter&#160;8, <em>Binding URL</em></a> for format of the URL and its permitted
+      options.</p></div><div class="navfooter"><hr /><table summary="Navigation footer" width="100%"><tr><td align="left" width="40%"><a accesskey="p" href="JMS-Client-0-8-JNDI-Properties-Format-Topic.html">Prev</a>&#160;</td><td align="center" width="20%"><a accesskey="u" href="JMS-Client-0-8-JNDI-Properties-Format.html">Up</a></td><td align="right" width="40%">&#160;<a accesskey="n" href="JMS-Client-0-8-Connection-URL.html">Next</a></td></tr><tr><td align="left" valign="top" width="40%">6.3.&#160;Topic&#160;</td><td align="center" width="20%"><a accesskey="h" href="JMS-Client-Book.html">Home</a></td><td align="right" valign="top" width="40%">&#160;Chapter&#160;7.&#160;Connection URLs</td></tr></table></div></div>
\ No newline at end of file

http://git-wip-us.apache.org/repos/asf/qpid-site/blob/4ae9ccad/input/releases/qpid-java-6.0.6/jms-client-0-8/book/JMS-Client-0-8-JNDI-Properties-Format-Queue.html.in
----------------------------------------------------------------------
diff --git a/input/releases/qpid-java-6.0.6/jms-client-0-8/book/JMS-Client-0-8-JNDI-Properties-Format-Queue.html.in b/input/releases/qpid-java-6.0.6/jms-client-0-8/book/JMS-Client-0-8-JNDI-Properties-Format-Queue.html.in
new file mode 100644
index 0000000..1ec381d
--- /dev/null
+++ b/input/releases/qpid-java-6.0.6/jms-client-0-8/book/JMS-Client-0-8-JNDI-Properties-Format-Queue.html.in
@@ -0,0 +1,2 @@
+<div class="docbook"><div class="navheader"><table summary="Navigation header" width="100%"><tr><th align="center" colspan="3">6.2.&#160;Queue</th></tr><tr><td align="left" width="20%"><a accesskey="p" href="JMS-Client-0-8-JNDI-Properties-Format.html">Prev</a>&#160;</td><th align="center" width="60%">Chapter&#160;6.&#160;JNDI Properties Format</th><td align="right" width="20%">&#160;<a accesskey="n" href="JMS-Client-0-8-JNDI-Properties-Format-Topic.html">Next</a></td></tr></table><hr /></div><div class="section"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a id="JMS-Client-0-8-JNDI-Properties-Format-Queue"></a>6.2.&#160;Queue</h2></div></div></div><p><code class="literal">queue.</code><span class="emphasis"><em>name</em></span> declares a <a class="link" href="http://docs.oracle.com/javaee/6/api/javax/jms/Queue.html" target="_top">Queue</a> with the given JNDI name. The
+      value is simple queue name. This is the name of the queue as known by the Broker.</p><p>The <code class="literal">queue.</code> form is a short hand for declaring a destination:</p><pre class="screen">destination.name=direct://amq.direct//&lt;queue name&gt;?routingkey=&#8217;&lt;queue name&gt;&#8217;&amp;durable=&#8217;true&#8217;</pre></div><div class="navfooter"><hr /><table summary="Navigation footer" width="100%"><tr><td align="left" width="40%"><a accesskey="p" href="JMS-Client-0-8-JNDI-Properties-Format.html">Prev</a>&#160;</td><td align="center" width="20%"><a accesskey="u" href="JMS-Client-0-8-JNDI-Properties-Format.html">Up</a></td><td align="right" width="40%">&#160;<a accesskey="n" href="JMS-Client-0-8-JNDI-Properties-Format-Topic.html">Next</a></td></tr><tr><td align="left" valign="top" width="40%">Chapter&#160;6.&#160;JNDI Properties Format&#160;</td><td align="center" width="20%"><a accesskey="h" href="JMS-Client-Book.html">Home</a></td><td align="right" valign="
 top" width="40%">&#160;6.3.&#160;Topic</td></tr></table></div></div>
\ No newline at end of file

http://git-wip-us.apache.org/repos/asf/qpid-site/blob/4ae9ccad/input/releases/qpid-java-6.0.6/jms-client-0-8/book/JMS-Client-0-8-JNDI-Properties-Format-Topic.html.in
----------------------------------------------------------------------
diff --git a/input/releases/qpid-java-6.0.6/jms-client-0-8/book/JMS-Client-0-8-JNDI-Properties-Format-Topic.html.in b/input/releases/qpid-java-6.0.6/jms-client-0-8/book/JMS-Client-0-8-JNDI-Properties-Format-Topic.html.in
new file mode 100644
index 0000000..3e6b6aa
--- /dev/null
+++ b/input/releases/qpid-java-6.0.6/jms-client-0-8/book/JMS-Client-0-8-JNDI-Properties-Format-Topic.html.in
@@ -0,0 +1,4 @@
+<div class="docbook"><div class="navheader"><table summary="Navigation header" width="100%"><tr><th align="center" colspan="3">6.3.&#160;Topic</th></tr><tr><td align="left" width="20%"><a accesskey="p" href="JMS-Client-0-8-JNDI-Properties-Format-Queue.html">Prev</a>&#160;</td><th align="center" width="60%">Chapter&#160;6.&#160;JNDI Properties Format</th><td align="right" width="20%">&#160;<a accesskey="n" href="JMS-Client-0-8-JNDI-Properties-Format-Destination.html">Next</a></td></tr></table><hr /></div><div class="section"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a id="JMS-Client-0-8-JNDI-Properties-Format-Topic"></a>6.3.&#160;Topic</h2></div></div></div><p><code class="literal">topic.</code><span class="emphasis"><em>name</em></span> declares a <a class="link" href="http://docs.oracle.com/javaee/6/api/javax/jms/Topic.html" target="_top">Topic</a> with the given JNDI name. The
+      value is topic name. This topic name is used on the Broker as a binding key between the
+        <code class="literal">amq.topic</code> exchange and the queue corresponding to the topic
+      subscriber.</p><p>The <code class="literal">topic.</code> form is a short hand for declaring a destination:</p><pre class="screen">destination.name=topic://amq.topic/&lt;topic name&gt;/?routingkey=&lt;topic name&gt;</pre></div><div class="navfooter"><hr /><table summary="Navigation footer" width="100%"><tr><td align="left" width="40%"><a accesskey="p" href="JMS-Client-0-8-JNDI-Properties-Format-Queue.html">Prev</a>&#160;</td><td align="center" width="20%"><a accesskey="u" href="JMS-Client-0-8-JNDI-Properties-Format.html">Up</a></td><td align="right" width="40%">&#160;<a accesskey="n" href="JMS-Client-0-8-JNDI-Properties-Format-Destination.html">Next</a></td></tr><tr><td align="left" valign="top" width="40%">6.2.&#160;Queue&#160;</td><td align="center" width="20%"><a accesskey="h" href="JMS-Client-Book.html">Home</a></td><td align="right" valign="top" width="40%">&#160;6.4.&#160;Destination</td></tr></table></div></div>
\ No newline at end of file

http://git-wip-us.apache.org/repos/asf/qpid-site/blob/4ae9ccad/input/releases/qpid-java-6.0.6/jms-client-0-8/book/JMS-Client-0-8-JNDI-Properties-Format.html.in
----------------------------------------------------------------------
diff --git a/input/releases/qpid-java-6.0.6/jms-client-0-8/book/JMS-Client-0-8-JNDI-Properties-Format.html.in b/input/releases/qpid-java-6.0.6/jms-client-0-8/book/JMS-Client-0-8-JNDI-Properties-Format.html.in
new file mode 100644
index 0000000..4e78b3a
--- /dev/null
+++ b/input/releases/qpid-java-6.0.6/jms-client-0-8/book/JMS-Client-0-8-JNDI-Properties-Format.html.in
@@ -0,0 +1,14 @@
+<div class="docbook"><div class="navheader"><table summary="Navigation header" width="100%"><tr><th align="center" colspan="3">Chapter&#160;6.&#160;JNDI Properties Format</th></tr><tr><td align="left" width="20%"><a accesskey="p" href="JMS-Client-0-8-Client-Understanding-Destinations.html">Prev</a>&#160;</td><th align="center" width="60%">&#160;</th><td align="right" width="20%">&#160;<a accesskey="n" href="JMS-Client-0-8-JNDI-Properties-Format-Queue.html">Next</a></td></tr></table><hr /></div><div class="chapter"><div class="titlepage"><div><div><h1 class="title"><a id="JMS-Client-0-8-JNDI-Properties-Format"></a>Chapter&#160;6.&#160;JNDI Properties Format</h1></div></div></div><div class="toc"><p><strong>Table of Contents</strong></p><dl class="toc"><dt><span class="section"><a href="JMS-Client-0-8-JNDI-Properties-Format.html#JMS-Client-0-8-JNDI-Properties-Format-ConnectionFactory">6.1. ConnectionFactory</a></span></dt><dt><span class="section"><a href="JMS-Client-0-8-JNDI-Properti
 es-Format-Queue.html">6.2. Queue</a></span></dt><dt><span class="section"><a href="JMS-Client-0-8-JNDI-Properties-Format-Topic.html">6.3. Topic</a></span></dt><dt><span class="section"><a href="JMS-Client-0-8-JNDI-Properties-Format-Destination.html">6.4. Destination</a></span></dt></dl></div><p>The Client comes with own JNDI context factory
+      <code class="literal">org.apache.qpid.jndi.PropertiesFileInitialContextFactory</code> which utilises a
+    Java properties file for declaring the JMS administered objects: connection factories, queues,
+    topics and destinations. It uses the following syntax:</p><p>
+    </p><pre class="screen">
+connectionfactory.&lt;jndi name&gt;=&lt;connection url&gt;
+queue.&lt;jndi name&gt;=&lt;queue name&gt;
+topic.&lt;jndi name&gt;=&lt;topic name&gt;
+destination.&lt;jndi name&gt;=&lt;binding url&gt;
+</pre><p>An arbitrary number of connection factories, queues, topics, queues or destinations or can
+    be declared in the JNDI properties file. Each JNDI name must be unique.</p><p>The application looks up the objects via an InitialContext. This lookup and an example JNDI
+    properties file is provided in <a class="xref" href="JMS-Client-0-8-Examples.html" title="Chapter&#160;4.&#160;Examples">Chapter&#160;4, <em>Examples</em></a></p><p>We now consider each JMS administered object type in turn.</p><div class="section"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a id="JMS-Client-0-8-JNDI-Properties-Format-ConnectionFactory"></a>6.1.&#160;ConnectionFactory</h2></div></div></div><p><code class="literal">connectionfactory.</code><span class="emphasis"><em>name</em></span> declares a <a class="link" href="http://docs.oracle.com/javaee/6/api/javax/jms/ConnectionFactory.html" target="_top">ConnectionFactory</a> with the
+      given JNDI name. The value must be a legal Connection URL.</p><p>See <a class="xref" href="JMS-Client-0-8-Connection-URL.html" title="Chapter&#160;7.&#160;Connection URLs">Chapter&#160;7, <em>Connection URLs</em></a> for format of the URL and its
+      permitted options.</p></div></div><div class="navfooter"><hr /><table summary="Navigation footer" width="100%"><tr><td align="left" width="40%"><a accesskey="p" href="JMS-Client-0-8-Client-Understanding-Destinations.html">Prev</a>&#160;</td><td align="center" width="20%">&#160;</td><td align="right" width="40%">&#160;<a accesskey="n" href="JMS-Client-0-8-JNDI-Properties-Format-Queue.html">Next</a></td></tr><tr><td align="left" valign="top" width="40%">5.7.&#160;Destinations&#160;</td><td align="center" width="20%"><a accesskey="h" href="JMS-Client-Book.html">Home</a></td><td align="right" valign="top" width="40%">&#160;6.2.&#160;Queue</td></tr></table></div></div>
\ No newline at end of file

http://git-wip-us.apache.org/repos/asf/qpid-site/blob/4ae9ccad/input/releases/qpid-java-6.0.6/jms-client-0-8/book/JMS-Client-0-8-Logging-EnablingDebugLogging.html.in
----------------------------------------------------------------------
diff --git a/input/releases/qpid-java-6.0.6/jms-client-0-8/book/JMS-Client-0-8-Logging-EnablingDebugLogging.html.in b/input/releases/qpid-java-6.0.6/jms-client-0-8/book/JMS-Client-0-8-Logging-EnablingDebugLogging.html.in
new file mode 100644
index 0000000..c3a821b
--- /dev/null
+++ b/input/releases/qpid-java-6.0.6/jms-client-0-8/book/JMS-Client-0-8-Logging-EnablingDebugLogging.html.in
@@ -0,0 +1,8 @@
+<div class="docbook"><div class="navheader"><table summary="Navigation header" width="100%"><tr><th align="center" colspan="3">10.2.&#160;Enabling Debug</th></tr><tr><td align="left" width="20%"><a accesskey="p" href="JMS-Client-0-8-Logging.html">Prev</a>&#160;</td><th align="center" width="60%">Chapter&#160;10.&#160;Logging</th><td align="right" width="20%">&#160;<a accesskey="n" href="JMS-Client-0-8-Appendix-Exceptions.html">Next</a></td></tr></table><hr /></div><div class="section"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a id="JMS-Client-0-8-Logging-EnablingDebugLogging"></a>10.2.&#160;Enabling Debug</h2></div></div></div><p>If you are experiencing a problem, it can be informative to enable debug logging to allow
+      the behaviour of the Client to be understood at a deeper level.</p><p>To do this, set the <code class="literal">org.apache.qpid</code> logger to
+      <code class="literal">DEBUG</code>.</p><p>If you are using Apache Log4j with a log4j.properties file, this simply means adding (or
+      changing) the following line:</p><pre class="screen">
+      log4j.logger.org.apache.qpid=DEBUG
+    </pre><p>If you are using another logging framework, or you are using Log4j but configuring in
+      another manner, refer to the documentation accompanying the logging framework for details of
+      how to proceed.</p></div><div class="navfooter"><hr /><table summary="Navigation footer" width="100%"><tr><td align="left" width="40%"><a accesskey="p" href="JMS-Client-0-8-Logging.html">Prev</a>&#160;</td><td align="center" width="20%"><a accesskey="u" href="JMS-Client-0-8-Logging.html">Up</a></td><td align="right" width="40%">&#160;<a accesskey="n" href="JMS-Client-0-8-Appendix-Exceptions.html">Next</a></td></tr><tr><td align="left" valign="top" width="40%">Chapter&#160;10.&#160;Logging&#160;</td><td align="center" width="20%"><a accesskey="h" href="JMS-Client-Book.html">Home</a></td><td align="right" valign="top" width="40%">&#160;Appendix&#160;A.&#160;Exceptions</td></tr></table></div></div>
\ No newline at end of file

http://git-wip-us.apache.org/repos/asf/qpid-site/blob/4ae9ccad/input/releases/qpid-java-6.0.6/jms-client-0-8/book/JMS-Client-0-8-Logging.html.in
----------------------------------------------------------------------
diff --git a/input/releases/qpid-java-6.0.6/jms-client-0-8/book/JMS-Client-0-8-Logging.html.in b/input/releases/qpid-java-6.0.6/jms-client-0-8/book/JMS-Client-0-8-Logging.html.in
new file mode 100644
index 0000000..e4f0f58
--- /dev/null
+++ b/input/releases/qpid-java-6.0.6/jms-client-0-8/book/JMS-Client-0-8-Logging.html.in
@@ -0,0 +1,12 @@
+<div class="docbook"><div class="navheader"><table summary="Navigation header" width="100%"><tr><th align="center" colspan="3">Chapter&#160;10.&#160;Logging</th></tr><tr><td align="left" width="20%"><a accesskey="p" href="JMS-Client-0-8-System-Properties.html">Prev</a>&#160;</td><th align="center" width="60%">&#160;</th><td align="right" width="20%">&#160;<a accesskey="n" href="JMS-Client-0-8-Logging-EnablingDebugLogging.html">Next</a></td></tr></table><hr /></div><div class="chapter"><div class="titlepage"><div><div><h1 class="title"><a id="JMS-Client-0-8-Logging"></a>Chapter&#160;10.&#160;Logging</h1></div></div></div><div class="toc"><p><strong>Table of Contents</strong></p><dl class="toc"><dt><span class="section"><a href="JMS-Client-0-8-Logging.html#JMS-Client-0-8-Logging-RecommendedProductionLoggingLevel">10.1. Recommended Production Logging Level</a></span></dt><dt><span class="section"><a href="JMS-Client-0-8-Logging-EnablingDebugLogging.html">10.2. Enabling Debug</a></span>
 </dt></dl></div><p>The Client uses the <a class="link" href="http://www.slf4j.org" target="_top">Apache SLF4J</a> logging
+    framework. All logging activity created by the client is directed through the SLF4J API. SLF4J
+    is a is a fa&#231;ade for other common logging frameworks. This makes it easy for application authors
+    to use their prefered logging framework in their application stack, and have the Client
+    use it too. </p><p>SLF4J suppplies bindings for many common logging frameworks (<a class="link" href="http://docs.oracle.com/javase/7/docs/api/java/util/logging/package-summary.html" target="_top">JUL</a>, <a class="link" href="http://logging.apache.org/log4j/1.2/" target="_top">Apache Log4J</a>, <a class="link" href="http://logback.qos.ch" target="_top">Logback</a>.</p><p>Include the SLF4J binding corresponding to the logging framework of your choosen logging
+    framework on classpath. For full details, see the SLF4J <a class="link" href="http://www.slf4j.org" target="_top">documentation</a>.</p><div class="section"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a id="JMS-Client-0-8-Logging-RecommendedProductionLoggingLevel"></a>10.1.&#160;Recommended Production Logging Level</h2></div></div></div><p>In production, it is recommended that you configure your logging framework is configured
+      with logger <code class="literal">org.apache.qpid</code> set to <code class="literal">WARN</code>.</p><p>If you are using Apache Log4j with a log4j.properties file, this simply means adding the
+      following line:</p><pre class="screen">
+      org.apache.qpid=WARN
+    </pre><p>If you are using another logging framework, or you are using Log4j but configuring in
+      another manner, refer to the documentation accompanying the logging framework for details of
+      how to proceed.</p></div></div><div class="navfooter"><hr /><table summary="Navigation footer" width="100%"><tr><td align="left" width="40%"><a accesskey="p" href="JMS-Client-0-8-System-Properties.html">Prev</a>&#160;</td><td align="center" width="20%">&#160;</td><td align="right" width="40%">&#160;<a accesskey="n" href="JMS-Client-0-8-Logging-EnablingDebugLogging.html">Next</a></td></tr><tr><td align="left" valign="top" width="40%">Chapter&#160;9.&#160;System Properties&#160;</td><td align="center" width="20%"><a accesskey="h" href="JMS-Client-Book.html">Home</a></td><td align="right" valign="top" width="40%">&#160;10.2.&#160;Enabling Debug</td></tr></table></div></div>
\ No newline at end of file


---------------------------------------------------------------------
To unsubscribe, e-mail: commits-unsubscribe@qpid.apache.org
For additional commands, e-mail: commits-help@qpid.apache.org