Added a bit more documentation

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

activemq-book/src/docbkx/activemq.xml

@@ -1,5 +1,4 @@
 <?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
@@ -16,69 +15,81 @@
   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">
+"http://www.oasis-open.org/docbook/xml/4.4/docbookx.dtd">
 <book>
   <bookinfo>
     <title>Apache ActiveMQ - User Guide</title>
-    <releaseinfo>4.2</releaseinfo>
+    <releaseinfo>&version;</releaseinfo>
+
     <authorgroup>
       <author>
         <firstname>James</firstname>
         <surname>Strachan</surname>
       </author>
+
       <author>
         <firstname>Brian</firstname>
         <surname>McCallister</surname>
       </author>
     </authorgroup>
+
     <legalnotice>
-      <para>
+      <para>Licensed to the Apache Software Foundation (ASF) under one or more
-        Licensed to the Apache Software Foundation (ASF) under one or more
+      contributor license agreements. See the NOTICE file distributed with
-        contributor license agreements. See the NOTICE file distributed with
+      this work for additional information regarding copyright ownership. The
-        this work for additional information regarding copyright ownership.
+      ASF licenses this file to You under the Apache License, Version 2.0 (the
-        The ASF licenses this file to You under the Apache License, Version 2.0
+      "License"); you may not use this file except in compliance with the
-        (the "License"); you may not use this file except in compliance with
+      License. You may obtain a copy of the License at</para>
-        the License. You may obtain a copy of the License at
-      </para>
 
-      <para>
+      <para>http://www.apache.org/licenses/LICENSE-2.0</para>
-        http://www.apache.org/licenses/LICENSE-2.0
-      </para>
 
-      <para>
+      <para>Unless required by applicable law or agreed to in writing,
-        Unless required by applicable law or agreed to in writing, software
+      software distributed under the License is distributed on an "AS IS"
-        distributed under the License is distributed on an "AS IS" BASIS,
+      BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or
-        WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+      implied. See the License for the specific language governing permissions
-        See the License for the specific language governing permissions and
+      and limitations under the License.</para>
-        limitations under the License.
-      </para>
     </legalnotice>
   </bookinfo>
-  <toc/>
 
+  <toc></toc>
 
   <chapter id="introduction">
     <title>Introduction</title>
+
     <para></para>
 
-    <para>Apache ActiveMQ is the most popular and powerful open source Message
+    <para><ulink url="http://activemq.apache.org/">Apache ActiveMQ</ulink> is
-      Broker available today. Its hosted at Apache and is distributed under the
+    the most popular and powerful open source Message Broker available today.
-      Apache Software License (2.0).
+    Its hosted at Apache and is distributed under the Apache Software License
-    </para>
+    (2.0).</para>
 
-    <section id="introduction-overview">
+    <para>ActiveMQ supports different <ulink
-      <title>Overview</title>
+    url="http://activemq.apache.org/cross-language-clients.html">cross
-      <para></para>
+    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>
 
   <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>The first thing you need to do is install Apache ActiveMQ from a
-    </para>
+    binary distribution.</para>
 
     <para></para>
   </chapter>
@@ -86,11 +97,12 @@
   <chapter id="running-broker">
     <title>Running a Broker</title>
 
-
+    <para>The most typical deployment of Apache ActiveMQ is for brokers to be
-    <para>The most typical deployment of Apache ActiveMQ, particularly if persistent messaging is to be used is for
+    run on the network as a stand alone processes then messaging clients
-      brokers to be run on the network somewhere. This chapter takes you through running a broker as a stand alone
+    connect to one or more brokers. So we will describe how to go about
-      process.
+    running brokers, then in the <link linkend="java-client">next
-    </para>
+    chapter</link> we will describe how to connect to a broker from a
+    client.</para>
 
     <para></para>
   </chapter>
@@ -98,9 +110,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
+    <para>Apache ActiveMQ fully supports the JMS 1.1 and J2EE 1.4
-      documentation you have on JMS or J2EE for more background.
+    specifications so feel free to follow any documentation you have on JMS or
-    </para>
+    J2EE for more background.</para>
 
     <para></para>
   </chapter>