Ything-RepoMirrors/cargo
1
0
Fork 0
mirror of https://github.com/rust-lang/cargo.git synced 2026-01-25 04:16:45 +00:00
Code Issues Packages Projects Releases Wiki Activity

docs(build-script): clarify OUT_DIR persistence and link tracking issues

Browse Source
This commit is contained in:
Dhruv Choudhary
2025-12-29 09:56:47 +05:30
parent 53f47806ae
commit cdc10ac2c6
1 changed files with 6 additions and 3 deletions
Download Patch File Download Diff File Expand all files Collapse all files

9
src/doc/src/reference/build-scripts.md
View File

@@ -78,9 +78,12 @@ should not modify any files outside of that directory.
> re-run. This behavior is intentional to support incremental builds, such as
> native code compilation.
>
> Build scripts should not assume that `OUT_DIR` is empty. If a script requires
> a clean directory, it is responsible for removing or managing any files or
> subdirectories it creates.
>Build scripts should not rely on `OUT_DIR` being empty, as its contents may
>persist across rebuilds. If a script requires a clean directory, it is currently
>responsible for managing or cleaning up any files or subdirectories it creates.
>Future improvements in this area are being discussed (see
>[#16427](https://github.com/rust-lang/cargo/issues/16427) and
>[#9661](https://github.com/rust-lang/cargo/issues/9661)).
Build scripts communicate with Cargo by printing to stdout. Cargo will
interpret each line that starts with `cargo::` as an instruction that will