Author: brianm
Date: Sat Feb 10 22:58:58 2007
New Revision: 505858

URL: http://svn.apache.org/viewvc?view=rev&rev=505858
Log:
* Start breaking out the book by chapters to make the xml manageable
* Add skeletons/ideas for additional chapters

Added:
    activemq/trunk/activemq-book/src/docbkx/installation.xml
    activemq/trunk/activemq-book/src/docbkx/introduction.xml
    activemq/trunk/activemq-book/src/docbkx/java-client.xml
    activemq/trunk/activemq-book/src/docbkx/running-broker.xml
Modified:
    activemq/trunk/activemq-book/   (props changed)
    activemq/trunk/activemq-book/src/docbkx/activemq.xml

Propchange: activemq/trunk/activemq-book/
------------------------------------------------------------------------------
--- svn:ignore (added)
+++ svn:ignore Sat Feb 10 22:58:58 2007
@@ -0,0 +1 @@
+target

Modified: activemq/trunk/activemq-book/src/docbkx/activemq.xml
URL: http://svn.apache.org/viewvc/activemq/trunk/activemq-book/src/docbkx/activemq.xml?view=diff&rev=505858&r1=505857&r2=505858
==============================================================================
--- activemq/trunk/activemq-book/src/docbkx/activemq.xml (original)
+++ activemq/trunk/activemq-book/src/docbkx/activemq.xml Sat Feb 10 22:58:58 2007
@@ -15,8 +15,14 @@
   See the License for the specific language governing permissions and
   limitations under the License.
 -->
-<!DOCTYPE book PUBLIC "-//OASIS//DTD DocBook XML V4.4//EN"
-"http://www.oasis-open.org/docbook/xml/4.4/docbookx.dtd">
+<!DOCTYPE book PUBLIC "-//OASIS//DTD DocBook XML V4.4//EN" 
+"http://www.oasis-open.org/docbook/xml/4.4/docbookx.dtd" 
+[
+  <!ENTITY introduction SYSTEM "introduction.xml">
+  <!ENTITY installation SYSTEM "installation.xml">
+  <!ENTITY java-client SYSTEM "java-client.xml">
+  <!ENTITY running-broker SYSTEM "running-broker.xml">
+]>
 <book>
   <bookinfo>
     <title>Apache ActiveMQ</title>
@@ -55,66 +61,80 @@
 
   <toc></toc>
 
-  <chapter id="introduction">
-    <title>Introduction</title>
-
-    <para></para>
-
-    <para><ulink url="http://activemq.apache.org/">Apache ActiveMQ</ulink> is
-    the most popular and powerful open source Message Broker available today.
-    Its hosted at Apache and is distributed under the Apache Software License
-    (2.0).</para>
-
-    <para>ActiveMQ supports different <ulink
-    url="http://activemq.apache.org/cross-language-clients.html">cross
-    language clients</ulink> from many different languages such as Java, C# /
-    .Net, C, C++, Ruby, Python, Perl, PHP together with different protocols
-    like OpenWire, Stomp, REST, Ajax/Cometd, XMPP. ActiveMQ also provides a
-    whole raft of powerful <ulink
-    url="http://activemq.apache.org/features.html">features</ulink> like
-    Message Groups, Exclusive Queues, Master/Slave, Networks of Brokers and so
-    forth.</para>
-
-    <section>
-      <title>Architecture</title>
-
-      <para>Like most Message Orientated Middleware (<acronym>MOM</acronym>)
-      providers ActiveMQ is based on the idea of one or more <emphasis>Message
-      Brokers</emphasis> running on the network which act as a message router
-      and optional persistence store, then <emphasis>Clients</emphasis>
-      connect to one or more Message Broker.</para>
-    </section>
+  &introduction;
+  
+  &installation;
+  
+  &running-broker;
+  
+  &java-client;
+
+  <chapter id="destination-concepts">
+    <title>Destinations in ActiveMQ</title>
+    <para>Discuss the types of destinations and their behavior</para>
   </chapter>
 
-  <chapter id="installation">
-    <title>Installing Apache ActiveMQ</title>
-
-    <para>The first thing you need to do is install Apache ActiveMQ from a
-    binary distribution.</para>
-
-    <para></para>
+  <chapter id="basic-configuration">
+    <title>Basic Configuration</title>
+    <para>In which we discuss the basic layout and concepts of the xbean XML</para>
   </chapter>
-
-  <chapter id="running-broker">
-    <title>Running a Broker</title>
-
-    <para>The most typical deployment of Apache ActiveMQ is for brokers to be
-    run on the network as a stand alone processes then messaging clients
-    connect to one or more brokers. So we will describe how to go about
-    running brokers, then in the <link linkend="java-client">next
-    chapter</link> we will describe how to connect to a broker from a
-    client.</para>
-
-    <para></para>
+  
+  <chapter id="destination-policies">
+    <title>Destination Policy Configuration</title>
+    <para>In which we discuss destination policies.</para>
   </chapter>
 
-  <chapter id="java-client">
-    <title>Using the Java Client</title>
-
-    <para>Apache ActiveMQ fully supports the JMS 1.1 and J2EE 1.4
-    specifications so feel free to follow any documentation you have on JMS or
-    J2EE for more background.</para>
+  <chapter id="persistence">
+    <title>Persistence</title>
+    <para>
+      In which we discuss persistence in the general sense, probably use sections for the 
+      different options.
+    </para>
+  </chapter>
+  
+  <chapter id="transports">
+    <title>Transports</title>
+    <para>In which we discuss transports.</para>
+  </chapter>
 
