mirror of
https://github.com/rust-lang/cargo
synced 2024-09-13 04:51:31 +00:00
docs: Clarify vendored sources as read-only and way to modify
This commit is contained in:
parent
3bb069775f
commit
13e72b9e8a
|
@ -21,6 +21,12 @@ stdout after `cargo vendor` completes the vendoring process.
|
|||
You will need to add or redirect it to your Cargo configuration file,
|
||||
which is usually `.cargo/config.toml` locally for the current package.
|
||||
|
||||
Cargo treats vendored sources as read-only as it does to registry and git sources.
|
||||
If you intend to modify a crate from a remote source,
|
||||
use `[patch]` or a `path` dependency pointing to a local copy of that crate.
|
||||
Cargo will then correctly handle the crate on incremental rebuilds,
|
||||
as it knowns that it is no longer a read-only dependency.
|
||||
|
||||
## OPTIONS
|
||||
|
||||
### Vendor Options
|
||||
|
|
|
@ -18,6 +18,12 @@ DESCRIPTION
|
|||
need to add or redirect it to your Cargo configuration file, which is
|
||||
usually .cargo/config.toml locally for the current package.
|
||||
|
||||
Cargo treats vendored sources as read-only as it does to registry and
|
||||
git sources. If you intend to modify a crate from a remote source, use
|
||||
[patch] or a path dependency pointing to a local copy of that crate.
|
||||
Cargo will then correctly handle the crate on incremental rebuilds, as
|
||||
it knowns that it is no longer a read-only dependency.
|
||||
|
||||
OPTIONS
|
||||
Vendor Options
|
||||
-s manifest, --sync manifest
|
||||
|
|
|
@ -21,6 +21,12 @@ stdout after `cargo vendor` completes the vendoring process.
|
|||
You will need to add or redirect it to your Cargo configuration file,
|
||||
which is usually `.cargo/config.toml` locally for the current package.
|
||||
|
||||
Cargo treats vendored sources as read-only as it does to registry and git sources.
|
||||
If you intend to modify a crate from a remote source,
|
||||
use `[patch]` or a `path` dependency pointing to a local copy of that crate.
|
||||
Cargo will then correctly handle the crate on incremental rebuilds,
|
||||
as it knowns that it is no longer a read-only dependency.
|
||||
|
||||
## OPTIONS
|
||||
|
||||
### Vendor Options
|
||||
|
|
|
@ -18,6 +18,12 @@ The configuration necessary to use the vendored sources would be printed to
|
|||
stdout after \fBcargo vendor\fR completes the vendoring process.
|
||||
You will need to add or redirect it to your Cargo configuration file,
|
||||
which is usually \fB\&.cargo/config.toml\fR locally for the current package.
|
||||
.sp
|
||||
Cargo treats vendored sources as read\-only as it does to registry and git sources.
|
||||
If you intend to modify a crate from a remote source,
|
||||
use \fB[patch]\fR or a \fBpath\fR dependency pointing to a local copy of that crate.
|
||||
Cargo will then correctly handle the crate on incremental rebuilds,
|
||||
as it knowns that it is no longer a read\-only dependency.
|
||||
.SH "OPTIONS"
|
||||
.SS "Vendor Options"
|
||||
.sp
|
||||
|
|
Loading…
Reference in a new issue