docs(trim-paths): add limitations and polish - #17425
Conversation
|
r? @epage rustbot has assigned @epage. Use Why was this reviewer chosen?The reviewer was selected based on:
|
|
cc @Urgau, if you'd also like to take a look. I generally want to mostly refer to rustc docs 😆. |
6a4abd9 to
f4b56c6
Compare
This comment has been minimized.
This comment has been minimized.
| It takes the following values: | ||
|
|
||
| - `"none"` and `false` --- disable path sanitization | ||
| - `"macro"` --- sanitize paths in the expansion of `std::file!()` macro. | ||
| This is where paths in embedded panic messages come from | ||
| - `"diagnostics"` --- sanitize paths in printed compiler diagnostics | ||
| - `"object"` --- sanitize paths in compiled executables or libraries | ||
| - `"all"` and `true` --- sanitize paths in all possible locations |
There was a problem hiding this comment.
I don't know if this list is intended to be the same as rustc, but if it's the case then it's missing the coverage and debuginfo scopes. If it's intended to diverge, it should maybe be mentioned that it's only a subset.
There was a problem hiding this comment.
Good point. I avoided touching this right now at this moment as we may want to stabilize a subset.
We are discussing it in #t-cargo > stabilization plan for `-Ztrim-paths` (though no discussions yet)
There was a problem hiding this comment.
We are discussing it in #t-cargo > stabilization plan for
-Ztrim-paths(though no discussions yet)
Replied the in the Zulip thread.
This is implementation details for better diagonstic remap that is not really meaning for cargo users directly.
f4b56c6 to
2198a00
Compare
|
This PR was rebased onto a different master commit. Here's a range-diff highlighting what actually changed. Rebasing is a normal part of keeping PRs up to date, so no action is needed—this note is just to help reviewers. |
Update cargo submodule 9 commits in b2e9d5f9db3fb1c454ab84f10c16508984a266e2..3c0b534756e166d12eb9fd2e1abfe5b42ac6101e 2026-09-02 14:49:16 +0000 to 2026-09-04 17:03:10 +0000 - fix(trim-paths)!: limit options to `none|object|all` (rust-lang/cargo#17432) - fix(git): Apply pr hint to git-fetch-with-cli (rust-lang/cargo#17437) - fix(git): Make PR dep note cloer to our style guide (rust-lang/cargo#17436) - docs: clarify cargo vendor source config option (rust-lang/cargo#17435) - docs(trim-paths): workspace remap begins with `.` (rust-lang/cargo#17433) - docs: Switch from "target triple" to "target tuple" (rust-lang/cargo#17430) - docs(trim-paths): add limitations and polish (rust-lang/cargo#17425) - fix(git): Simplify error message (rust-lang/cargo#17429) - chore(deps): update rust crate base64 to 0.23.0 (rust-lang/cargo#17418)
Update cargo submodule 9 commits in b2e9d5f9db3fb1c454ab84f10c16508984a266e2..3c0b534756e166d12eb9fd2e1abfe5b42ac6101e 2026-09-02 14:49:16 +0000 to 2026-09-04 17:03:10 +0000 - fix(trim-paths)!: limit options to `none|object|all` (rust-lang/cargo#17432) - fix(git): Apply pr hint to git-fetch-with-cli (rust-lang/cargo#17437) - fix(git): Make PR dep note cloer to our style guide (rust-lang/cargo#17436) - docs: clarify cargo vendor source config option (rust-lang/cargo#17435) - docs(trim-paths): workspace remap begins with `.` (rust-lang/cargo#17433) - docs: Switch from "target triple" to "target tuple" (rust-lang/cargo#17430) - docs(trim-paths): add limitations and polish (rust-lang/cargo#17425) - fix(git): Simplify error message (rust-lang/cargo#17429) - chore(deps): update rust crate base64 to 0.23.0 (rust-lang/cargo#17418)
What does this PR try to resolve?
This doc polish is a stabilization preparation.
See #12137 (comment)
How to test and review this PR?
This is stacked on top of #17424 to minimize merge conflict. Please review from c99bbf2