-    <para></para>
+  <chapter id="networks-of-brokers">
+    <title>Networks of Brokers</title>
+    <para>In which we discuss networks of brokers.</para>
+  </chapter>
+  
+  <chapter id="using-jmx">
+    <title>Using JMX</title>
+    <para>What is doable, and how, via JMX</para>
+  </chapter>
+  
+  <chapter id="web-console">
+    <title>Web Console</title>
+    <para>Setting up and using the web console.</para>
+  </chapter>
+  
+  <chapter id="jms-bridge">
+    <title>The JMS to JMS Bridge</title>
+    <para>Using the JMS to JMS Bridge</para>
+  </chapter>
+  
+  <chapter id="authentication">
+    <title>Authentication</title>
+    <para>Yea!</para>
+  </chapter>
+  
+  <chapter id="deployment-example-small">
+    <title>A Small Deployment</title>
+    <para>...</para>
+  </chapter>
+  
+  <chapter id="deployment-example-multisite">
+    <title>A Multi-Site Deployment Example</title>
+    <para>...</para>
+  </chapter>
+  
+  <chapter id="message-converters">
+    <title>Using Message Converters</title>
+    <para>...</para>
   </chapter>
+  
 </book>

Added: activemq/trunk/activemq-book/src/docbkx/installation.xml
URL: http://svn.apache.org/viewvc/activemq/trunk/activemq-book/src/docbkx/installation.xml?view=auto&rev=505858
==============================================================================
--- activemq/trunk/activemq-book/src/docbkx/installation.xml (added)
+++ activemq/trunk/activemq-book/src/docbkx/installation.xml Sat Feb 10 22:58:58 2007
@@ -0,0 +1,25 @@
+<?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.
+-->
+<chapter id="installation">
+  <title>Installing Apache ActiveMQ</title>
+
+  <para>The first thing you need to do is install Apache ActiveMQ from a
+  binary distribution.</para>
+
+  <para></para>
+</chapter>

Added: activemq/trunk/activemq-book/src/docbkx/introduction.xml
URL: http://svn.apache.org/viewvc/activemq/trunk/activemq-book/src/docbkx/introduction.xml?view=auto&rev=505858
==============================================================================
--- activemq/trunk/activemq-book/src/docbkx/introduction.xml (added)
+++ activemq/trunk/activemq-book/src/docbkx/introduction.xml Sat Feb 10 22:58:58 2007
@@ -0,0 +1,45 @@
+<?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.
+-->
+<chapter id="introduction">
+  <title>Introduction</title>
+  
+  <para><ulink url="http://activemq.apache.org/">Apache ActiveMQ</ulink> is
+  the most popular and powerful open source Message Broker available today.
+  Its hosted at Apache and is distributed under the Apache Software License
+  (2.0).</para>
+
+  <para>ActiveMQ supports different <ulink
+  url="http://activemq.apache.org/cross-language-clients.html">cross
+  language clients</ulink> from many different languages such as Java, C# /
+  .Net, C, C++, Ruby, Python, Perl, PHP together with different protocols
+  like OpenWire, Stomp, REST, Ajax/Cometd, XMPP. ActiveMQ also provides a
+  whole raft of powerful <ulink
+  url="http://activemq.apache.org/features.html">features</ulink> like
+  Message Groups, Exclusive Queues, Master/Slave, Networks of Brokers and so
+  forth.</para>
+
+  <section>
+    <title>Architecture</title>
+
+    <para>Like most Message Orientated Middleware (<acronym>MOM</acronym>)
+    providers ActiveMQ is based on the idea of one or more <emphasis>Message
+    Brokers</emphasis> running on the network which act as a message router
+    and optional persistence store, then <emphasis>Clients</emphasis>
+    connect to one or more Message Broker.</para>
+  </section>
+</chapter>
\ No newline at end of file

Added: activemq/trunk/activemq-book/src/docbkx/java-client.xml
URL: http://svn.apache.org/viewvc/activemq/trunk/activemq-book/src/docbkx/java-client.xml?view=auto&rev=505858
==============================================================================
--- activemq/trunk/activemq-book/src/docbkx/java-client.xml (added)
+++ activemq/trunk/activemq-book/src/docbkx/java-client.xml Sat Feb 10 22:58:58 2007
@@ -0,0 +1,9 @@
+<chapter id="java-client">
+  <title>Using the Java Client</title>
+
+  <para>Apache ActiveMQ fully supports the JMS 1.1 and J2EE 1.4
+  specifications so feel free to follow any documentation you have on JMS or
+  J2EE for more background.</para>
+
+  <para></para>
+</chapter>
\ No newline at end of file

Added: activemq/trunk/activemq-book/src/docbkx/running-broker.xml
URL: http://svn.apache.org/viewvc/activemq/trunk/activemq-book/src/docbkx/running-broker.xml?view=auto&rev=505858
==============================================================================
--- activemq/trunk/activemq-book/src/docbkx/running-broker.xml (added)
+++ activemq/trunk/activemq-book/src/docbkx/running-broker.xml Sat Feb 10 22:58:58 2007
@@ -0,0 +1,29 @@
+<?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.
+-->
+<chapter id="running-broker">
+  <title>Running a Broker</title>
+
+  <para>The most typical deployment of Apache ActiveMQ is for brokers to be
+  run on the network as a stand alone processes then messaging clients
+  connect to one or more brokers. So we will describe how to go about
+  running brokers, then in the <link linkend="java-client">next
+  chapter</link> we will describe how to connect to a broker from a
+  client.</para>
+
+  <para></para>
+</chapter>
\ No newline at end of file