Update docs for TRAVIS_BRANCH environment variable

To make it clear that for pull requests this is the name of the target branch rather
than the one being built.

This was originally [pull request #430 on travis-ci.github.com](https://github.com/travis-ci/travis-ci.github.com/pull/430).