update readme

Author: DannyBen

README.md

@@ -27,6 +27,13 @@ then this functionality is already integrated with it.
 $ gem install completely
 ```
 
+or with homebrew:
+
+```bash
+$ brew install brew-gem
+$ brew gem install completely
+````
+
 ## Using the `completely` command line
 
 The `completely` command line works with a simple YAML configuration file as
@@ -159,6 +166,37 @@ mygit:
 The `2> /dev/null` is used so that if the command is executed in a directory
 without a git repository, it will still behave as expected.
 
+### Suggesting flag arguments
+
+Adding a `*` wildcard in the middle of a pattern can be useful for suggesting
+arguments for flags. For example:
+
+```yaml
+mygit checkout:
+- --branch
+- -b
+
+mygit checkout*--branch:
+- $(git branch 2> /dev/null)
+
+mygit checkout*-b:
+- $(git branch 2> /dev/null)
+```
+
+The above will suggest git branches for commands that end with `-b` or `--branch`.
+To avoid code duplication, you may use YAML aliases, so the above can also be
+written like this:
+
+```yaml
+mygit checkout:
+- --branch
+- -b
+
+mygit checkout*--branch: &branches
+- $(git branch 2> /dev/null)
+
+mygit checkout*-b: *branches
+```
 
 ## Using the generated completion scripts
 
@@ -171,6 +209,18 @@ $ source completely.bash
 You may wish to add this to your `~/.bashrc` file to enable this for future
 sessions (just be sure to use absolute path).
 
+## Testing and debugging completions scripts
+
+You can use the built in completions script tester by running `completely test`.
+
+This command lets you test any completions script, whether it was generated by
+completely or not.
+
+In addition, you can set the `COMPLETELY_DEBUG` environment variable to any value
+in order to generate scripts with some additional debugging functionality. Run
+`completely generate --help` for additional information.
+
+
 ## Using from within Ruby code
 
 ```ruby
@@ -192,6 +242,9 @@ puts completions.script
 # Or, generate a function that echos the script
 puts completions.wrapper_function
 puts completions.wrapper_function "custom_function_name"
+
+# Or, test the completions with the Tester object
+p completions.tester.test "mygit status "
 ```