TUSCANY-3563 new style contribution READMEs

git-svn-id: http://svn.us.apache.org/repos/asf/tuscany@947579 13f79535-47bb-0310-9956-ffa450edef68

1 files changed, 8 insertions, 112 deletions

diff --git a/sca-java-2.x/trunk/samples/binding-rmi/contribution-calculator-reference/README b/sca-java-2.x/trunk/samples/binding-rmi/contribution-calculator-reference/README
index 07b6dd9713..2f169419ba 100644
--- a/sca-java-2.x/trunk/samples/binding-rmi/contribution-calculator-reference/README
+++ b/sca-java-2.x/trunk/samples/binding-rmi/contribution-calculator-reference/README
@@ -1,38 +1,14 @@
-Calculator RMI Reference Sample
-===============================
+Calculator RMI Reference Sample Contribution
+============================================
 
 This sample illustrates the use of Tuscany RMI Binding to call reference 
 services that are hosted as Java RMI services.  
 
-The README in the samples directory (the directory above this) provides 
-general instructions about building and running samples. Take a look there 
-first. 
-
-If you just want to run it to see what happens open a command prompt, first 
-navigate to the calculator-rmi-service sample and do:
-
-ant run
-
-OR if you don't have ant, on Windows do
-
-java -cp ..\..\features\tuscany-sca-manifest.jar;target\sample-calculator-rmi-service.jar calculator.CalculatorServer
-
-and on *nix do
-
-java -cp ../../features/tuscany-sca-manifest.jar:target/sample-calculator-rmi-service.jar calculator.CalculatorServer
-
-Now you have the server running you need to open another command prompt, navigate
-to this sample directory and do:
-
-ant run
-
-OR if you don't have ant, on Windows do
-
-java -cp ..\..\features\tuscany-sca-manifest.jar;target\sample-calculator-rmi-reference.jar calculator.CalculatorClient
-
-and on *nix do
-
-java -cp ../../features/tuscany-sca-manifest.jar:target/sample-calculator-rmi-reference.jar calculator.CalculatorClient
+The README in the <distribution-unpack-dir>/samples directory provides 
+general instructions about building and running samples. ( where
+distribution-unpack-dir is the directory in which you unpacked the tuscany
+binary distribution archive) Take a look there for instructions on how to launch
+this sample contribution. 
 
 Sample Overview
 ---------------
@@ -42,97 +18,17 @@ divide components, an RMI service implementation now provides the
 add, subtract, multiply and divide interfaces and is hosted as an RMI server. 
 References specified in the .composite file include an RMI binding which targets
 this RMI server.
-
-This sample adds a number of classes to the basic calculator sample:
-
-calculator-rmi-reference/
-  src/
-    main/
-      java/
-        calculator/
-          CalculatorService.java  - as calculator sample
-          AddService.java         - as calculator sample
-          SubtractService.java    - as calculator sample
-          MultipleService.java    - as calculator sample
-          DivideService.java      - as calculator sample
-          CalculatorClient.java   - as calculator sample
-          CalculatorServiceImpl.java - calls the RMI service
-                                    that provides the target for the 
-                                    RMI bindings in the composite 
-      resources/
-        CalculatorRMIReference.composite - the SCA assembly for this sample
-    test/
-      java/
-        calculator/
-          CalculatorRMIReferenceTestCase.java - JUnit test case
-          CalculatorRMIServiceImpl.java - test RMI service to call
-  calculator-rmi-reference.png    - a pictorial representation of the 
-                                    .composite file
-  build.xml                       - the Ant build file for the client
-  pom.xml                         - the Maven build file   
-  
 Note. As this test creates and uses local network connections you may need to 
 configure your firewall, if you are running one, to allow the test to run
 successfully.         
 
-Building And Running The Sample Using Ant
------------------------------------------
-With the binary distribution the sample can be built and run using Ant. 
+Amongst the other output created by the launcher/contribution combination,  you should see the following output ...
 
-The server provides an RMI server that the acts as a target for the SCA RMI 
-bindings. Start a new console and use the following commands.
 
-cd calculator-rmi-service
-ant compile
-ant run
-
-This will run up the server and display the following.
-
-run:
-     [java] Starting of the SCA Calculator Application exposed as RMI Services... 
-     [java] ...Press Enter to Exit...
-     
-The client is very similar to the calculator sample. It starts the SCA runtime
-and calls each of the calculator operations. In doing this the RMI bindings
-make calls out to the RMI server you started in the previous step. Start
-a new console and use the following commands. 
-
-cd calculator-rmi-reference
-ant compile
-ant run
-
-You should see the following output from the run target.
-
-run:
      [java] 3 + 2=5.0
      [java] 3 - 2=1.0
      [java] 3 * 2=6.0
      [java] 3 / 2=1.5
      
-If you now return to the console window running the server and press enter the 
-server should stop.     
-
-Building And Running The Sample Using Maven 
--------------------------------------------
-With either the binary or source distributions the sample can be built and run 
-using Maven as follows. 
-
-cd calculator-rmi-reference
-mvn
-
-You should see the following output from the test phase.
-
--------------------------------------------------------
- T E S T S
--------------------------------------------------------
-Running calculator.CalculatorRMIReferenceTestCase
-Tests run: 1, Failures: 0, Errors: 0, Skipped: 0, Time elapsed: 5.308 sec
-
-Results :
-
-Tests run: 1, Failures: 0, Errors: 0, Skipped: 0
-
-This shows that the Junit test cases have run successfully.
-