diff --git a/src/doc/man/cargo-add.md b/src/doc/man/cargo-add.md index 6d388cb54..1c0b736af 100644 --- a/src/doc/man/cargo-add.md +++ b/src/doc/man/cargo-add.md @@ -160,6 +160,8 @@ Add dependencies to only the specified package. {{> options-ignore-rust-version }} {{> options-locked }} + +{{> options-lockfile-path }} {{/options}} {{> section-options-common }} diff --git a/src/doc/man/cargo-bench.md b/src/doc/man/cargo-bench.md index cd54fcee4..9e8ce2490 100644 --- a/src/doc/man/cargo-bench.md +++ b/src/doc/man/cargo-bench.md @@ -146,6 +146,8 @@ passing `--nocapture` to the benchmark binaries: {{> options-ignore-rust-version }} {{> options-locked }} + +{{> options-lockfile-path }} {{/options}} {{> section-options-common }} diff --git a/src/doc/man/cargo-build.md b/src/doc/man/cargo-build.md index 7c704314c..bf4fbc34e 100644 --- a/src/doc/man/cargo-build.md +++ b/src/doc/man/cargo-build.md @@ -87,6 +87,8 @@ See for more information. {{> options-ignore-rust-version }} {{> options-locked }} + +{{> options-lockfile-path }} {{/options}} {{> section-options-common }} diff --git a/src/doc/man/cargo-check.md b/src/doc/man/cargo-check.md index 9af606fda..0a846c4e9 100644 --- a/src/doc/man/cargo-check.md +++ b/src/doc/man/cargo-check.md @@ -70,6 +70,8 @@ they have `required-features` that are missing. {{> options-ignore-rust-version }} {{> options-locked }} + +{{> options-lockfile-path }} {{/options}} {{> section-options-common }} diff --git a/src/doc/man/cargo-clean.md b/src/doc/man/cargo-clean.md index ee920b223..bc8fdc2ba 100644 --- a/src/doc/man/cargo-clean.md +++ b/src/doc/man/cargo-clean.md @@ -72,6 +72,8 @@ Remove all artifacts in the directory with the given profile name. {{> options-manifest-path }} {{> options-locked }} + +{{> options-lockfile-path }} {{/options}} {{> section-options-common }} diff --git a/src/doc/man/cargo-doc.md b/src/doc/man/cargo-doc.md index 3d036024d..d5431df5d 100644 --- a/src/doc/man/cargo-doc.md +++ b/src/doc/man/cargo-doc.md @@ -104,6 +104,8 @@ and supports common Unix glob patterns. {{> options-ignore-rust-version }} {{> options-locked }} + +{{> options-lockfile-path }} {{/options}} {{> section-options-common }} diff --git a/src/doc/man/cargo-fetch.md b/src/doc/man/cargo-fetch.md index b8a0eb666..22a833f81 100644 --- a/src/doc/man/cargo-fetch.md +++ b/src/doc/man/cargo-fetch.md @@ -48,6 +48,8 @@ you plan to use Cargo without a network with the `--offline` flag. {{> options-manifest-path }} {{> options-locked }} + +{{> options-lockfile-path }} {{/options}} {{> section-options-common }} diff --git a/src/doc/man/cargo-fix.md b/src/doc/man/cargo-fix.md index af0dc3f21..2c25720db 100644 --- a/src/doc/man/cargo-fix.md +++ b/src/doc/man/cargo-fix.md @@ -150,6 +150,8 @@ When no target selection options are given, `cargo fix` will fix all targets {{> options-ignore-rust-version }} {{> options-locked }} + +{{> options-lockfile-path }} {{/options}} {{> section-options-common }} diff --git a/src/doc/man/cargo-generate-lockfile.md b/src/doc/man/cargo-generate-lockfile.md index 956cc58dc..63c17849c 100644 --- a/src/doc/man/cargo-generate-lockfile.md +++ b/src/doc/man/cargo-generate-lockfile.md @@ -33,6 +33,8 @@ lockfile and has more options for controlling update behavior. {{> options-ignore-rust-version }} {{> options-locked }} + +{{> options-lockfile-path }} {{/options}} {{> section-options-common }} diff --git a/src/doc/man/cargo-metadata.md b/src/doc/man/cargo-metadata.md index f95ba7c5e..0205a61e8 100644 --- a/src/doc/man/cargo-metadata.md +++ b/src/doc/man/cargo-metadata.md @@ -378,6 +378,8 @@ reproduction of the information within `Cargo.toml`. {{> options-manifest-path }} {{> options-locked }} + +{{> options-lockfile-path }} {{/options}} {{> section-options-common }} diff --git a/src/doc/man/cargo-package.md b/src/doc/man/cargo-package.md index 7443c20fd..3d2fd1fbb 100644 --- a/src/doc/man/cargo-package.md +++ b/src/doc/man/cargo-package.md @@ -128,6 +128,8 @@ published to this registry. {{> options-locked }} +{{> options-lockfile-path }} + {{/options}} ### Miscellaneous Options diff --git a/src/doc/man/cargo-pkgid.md b/src/doc/man/cargo-pkgid.md index 54cb9f391..28a6ea138 100644 --- a/src/doc/man/cargo-pkgid.md +++ b/src/doc/man/cargo-pkgid.md @@ -63,6 +63,8 @@ Get the package ID for the given package instead of the current package. {{> options-locked }} +{{> options-lockfile-path }} + {{/options}} {{> section-options-common }} diff --git a/src/doc/man/cargo-publish.md b/src/doc/man/cargo-publish.md index c5e64db80..fa4c823ea 100644 --- a/src/doc/man/cargo-publish.md +++ b/src/doc/man/cargo-publish.md @@ -90,6 +90,8 @@ which defaults to `crates-io`. {{> options-locked }} +{{> options-lockfile-path }} + {{/options}} ### Miscellaneous Options diff --git a/src/doc/man/cargo-remove.md b/src/doc/man/cargo-remove.md index 0bdb04ac6..87bacb5b4 100644 --- a/src/doc/man/cargo-remove.md +++ b/src/doc/man/cargo-remove.md @@ -59,6 +59,8 @@ Don't actually write to the manifest. {{> options-manifest-path }} {{> options-locked }} + +{{> options-lockfile-path }} {{/options}} ### Package Selection diff --git a/src/doc/man/cargo-run.md b/src/doc/man/cargo-run.md index d32236c1e..c5d37790e 100644 --- a/src/doc/man/cargo-run.md +++ b/src/doc/man/cargo-run.md @@ -87,6 +87,8 @@ Run the specified example. {{> options-locked }} +{{> options-lockfile-path }} + {{/options}} {{> section-options-common }} diff --git a/src/doc/man/cargo-rustc.md b/src/doc/man/cargo-rustc.md index 7a3f57608..15238ea09 100644 --- a/src/doc/man/cargo-rustc.md +++ b/src/doc/man/cargo-rustc.md @@ -112,6 +112,8 @@ This flag only works when building a `lib` or `example` library target. {{> options-locked }} +{{> options-lockfile-path }} + {{/options}} {{> section-options-common }} diff --git a/src/doc/man/cargo-rustdoc.md b/src/doc/man/cargo-rustdoc.md index 393f7c8b4..5a354d2d1 100644 --- a/src/doc/man/cargo-rustdoc.md +++ b/src/doc/man/cargo-rustdoc.md @@ -93,6 +93,8 @@ if its name is the same as the lib target. Binaries are skipped if they have {{> options-ignore-rust-version }} {{> options-locked }} + +{{> options-lockfile-path }} {{/options}} {{> section-options-common }} diff --git a/src/doc/man/cargo-test.md b/src/doc/man/cargo-test.md index fa4c998e9..93663f9ca 100644 --- a/src/doc/man/cargo-test.md +++ b/src/doc/man/cargo-test.md @@ -172,6 +172,8 @@ results readable. Test output can be recovered (e.g., for debugging) by passing {{> options-locked }} +{{> options-lockfile-path }} + {{/options}} {{> section-options-common }} diff --git a/src/doc/man/cargo-tree.md b/src/doc/man/cargo-tree.md index f8773430c..ce99b761e 100644 --- a/src/doc/man/cargo-tree.md +++ b/src/doc/man/cargo-tree.md @@ -186,6 +186,7 @@ Sets how each line is displayed. The _prefix_ value can be one of: {{> options-locked }} +{{> options-lockfile-path }} {{/options}} {{> section-features }} diff --git a/src/doc/man/cargo-update.md b/src/doc/man/cargo-update.md index e0ad8ff53..8e7a9be5a 100644 --- a/src/doc/man/cargo-update.md +++ b/src/doc/man/cargo-update.md @@ -97,6 +97,8 @@ Displays what would be updated, but doesn't actually write the lockfile. {{> options-locked }} +{{> options-lockfile-path }} + {{/options}} {{> section-options-common }} diff --git a/src/doc/man/cargo-vendor.md b/src/doc/man/cargo-vendor.md index 8f0ea9521..464437b04 100644 --- a/src/doc/man/cargo-vendor.md +++ b/src/doc/man/cargo-vendor.md @@ -66,6 +66,8 @@ only a subset of the packages have changed. {{> options-locked }} +{{> options-lockfile-path }} + {{/options}} ### Display Options diff --git a/src/doc/man/generated_txt/cargo-add.txt b/src/doc/man/generated_txt/cargo-add.txt index b4f006b9e..a9628eb01 100644 --- a/src/doc/man/generated_txt/cargo-add.txt +++ b/src/doc/man/generated_txt/cargo-add.txt @@ -197,6 +197,21 @@ OPTIONS --frozen Equivalent to specifying both --locked and --offline. + --lockfile-path PATH + Changes the path of the lockfile from the default (./Cargo.lock) to + PATH. PATH must end with Cargo.lock (e.g. --lockfile-path + /tmp/temporary-lockfile/Cargo.lock). Note that providing + --lockfile-path will ignore existing default lockfile + (./Cargo.lock), if exists, and instead will either use PATH lockfile + (or write a new lockfile into the provided path if it doesn’t + exist). This flag can be used to run most commands in read-only + directories, writing lockfile into the provided PATH. + + This option is only available on the nightly channel + and + requires the -Z unstable-options flag to enable (see #5707 + ). + Common Options +toolchain If Cargo has been installed with rustup, and the first argument to diff --git a/src/doc/man/generated_txt/cargo-bench.txt b/src/doc/man/generated_txt/cargo-bench.txt index ae26fae33..0770525e7 100644 --- a/src/doc/man/generated_txt/cargo-bench.txt +++ b/src/doc/man/generated_txt/cargo-bench.txt @@ -368,6 +368,21 @@ OPTIONS --frozen Equivalent to specifying both --locked and --offline. + --lockfile-path PATH + Changes the path of the lockfile from the default (./Cargo.lock) to + PATH. PATH must end with Cargo.lock (e.g. --lockfile-path + /tmp/temporary-lockfile/Cargo.lock). Note that providing + --lockfile-path will ignore existing default lockfile + (./Cargo.lock), if exists, and instead will either use PATH lockfile + (or write a new lockfile into the provided path if it doesn’t + exist). This flag can be used to run most commands in read-only + directories, writing lockfile into the provided PATH. + + This option is only available on the nightly channel + and + requires the -Z unstable-options flag to enable (see #5707 + ). + Common Options +toolchain If Cargo has been installed with rustup, and the first argument to diff --git a/src/doc/man/generated_txt/cargo-build.txt b/src/doc/man/generated_txt/cargo-build.txt index 316c068d0..f3a461de5 100644 --- a/src/doc/man/generated_txt/cargo-build.txt +++ b/src/doc/man/generated_txt/cargo-build.txt @@ -302,6 +302,21 @@ OPTIONS --frozen Equivalent to specifying both --locked and --offline. + --lockfile-path PATH + Changes the path of the lockfile from the default (./Cargo.lock) to + PATH. PATH must end with Cargo.lock (e.g. --lockfile-path + /tmp/temporary-lockfile/Cargo.lock). Note that providing + --lockfile-path will ignore existing default lockfile + (./Cargo.lock), if exists, and instead will either use PATH lockfile + (or write a new lockfile into the provided path if it doesn’t + exist). This flag can be used to run most commands in read-only + directories, writing lockfile into the provided PATH. + + This option is only available on the nightly channel + and + requires the -Z unstable-options flag to enable (see #5707 + ). + Common Options +toolchain If Cargo has been installed with rustup, and the first argument to diff --git a/src/doc/man/generated_txt/cargo-check.txt b/src/doc/man/generated_txt/cargo-check.txt index 844f10178..5b8c81ca9 100644 --- a/src/doc/man/generated_txt/cargo-check.txt +++ b/src/doc/man/generated_txt/cargo-check.txt @@ -287,6 +287,21 @@ OPTIONS --frozen Equivalent to specifying both --locked and --offline. + --lockfile-path PATH + Changes the path of the lockfile from the default (./Cargo.lock) to + PATH. PATH must end with Cargo.lock (e.g. --lockfile-path + /tmp/temporary-lockfile/Cargo.lock). Note that providing + --lockfile-path will ignore existing default lockfile + (./Cargo.lock), if exists, and instead will either use PATH lockfile + (or write a new lockfile into the provided path if it doesn’t + exist). This flag can be used to run most commands in read-only + directories, writing lockfile into the provided PATH. + + This option is only available on the nightly channel + and + requires the -Z unstable-options flag to enable (see #5707 + ). + Common Options +toolchain If Cargo has been installed with rustup, and the first argument to diff --git a/src/doc/man/generated_txt/cargo-clean.txt b/src/doc/man/generated_txt/cargo-clean.txt index 066a70352..b0a803342 100644 --- a/src/doc/man/generated_txt/cargo-clean.txt +++ b/src/doc/man/generated_txt/cargo-clean.txt @@ -123,6 +123,21 @@ OPTIONS --frozen Equivalent to specifying both --locked and --offline. + --lockfile-path PATH + Changes the path of the lockfile from the default (./Cargo.lock) to + PATH. PATH must end with Cargo.lock (e.g. --lockfile-path + /tmp/temporary-lockfile/Cargo.lock). Note that providing + --lockfile-path will ignore existing default lockfile + (./Cargo.lock), if exists, and instead will either use PATH lockfile + (or write a new lockfile into the provided path if it doesn’t + exist). This flag can be used to run most commands in read-only + directories, writing lockfile into the provided PATH. + + This option is only available on the nightly channel + and + requires the -Z unstable-options flag to enable (see #5707 + ). + Common Options +toolchain If Cargo has been installed with rustup, and the first argument to diff --git a/src/doc/man/generated_txt/cargo-doc.txt b/src/doc/man/generated_txt/cargo-doc.txt index 2f90b9458..0aef3201e 100644 --- a/src/doc/man/generated_txt/cargo-doc.txt +++ b/src/doc/man/generated_txt/cargo-doc.txt @@ -258,6 +258,21 @@ OPTIONS --frozen Equivalent to specifying both --locked and --offline. + --lockfile-path PATH + Changes the path of the lockfile from the default (./Cargo.lock) to + PATH. PATH must end with Cargo.lock (e.g. --lockfile-path + /tmp/temporary-lockfile/Cargo.lock). Note that providing + --lockfile-path will ignore existing default lockfile + (./Cargo.lock), if exists, and instead will either use PATH lockfile + (or write a new lockfile into the provided path if it doesn’t + exist). This flag can be used to run most commands in read-only + directories, writing lockfile into the provided PATH. + + This option is only available on the nightly channel + and + requires the -Z unstable-options flag to enable (see #5707 + ). + Common Options +toolchain If Cargo has been installed with rustup, and the first argument to diff --git a/src/doc/man/generated_txt/cargo-fetch.txt b/src/doc/man/generated_txt/cargo-fetch.txt index 63fa205a3..263fb2155 100644 --- a/src/doc/man/generated_txt/cargo-fetch.txt +++ b/src/doc/man/generated_txt/cargo-fetch.txt @@ -102,6 +102,21 @@ OPTIONS --frozen Equivalent to specifying both --locked and --offline. + --lockfile-path PATH + Changes the path of the lockfile from the default (./Cargo.lock) to + PATH. PATH must end with Cargo.lock (e.g. --lockfile-path + /tmp/temporary-lockfile/Cargo.lock). Note that providing + --lockfile-path will ignore existing default lockfile + (./Cargo.lock), if exists, and instead will either use PATH lockfile + (or write a new lockfile into the provided path if it doesn’t + exist). This flag can be used to run most commands in read-only + directories, writing lockfile into the provided PATH. + + This option is only available on the nightly channel + and + requires the -Z unstable-options flag to enable (see #5707 + ). + Common Options +toolchain If Cargo has been installed with rustup, and the first argument to diff --git a/src/doc/man/generated_txt/cargo-fix.txt b/src/doc/man/generated_txt/cargo-fix.txt index c458ce5a2..9f510183b 100644 --- a/src/doc/man/generated_txt/cargo-fix.txt +++ b/src/doc/man/generated_txt/cargo-fix.txt @@ -360,6 +360,21 @@ OPTIONS --frozen Equivalent to specifying both --locked and --offline. + --lockfile-path PATH + Changes the path of the lockfile from the default (./Cargo.lock) to + PATH. PATH must end with Cargo.lock (e.g. --lockfile-path + /tmp/temporary-lockfile/Cargo.lock). Note that providing + --lockfile-path will ignore existing default lockfile + (./Cargo.lock), if exists, and instead will either use PATH lockfile + (or write a new lockfile into the provided path if it doesn’t + exist). This flag can be used to run most commands in read-only + directories, writing lockfile into the provided PATH. + + This option is only available on the nightly channel + and + requires the -Z unstable-options flag to enable (see #5707 + ). + Common Options +toolchain If Cargo has been installed with rustup, and the first argument to diff --git a/src/doc/man/generated_txt/cargo-generate-lockfile.txt b/src/doc/man/generated_txt/cargo-generate-lockfile.txt index 7c925d384..504aca13e 100644 --- a/src/doc/man/generated_txt/cargo-generate-lockfile.txt +++ b/src/doc/man/generated_txt/cargo-generate-lockfile.txt @@ -81,6 +81,21 @@ OPTIONS --frozen Equivalent to specifying both --locked and --offline. + --lockfile-path PATH + Changes the path of the lockfile from the default (./Cargo.lock) to + PATH. PATH must end with Cargo.lock (e.g. --lockfile-path + /tmp/temporary-lockfile/Cargo.lock). Note that providing + --lockfile-path will ignore existing default lockfile + (./Cargo.lock), if exists, and instead will either use PATH lockfile + (or write a new lockfile into the provided path if it doesn’t + exist). This flag can be used to run most commands in read-only + directories, writing lockfile into the provided PATH. + + This option is only available on the nightly channel + and + requires the -Z unstable-options flag to enable (see #5707 + ). + Common Options +toolchain If Cargo has been installed with rustup, and the first argument to diff --git a/src/doc/man/generated_txt/cargo-metadata.txt b/src/doc/man/generated_txt/cargo-metadata.txt index 9785e0057..5e7ba5748 100644 --- a/src/doc/man/generated_txt/cargo-metadata.txt +++ b/src/doc/man/generated_txt/cargo-metadata.txt @@ -438,6 +438,21 @@ OPTIONS --frozen Equivalent to specifying both --locked and --offline. + --lockfile-path PATH + Changes the path of the lockfile from the default (./Cargo.lock) to + PATH. PATH must end with Cargo.lock (e.g. --lockfile-path + /tmp/temporary-lockfile/Cargo.lock). Note that providing + --lockfile-path will ignore existing default lockfile + (./Cargo.lock), if exists, and instead will either use PATH lockfile + (or write a new lockfile into the provided path if it doesn’t + exist). This flag can be used to run most commands in read-only + directories, writing lockfile into the provided PATH. + + This option is only available on the nightly channel + and + requires the -Z unstable-options flag to enable (see #5707 + ). + Common Options +toolchain If Cargo has been installed with rustup, and the first argument to diff --git a/src/doc/man/generated_txt/cargo-package.txt b/src/doc/man/generated_txt/cargo-package.txt index 39c317c63..be73a7493 100644 --- a/src/doc/man/generated_txt/cargo-package.txt +++ b/src/doc/man/generated_txt/cargo-package.txt @@ -212,6 +212,21 @@ OPTIONS --frozen Equivalent to specifying both --locked and --offline. + --lockfile-path PATH + Changes the path of the lockfile from the default (./Cargo.lock) to + PATH. PATH must end with Cargo.lock (e.g. --lockfile-path + /tmp/temporary-lockfile/Cargo.lock). Note that providing + --lockfile-path will ignore existing default lockfile + (./Cargo.lock), if exists, and instead will either use PATH lockfile + (or write a new lockfile into the provided path if it doesn’t + exist). This flag can be used to run most commands in read-only + directories, writing lockfile into the provided PATH. + + This option is only available on the nightly channel + and + requires the -Z unstable-options flag to enable (see #5707 + ). + Miscellaneous Options -j N, --jobs N Number of parallel jobs to run. May also be specified with the diff --git a/src/doc/man/generated_txt/cargo-pkgid.txt b/src/doc/man/generated_txt/cargo-pkgid.txt index 3123dcad2..b9f6bbf86 100644 --- a/src/doc/man/generated_txt/cargo-pkgid.txt +++ b/src/doc/man/generated_txt/cargo-pkgid.txt @@ -116,6 +116,21 @@ OPTIONS --frozen Equivalent to specifying both --locked and --offline. + --lockfile-path PATH + Changes the path of the lockfile from the default (./Cargo.lock) to + PATH. PATH must end with Cargo.lock (e.g. --lockfile-path + /tmp/temporary-lockfile/Cargo.lock). Note that providing + --lockfile-path will ignore existing default lockfile + (./Cargo.lock), if exists, and instead will either use PATH lockfile + (or write a new lockfile into the provided path if it doesn’t + exist). This flag can be used to run most commands in read-only + directories, writing lockfile into the provided PATH. + + This option is only available on the nightly channel + and + requires the -Z unstable-options flag to enable (see #5707 + ). + Common Options +toolchain If Cargo has been installed with rustup, and the first argument to diff --git a/src/doc/man/generated_txt/cargo-publish.txt b/src/doc/man/generated_txt/cargo-publish.txt index d0b32a158..e9a82c5fd 100644 --- a/src/doc/man/generated_txt/cargo-publish.txt +++ b/src/doc/man/generated_txt/cargo-publish.txt @@ -160,6 +160,21 @@ OPTIONS --frozen Equivalent to specifying both --locked and --offline. + --lockfile-path PATH + Changes the path of the lockfile from the default (./Cargo.lock) to + PATH. PATH must end with Cargo.lock (e.g. --lockfile-path + /tmp/temporary-lockfile/Cargo.lock). Note that providing + --lockfile-path will ignore existing default lockfile + (./Cargo.lock), if exists, and instead will either use PATH lockfile + (or write a new lockfile into the provided path if it doesn’t + exist). This flag can be used to run most commands in read-only + directories, writing lockfile into the provided PATH. + + This option is only available on the nightly channel + and + requires the -Z unstable-options flag to enable (see #5707 + ). + Miscellaneous Options -j N, --jobs N Number of parallel jobs to run. May also be specified with the diff --git a/src/doc/man/generated_txt/cargo-remove.txt b/src/doc/man/generated_txt/cargo-remove.txt index 9d8c14afc..691557a16 100644 --- a/src/doc/man/generated_txt/cargo-remove.txt +++ b/src/doc/man/generated_txt/cargo-remove.txt @@ -93,6 +93,21 @@ OPTIONS --frozen Equivalent to specifying both --locked and --offline. + --lockfile-path PATH + Changes the path of the lockfile from the default (./Cargo.lock) to + PATH. PATH must end with Cargo.lock (e.g. --lockfile-path + /tmp/temporary-lockfile/Cargo.lock). Note that providing + --lockfile-path will ignore existing default lockfile + (./Cargo.lock), if exists, and instead will either use PATH lockfile + (or write a new lockfile into the provided path if it doesn’t + exist). This flag can be used to run most commands in read-only + directories, writing lockfile into the provided PATH. + + This option is only available on the nightly channel + and + requires the -Z unstable-options flag to enable (see #5707 + ). + Package Selection -p spec…, --package spec… Package to remove from. diff --git a/src/doc/man/generated_txt/cargo-run.txt b/src/doc/man/generated_txt/cargo-run.txt index 6cea9d3a6..9a644b3ef 100644 --- a/src/doc/man/generated_txt/cargo-run.txt +++ b/src/doc/man/generated_txt/cargo-run.txt @@ -206,6 +206,21 @@ OPTIONS --frozen Equivalent to specifying both --locked and --offline. + --lockfile-path PATH + Changes the path of the lockfile from the default (./Cargo.lock) to + PATH. PATH must end with Cargo.lock (e.g. --lockfile-path + /tmp/temporary-lockfile/Cargo.lock). Note that providing + --lockfile-path will ignore existing default lockfile + (./Cargo.lock), if exists, and instead will either use PATH lockfile + (or write a new lockfile into the provided path if it doesn’t + exist). This flag can be used to run most commands in read-only + directories, writing lockfile into the provided PATH. + + This option is only available on the nightly channel + and + requires the -Z unstable-options flag to enable (see #5707 + ). + Common Options +toolchain If Cargo has been installed with rustup, and the first argument to diff --git a/src/doc/man/generated_txt/cargo-rustc.txt b/src/doc/man/generated_txt/cargo-rustc.txt index 86ef31140..7f52a3686 100644 --- a/src/doc/man/generated_txt/cargo-rustc.txt +++ b/src/doc/man/generated_txt/cargo-rustc.txt @@ -304,6 +304,21 @@ OPTIONS --frozen Equivalent to specifying both --locked and --offline. + --lockfile-path PATH + Changes the path of the lockfile from the default (./Cargo.lock) to + PATH. PATH must end with Cargo.lock (e.g. --lockfile-path + /tmp/temporary-lockfile/Cargo.lock). Note that providing + --lockfile-path will ignore existing default lockfile + (./Cargo.lock), if exists, and instead will either use PATH lockfile + (or write a new lockfile into the provided path if it doesn’t + exist). This flag can be used to run most commands in read-only + directories, writing lockfile into the provided PATH. + + This option is only available on the nightly channel + and + requires the -Z unstable-options flag to enable (see #5707 + ). + Common Options +toolchain If Cargo has been installed with rustup, and the first argument to diff --git a/src/doc/man/generated_txt/cargo-rustdoc.txt b/src/doc/man/generated_txt/cargo-rustdoc.txt index f93a59c79..6829e19ca 100644 --- a/src/doc/man/generated_txt/cargo-rustdoc.txt +++ b/src/doc/man/generated_txt/cargo-rustdoc.txt @@ -274,6 +274,21 @@ OPTIONS --frozen Equivalent to specifying both --locked and --offline. + --lockfile-path PATH + Changes the path of the lockfile from the default (./Cargo.lock) to + PATH. PATH must end with Cargo.lock (e.g. --lockfile-path + /tmp/temporary-lockfile/Cargo.lock). Note that providing + --lockfile-path will ignore existing default lockfile + (./Cargo.lock), if exists, and instead will either use PATH lockfile + (or write a new lockfile into the provided path if it doesn’t + exist). This flag can be used to run most commands in read-only + directories, writing lockfile into the provided PATH. + + This option is only available on the nightly channel + and + requires the -Z unstable-options flag to enable (see #5707 + ). + Common Options +toolchain If Cargo has been installed with rustup, and the first argument to diff --git a/src/doc/man/generated_txt/cargo-test.txt b/src/doc/man/generated_txt/cargo-test.txt index 1b97d3d7d..eca7bdc88 100644 --- a/src/doc/man/generated_txt/cargo-test.txt +++ b/src/doc/man/generated_txt/cargo-test.txt @@ -394,6 +394,21 @@ OPTIONS --frozen Equivalent to specifying both --locked and --offline. + --lockfile-path PATH + Changes the path of the lockfile from the default (./Cargo.lock) to + PATH. PATH must end with Cargo.lock (e.g. --lockfile-path + /tmp/temporary-lockfile/Cargo.lock). Note that providing + --lockfile-path will ignore existing default lockfile + (./Cargo.lock), if exists, and instead will either use PATH lockfile + (or write a new lockfile into the provided path if it doesn’t + exist). This flag can be used to run most commands in read-only + directories, writing lockfile into the provided PATH. + + This option is only available on the nightly channel + and + requires the -Z unstable-options flag to enable (see #5707 + ). + Common Options +toolchain If Cargo has been installed with rustup, and the first argument to diff --git a/src/doc/man/generated_txt/cargo-tree.txt b/src/doc/man/generated_txt/cargo-tree.txt index 4037e7f0c..ed690bebd 100644 --- a/src/doc/man/generated_txt/cargo-tree.txt +++ b/src/doc/man/generated_txt/cargo-tree.txt @@ -243,6 +243,21 @@ OPTIONS --frozen Equivalent to specifying both --locked and --offline. + --lockfile-path PATH + Changes the path of the lockfile from the default (./Cargo.lock) to + PATH. PATH must end with Cargo.lock (e.g. --lockfile-path + /tmp/temporary-lockfile/Cargo.lock). Note that providing + --lockfile-path will ignore existing default lockfile + (./Cargo.lock), if exists, and instead will either use PATH lockfile + (or write a new lockfile into the provided path if it doesn’t + exist). This flag can be used to run most commands in read-only + directories, writing lockfile into the provided PATH. + + This option is only available on the nightly channel + and + requires the -Z unstable-options flag to enable (see #5707 + ). + Feature Selection The feature flags allow you to control which features are enabled. When no feature options are given, the default feature is activated for every diff --git a/src/doc/man/generated_txt/cargo-update.txt b/src/doc/man/generated_txt/cargo-update.txt index 1e3500481..0d36e2347 100644 --- a/src/doc/man/generated_txt/cargo-update.txt +++ b/src/doc/man/generated_txt/cargo-update.txt @@ -140,6 +140,21 @@ OPTIONS --frozen Equivalent to specifying both --locked and --offline. + --lockfile-path PATH + Changes the path of the lockfile from the default (./Cargo.lock) to + PATH. PATH must end with Cargo.lock (e.g. --lockfile-path + /tmp/temporary-lockfile/Cargo.lock). Note that providing + --lockfile-path will ignore existing default lockfile + (./Cargo.lock), if exists, and instead will either use PATH lockfile + (or write a new lockfile into the provided path if it doesn’t + exist). This flag can be used to run most commands in read-only + directories, writing lockfile into the provided PATH. + + This option is only available on the nightly channel + and + requires the -Z unstable-options flag to enable (see #5707 + ). + Common Options +toolchain If Cargo has been installed with rustup, and the first argument to diff --git a/src/doc/man/generated_txt/cargo-vendor.txt b/src/doc/man/generated_txt/cargo-vendor.txt index 771e75326..8979505f9 100644 --- a/src/doc/man/generated_txt/cargo-vendor.txt +++ b/src/doc/man/generated_txt/cargo-vendor.txt @@ -85,6 +85,21 @@ OPTIONS --frozen Equivalent to specifying both --locked and --offline. + --lockfile-path PATH + Changes the path of the lockfile from the default (./Cargo.lock) to + PATH. PATH must end with Cargo.lock (e.g. --lockfile-path + /tmp/temporary-lockfile/Cargo.lock). Note that providing + --lockfile-path will ignore existing default lockfile + (./Cargo.lock), if exists, and instead will either use PATH lockfile + (or write a new lockfile into the provided path if it doesn’t + exist). This flag can be used to run most commands in read-only + directories, writing lockfile into the provided PATH. + + This option is only available on the nightly channel + and + requires the -Z unstable-options flag to enable (see #5707 + ). + Display Options -v, --verbose Use verbose output. May be specified twice for “very verbose” diff --git a/src/doc/man/includes/options-lockfile-path.md b/src/doc/man/includes/options-lockfile-path.md new file mode 100644 index 000000000..6e96a9261 --- /dev/null +++ b/src/doc/man/includes/options-lockfile-path.md @@ -0,0 +1,12 @@ +{{#option "`--lockfile-path` _PATH_"}} +Changes the path of the lockfile from the default (`./Cargo.lock`) to _PATH_. _PATH_ must end with +`Cargo.lock` (e.g. `--lockfile-path /tmp/temporary-lockfile/Cargo.lock`). Note that providing +`--lockfile-path` will ignore existing default lockfile (`./Cargo.lock`), if exists, and instead will +either use _PATH_ lockfile (or write a new lockfile into the provided path if it doesn't exist). +This flag can be used to run most commands in read-only directories, writing lockfile into the provided _PATH_. + +This option is only available on the [nightly +channel](https://doc.rust-lang.org/book/appendix-07-nightly-rust.html) and +requires the `-Z unstable-options` flag to enable (see +[#5707](https://github.com/rust-lang/cargo/issues/5707)). +{{/option}} \ No newline at end of file diff --git a/src/doc/src/commands/cargo-add.md b/src/doc/src/commands/cargo-add.md index 0411bdd5c..80145be38 100644 --- a/src/doc/src/commands/cargo-add.md +++ b/src/doc/src/commands/cargo-add.md @@ -215,6 +215,18 @@ offline.

