QPID-3230: updates to getting started page and 0.10 release notes page

Applied patch from Justin Ross <jross@redhat.com>


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

2 files changed, 35 insertions, 25 deletions

diff --git a/qpid/doc/website/content/getting_started.html b/qpid/doc/website/content/getting_started.html
index 5a3a8cb602..5706d77781 100644
--- a/qpid/doc/website/content/getting_started.html
+++ b/qpid/doc/website/content/getting_started.html
@@ -23,8 +23,12 @@
   <p>To get started with Apache Qpid, follow the steps below.</p>
  
   <ol>
-    <li>Download the software <a href="download.cgi" title="Download">Download</a></li>
-    <li>Start a broker.
+    <li>Download the software:
+      <ul>
+	<li><a href="download.cgi" title="Download page">Download page</a></li>
+      </ul>
+    </li>
+    <li>Start a broker:
       <ul>
 	<li>Instructions for <a href="https://cwiki.apache.org/qpid/getting-started-guide.html" title="Getting Started Guide">running a Qpid Java broker (AMQP 0-8, 0-9) </a></li>
 	<li>Instructions for <a href="http://qpid.apache.org/books/trunk/AMQP-Messaging-Broker-CPP-Book/html/ch01.html#section-Running-a-Qpid-CPP-Broker" title="RASC">running a Qpid C++ broker (AMQP 0-10) </a></li>
@@ -32,12 +36,11 @@
 	<li><a href="https://cwiki.apache.org/qpid/mgmtc.html" title="MgmtC++">Management tools </a>  (AMQP 0-10, works with the Qpid C++ broker)</li>
       </ul>
     </li>
-    <li>Run an example program from the downloaded software, or from the following URLs (these are svn URLs, which you can use to browse the examples or check them out):
+    <li>Run an example program from the downloaded software, or from the following URLs (these are Subversion URLs, which you can use to browse the examples or check them out):
       <ul>
 	<li>C++ (AMQP 0-10):
 	  <ul>
 	    <li>Examples: <a href="https://svn.apache.org/repos/asf/qpid/trunk/qpid/cpp/examples/">https://svn.apache.org/repos/asf/qpid/trunk/qpid/cpp/examples/ </a></li>
-
 	    <li><a href="https://svn.apache.org/repos/asf/qpid/trunk/qpid/cpp/examples/README.txt">Running the C++ Examples </a></li>
 	  </ul>
 	</li>
@@ -45,7 +48,6 @@
 	  <ul>
 	    <li>Examples: <a href="https://svn.apache.org/repos/asf/qpid/trunk/qpid/java/client/example/">https://svn.apache.org/repos/asf/qpid/trunk/qpid/java/client/example/ </a></li>
 	    <li><a href="https://svn.apache.org/repos/asf/qpid/trunk/qpid/java/client/example/src/main/java/runSample.sh">Script for Running the Java JMS Examples </a></li>
-
 	  </ul>
 	</li>
 	<li>Python (AMQP 0-10):
@@ -54,30 +56,16 @@
 	    <li><a href="https://svn.apache.org/repos/asf/qpid/trunk/qpid/python/examples/README">Running the Python Examples </a></li>
 	  </ul>
 	</li>
-
-	<li>Ruby (AMQP 0-10):
-	  <ul>
-	    <li>Examples: <a href="https://svn.apache.org/repos/asf/qpid/trunk/qpid/ruby/examples/">https://svn.apache.org/repos/asf/qpid/trunk/qpid/ruby/examples/ </a></li>
-	  </ul>
-	</li>
-	<li>.NET (AMQP 0-10):
-	  <ul>
-	    <li>Examples: <a href="http://svn.apache.org/viewvc/qpid/trunk/qpid/dotnet/client-010/examples/">http://svn.apache.org/viewvc/qpid/trunk/qpid/dotnet/client-010/examples/ </a></li>
-
-	    <li><a href="https://cwiki.apache.org/qpid/net-user-guide.html">.NET Tutorial </a></li>
-	  </ul>
-	</li>
       </ul>
     </li>
