Merge branch 'master' into 14965-arv-mount-py-three

[arvados.git] / doc / sdk / cli / subcommands.html.textile.liquid

diff --git a/doc/sdk/cli/subcommands.html.textile.liquid b/doc/sdk/cli/subcommands.html.textile.liquid
index d2add52a325c09f2529aa32d14a4290026e39ada..b23ec46fa75f35f1955aea204d3f01bd6407f365 100644 (file)
--- a/doc/sdk/cli/subcommands.html.textile.liquid
+++ b/doc/sdk/cli/subcommands.html.textile.liquid
@@ -5,6 +5,11 @@ navmenu: CLI
 title: "arv subcommands"
 
 ...
+{% comment %}
+Copyright (C) The Arvados Authors. All rights reserved.
+
+SPDX-License-Identifier: CC-BY-SA-3.0
+{% endcomment %}
 
 _In order to use the @arv@ command, make sure that you have a "working environment.":{{site.baseurl}}/user/getting_started/check-environment.html_
 
@@ -27,19 +32,11 @@ h3(#arv-get). arv get
 
 <notextile>
 <pre>
-$ <code class="userinput">arv arv get --help</code>
-Usage: arv get [uuid] [fields...]
-Fetch the specified Arvados object, select the specified fields,
-and print a text representation (json or yaml, use --format).
-</pre>
-</notextile>
-*Note*: the 'format' flag is used by @arv@ (not @arv get@), as detailed on the "arv CLI overview page":{{site.baseurl}}/sdk/cli/index.html.
+$ <code class="userinput">arv get --help</code>
+Usage: arv [--format json|yaml] get [uuid] [fields...]
 
-This command can be used instead of the previously required:
-
-<notextile>
-<pre>
-$ <code class="userinput">EDITOR=cat arv edit [uuid]</code>
+Fetch the specified Arvados object, select the specified fields,
+and print a text representation.
 </pre>
 </notextile>
 
@@ -143,6 +140,8 @@ arv tag remove --all
 
 h3(#arv-ws). arv ws
 
+This is a frontend to @arv-ws@.
+
 @arv ws@ provides access to the websockets event stream.
 
 <notextile>
@@ -171,7 +170,7 @@ optional arguments:
 
 h3(#arv-keep). arv keep
 
-@arv keep@ provides access to the Keep storage service.
+@arv keep@ commands for accessing the Keep storage service.
 
 <notextile>
 <pre>
@@ -185,6 +184,8 @@ Available methods: ls, get, put, docker
 
 h3(#arv-keep-ls). arv keep ls
 
+This is a frontend to @arv-ls@.
+
 <notextile>
 <pre>
 $ <code class="userinput">arv keep ls --help</code>
@@ -206,6 +207,8 @@ optional arguments:
 
 h3(#arv-keep-get). arv keep get
 
+This is a frontend to @arv-get@.
+
 <notextile>
 <pre>
 $ <code class="userinput">arv keep get --help</code>
@@ -259,6 +262,8 @@ optional arguments:
 
 h3(#arv-keep-put). arv keep put
 
+This is a frontend to @arv-put@.
+
 <notextile>
 <pre>
 $ <code class="userinput">arv keep put --help</code>
@@ -338,6 +343,8 @@ optional arguments:
 
 h3(#arv-pipeline-run). arv pipeline run
 
+WARNING: this uses the obsolete "job" API.  Don't use this.  You should use @arvados-cwl-runner@ instead.
+
 @arv pipeline run@ can be used to start a pipeline run from the command line.
 
 The User Guide has a page with a bit more information on "using arv pipeline run":{{site.baseurl}}/user/topics/running-pipeline-command-line.html.
@@ -384,6 +391,8 @@ Options:
 
 h3(#arv-run). arv run
 
+WARNING: this uses the obsolete "job" API.  Don't use this.  You should use @arvados-cwl-runner@ instead.
+
 The @arv-run@ command creates Arvados pipelines at the command line that fan out to multiple concurrent tasks across Arvados compute nodes.
 
 The User Guide has a page on "using arv-run":{{site.baseurl}}/user/topics/arv-run.html.