From: johnthagen Date: Fri, 15 Dec 2017 15:05:21 +0000 (-0500) Subject: Add note about running clean before using -vv X-Git-Tag: archive/raspbian/0.35.0-2+rpi1~3^2^2^2^2^2^2^2~22^2~4^2~20^2 X-Git-Url: https://dgit.raspbian.org/?a=commitdiff_plain;h=72c924230c3df67261642f74ba415cb34086935f;p=cargo.git Add note about running clean before using -vv This solves an issue that came up in the beginners chat that took about fifteen minutes to finally understand what was going on. This should help users who are actively developing `build.rs` consistently get debugging information printed to the terminal. --- diff --git a/src/doc/build-script.md b/src/doc/build-script.md index 1a311915c..d5a4b7967 100644 --- a/src/doc/build-script.md +++ b/src/doc/build-script.md @@ -47,9 +47,13 @@ the source directory of the build script’s package. All the lines printed to stdout by a build script are written to a file like `target/debug/build//output` (the precise location may depend on your configuration). If you would like to see such output directly in your terminal, -invoke cargo as 'very verbose' with the `-vv` flag. Any line that starts with -`cargo:` is interpreted directly by Cargo. This line must be of the form -`cargo:key=value`, like the examples below: +invoke cargo as 'very verbose' with the `-vv` flag. Note that if neither the +build script nor project source files are modified, subsequent calls to +cargo with the `-vv` will **not** print output to the terminal because a +new build is not executed. Run `cargo clean` before each cargo invokation +if you want to ensure that output is always displayed on your terminal. +Any line that starts with `cargo:` is interpreted directly by Cargo. +This line must be of the form `cargo:key=value`, like the examples below: ```notrust # specially recognized by Cargo