X-Git-Url: https://git.arvados.org/arvados.git/blobdiff_plain/10184eeb601e432f8e81aea00cbc2375f79bcf45..078bdb166766423e1a423523e5285966aff7ec6b:/doc/sdk/cli/index.html.textile.liquid

diff --git a/doc/sdk/cli/index.html.textile.liquid b/doc/sdk/cli/index.html.textile.liquid
index ab5a41d5e4..d64fb23df2 100644
--- a/doc/sdk/cli/index.html.textile.liquid
+++ b/doc/sdk/cli/index.html.textile.liquid
@@ -2,62 +2,56 @@
 layout: default
 navsection: sdk
 navmenu: CLI
-title: "Command line SDK"
+title: "Overview"
 
 ...
 
-h1. Command line SDK
+The @arv@ CLI tool provide provides a convenient interface to manipulate API resources. Additionally, it provides access to a number of subcommands.
 
-The @arv@ CLI tool provides a generic set of wrappers so you can make API calls easily. It performs some validation before connecting to the API server: for example, it refuses to do an API call if a required parameter is missing.
+h3. Syntax
 
-It also provides access to Keep storage services with the @arv keep@ subcommand.
+The @arv@ command takes the following arguments:
 
-h3. Usage
+<pre>
+Arvados command line client
+Usage: arv [--flags] subcommand|resource [method] [--parameters]
 
-See the "command line interface":{{site.baseurl}}/user/reference/sdk-cli.html page in the user guide.
+Available flags:
+  -n, --dry-run       Don't actually do anything
+  -v, --verbose       Print some things on stderr
+  -f, --format=<s>    Set the output format. Must be one of json (default),
+                      yaml or uuid. (Default: json)
+  -s, --short         Return only UUIDs (equivalent to --format=uuid)
 
-h3. Installation
+Use 'arv subcommand|resource --help' to get more information about a particular
+command or resource.
 
-If you are logged in to an Arvados VM, the @arv@ should be installed.
+Available subcommands: copy, create, edit, keep, pipeline, run, tag, ws
 
-To use @arv@ elsewhere, you can either install the @arvados-cli@ gem via RubyGems or build and install the package using the arvados source tree.
+Available resources: api_client_authorization, api_client, authorized_key,
+collection, user_agreement, group, job_task, link, log, keep_disk,
+pipeline_instance, node, repository, specimen, pipeline_template, user,
+virtual_machine, trait, human, job, keep_service
 
-h4. Prerequisites: Ruby &gt;= 2.0.0 and curl libraries
+Additional options:
+  -e, --version       Print version and exit
+  -h, --help          Show this message
+</pre>
 
-You can use "RVM":http://rvm.io/rvm/install to install and manage Ruby versions.
+h4. Flags: @--format@
 
-<notextile>
-<pre>
-$ <code class="userinput">sudo apt-get install curl</code>
-$ <code class="userinput">sudo sh -c 'curl -sSL https://get.rvm.io | bash -s stable'</code>
-$ <code class="userinput">source /etc/profile.d/rvm.sh</code>
-</pre>
-</notextile>
+- @--format=json@ := Output response as JSON. This is the default format.
 
-Install curl libraries with your system's package manager. For example, with Debian or Ubuntu:
+- @--format=yaml@ := Output response as YAML
 
-<notextile>
-<pre>
-$ <code class="userinput">sudo apt-get install libcurl3 libcurl3-gnutls libcurl4-openssl-dev</code>
-</pre>
-</notextile>
+- @--format=uuid@ := Output only the UUIDs of object(s) in the API response, one per line.
 
-h4. Option 1: install with RubyGems
 
-<notextile>
-<pre>
-$ <code class="userinput">sudo gem install arvados-cli</code>
-</pre>
-</notextile>
 
-h4. Option 2: build and install from source
+h3. Resources
 
-<notextile>
-<pre>
-$ <code class="userinput">git clone https://github.com/curoverse/arvados.git</code>
-$ <code class="userinput">cd arvados/sdk/cli</code>
-$ <code class="userinput">gem build arvados-cli.gemspec</code>
-$ <code class="userinput">sudo gem install arvados-cli-*.gem</code>
-</pre>
-</notextile>
+See the "arv reference":{{site.baseurl}}/sdk/cli/reference.html page.
+
+h3. Subcommands
 
+See the "arv subcommands":{{site.baseurl}}/sdk/cli/subcommands.html page.