[ARVADOS] updated: 0eb4abfca9127ad1a7a8153840f876e512c624cb

[git at public.curoverse.com]

Summary of changes:
 ....liquid => _run_command_foreach_example.liquid} |  1 -
 ...e.liquid => _run_command_simple_example.liquid} |  1 -
 doc/user/topics/run-command.html.textile.liquid    | 35 ++++++++++++++++++----
 3 files changed, 30 insertions(+), 7 deletions(-)
 copy doc/_includes/{_run_command_example.liquid => _run_command_foreach_example.liquid} (93%)
 rename doc/_includes/{_run_command_example.liquid => _run_command_simple_example.liquid} (93%)

       via  0eb4abfca9127ad1a7a8153840f876e512c624cb (commit)
      from  3e4b42f63c615ca1a7130f7b935d63118874d984 (commit)

Those revisions listed above that are new to this repository have
not appeared on any other notification email; so we list those
revisions in full, below.


commit 0eb4abfca9127ad1a7a8153840f876e512c624cb
Author: Peter Amstutz <peter.amstutz at curoverse.com>
Date:   Thu Oct 2 17:11:23 2014 -0400

    4042: Getting started on run-command reference

diff --git a/doc/_includes/_run_command_example.liquid b/doc/_includes/_run_command_foreach_example.liquid
similarity index 93%
copy from doc/_includes/_run_command_example.liquid
copy to doc/_includes/_run_command_foreach_example.liquid
index 6de156d..dfa14c9 100644
--- a/doc/_includes/_run_command_example.liquid
+++ b/doc/_includes/_run_command_foreach_example.liquid
@@ -12,7 +12,6 @@
             "$(glob $(dir $(sample))/*_1.fastq)",
             "$(glob $(dir $(sample))/*_2.fastq)"
         ],
-        "task.foreach": ["samples", "pairs"],
         "task.stdout": "$(basename $(glob $(dir $(sample))/*_1.fastq)).sam"
         "reference_collection": {
             "required": true,
diff --git a/doc/_includes/_run_command_example.liquid b/doc/_includes/_run_command_simple_example.liquid
similarity index 93%
rename from doc/_includes/_run_command_example.liquid
rename to doc/_includes/_run_command_simple_example.liquid
index 6de156d..dfa14c9 100644
--- a/doc/_includes/_run_command_example.liquid
+++ b/doc/_includes/_run_command_simple_example.liquid
@@ -12,7 +12,6 @@
             "$(glob $(dir $(sample))/*_1.fastq)",
             "$(glob $(dir $(sample))/*_2.fastq)"
         ],
-        "task.foreach": ["samples", "pairs"],
         "task.stdout": "$(basename $(glob $(dir $(sample))/*_1.fastq)).sam"
         "reference_collection": {
             "required": true,
diff --git a/doc/user/topics/run-command.html.textile.liquid b/doc/user/topics/run-command.html.textile.liquid
index 1a2616b..85eefa8 100644
--- a/doc/user/topics/run-command.html.textile.liquid
+++ b/doc/user/topics/run-command.html.textile.liquid
@@ -4,11 +4,36 @@ navsection: userguide
 title: "run-command reference"
 ...
 
-The @run-command@ crunch script provides a way to run a command over a dataset.  Run-command is controlled through the script_parameters section of a pipeline component.
+The @run-command@ crunch script enables you run command line programs.
 
-<notextile>{% code 'run_command_example' as javascript %}</notextile>
+h2. Basic usage
 
-The script_parameters section consists of three parts:
-* The @command@ section defining how to build the command line of task
-* Special processing directives @task.foreach@ @task.cwd@ @task.vwd@ @task.stdin@ @task.stdout@
+Run-command is controlled through the script_parameters section of a pipeline component.  The script_parameters of run-command section consists of three parts:
 * User-defined parameters
+* Special processing directives @task.foreach@ @task.cwd@ @task.vwd@ @task.stdin@ @task.stdout@
+* The @command@ section defines the template to actually build the command line of task
+
+h3. Parameter substitution
+
+Any entry in the "script_parameters" object that is not a directive or reserved parameter is a user-defined parameter.  User-defined parameters can be used in parameter substitution and in directives.  String substitution is indicated by wrapping the expression with @$(...)@.  In the following example, using @$(varA)@ for the value of "varB" denotes that it should be replaced with the value of the parameter "varA", which is "ABC".
+
+<pre>
+"script_parameters": {
+  "varA": "ABC",
+  "varB": "$(varA)"
+}
+</pre>
+
+
+
+h3. Directives
+
+h3. Command template
+
+The command section
+
+h2. Examples
+
+<notextile>{% code 'run_command_simple_example' as javascript %}</notextile>
+
+<notextile>{% code 'run_command_foreach_example' as javascript %}</notextile>

-----------------------------------------------------------------------


hooks/post-receive
--