add new watch event type
convert etcd errors to watch errors
update pkg/api documentation
handle watch errors everywhere
hack: Switch some $(dirname $0)../blah to use ${KUBE_*} vars

This doesn't fix anything broken. But we have config-go which exports
KUBE_REPO_ROOT and KUBE_TARGET.  Using those means the test scripts can
be more easily moved around the repo and still work.  Especially in
hack/test-integration.sh where we use hack/build-go.sh which is going
to use KUBE_TARGET to place the binary, then we use a different method
to find/execute the binary...
Replace --lines= with -n to fix tail on mac os.
Merge pull request #1408 from bgrant0607/gcutilfix

Replace --lines= with -n to fix tail on mac os.
Merge pull request #1409 from eparis/use-config-go-in-hack

hack: Switch some $(dirname $0)../blah to use ${KUBE_*} vars
Merge pull request #1404 from lavalamp/scheduler

Add error type to watch.
Add a doc on pod states
Merge pull request #1406 from thockin/docs

Add a doc on pod states
Allow option to not build cmd/integration

In case it was built seperately (as in, on Fedora, we cannot use go
install as we do not have write permission to portions of the GOPATH)