From 878b5e8a4a223047e946009e437cb8877cbbc9b6 Mon Sep 17 00:00:00 2001
From: Brendan Burns <bburns@google.com>
Date: Mon, 8 Dec 2014 19:48:02 -0800
Subject: [PATCH] address comments.

---
 docs/devel/development.md | 23 +++++++++++++++++++++++
 1 file changed, 23 insertions(+)

diff --git a/docs/devel/development.md b/docs/devel/development.md
index 14a4df877be..816958034e7 100644
--- a/docs/devel/development.md
+++ b/docs/devel/development.md
@@ -115,9 +115,13 @@ Pressing control-C should result in an orderly shutdown but if something goes wr
 go run e2e.go --down
 ```
 
+### Flag options
 See the flag definitions in `hack/e2e.go` for more options, such as reusing an existing cluster, here is an overview:
 
 ```sh
+# Build binaries for testing
+go run e2e.go --build
+
 # Create a fresh cluster.  Deletes a cluster first, if it exists
 go run e2e.go --up
 
@@ -127,6 +131,9 @@ go run e2e.go --isup
 # Push code to an existing cluster
 go run e2e.go --push
 
+# Push to an existing cluster, or bring up a cluster if it's down.
+go run e2e.go --pushup
+
 # Run all tests
 go run e2e.go --test
 
@@ -134,6 +141,22 @@ go run e2e.go --test
 go run e2e.go --tests=...
 ```
 
+### Combining flags
+```sh
+# Flags can be combined, and their actions will take place in this order:
+# -build, -push|-up|-pushup, -test|-tests=..., -down
+# e.g.:
+go run e2e.go -build -pushup -test -down
+
+# -v (verbose) can be added if you want streaming output instead of only
+# seeing the output of failed commands.
+
+# -ctl can be used to quickly call kubectl against your e2e cluster. Useful for
+# cleaning up after a failed test or viewing logs.
+go run e2e.go -ctl='get events'
+go run e2e.go -ctl='delete pod foobar'
+```
+
 ## Testing out flaky tests
 [Instructions here](docs/devel/flaky-tests.md)