rocket-chip/README_TRAVIS.md

# Travis Notes for Administrators

Administrators: Are PRs taking > 1 hr to run through Travis? If you look at the Travis logs is it building `riscv-tools`?

This is because someone committed a PR to `master` which bumped `riscv-tools` and the master cache needs to be updated.
This is the procedure to follow to get things fast again. We don't generally branch updates (e.g. to `master`), just PRs.

To get the `master` cache good again:
----------------------------------

1. Wait for the PR that is changing `riscv-tools` to go green.
2. On Travis, click `More Options -> Caches` on the upper right.
3. Click `Delete` for the `master` Cache. 
4. Click `More Options->Settings`
5. On the `General Settings` section, switch the `Build Branch Updates` toggle to `ON`.
6. Perform the PR's merge to `master`. This will cause the `master` cache to build `riscv-tools`.
7. Once the merge commit goes green on Travis, switch the `Build Branch Updates` toggle to `OFF`.

For other PRs which were happening in parallel to the bump of `riscv-tools`:
----------------------------------------------------------------------------

If your PR already has a cache and you want to keep doing development with the old version of `riscv-tools`, no action is needed. 

If you want to merge or rebase your PR on top of `master` with the new version of `riscv-tools`, you should delete your PR branch's local cache. Otherwise it will rebuild the branch cache instead of using `master`'s cache. To do this:

1. Wait for the previous steps to go through so that the `master` cache is done. 
2. On Travis, click `More Options -> Caches` on the upper right.
3. Click `Delete` for your PR branch's cache.
4. Push updates to the PR as usual, it should download the new `master` cache.