Document --open-browser; improve CLI help output

Author: pont-us

docs/xcetool.md

@@ -57,6 +57,8 @@ Options:
     already.
 -   `-k`, `--keep`: Keep container after it has finished
     running.
+-   `-b`, `--open-browser`: After the server has started, open a web browser
+    window showing the viewer. Implies `--server`.
 -   `--help`: Show a help message for this subcommand and exit.
 
 This subcommand runs an xcengine container image. Any arguments provided

xcengine/cli.py

@@ -28,7 +28,12 @@
     help="Create and run compute engine scripts and containers "
     "from IPython notebooks"
 )
-@click.option("-v", "--verbose", count=True)
+@click.option(
+    "-v",
+    "--verbose",
+    count=True,
+    help="Increase the verbosity of the log messages."
+)
 def cli(verbose):
     if verbose > 0:
         logging.getLogger().setLevel(logging.DEBUG)
@@ -231,7 +236,8 @@ def increase_indent(self, flow=False, indentless=False):
     "-b",
     "--open-browser",
     is_flag=True,
-    help="Open a web browser window showing the viewer. Implies --server.",
+    help="After the server has started, open a web browser window "
+    "showing the viewer. Implies --server.",
 )
 @click.argument("image", type=str)
 @click.argument(