update README.md to describe the -c option
diff --git a/README.md b/README.md
index b73acb4..120f75e 100644
--- a/README.md
+++ b/README.md
@@ -12,9 +12,9 @@
(wskdb)
```
-You will now be in a REPL. Issue `help` to see the list of available commands.
+You will now be in the `wsdk` REPL. Issue `help` to see the list of available commands.
-# Invoking an action
+## Invoking an action
The syntax here is almost identical to that of the `wsk` CLI.
```
(wskdb) invoke actionName -p param1 value1 -p param2 value2
@@ -22,8 +22,10 @@
If you haven't yet attached to the action you are invoking, the invocation will proceed as if you weren't in the debugger, and had issued a blocking invocation from the CLI.
-# Attaching to an action
+## Attaching to an action
+
Say for example you wish to attach to an action `foo`, and this action occurs in a sequence `seq`.
+
```
(wskdb) attach foo
Attaching to foo
@@ -32,12 +34,23 @@
```
If you wish to limit the instrumentation to the action, avoiding any containing rules or sequences:
+
```
(wskdb) attach foo --action-only
Attaching to foo
Creating action trampoline
```
+## Choosing CLI versus Browser-based Debugging
+
+By default, `wskdb` will prefer to use a browser-based debugger. If instead you wish to use a command-line debugger, pass the `--use-cli-debugger` option to `wskdb`; the short-hand form of this option is `-c`:
+
+```
+./wskdb -c
+Welcome to the OpenWhisk Debugger
+ + Favor the CLI for debug sessions over a GUI
+```
+
### License
Copyright 2015-2016 IBM Corporation
