add new watch event type
convert etcd errors to watch errors
update pkg/api documentation
handle watch errors everywhere
Merge pull request #1400 from abhgupta/abhgupta-dev

Adding GetEndpoints method to the client EndpointsInterface
Modifications and improvements to the vagrant cluster README
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)
Merge pull request #1410 from eparis/no-build-integration

Allow option to not build cmd/integration
Merge pull request #1379 from runseb/vagrant

Modifications and improvements to the vagrant cluster README
Cleanup hack/test-integration.sh

Proper quoting, error checks, use $KUBE_* variables when applicable, trap to do
cleanup on all errors, call cleanup explicitly on successful exit.

Tested:
- Ran it manually to completion, test run successful.
- Interrupted it during the run, checked that $? was non-zero, etcd was killed.

Signed-off-by: Filipe Brandenburger <filbranden@google.com>
Merge pull request #1412 from filbranden/test_integration1

Cleanup hack/test-integration.sh