svn commit: r538489 - /incubator/tuscany/java/sca/samples/README

[sl...@apache.org]

Author: slaws
Date: Wed May 16 02:00:28 2007
New Revision: 538489

URL: http://svn.apache.org/viewvc?view=rev&rev=538489
Log:
update to describe how the three extension samples are different from other samples

Modified:
    incubator/tuscany/java/sca/samples/README

Modified: incubator/tuscany/java/sca/samples/README
URL: http://svn.apache.org/viewvc/incubator/tuscany/java/sca/samples/README?view=diff&rev=538489&r1=538488&r2=538489
==============================================================================
--- incubator/tuscany/java/sca/samples/README (original)
+++ incubator/tuscany/java/sca/samples/README Wed May 16 02:00:28 2007
@@ -2,7 +2,8 @@
 ==============================
 
 The Apache Tuscany SCA samples are built as part of the main Maven build and 
-run, using the provided JUnit tests cases, as extra tests in the Maven build. 
+run, using the provided JUnit tests cases, as tests in the Maven build.
+
 In the binary distribution of Apache Tuscany the samples can also 
 be run using the provided Ant build.xml file. This shows the samples running 
 from a simple main() method without the need for a JUnit test case. 
@@ -10,6 +11,29 @@
 In these notes text that appears in angled brackets like this <example> means 
 that you need to make a choice and provide you own text at that point. 
 
+Sample Overview
+---------------
+The samples generally show off different features of the SCA runtime
+and the extensions that come packaged with it. Hence samples generally
+describe SCA component implementations and the clients required to drive the
+resulting applications. 
+
+As is always the case there are exceptions to this. There are three samples
+that demonstrate how to build extensions for the Tuscany SCA runtime.
+
+binding-echo        - shows how to build a binding extension
+databinding-echo    - shows how to build a databinding extension
+implementation-crud - shows how to build an implemenation extension
+
+In these samples the provided code is concerned with building the extension
+and now with building an application that uses it. The application
+that shows how the new extension can be used is provided in an associated
+client sample. 
+
+binding-echo-client
+databinding-echo-client
+implementation-crud-client
+
 Sample Layout
 -------------
 All sample directories are organized in the same way based on the default 
@@ -63,10 +87,11 @@
 run a sample based on all of the precompiled artifacts all you have to do is:
 
 cd <sampledir>
-ant
+ant run
 
 Check each <sampledir>/README file as some samples require that two progams are
-run to get the desired result. 
+run to get the desired result, for example, the three samples that show how
+to build extensions a run from their associated client samples. 
 
 If you want to rebuild a sample, for example, if you have changed it, do the
 following:
@@ -80,7 +105,7 @@
 The compile target builds the class files and then builds the jar so you can use 
 the same command as before:
 
-ant
+ant run
 
 This will use the generated jar to run the samples. The command line version of
 this is:



---------------------------------------------------------------------
To unsubscribe, e-mail: tuscany-commits-unsubscribe@ws.apache.org
For additional commands, e-mail: tuscany-commits-help@ws.apache.org