Skip to content

Commit 030c9ab

Browse files
committed
Add appropriate documentation
1 parent 5df5a0d commit 030c9ab

File tree

1 file changed

+8
-0
lines changed

1 file changed

+8
-0
lines changed

src/doc/src/reference/unstable.md

Lines changed: 8 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -84,6 +84,7 @@ Each new feature described below should explain how to use it.
8484
* [build-std](#build-std) --- Builds the standard library instead of using pre-built binaries.
8585
* [build-std-features](#build-std-features) --- Sets features to use with the standard library.
8686
* [binary-dep-depinfo](#binary-dep-depinfo) --- Causes the dep-info file to track binary dependencies.
87+
* [checksum-freshness](#checksum-freshness) --- When passed, the decision as to whether a crate needs to be rebuilt is made using file checksums instead of the file mtime.
8788
* [panic-abort-tests](#panic-abort-tests) --- Allows running tests with the "abort" panic strategy.
8889
* [host-config](#host-config) --- Allows setting `[target]`-like configuration settings for host build targets.
8990
* [target-applies-to-host](#target-applies-to-host) --- Alters whether certain flags will be passed to host build targets.
@@ -512,6 +513,13 @@ the crate will be rebuilt). The primary use case is for building the compiler
512513
itself, which has implicit dependencies on the standard library that would
513514
otherwise be untracked for change-detection.
514515

516+
## checksum-freshness
517+
* Tracking issue: [#14136](https://github.com/rust-lang/cargo/issues/14136)
518+
519+
The `-Z checksum-freshness` flag will replace the use of file mtimes in cargo's
520+
fingerprints with a file checksum value. This is most useful on systems with a poor
521+
mtime implementation, or in CI/CD. The checksum algorithm can change without notice between cargo versions. Fingerprints are used by cargo to determine when a crate needs to be rebuilt.
522+
515523
## panic-abort-tests
516524
* Tracking Issue: [#67650](https://github.com/rust-lang/rust/issues/67650)
517525
* Original Pull Request: [#7460](https://github.com/rust-lang/cargo/pull/7460)

0 commit comments

Comments
 (0)