Skip to content

Commit

Permalink
document the lack of automatic rebuilding after env var changes
Browse files Browse the repository at this point in the history
Tracking issue: rust-lang#230
  • Loading branch information
oconnor663 committed Sep 24, 2019
1 parent 02ed9e6 commit d742e50
Showing 1 changed file with 7 additions and 0 deletions.
7 changes: 7 additions & 0 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -89,6 +89,13 @@ functions with hard requirements on some variables supplied by [cargo's
build-script driver][cargo] that it has the `TARGET`, `OUT_DIR`, `OPT_LEVEL`,
and `HOST` variables.

Note that by default, changing these environment variables from one
build to the next does not cause Cargo to rerun `build.rs`, and later
builds may use stale artifacts. One workaround is to `touch build.rs`
whenever you change these variables. You can also enable automatic
rebuilding on a case-by-case basis with
[`rerun-if-env-changed`](https://doc.rust-lang.org/cargo/reference/build-scripts.html#outputs-of-the-build-script).

[cargo]: http://doc.crates.io/build-script.html#inputs-to-the-build-script

## Optional features
Expand Down

0 comments on commit d742e50

Please sign in to comment.