Merge pull request #952 from progrium/951-mh-document-args-over-ssh

[ci skip] document cli args over ssh. closes #951

docs/remote-commands.md

@@ -17,3 +17,14 @@ It's possible to run commands in the environment of the deployed application:
 dokku run node-js-app ls -alh
 dokku run <app> <cmd>
 ```
+
+## Behavioral modifiers
+
+Dokku also supports certain command-line arguments that augment it's behavior. If using these over ssh, you must use the form `ssh -t dokku@dokku.me -- <command>`
+in order to avoid ssh interpretting dokku arguments for itself.
+
+```shell
+-q|--quiet            suppress output headers
+-t|--trace            enable DOKKU_TRACE for current execution only
+--rm|--rm-container    remove docker container after successful dokku run <app> <command>
+```

dokku

@@ -184,7 +184,7 @@ case "$1" in
     ;;
 
   help|'')
-    echo "Usage: dokku [-q|--quiet|-t|--trace|--rm-container|-rm] COMMAND <app> [command-specific-options]"
+    echo "Usage: dokku [-q|--quiet|-t|--trace|--rm-container|--rm] COMMAND <app> [command-specific-options]"
     echo ""
     echo "Options:"
 

plugins/common/functions

@@ -61,7 +61,7 @@ function parse_args() {
       --trace|-t)
         export DOKKU_TRACE=1
         ;;
-      --rm-container|-rm)
+      --rm-container|--rm)
         export DOKKU_RM_CONTAINER=1
         ;;
       --force|-f)