svn commit: r1037881 - in /qpid/trunk/qpid/java/client: README.txt build.xml

[ro...@apache.org]

Author: robbie
Date: Mon Nov 22 20:49:00 2010
New Revision: 1037881

URL: http://svn.apache.org/viewvc?rev=1037881&view=rev
Log:
add README.txt file for Java client, include in the distributed binary convenience archive

Added:
    qpid/trunk/qpid/java/client/README.txt
Modified:
    qpid/trunk/qpid/java/client/build.xml

Added: qpid/trunk/qpid/java/client/README.txt
URL: http://svn.apache.org/viewvc/qpid/trunk/qpid/java/client/README.txt?rev=1037881&view=auto
==============================================================================
--- qpid/trunk/qpid/java/client/README.txt (added)
+++ qpid/trunk/qpid/java/client/README.txt Mon Nov 22 20:49:00 2010
@@ -0,0 +1,51 @@
+Documentation
+=============
+
+You can access documentation for the client via our website at:
+http://qpid.apache.org/documentation
+
+and via our wiki at:
+http://cwiki.apache.org/confluence/display/qpid/Qpid+Java+Documentation
+
+The client uses the Java Message Service (JMS) 1.1 API, information on which is
+widely available using your favoured search engine.
+
+
+Running the Examples:
+=====================
+
+1. From the client Binary distribution:
+
+From the <installation path>/qpid-client-<version> directory, there are examples
+provided in source form in the example/src sub-directory. These are also
+provided in binary form in the example/lib directory in order that they can be
+run more easily.
+
+E.g, in order to run the Hello example, you would add the client+example library
+files to the java classpath and launch the example like follows:
+
+java -cp "lib/qpid-all.jar:example/lib/qpid-client-examples-<version>.jar" \
+    org.apache.qpid.example.Hello
+
+NOTE: The client uses the SL4FJ API for its logging. You must supply a logging 
+implementation of your choice (eg Log4J) and its associated SLF4J binding, by 
+also adding them to the Java classpath as well as the client libraries 
+themselves. Failure to do so will result in a warning being output and use of
+NoOp logging by the client.
+
+More information on using SLF4J is available at http://www.slf4j.org/manual.html
+which details some of the suipported logging implementations and their
+associted SLF4 bindings as available in the SLF4J distribution.
+
+
+
+2. From the Source distribution / repository:
+
+Run 'ant build' in the parent directory from where this file is stored, ie:
+<installation path>/qpid/java
+
+This will build the various Java modules, leaving binary .jar files output in:
+<installation path>/qpid/java/build/lib
+
+Taking the above the 'distribution directory', consult the README.txt file at:
+<installation path>/qpid/java/client/example/src/main/java

Modified: qpid/trunk/qpid/java/client/build.xml
URL: http://svn.apache.org/viewvc/qpid/trunk/qpid/java/client/build.xml?rev=1037881&r1=1037880&r2=1037881&view=diff
==============================================================================
--- qpid/trunk/qpid/java/client/build.xml (original)
+++ qpid/trunk/qpid/java/client/build.xml Mon Nov 22 20:49:00 2010
@@ -58,7 +58,13 @@
       </copy>
   </target>
 
-  <target name="release-bin-other" depends="release-bin-copy-examples"/>
+  <target name="release-bin-copy-readme">
+      <copy todir="${module.release}" overwrite="true" failonerror="true">
+          <fileset file="${basedir}/README.txt" />
+      </copy>
+  </target>
+
+  <target name="release-bin-other" depends="release-bin-copy-examples,release-bin-copy-readme"/>
 
   <target name="release-bin" depends="release-bin-tasks"/>    
 



---------------------------------------------------------------------
Apache Qpid - AMQP Messaging Implementation
Project:      http://qpid.apache.org
Use/Interact: mailto:commits-subscribe@qpid.apache.org