--frozen
Equivalent to specifying both --locked and --offline.
+ +
--lockfile-path PATH
+
Changes the path of the lockfile from the default (./Cargo.lock) to PATH. PATH must end with +Cargo.lock (e.g. --lockfile-path /tmp/temporary-lockfile/Cargo.lock). Note that providing +--lockfile-path will ignore existing default lockfile (./Cargo.lock), if exists, and instead will +either use PATH lockfile (or write a new lockfile into the provided path if it doesn’t exist). +This flag can be used to run most commands in read-only directories, writing lockfile into the provided PATH.

+

This option is only available on the nightly +channel and +requires the -Z unstable-options flag to enable (see +#5707).

+ ### Common Options diff --git a/src/doc/src/commands/cargo-bench.md b/src/doc/src/commands/cargo-bench.md index d48e164e9..9e8815e75 100644 --- a/src/doc/src/commands/cargo-bench.md +++ b/src/doc/src/commands/cargo-bench.md @@ -404,6 +404,18 @@ offline.

--frozen
Equivalent to specifying both --locked and --offline.
+ +
--lockfile-path PATH
+
Changes the path of the lockfile from the default (./Cargo.lock) to PATH. PATH must end with +Cargo.lock (e.g. --lockfile-path /tmp/temporary-lockfile/Cargo.lock). Note that providing +--lockfile-path will ignore existing default lockfile (./Cargo.lock), if exists, and instead will +either use PATH lockfile (or write a new lockfile into the provided path if it doesn’t exist). +This flag can be used to run most commands in read-only directories, writing lockfile into the provided PATH.

+

This option is only available on the nightly +channel and +requires the -Z unstable-options flag to enable (see +#5707).

+ ### Common Options diff --git a/src/doc/src/commands/cargo-build.md b/src/doc/src/commands/cargo-build.md index d0be79bbd..1e2a22110 100644 --- a/src/doc/src/commands/cargo-build.md +++ b/src/doc/src/commands/cargo-build.md @@ -335,6 +335,18 @@ offline.

--frozen
Equivalent to specifying both --locked and --offline.
+ +
--lockfile-path PATH
+
Changes the path of the lockfile from the default (./Cargo.lock) to PATH. PATH must end with +Cargo.lock (e.g. --lockfile-path /tmp/temporary-lockfile/Cargo.lock). Note that providing +--lockfile-path will ignore existing default lockfile (./Cargo.lock), if exists, and instead will +either use PATH lockfile (or write a new lockfile into the provided path if it doesn’t exist). +This flag can be used to run most commands in read-only directories, writing lockfile into the provided PATH.

+

This option is only available on the nightly +channel and +requires the -Z unstable-options flag to enable (see +#5707).

+ ### Common Options diff --git a/src/doc/src/commands/cargo-check.md b/src/doc/src/commands/cargo-check.md index 2db53d9dc..7d9726204 100644 --- a/src/doc/src/commands/cargo-check.md +++ b/src/doc/src/commands/cargo-check.md @@ -317,6 +317,18 @@ offline.

--frozen
Equivalent to specifying both --locked and --offline.
+ +
--lockfile-path PATH
+
Changes the path of the lockfile from the default (./Cargo.lock) to PATH. PATH must end with +Cargo.lock (e.g. --lockfile-path /tmp/temporary-lockfile/Cargo.lock). Note that providing +--lockfile-path will ignore existing default lockfile (./Cargo.lock), if exists, and instead will +either use PATH lockfile (or write a new lockfile into the provided path if it doesn’t exist). +This flag can be used to run most commands in read-only directories, writing lockfile into the provided PATH.

+

This option is only available on the nightly +channel and +requires the -Z unstable-options flag to enable (see +#5707).

+ ### Common Options diff --git a/src/doc/src/commands/cargo-clean.md b/src/doc/src/commands/cargo-clean.md index aa4e0eb46..9e58cbe73 100644 --- a/src/doc/src/commands/cargo-clean.md +++ b/src/doc/src/commands/cargo-clean.md @@ -138,6 +138,18 @@ offline.

--frozen
Equivalent to specifying both --locked and --offline.
+ +
--lockfile-path PATH
+
Changes the path of the lockfile from the default (./Cargo.lock) to PATH. PATH must end with +Cargo.lock (e.g. --lockfile-path /tmp/temporary-lockfile/Cargo.lock). Note that providing +--lockfile-path will ignore existing default lockfile (./Cargo.lock), if exists, and instead will +either use PATH lockfile (or write a new lockfile into the provided path if it doesn’t exist). +This flag can be used to run most commands in read-only directories, writing lockfile into the provided PATH.

+

This option is only available on the nightly +channel and +requires the -Z unstable-options flag to enable (see +#5707).

+ ### Common Options diff --git a/src/doc/src/commands/cargo-doc.md b/src/doc/src/commands/cargo-doc.md index a57389e8a..a05fd45c6 100644 --- a/src/doc/src/commands/cargo-doc.md +++ b/src/doc/src/commands/cargo-doc.md @@ -292,6 +292,18 @@ offline.

--frozen
Equivalent to specifying both --locked and --offline.
+ +
--lockfile-path PATH
+
Changes the path of the lockfile from the default (./Cargo.lock) to PATH. PATH must end with +Cargo.lock (e.g. --lockfile-path /tmp/temporary-lockfile/Cargo.lock). Note that providing +--lockfile-path will ignore existing default lockfile (./Cargo.lock), if exists, and instead will +either use PATH lockfile (or write a new lockfile into the provided path if it doesn’t exist). +This flag can be used to run most commands in read-only directories, writing lockfile into the provided PATH.

+

This option is only available on the nightly +channel and +requires the -Z unstable-options flag to enable (see +#5707).

+ ### Common Options diff --git a/src/doc/src/commands/cargo-fetch.md b/src/doc/src/commands/cargo-fetch.md index 694a4a2f0..224db2baf 100644 --- a/src/doc/src/commands/cargo-fetch.md +++ b/src/doc/src/commands/cargo-fetch.md @@ -105,6 +105,18 @@ if there might be a newer version as indicated in the local copy of the index.--frozen
Equivalent to specifying both --locked and --offline.
+ +
--lockfile-path PATH
+
Changes the path of the lockfile from the default (./Cargo.lock) to PATH. PATH must end with +Cargo.lock (e.g. --lockfile-path /tmp/temporary-lockfile/Cargo.lock). Note that providing +--lockfile-path will ignore existing default lockfile (./Cargo.lock), if exists, and instead will +either use PATH lockfile (or write a new lockfile into the provided path if it doesn’t exist). +This flag can be used to run most commands in read-only directories, writing lockfile into the provided PATH.

+

This option is only available on the nightly +channel and +requires the -Z unstable-options flag to enable (see +#5707).

+ ### Common Options diff --git a/src/doc/src/commands/cargo-fix.md b/src/doc/src/commands/cargo-fix.md index 6e3faa01b..653a4acb1 100644 --- a/src/doc/src/commands/cargo-fix.md +++ b/src/doc/src/commands/cargo-fix.md @@ -397,6 +397,18 @@ offline.

--frozen
Equivalent to specifying both --locked and --offline.
+ +
--lockfile-path PATH
+
Changes the path of the lockfile from the default (./Cargo.lock) to PATH. PATH must end with +Cargo.lock (e.g. --lockfile-path /tmp/temporary-lockfile/Cargo.lock). Note that providing +--lockfile-path will ignore existing default lockfile (./Cargo.lock), if exists, and instead will +either use PATH lockfile (or write a new lockfile into the provided path if it doesn’t exist). +This flag can be used to run most commands in read-only directories, writing lockfile into the provided PATH.

+

This option is only available on the nightly +channel and +requires the -Z unstable-options flag to enable (see +#5707).

+ ### Common Options diff --git a/src/doc/src/commands/cargo-generate-lockfile.md b/src/doc/src/commands/cargo-generate-lockfile.md index a87e86a62..776f97ff2 100644 --- a/src/doc/src/commands/cargo-generate-lockfile.md +++ b/src/doc/src/commands/cargo-generate-lockfile.md @@ -90,6 +90,18 @@ offline.

--frozen
Equivalent to specifying both --locked and --offline.
+ +
--lockfile-path PATH
+
Changes the path of the lockfile from the default (./Cargo.lock) to PATH. PATH must end with +Cargo.lock (e.g. --lockfile-path /tmp/temporary-lockfile/Cargo.lock). Note that providing +--lockfile-path will ignore existing default lockfile (./Cargo.lock), if exists, and instead will +either use PATH lockfile (or write a new lockfile into the provided path if it doesn’t exist). +This flag can be used to run most commands in read-only directories, writing lockfile into the provided PATH.

+

This option is only available on the nightly +channel and +requires the -Z unstable-options flag to enable (see +#5707).

+ ### Common Options diff --git a/src/doc/src/commands/cargo-metadata.md b/src/doc/src/commands/cargo-metadata.md index 3326c44a1..5bca0fe1c 100644 --- a/src/doc/src/commands/cargo-metadata.md +++ b/src/doc/src/commands/cargo-metadata.md @@ -458,6 +458,18 @@ offline.

--frozen
Equivalent to specifying both --locked and --offline.
+ +
--lockfile-path PATH
+
Changes the path of the lockfile from the default (./Cargo.lock) to PATH. PATH must end with +Cargo.lock (e.g. --lockfile-path /tmp/temporary-lockfile/Cargo.lock). Note that providing +--lockfile-path will ignore existing default lockfile (./Cargo.lock), if exists, and instead will +either use PATH lockfile (or write a new lockfile into the provided path if it doesn’t exist). +This flag can be used to run most commands in read-only directories, writing lockfile into the provided PATH.

+

This option is only available on the nightly +channel and +requires the -Z unstable-options flag to enable (see +#5707).

+ ### Common Options diff --git a/src/doc/src/commands/cargo-package.md b/src/doc/src/commands/cargo-package.md index 765281f47..ed091a127 100644 --- a/src/doc/src/commands/cargo-package.md +++ b/src/doc/src/commands/cargo-package.md @@ -233,6 +233,18 @@ offline.

Equivalent to specifying both --locked and --offline.
+
--lockfile-path PATH
+
Changes the path of the lockfile from the default (./Cargo.lock) to PATH. PATH must end with +Cargo.lock (e.g. --lockfile-path /tmp/temporary-lockfile/Cargo.lock). Note that providing +--lockfile-path will ignore existing default lockfile (./Cargo.lock), if exists, and instead will +either use PATH lockfile (or write a new lockfile into the provided path if it doesn’t exist). +This flag can be used to run most commands in read-only directories, writing lockfile into the provided PATH.

+

This option is only available on the nightly +channel and +requires the -Z unstable-options flag to enable (see +#5707).

+ + ### Miscellaneous Options diff --git a/src/doc/src/commands/cargo-pkgid.md b/src/doc/src/commands/cargo-pkgid.md index e392985f1..241a852b4 100644 --- a/src/doc/src/commands/cargo-pkgid.md +++ b/src/doc/src/commands/cargo-pkgid.md @@ -119,6 +119,18 @@ offline.

Equivalent to specifying both --locked and --offline.
+
--lockfile-path PATH
+
Changes the path of the lockfile from the default (./Cargo.lock) to PATH. PATH must end with +Cargo.lock (e.g. --lockfile-path /tmp/temporary-lockfile/Cargo.lock). Note that providing +--lockfile-path will ignore existing default lockfile (./Cargo.lock), if exists, and instead will +either use PATH lockfile (or write a new lockfile into the provided path if it doesn’t exist). +This flag can be used to run most commands in read-only directories, writing lockfile into the provided PATH.

+

This option is only available on the nightly +channel and +requires the -Z unstable-options flag to enable (see +#5707).

+ + ### Common Options diff --git a/src/doc/src/commands/cargo-publish.md b/src/doc/src/commands/cargo-publish.md index 17d917b7c..4607fc589 100644 --- a/src/doc/src/commands/cargo-publish.md +++ b/src/doc/src/commands/cargo-publish.md @@ -180,6 +180,18 @@ offline.

Equivalent to specifying both --locked and --offline.
+
--lockfile-path PATH
+
Changes the path of the lockfile from the default (./Cargo.lock) to PATH. PATH must end with +Cargo.lock (e.g. --lockfile-path /tmp/temporary-lockfile/Cargo.lock). Note that providing +--lockfile-path will ignore existing default lockfile (./Cargo.lock), if exists, and instead will +either use PATH lockfile (or write a new lockfile into the provided path if it doesn’t exist). +This flag can be used to run most commands in read-only directories, writing lockfile into the provided PATH.

+

This option is only available on the nightly +channel and +requires the -Z unstable-options flag to enable (see +#5707).

+ + ### Miscellaneous Options diff --git a/src/doc/src/commands/cargo-remove.md b/src/doc/src/commands/cargo-remove.md index afbcbf590..de9257543 100644 --- a/src/doc/src/commands/cargo-remove.md +++ b/src/doc/src/commands/cargo-remove.md @@ -109,6 +109,18 @@ offline.

--frozen
Equivalent to specifying both --locked and --offline.
+ +
--lockfile-path PATH
+
Changes the path of the lockfile from the default (./Cargo.lock) to PATH. PATH must end with +Cargo.lock (e.g. --lockfile-path /tmp/temporary-lockfile/Cargo.lock). Note that providing +--lockfile-path will ignore existing default lockfile (./Cargo.lock), if exists, and instead will +either use PATH lockfile (or write a new lockfile into the provided path if it doesn’t exist). +This flag can be used to run most commands in read-only directories, writing lockfile into the provided PATH.

+

This option is only available on the nightly +channel and +requires the -Z unstable-options flag to enable (see +#5707).

+ ### Package Selection diff --git a/src/doc/src/commands/cargo-run.md b/src/doc/src/commands/cargo-run.md index 4ea9ef2f8..e68f55001 100644 --- a/src/doc/src/commands/cargo-run.md +++ b/src/doc/src/commands/cargo-run.md @@ -238,6 +238,18 @@ offline.

Equivalent to specifying both --locked and --offline.
+
--lockfile-path PATH
+
Changes the path of the lockfile from the default (./Cargo.lock) to PATH. PATH must end with +Cargo.lock (e.g. --lockfile-path /tmp/temporary-lockfile/Cargo.lock). Note that providing +--lockfile-path will ignore existing default lockfile (./Cargo.lock), if exists, and instead will +either use PATH lockfile (or write a new lockfile into the provided path if it doesn’t exist). +This flag can be used to run most commands in read-only directories, writing lockfile into the provided PATH.

+

This option is only available on the nightly +channel and +requires the -Z unstable-options flag to enable (see +#5707).

+ + ### Common Options diff --git a/src/doc/src/commands/cargo-rustc.md b/src/doc/src/commands/cargo-rustc.md index 08d2479e3..8a5bee5da 100644 --- a/src/doc/src/commands/cargo-rustc.md +++ b/src/doc/src/commands/cargo-rustc.md @@ -332,6 +332,18 @@ offline.

Equivalent to specifying both --locked and --offline.
+
--lockfile-path PATH
+
Changes the path of the lockfile from the default (./Cargo.lock) to PATH. PATH must end with +Cargo.lock (e.g. --lockfile-path /tmp/temporary-lockfile/Cargo.lock). Note that providing +--lockfile-path will ignore existing default lockfile (./Cargo.lock), if exists, and instead will +either use PATH lockfile (or write a new lockfile into the provided path if it doesn’t exist). +This flag can be used to run most commands in read-only directories, writing lockfile into the provided PATH.

+

This option is only available on the nightly +channel and +requires the -Z unstable-options flag to enable (see +#5707).

+ + ### Common Options diff --git a/src/doc/src/commands/cargo-rustdoc.md b/src/doc/src/commands/cargo-rustdoc.md index f6c2ac4ce..5ec25b924 100644 --- a/src/doc/src/commands/cargo-rustdoc.md +++ b/src/doc/src/commands/cargo-rustdoc.md @@ -312,6 +312,18 @@ offline.

--frozen
Equivalent to specifying both --locked and --offline.
+ +
--lockfile-path PATH
+
Changes the path of the lockfile from the default (./Cargo.lock) to PATH. PATH must end with +Cargo.lock (e.g. --lockfile-path /tmp/temporary-lockfile/Cargo.lock). Note that providing +--lockfile-path will ignore existing default lockfile (./Cargo.lock), if exists, and instead will +either use PATH lockfile (or write a new lockfile into the provided path if it doesn’t exist). +This flag can be used to run most commands in read-only directories, writing lockfile into the provided PATH.

+

This option is only available on the nightly +channel and +requires the -Z unstable-options flag to enable (see +#5707).

+ ### Common Options diff --git a/src/doc/src/commands/cargo-test.md b/src/doc/src/commands/cargo-test.md index 0ea9255f9..ba9277594 100644 --- a/src/doc/src/commands/cargo-test.md +++ b/src/doc/src/commands/cargo-test.md @@ -434,6 +434,18 @@ offline.

Equivalent to specifying both --locked and --offline.
+
--lockfile-path PATH
+
Changes the path of the lockfile from the default (./Cargo.lock) to PATH. PATH must end with +Cargo.lock (e.g. --lockfile-path /tmp/temporary-lockfile/Cargo.lock). Note that providing +--lockfile-path will ignore existing default lockfile (./Cargo.lock), if exists, and instead will +either use PATH lockfile (or write a new lockfile into the provided path if it doesn’t exist). +This flag can be used to run most commands in read-only directories, writing lockfile into the provided PATH.

+

This option is only available on the nightly +channel and +requires the -Z unstable-options flag to enable (see +#5707).

+ + ### Common Options diff --git a/src/doc/src/commands/cargo-tree.md b/src/doc/src/commands/cargo-tree.md index a596a9b98..41e6d4dbb 100644 --- a/src/doc/src/commands/cargo-tree.md +++ b/src/doc/src/commands/cargo-tree.md @@ -251,6 +251,17 @@ offline.

Equivalent to specifying both --locked and --offline.
+
--lockfile-path PATH
+
Changes the path of the lockfile from the default (./Cargo.lock) to PATH. PATH must end with +Cargo.lock (e.g. --lockfile-path /tmp/temporary-lockfile/Cargo.lock). Note that providing +--lockfile-path will ignore existing default lockfile (./Cargo.lock), if exists, and instead will +either use PATH lockfile (or write a new lockfile into the provided path if it doesn’t exist). +This flag can be used to run most commands in read-only directories, writing lockfile into the provided PATH.

+

This option is only available on the nightly +channel and +requires the -Z unstable-options flag to enable (see +#5707).

+ ### Feature Selection diff --git a/src/doc/src/commands/cargo-update.md b/src/doc/src/commands/cargo-update.md index 3c7eb59e7..2b3a6458d 100644 --- a/src/doc/src/commands/cargo-update.md +++ b/src/doc/src/commands/cargo-update.md @@ -150,6 +150,18 @@ offline.

Equivalent to specifying both --locked and --offline.
+
--lockfile-path PATH
+
Changes the path of the lockfile from the default (./Cargo.lock) to PATH. PATH must end with +Cargo.lock (e.g. --lockfile-path /tmp/temporary-lockfile/Cargo.lock). Note that providing +--lockfile-path will ignore existing default lockfile (./Cargo.lock), if exists, and instead will +either use PATH lockfile (or write a new lockfile into the provided path if it doesn’t exist). +This flag can be used to run most commands in read-only directories, writing lockfile into the provided PATH.

+

This option is only available on the nightly +channel and +requires the -Z unstable-options flag to enable (see +#5707).

+ + ### Common Options diff --git a/src/doc/src/commands/cargo-vendor.md b/src/doc/src/commands/cargo-vendor.md index 587da266e..2e8ca08cd 100644 --- a/src/doc/src/commands/cargo-vendor.md +++ b/src/doc/src/commands/cargo-vendor.md @@ -97,6 +97,18 @@ offline.

Equivalent to specifying both --locked and --offline.
+
--lockfile-path PATH
+
Changes the path of the lockfile from the default (./Cargo.lock) to PATH. PATH must end with +Cargo.lock (e.g. --lockfile-path /tmp/temporary-lockfile/Cargo.lock). Note that providing +--lockfile-path will ignore existing default lockfile (./Cargo.lock), if exists, and instead will +either use PATH lockfile (or write a new lockfile into the provided path if it doesn’t exist). +This flag can be used to run most commands in read-only directories, writing lockfile into the provided PATH.

+

This option is only available on the nightly +channel and +requires the -Z unstable-options flag to enable (see +#5707).

+ + ### Display Options diff --git a/src/etc/man/cargo-add.1 b/src/etc/man/cargo-add.1 index ed8859da3..20fbed027 100644 --- a/src/etc/man/cargo-add.1 +++ b/src/etc/man/cargo-add.1 @@ -254,6 +254,20 @@ May also be specified with the \fBnet.offline\fR \fIconfig value\fR and +requires the \fB\-Z unstable\-options\fR flag to enable (see +\fI#5707\fR ). +.RE .SS "Common Options" .sp \fB+\fR\fItoolchain\fR diff --git a/src/etc/man/cargo-bench.1 b/src/etc/man/cargo-bench.1 index a9c3ba003..ae19351f1 100644 --- a/src/etc/man/cargo-bench.1 +++ b/src/etc/man/cargo-bench.1 @@ -454,6 +454,20 @@ May also be specified with the \fBnet.offline\fR \fIconfig value\fR and +requires the \fB\-Z unstable\-options\fR flag to enable (see +\fI#5707\fR ). +.RE .SS "Common Options" .sp \fB+\fR\fItoolchain\fR diff --git a/src/etc/man/cargo-build.1 b/src/etc/man/cargo-build.1 index 23e49a15e..77ffc5a2c 100644 --- a/src/etc/man/cargo-build.1 +++ b/src/etc/man/cargo-build.1 @@ -372,6 +372,20 @@ May also be specified with the \fBnet.offline\fR \fIconfig value\fR and +requires the \fB\-Z unstable\-options\fR flag to enable (see +\fI#5707\fR ). +.RE .SS "Common Options" .sp \fB+\fR\fItoolchain\fR diff --git a/src/etc/man/cargo-check.1 b/src/etc/man/cargo-check.1 index 50dd9e37f..2d9422ea8 100644 --- a/src/etc/man/cargo-check.1 +++ b/src/etc/man/cargo-check.1 @@ -353,6 +353,20 @@ May also be specified with the \fBnet.offline\fR \fIconfig value\fR and +requires the \fB\-Z unstable\-options\fR flag to enable (see +\fI#5707\fR ). +.RE .SS "Common Options" .sp \fB+\fR\fItoolchain\fR diff --git a/src/etc/man/cargo-clean.1 b/src/etc/man/cargo-clean.1 index 00f47ad91..8b5a483bb 100644 --- a/src/etc/man/cargo-clean.1 +++ b/src/etc/man/cargo-clean.1 @@ -153,6 +153,20 @@ May also be specified with the \fBnet.offline\fR \fIconfig value\fR and +requires the \fB\-Z unstable\-options\fR flag to enable (see +\fI#5707\fR ). +.RE .SS "Common Options" .sp \fB+\fR\fItoolchain\fR diff --git a/src/etc/man/cargo-doc.1 b/src/etc/man/cargo-doc.1 index 789a736f2..e704976df 100644 --- a/src/etc/man/cargo-doc.1 +++ b/src/etc/man/cargo-doc.1 @@ -320,6 +320,20 @@ May also be specified with the \fBnet.offline\fR \fIconfig value\fR and +requires the \fB\-Z unstable\-options\fR flag to enable (see +\fI#5707\fR ). +.RE .SS "Common Options" .sp \fB+\fR\fItoolchain\fR diff --git a/src/etc/man/cargo-fetch.1 b/src/etc/man/cargo-fetch.1 index 6687506f4..340330d58 100644 --- a/src/etc/man/cargo-fetch.1 +++ b/src/etc/man/cargo-fetch.1 @@ -119,6 +119,20 @@ May also be specified with the \fBnet.offline\fR \fIconfig value\fR and +requires the \fB\-Z unstable\-options\fR flag to enable (see +\fI#5707\fR ). +.RE .SS "Common Options" .sp \fB+\fR\fItoolchain\fR diff --git a/src/etc/man/cargo-fix.1 b/src/etc/man/cargo-fix.1 index 0b94291bb..897ea32cb 100644 --- a/src/etc/man/cargo-fix.1 +++ b/src/etc/man/cargo-fix.1 @@ -448,6 +448,20 @@ May also be specified with the \fBnet.offline\fR \fIconfig value\fR and +requires the \fB\-Z unstable\-options\fR flag to enable (see +\fI#5707\fR ). +.RE .SS "Common Options" .sp \fB+\fR\fItoolchain\fR diff --git a/src/etc/man/cargo-generate-lockfile.1 b/src/etc/man/cargo-generate-lockfile.1 index 732c805a7..235d81871 100644 --- a/src/etc/man/cargo-generate-lockfile.1 +++ b/src/etc/man/cargo-generate-lockfile.1 @@ -105,6 +105,20 @@ May also be specified with the \fBnet.offline\fR \fIconfig value\fR and +requires the \fB\-Z unstable\-options\fR flag to enable (see +\fI#5707\fR ). +.RE .SS "Common Options" .sp \fB+\fR\fItoolchain\fR diff --git a/src/etc/man/cargo-metadata.1 b/src/etc/man/cargo-metadata.1 index 1357ad1f5..bdb150576 100644 --- a/src/etc/man/cargo-metadata.1 +++ b/src/etc/man/cargo-metadata.1 @@ -476,6 +476,20 @@ May also be specified with the \fBnet.offline\fR \fIconfig value\fR and +requires the \fB\-Z unstable\-options\fR flag to enable (see +\fI#5707\fR ). +.RE .SS "Common Options" .sp \fB+\fR\fItoolchain\fR diff --git a/src/etc/man/cargo-package.1 b/src/etc/man/cargo-package.1 index 8530e5454..de7e71f91 100644 --- a/src/etc/man/cargo-package.1 +++ b/src/etc/man/cargo-package.1 @@ -260,6 +260,20 @@ May also be specified with the \fBnet.offline\fR \fIconfig value\fR and +requires the \fB\-Z unstable\-options\fR flag to enable (see +\fI#5707\fR ). +.RE .SS "Miscellaneous Options" .sp \fB\-j\fR \fIN\fR, diff --git a/src/etc/man/cargo-pkgid.1 b/src/etc/man/cargo-pkgid.1 index f8b7724bd..b84027526 100644 --- a/src/etc/man/cargo-pkgid.1 +++ b/src/etc/man/cargo-pkgid.1 @@ -159,6 +159,20 @@ May also be specified with the \fBnet.offline\fR \fIconfig value\fR and +requires the \fB\-Z unstable\-options\fR flag to enable (see +\fI#5707\fR ). +.RE .SS "Common Options" .sp \fB+\fR\fItoolchain\fR diff --git a/src/etc/man/cargo-publish.1 b/src/etc/man/cargo-publish.1 index 8a65416f7..4c3ddb665 100644 --- a/src/etc/man/cargo-publish.1 +++ b/src/etc/man/cargo-publish.1 @@ -192,6 +192,20 @@ May also be specified with the \fBnet.offline\fR \fIconfig value\fR and +requires the \fB\-Z unstable\-options\fR flag to enable (see +\fI#5707\fR ). +.RE .SS "Miscellaneous Options" .sp \fB\-j\fR \fIN\fR, diff --git a/src/etc/man/cargo-remove.1 b/src/etc/man/cargo-remove.1 index 12f1dcfe8..a2fe5ee12 100644 --- a/src/etc/man/cargo-remove.1 +++ b/src/etc/man/cargo-remove.1 @@ -119,6 +119,20 @@ May also be specified with the \fBnet.offline\fR \fIconfig value\fR and +requires the \fB\-Z unstable\-options\fR flag to enable (see +\fI#5707\fR ). +.RE .SS "Package Selection" .sp \fB\-p\fR \fIspec\fR\[u2026], diff --git a/src/etc/man/cargo-run.1 b/src/etc/man/cargo-run.1 index 654322fb9..dc4757ba2 100644 --- a/src/etc/man/cargo-run.1 +++ b/src/etc/man/cargo-run.1 @@ -257,6 +257,20 @@ May also be specified with the \fBnet.offline\fR \fIconfig value\fR and +requires the \fB\-Z unstable\-options\fR flag to enable (see +\fI#5707\fR ). +.RE .SS "Common Options" .sp \fB+\fR\fItoolchain\fR diff --git a/src/etc/man/cargo-rustc.1 b/src/etc/man/cargo-rustc.1 index cd07c6a32..f26973815 100644 --- a/src/etc/man/cargo-rustc.1 +++ b/src/etc/man/cargo-rustc.1 @@ -371,6 +371,20 @@ May also be specified with the \fBnet.offline\fR \fIconfig value\fR and +requires the \fB\-Z unstable\-options\fR flag to enable (see +\fI#5707\fR ). +.RE .SS "Common Options" .sp \fB+\fR\fItoolchain\fR diff --git a/src/etc/man/cargo-rustdoc.1 b/src/etc/man/cargo-rustdoc.1 index f89a6f7de..ee07bb6a7 100644 --- a/src/etc/man/cargo-rustdoc.1 +++ b/src/etc/man/cargo-rustdoc.1 @@ -339,6 +339,20 @@ May also be specified with the \fBnet.offline\fR \fIconfig value\fR and +requires the \fB\-Z unstable\-options\fR flag to enable (see +\fI#5707\fR ). +.RE .SS "Common Options" .sp \fB+\fR\fItoolchain\fR diff --git a/src/etc/man/cargo-test.1 b/src/etc/man/cargo-test.1 index 84b7ef192..504b3b788 100644 --- a/src/etc/man/cargo-test.1 +++ b/src/etc/man/cargo-test.1 @@ -481,6 +481,20 @@ May also be specified with the \fBnet.offline\fR \fIconfig value\fR and +requires the \fB\-Z unstable\-options\fR flag to enable (see +\fI#5707\fR ). +.RE .SS "Common Options" .sp \fB+\fR\fItoolchain\fR diff --git a/src/etc/man/cargo-tree.1 b/src/etc/man/cargo-tree.1 index 9c08491c8..be17c7948 100644 --- a/src/etc/man/cargo-tree.1 +++ b/src/etc/man/cargo-tree.1 @@ -304,6 +304,20 @@ May also be specified with the \fBnet.offline\fR \fIconfig value\fR and +requires the \fB\-Z unstable\-options\fR flag to enable (see +\fI#5707\fR ). +.RE .SS "Feature Selection" The feature flags allow you to control which features are enabled. When no feature options are given, the \fBdefault\fR feature is activated for every diff --git a/src/etc/man/cargo-update.1 b/src/etc/man/cargo-update.1 index c682e05fc..83975c2fc 100644 --- a/src/etc/man/cargo-update.1 +++ b/src/etc/man/cargo-update.1 @@ -181,6 +181,20 @@ May also be specified with the \fBnet.offline\fR \fIconfig value\fR and +requires the \fB\-Z unstable\-options\fR flag to enable (see +\fI#5707\fR ). +.RE .SS "Common Options" .sp \fB+\fR\fItoolchain\fR diff --git a/src/etc/man/cargo-vendor.1 b/src/etc/man/cargo-vendor.1 index eae728dea..66b842d01 100644 --- a/src/etc/man/cargo-vendor.1 +++ b/src/etc/man/cargo-vendor.1 @@ -100,6 +100,20 @@ May also be specified with the \fBnet.offline\fR \fIconfig value\fR and +requires the \fB\-Z unstable\-options\fR flag to enable (see +\fI#5707\fR ). +.RE .SS "Display Options" .sp \fB\-v\fR, diff --git a/tests/testsuite/cargo_add/help/stdout.term.svg b/tests/testsuite/cargo_add/help/stdout.term.svg index 2e1cacd32..e7bbb88b0 100644 --- a/tests/testsuite/cargo_add/help/stdout.term.svg +++ b/tests/testsuite/cargo_add/help/stdout.term.svg @@ -1,4 +1,4 @@ - +