Added "Book" templates for creating separate books with subsets of the material from the Wiki.

git-svn-id: https://svn.apache.org/repos/asf/qpid/trunk/qpid@954631 13f79535-47bb-0310-9956-ffa450edef68

4 files changed, 267 insertions, 0 deletions

diff --git a/doc/book/src/AMQP-Messaging-Broker-CPP-Book.xml b/doc/book/src/AMQP-Messaging-Broker-CPP-Book.xml
new file mode 100644
index 0000000000..668b940b46
--- /dev/null
+++ b/doc/book/src/AMQP-Messaging-Broker-CPP-Book.xml
@@ -0,0 +1,73 @@
+<?xml version="1.0"?>
+<!--
+ 
+ Licensed to the Apache Software Foundation (ASF) under one
+ or more contributor license agreements.  See the NOTICE file
+ distributed with this work for additional information
+ regarding copyright ownership.  The ASF licenses this file
+ to you under the Apache License, Version 2.0 (the
+ "License"); you may not use this file except in compliance
+ with the License.  You may obtain a copy of the License at
+ 
+   http://www.apache.org/licenses/LICENSE-2.0
+ 
+ Unless required by applicable law or agreed to in writing,
+ software distributed under the License is distributed on an
+ "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+ KIND, either express or implied.  See the License for the
+ specific language governing permissions and limitations
+ under the License.
+ 
+-->
+
+<book>
+  <title>AMQP Messaging Broker (Implemented in C++)</title>
+  <preface>
+    <para>Qpid provides two AMQP messaging brokers:</para>
+
+    <itemizedlist>
+      <listitem><para>Implemented in C++ - high performance, low latency, and RDMA support.</para></listitem>
+      <listitem><para>Implemented in Java - Fully JMS compliant, runs on any Java platform.</para></listitem>
+    </itemizedlist>
+
+    <para>Both AMQP messaging brokers support clients in multiple
+    languages, as long as the messaging client and the messaging
+    broker use the same version of AMQP. See <link
+    linkend="AMQP-Compatibility">AMQP Compatibility</link> to see
+    which messaging clients work with each broker.</para>
+
+    <para>This manual contains information specific to the broker that is implemented in C++.</para>
+  </preface>
+
+<chapter>
+    <title>            
+      Running the AMQP Messaging Broker
+    </title>
+    
+    <xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="Running-CPP-Broker.xml"/>
+    <xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="Cheat-Sheet-for-configuring-Queue-Options.xml"/>
+    <xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="Cheat-Sheet-for-configuring-Exchange-Options.xml"/>
+
+    <xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="Using-Broker-Federation.xml"/>
+
+    <xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="SSL.xml"/>
+    <xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="LVQ.xml"/>
+    <xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="queue-state-replication.xml"/>
+    <xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="Starting-a-cluster.xml"/>
+    <xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="ACL.xml"/> 
+    <xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="AMQP-Compatibility.xml"/> 
+    <xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="Qpid-Interoperability-Documentation.xml"/>
+    
+</chapter>
+ 
+
+<chapter id="chapter-Managing-CPP-Broker">
+    <title>            
+      Managing the AMQP Messaging Broker
+    </title>
+
+    <xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="Managing-CPP-Broker.xml"/> 
+    <xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="Qpid-Management-Framework.xml"/> 
+    <xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="QMF-Python-Console-Tutorial.xml"/> 
+</chapter>
+</book>
diff --git a/doc/book/src/AMQP-Messaging-Broker-Java-Book.xml b/doc/book/src/AMQP-Messaging-Broker-Java-Book.xml
new file mode 100644
index 0000000000..56c984df87
--- /dev/null
+++ b/doc/book/src/AMQP-Messaging-Broker-Java-Book.xml
@@ -0,0 +1,71 @@
+<?xml version="1.0"?>
+<!--
+ 
+ Licensed to the Apache Software Foundation (ASF) under one
+ or more contributor license agreements.  See the NOTICE file
+ distributed with this work for additional information
+ regarding copyright ownership.  The ASF licenses this file
+ to you under the Apache License, Version 2.0 (the
+ "License"); you may not use this file except in compliance
+ with the License.  You may obtain a copy of the License at
+ 
+   http://www.apache.org/licenses/LICENSE-2.0
+ 
+ Unless required by applicable law or agreed to in writing,
+ software distributed under the License is distributed on an
+ "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+ KIND, either express or implied.  See the License for the
+ specific language governing permissions and limitations
+ under the License.
+ 
+-->
+
+<book>
+  <title>AMQP Messaging Broker (Implemented in Java)</title>
+  <preface>
+    <title>Introduction</title>
+    <para>Qpid provides two AMQP messaging brokers:</para>
+
+    <itemizedlist>
+      <listitem><para>Implemented in C++ - high performance, low latency, and RDMA support.</para></listitem>
+      <listitem><para>Implemented in Java - Fully JMS compliant, runs on any Java platform.</para></listitem>
+    </itemizedlist>
+
+    <para>Both AMQP messaging brokers support clients in multiple languages, as long as the messaging client and the messaging broker use the same version of AMQP. See <link linkend="AMQP-Compatibility"/> to see which messaging clients work with each broker.</para>
+
+    <para>This manual contains information specific to the broker that is implemented in Java.</para>
+  </preface>
+
+<chapter>
+  <title>General User Guides</title>
+
+        <xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="Java-Broker-Feature-Guide.xml"/>
+        <xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="Qpid-Java-FAQ.xml"/>
+        <xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="Java-Environment-Variables.xml"/>
+        <xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="Qpid-Troubleshooting-Guide.xml"/>
+</chapter>
+
+<chapter  id="Qpid-Java-Broker-HowTos">
+<title>How Tos</title>
+
+        <xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="Add-New-Users.xml"/>
+        <xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="Configure-ACLs.xml"/>
+        <xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="Configure-Java-Qpid-to-use-a-SSL-connection.xml"/>
+        <xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="Configure-Log4j-CompositeRolling-Appender.xml"/>
+        <xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="Configure-the-Broker-via-config.xml.xml"/>
+        <xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="Configure-the-Virtual-Hosts-via-virtualhosts.xml.xml"/>
+        <xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="Debug-using-log4j.xml"/>
+        <xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="How-to-Tune-M3-Java-Broker-Performance.xml"/>
+        <xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="Qpid-Java-Build-How-To.xml"/>
+        <xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="Use-Priority-Queues.xml"/>
+</chapter>
+
+
+<xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="Qpid-JMX-Management-Console.xml"/>
+
+<chapter id="QpidJavaBroker-ManagementTools">
+<title>Management Tools</title>
+        <xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="MessageStore-Tool.xml"/>
+        <xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="Qpid-Java-Broker-Management-CLI.xml"/>
+</chapter>
+</book>
diff --git a/doc/book/src/Qpid-Book.xml b/doc/book/src/Qpid-Book.xml
new file mode 100644
index 0000000000..ee69532152
--- /dev/null
+++ b/doc/book/src/Qpid-Book.xml
@@ -0,0 +1,93 @@
+<?xml version='1.0' encoding='utf-8' ?>
+
+<!--
+ 
+ Licensed to the Apache Software Foundation (ASF) under one
+ or more contributor license agreements.  See the NOTICE file
+ distributed with this work for additional information
+ regarding copyright ownership.  The ASF licenses this file
+ to you under the Apache License, Version 2.0 (the
+ "License"); you may not use this file except in compliance
+ with the License.  You may obtain a copy of the License at
+ 
+   http://www.apache.org/licenses/LICENSE-2.0
+ 
+ Unless required by applicable law or agreed to in writing,
+ software distributed under the License is distributed on an
+ "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+ KIND, either express or implied.  See the License for the
+ specific language governing permissions and limitations
+ under the License.
+ 
+-->
+
+<!DOCTYPE book PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN" "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" [
+]>
+
+<book>
+        <xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="Book-Info.xml"/>
+	<part>
+	  <title>Basics</title>
+	  <xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="Introduction.xml"/>
+	  <xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="AMQP.xml"/>
+	  <xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="Getting-Started.xml"/>
+	  <xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="Download.xml"/>
+	</part>
+
+<!--
+    The broker sections define their own <part/> elements, with <partintro/> text.
+-->
+	<xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="AMQP-Messaging-Broker-CPP.xml"/>
+	<xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="AMQP-Messaging-Broker-Java.xml"/>
+
+	<part>
+	  <title>AMQP Messaging Clients Clients</title>
+	  <xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="AMQP-Java-JMS-Messaging-Client.xml"/>
+	  <xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="AMQP-C++-Messaging-Client.xml"/>
+	  <xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="AMQP-.NET-Messaging-Client.xml"/>
+	  <xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="AMQP-Python-Messaging-Client.xml"/>
+	  <xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="AMQP-Ruby-Messaging-Client.xml"/>
+
+	</part>
+	<part>
+	  <title>Appendices</title>
+	  <xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="AMQP-Compatibility.xml"/>
+	  <xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="Qpid-Interoperability-Documentation.xml"/>
+<!--	  <xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="FAQ.xml"/> -->
+	</part>
+</book>
+
+<!--
+Documentation
+Getting Started
+
+    * Download
+    * Getting Started
+
+AMQP (Advanced Message Queueing Protocol)
+
+    * Toward a Commodity Enterprise Middleware
+    * AMQP (Advanced Message Queueing Protocol)
+
+Qpid AMQP Brokers
+
+    * AMQP Messaging Broker (implemented in C++)
+    * AMQP Messaging Broker (implemented in Java)
+
+Qpid AMQP Clients
+
+    * AMQP Java JMS Messaging Client
+    * AMQP C++ Messaging Client
+    * AMQP .NET Messaging Client
+    * AMQP Python Messaging Client
+    * AMQP Ruby Messaging Client
+
+Interoperability
+
+    * AMQP Compatibility
+    * SASL Interoperability
+
+FAQ
+
+    * Frequently Asked Questions
+-->
diff --git a/doc/book/src/Qpid-Compatibility-And-Interoperability-Book.xml b/doc/book/src/Qpid-Compatibility-And-Interoperability-Book.xml
new file mode 100644
index 0000000000..2f120af02e
--- /dev/null
+++ b/doc/book/src/Qpid-Compatibility-And-Interoperability-Book.xml
@@ -0,0 +1,30 @@
+<?xml version='1.0' encoding='utf-8' ?>
+
+<!--
+ 
+ Licensed to the Apache Software Foundation (ASF) under one
+ or more contributor license agreements.  See the NOTICE file
+ distributed with this work for additional information
+ regarding copyright ownership.  The ASF licenses this file
+ to you under the Apache License, Version 2.0 (the
+ "License"); you may not use this file except in compliance
+ with the License.  You may obtain a copy of the License at
+ 
+   http://www.apache.org/licenses/LICENSE-2.0
+ 
+ Unless required by applicable law or agreed to in writing,
+ software distributed under the License is distributed on an
+ "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+ KIND, either express or implied.  See the License for the
+ specific language governing permissions and limitations
+ under the License.
+ 
+-->
+
+<!DOCTYPE book PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN" "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" [
+]>
+
+<book>
+	  <xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="AMQP-Compatibility.xml"/>
+	  <xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="Qpid-Interoperability-Documentation.xml"/>
+</book>