Added a README_TESTS, modified the build.xml to only run server tests if umbrella present, added some more descriptions to ant targets

Author: Tim Clark

README-TESTS

@@ -0,0 +1,83 @@
+There are multiple test suites in the RabbitMQ Java client library; the source
+for all of the suites can be found in the test/src directory.
+
+The suites are:
+
+  Client tests
+  Funtional tests
+
+To run any of these test suites you need to first satisfy the following
+preconditions:
+
+  1. Ensure that you are running a RabbitMQ server locally on the standard 
+port.
+  2. Ensure that you have successfully built the javas client using ANT.
+
+All the test suites can be run with the command ant test-suite. To run 
+specific test suites see the instructions below.
+
+
+RUNNING CLIENT TESTS
+
+To run these tests, from the command line in the project directory execute
+the command ant test-client. For example:
+
+----------------- Example shell session -------------------------------------
+rabbitmq-java-client$ ant test-client
+Buildfile: build.xml
+
+test-prepare:
+
+test-build:
+
+amqp-generate-check:
+
+amqp-generate:
+
+build:
+
+test-build-param:
+
+test-client:
+    [junit] Running com.rabbitmq.client.test.ClientTests
+    [junit] Tests run: 31, Failures: 0, Errors: 0, Time elapsed: 2.388 sec
+
+BUILD SUCCESSFUL
+-----------------------------------------------------------------------------
+
+If any tests are broken details can be found by viewing this file:
+	build/TEST-com.rabbitmq.client.test.ClientTests.txt
+
+
+RUNNING FUNCTIONAL TESTS
+
+To run these tests, from the command line in the project directory execute
+the command ant test-functional.
+
+----------------- Example shell session -------------------------------------
+rabbitmq-java-client$ ant test-functional
+Buildfile: build.xml
+
+test-prepare:
+
+test-build:
+
+amqp-generate-check:
+
+amqp-generate:
+
+build:
+
+test-build-param:
+
+test-functional:
+    [junit] Running com.rabbitmq.client.test.functional.FunctionalTests
+    [junit] Tests run: 69, Failures: 0, Errors: 0, Time elapsed: 10.621 sec
+
+BUILD SUCCESSFUL
+Total time: 11 seconds
+-----------------------------------------------------------------------------
+
+If any tests are broken details can be found by viewing this file:
+	build/TEST-com.rabbitmq.client.test.functional.FunctionalTests.txt
+

build.xml

@@ -77,7 +77,7 @@
   	</fail>
   </target>
 
-  <target name="build" depends="amqp-generate">
+  <target name="build" depends="amqp-generate" description="Build the client library.">
     <mkdir dir="${javac.out}"/>
     <copy file="src/com/rabbitmq/client/impl/ClientVersion.java.in"
 	  tofile="${src.generated}/com/rabbitmq/client/impl/ClientVersion.java">
@@ -116,6 +116,10 @@
     <property name="SSL_P12_PASSWORD" value="${env.PASSWORD}"/>
   </target>
 
+  <target  name="detect-umbrella">
+    <available property="UMBRELLA_AVAIALBLE" file="../rabbitmq-test"/>
+  </target>
+
   <target name="detect-tmpdir">
     <property environment="env"/>
     <condition property="TMPDIR" value="${env.TMPDIR}" else="/tmp">
@@ -317,7 +321,7 @@
   	<property name="haltOnFailureJava" value="false" />	
   </target>
 
-  <target name="test-suite" depends="test-suite-prepare, test-suite-run">
+  <target name="test-suite" depends="test-suite-prepare, test-suite-run" description="Run all test suites.">
   	<fail message="Errors occured in tests">
   	    <condition>
             <not>
@@ -329,7 +333,7 @@
 
   <target name="test-suite-run" depends="test-client, test-ssl, test-server, test-functional, test-main-silent"/>
 
-  <target name="test-client" depends="test-build">
+  <target name="test-client" depends="test-build" description="Run the client test suites.">
     <junit printSummary="withOutAndErr"
         haltOnFailure="${haltOnFailureJunit}"
         failureproperty="test.failure"
@@ -362,7 +366,7 @@
     <antcall target="remove-client-keystore"/>
   </target>
 
-  <target name="test-functional" depends="test-build">
+  <target name="test-functional" depends="test-build" description="Run the functional test suite.">
     <junit printSummary="withOutAndErr"
         haltOnFailure="${haltOnFailureJunit}"
         failureproperty="test.failure"
@@ -375,7 +379,7 @@
     </junit>
   </target>
 
-  <target name="test-server" depends="test-build">
+  <target name="test-server" depends="test-build" if="UMBRELLA_AVAILABLE">
     <junit printSummary="withOutAndErr"
         haltOnFailure="${haltOnFailureJunit}"
         failureproperty="test.failure"