-    <li>Read the API Guides and Documentation
+    <li>Read the API Guides and Documentation:
       <ul>
-	<li><p><a href="documentation.html">API Guides and Documentation</a></li>
+	<li><a href="documentation.html">API Guides and Documentation</a></li>
       </ul>
     </li>
-    <li>Get your Questions Answered
+    <li>Get your questions answered:
       <ul>
 	<li>Read the <a href="https://cwiki.apache.org/qpid/faq.html" title="FAQ">FAQ</a></li>
-
 	<li>Ask a question on the user list <a href="mailto:users-subscribe@qpid.apache.org">users-subscribe@qpid.apache.org</a></li>
       </ul>
     </li>
diff --git a/qpid/doc/website/content/release_notes_0.10.html b/qpid/doc/website/content/release_notes_0.10.html
index 8357150824..5c3aa3a9e7 100644
--- a/qpid/doc/website/content/release_notes_0.10.html
+++ b/qpid/doc/website/content/release_notes_0.10.html
@@ -21,10 +21,19 @@
 <div class="main_text_area_body">
   <h1>0.10 Release Notes</h1>
 
-<p>The full list of changes in the Qpid 0.10 release incorporates both the issues worked on during the 0.9 development stream and any final touches made during the 0.10 release process. A list of these JIRA issues can be found below.</p>
+<h3>Changes Requiring User Attention</h3>
+
+<ul>
+  <li>The C++ broker now enables producer flow control by default. It is controlled via the default-flow-stop-threshold and default-flow-resume-threshold broker configuration parameters. See <a href="https://issues.apache.org/jira/browse/QPID-2935">QPID-2935</a>.</li>
+  <li>In the C++ broker, when declaring an exchange with an unknown type or canceling a message on an unknown subscription, an exception with code 404 is created. See <a href="https://issues.apache.org/jira/browse/QPID-2324">QPID-2324</a> and <a href="https://issues.apache.org/jira/browse/QPID-2326">QPID-2326</a>.</li>
+  <li>The C++ broker now enables QMF version 1 and 2 event broadcasts by default. Previously only QMF version 1 events were enabled.</li>
+  <li>In the C++ broker, invalid arguments now result in a rejected queue-declare where previously they were ignored. See <a href="https://issues.apache.org/jira/browse/QPID-3087">QPID-3087</a>.</li>
+  <li>The C++ client now raises an exception if it is issued connection options that it doesn't recognize. Previously it silently ignored them. See <a href="https://issues.apache.org/jira/browse/QPID-3115">QPID-3115</a>.</li>
+</ul>
 
-<h3>JIRA Issues</h3>
+<h3>Resolved Issues</h3>
 
+<p>The full list of changes in the Qpid 0.10 release incorporates both the issues worked on during the 0.9 development stream and any final touches made during the 0.10 release process. A list of these JIRA issues can be found below.</p>
 
 <h4>New Feature</h4>
 <ul>
@@ -355,5 +364,18 @@
 <li>[<a href='https://issues.apache.org/jira/browse/QPID-3023'>QPID-3023</a>] -         logging tests unnecessarily use an InternalBrokerBaseCase to load configuration for test comparison
 </li>
 </ul>
-        
+
+<h3>Known Issues</h3>
+
+<ul>
+<li>[<a href='https://issues.apache.org/jira/browse/QPID-3182'>QPID-3182</a>] -         Node bindings not established correctly when address used for producer
+<li>[<a href='https://issues.apache.org/jira/browse/QPID-3214'>QPID-3214</a>]* -        Deadlock between the failover mutex (in AMQConnection.java) and the current_exception_lock (in AMQSession.java)
+<li>[<a href='https://issues.apache.org/jira/browse/QPID-3216'>QPID-3216</a>]* -        Deadlock between "_lock" (in AMQSession#DisptcherThread) and "_messageDeliveryLock" (in AMQSession.java)
+</ul>
+
+<p>*Although these deadlocks are present in the release, the changes
+that are known to trigger them were committed post-release. Therefore
+the likelihood of these deadlocks appearing in the 0.10 release is
+slim.</p>
+
 </div>