From 26b2e74e555f85e69ec711dfd526598aaac2ba78 Mon Sep 17 00:00:00 2001 From: Weihang Lo Date: Wed, 27 Mar 2024 22:24:06 -0400 Subject: [PATCH] docs: clarify `--locked` disallows changes in `Cargo.lock` --- src/bin/cargo/cli.rs | 2 +- src/doc/man/generated_txt/cargo-add.txt | 17 +++++++++++------ src/doc/man/generated_txt/cargo-bench.txt | 17 +++++++++++------ src/doc/man/generated_txt/cargo-build.txt | 17 +++++++++++------ src/doc/man/generated_txt/cargo-check.txt | 17 +++++++++++------ src/doc/man/generated_txt/cargo-clean.txt | 17 +++++++++++------ src/doc/man/generated_txt/cargo-doc.txt | 17 +++++++++++------ src/doc/man/generated_txt/cargo-fetch.txt | 17 +++++++++++------ src/doc/man/generated_txt/cargo-fix.txt | 17 +++++++++++------ .../generated_txt/cargo-generate-lockfile.txt | 17 +++++++++++------ src/doc/man/generated_txt/cargo-install.txt | 17 +++++++++++------ src/doc/man/generated_txt/cargo-metadata.txt | 17 +++++++++++------ src/doc/man/generated_txt/cargo-package.txt | 17 +++++++++++------ src/doc/man/generated_txt/cargo-pkgid.txt | 17 +++++++++++------ src/doc/man/generated_txt/cargo-publish.txt | 17 +++++++++++------ src/doc/man/generated_txt/cargo-remove.txt | 17 +++++++++++------ src/doc/man/generated_txt/cargo-run.txt | 17 +++++++++++------ src/doc/man/generated_txt/cargo-rustc.txt | 17 +++++++++++------ src/doc/man/generated_txt/cargo-rustdoc.txt | 17 +++++++++++------ src/doc/man/generated_txt/cargo-test.txt | 17 +++++++++++------ src/doc/man/generated_txt/cargo-tree.txt | 17 +++++++++++------ src/doc/man/generated_txt/cargo-update.txt | 17 +++++++++++------ src/doc/man/generated_txt/cargo-vendor.txt | 17 +++++++++++------ .../man/generated_txt/cargo-verify-project.txt | 17 +++++++++++------ src/doc/man/includes/options-locked.md | 13 ++++++++----- src/doc/src/commands/cargo-add.md | 14 +++++++++----- src/doc/src/commands/cargo-bench.md | 14 +++++++++----- src/doc/src/commands/cargo-build.md | 14 +++++++++----- src/doc/src/commands/cargo-check.md | 14 +++++++++----- src/doc/src/commands/cargo-clean.md | 14 +++++++++----- src/doc/src/commands/cargo-doc.md | 14 +++++++++----- src/doc/src/commands/cargo-fetch.md | 14 +++++++++----- src/doc/src/commands/cargo-fix.md | 14 +++++++++----- .../src/commands/cargo-generate-lockfile.md | 14 +++++++++----- src/doc/src/commands/cargo-install.md | 14 +++++++++----- src/doc/src/commands/cargo-metadata.md | 14 +++++++++----- src/doc/src/commands/cargo-package.md | 14 +++++++++----- src/doc/src/commands/cargo-pkgid.md | 14 +++++++++----- src/doc/src/commands/cargo-publish.md | 14 +++++++++----- src/doc/src/commands/cargo-remove.md | 14 +++++++++----- src/doc/src/commands/cargo-run.md | 14 +++++++++----- src/doc/src/commands/cargo-rustc.md | 14 +++++++++----- src/doc/src/commands/cargo-rustdoc.md | 14 +++++++++----- src/doc/src/commands/cargo-test.md | 14 +++++++++----- src/doc/src/commands/cargo-tree.md | 14 +++++++++----- src/doc/src/commands/cargo-update.md | 14 +++++++++----- src/doc/src/commands/cargo-vendor.md | 14 +++++++++----- src/doc/src/commands/cargo-verify-project.md | 14 +++++++++----- src/etc/man/cargo-add.1 | 18 +++++++++++++----- src/etc/man/cargo-bench.1 | 18 +++++++++++++----- src/etc/man/cargo-build.1 | 18 +++++++++++++----- src/etc/man/cargo-check.1 | 18 +++++++++++++----- src/etc/man/cargo-clean.1 | 18 +++++++++++++----- src/etc/man/cargo-doc.1 | 18 +++++++++++++----- src/etc/man/cargo-fetch.1 | 18 +++++++++++++----- src/etc/man/cargo-fix.1 | 18 +++++++++++++----- src/etc/man/cargo-generate-lockfile.1 | 18 +++++++++++++----- src/etc/man/cargo-install.1 | 18 +++++++++++++----- src/etc/man/cargo-metadata.1 | 18 +++++++++++++----- src/etc/man/cargo-package.1 | 18 +++++++++++++----- src/etc/man/cargo-pkgid.1 | 18 +++++++++++++----- src/etc/man/cargo-publish.1 | 18 +++++++++++++----- src/etc/man/cargo-remove.1 | 18 +++++++++++++----- src/etc/man/cargo-run.1 | 18 +++++++++++++----- src/etc/man/cargo-rustc.1 | 18 +++++++++++++----- src/etc/man/cargo-rustdoc.1 | 18 +++++++++++++----- src/etc/man/cargo-test.1 | 18 +++++++++++++----- src/etc/man/cargo-tree.1 | 18 +++++++++++++----- src/etc/man/cargo-update.1 | 18 +++++++++++++----- src/etc/man/cargo-vendor.1 | 18 +++++++++++++----- src/etc/man/cargo-verify-project.1 | 18 +++++++++++++----- tests/testsuite/cargo/help/stdout.term.svg | 2 +- tests/testsuite/cargo_add/help/stdout.term.svg | 2 +- .../testsuite/cargo_bench/help/stdout.term.svg | 2 +- .../testsuite/cargo_build/help/stdout.term.svg | 2 +- .../testsuite/cargo_check/help/stdout.term.svg | 2 +- .../testsuite/cargo_clean/help/stdout.term.svg | 2 +- .../cargo_config/help/stdout.term.svg | 2 +- tests/testsuite/cargo_doc/help/stdout.term.svg | 2 +- .../testsuite/cargo_fetch/help/stdout.term.svg | 2 +- tests/testsuite/cargo_fix/help/stdout.term.svg | 2 +- .../help/stdout.term.svg | 2 +- .../testsuite/cargo_help/help/stdout.term.svg | 2 +- .../testsuite/cargo_init/help/stdout.term.svg | 2 +- .../cargo_install/help/stdout.term.svg | 2 +- .../cargo_locate_project/help/stdout.term.svg | 2 +- .../testsuite/cargo_login/help/stdout.term.svg | 2 +- .../cargo_logout/help/stdout.term.svg | 2 +- .../cargo_metadata/help/stdout.term.svg | 2 +- tests/testsuite/cargo_new/help/stdout.term.svg | 2 +- .../testsuite/cargo_owner/help/stdout.term.svg | 2 +- .../cargo_package/help/stdout.term.svg | 2 +- .../testsuite/cargo_pkgid/help/stdout.term.svg | 2 +- .../cargo_publish/help/stdout.term.svg | 2 +- .../cargo_read_manifest/help/stdout.term.svg | 2 +- .../cargo_remove/help/stdout.term.svg | 2 +- .../cargo_report/help/stdout.term.svg | 2 +- tests/testsuite/cargo_run/help/stdout.term.svg | 2 +- .../testsuite/cargo_rustc/help/stdout.term.svg | 2 +- .../cargo_rustdoc/help/stdout.term.svg | 2 +- .../cargo_search/help/stdout.term.svg | 2 +- .../testsuite/cargo_test/help/stdout.term.svg | 2 +- .../testsuite/cargo_tree/help/stdout.term.svg | 2 +- .../cargo_uninstall/help/stdout.term.svg | 2 +- .../cargo_update/help/stdout.term.svg | 2 +- .../cargo_vendor/help/stdout.term.svg | 2 +- .../cargo_verify_project/help/stdout.term.svg | 2 +- .../cargo_version/help/stdout.term.svg | 2 +- .../testsuite/cargo_yank/help/stdout.term.svg | 2 +- 109 files changed, 806 insertions(+), 412 deletions(-) diff --git a/src/bin/cargo/cli.rs b/src/bin/cargo/cli.rs index 95e5c0e8a67..f4f04bb4f5e 100644 --- a/src/bin/cargo/cli.rs +++ b/src/bin/cargo/cli.rs @@ -640,7 +640,7 @@ See 'cargo help <>' for more information on a sp .value_parser(clap::builder::ValueParser::path_buf()), ) .arg( - flag("locked", "Require Cargo.lock to be up-to-date") + flag("locked", "Assert that `Cargo.lock` will remain unchanged") .help_heading(heading::MANIFEST_OPTIONS) .global(true), ) diff --git a/src/doc/man/generated_txt/cargo-add.txt b/src/doc/man/generated_txt/cargo-add.txt index b8981fd2087..83e1dda7de2 100644 --- a/src/doc/man/generated_txt/cargo-add.txt +++ b/src/doc/man/generated_txt/cargo-add.txt @@ -172,13 +172,18 @@ OPTIONS Add dependencies to only the specified package. --locked - Requires the Cargo.lock file be up-to-date. If the lock file is - missing, or it needs to be updated due to changes in the Cargo.toml - file, for example a new dependency is added, Cargo will exit with an - error. + Asserts that the exact same dependencies and versions are used as + when the existing Cargo.lock file was originally generated. Cargo + will exit with an error when either of the following scenarios + arises: - It may be used in environments where you want to assert that the - Cargo.lock file is up-to-date (such as a CI build). + o The lock file is missing. + + o Cargo attempted to change the lock file due to a different + dependency resolution. + + It may be used in environments where deterministic builds are + desired, such as in CI pipelines. --offline Prevents Cargo from accessing the network for any reason. Without diff --git a/src/doc/man/generated_txt/cargo-bench.txt b/src/doc/man/generated_txt/cargo-bench.txt index f75e8ac8264..7984879acdb 100644 --- a/src/doc/man/generated_txt/cargo-bench.txt +++ b/src/doc/man/generated_txt/cargo-bench.txt @@ -339,13 +339,18 @@ OPTIONS Cargo.toml file in the current directory or any parent directory. --locked - Requires the Cargo.lock file be up-to-date. If the lock file is - missing, or it needs to be updated due to changes in the Cargo.toml - file, for example a new dependency is added, Cargo will exit with an - error. + Asserts that the exact same dependencies and versions are used as + when the existing Cargo.lock file was originally generated. Cargo + will exit with an error when either of the following scenarios + arises: - It may be used in environments where you want to assert that the - Cargo.lock file is up-to-date (such as a CI build). + o The lock file is missing. + + o Cargo attempted to change the lock file due to a different + dependency resolution. + + It may be used in environments where deterministic builds are + desired, such as in CI pipelines. --offline Prevents Cargo from accessing the network for any reason. Without diff --git a/src/doc/man/generated_txt/cargo-build.txt b/src/doc/man/generated_txt/cargo-build.txt index e6fc2616a25..7d652e8eb0c 100644 --- a/src/doc/man/generated_txt/cargo-build.txt +++ b/src/doc/man/generated_txt/cargo-build.txt @@ -273,13 +273,18 @@ OPTIONS Cargo.toml file in the current directory or any parent directory. --locked - Requires the Cargo.lock file be up-to-date. If the lock file is - missing, or it needs to be updated due to changes in the Cargo.toml - file, for example a new dependency is added, Cargo will exit with an - error. + Asserts that the exact same dependencies and versions are used as + when the existing Cargo.lock file was originally generated. Cargo + will exit with an error when either of the following scenarios + arises: - It may be used in environments where you want to assert that the - Cargo.lock file is up-to-date (such as a CI build). + o The lock file is missing. + + o Cargo attempted to change the lock file due to a different + dependency resolution. + + It may be used in environments where deterministic builds are + desired, such as in CI pipelines. --offline Prevents Cargo from accessing the network for any reason. Without diff --git a/src/doc/man/generated_txt/cargo-check.txt b/src/doc/man/generated_txt/cargo-check.txt index 0cbb36a1aea..bfc300360f9 100644 --- a/src/doc/man/generated_txt/cargo-check.txt +++ b/src/doc/man/generated_txt/cargo-check.txt @@ -258,13 +258,18 @@ OPTIONS Cargo.toml file in the current directory or any parent directory. --locked - Requires the Cargo.lock file be up-to-date. If the lock file is - missing, or it needs to be updated due to changes in the Cargo.toml - file, for example a new dependency is added, Cargo will exit with an - error. + Asserts that the exact same dependencies and versions are used as + when the existing Cargo.lock file was originally generated. Cargo + will exit with an error when either of the following scenarios + arises: - It may be used in environments where you want to assert that the - Cargo.lock file is up-to-date (such as a CI build). + o The lock file is missing. + + o Cargo attempted to change the lock file due to a different + dependency resolution. + + It may be used in environments where deterministic builds are + desired, such as in CI pipelines. --offline Prevents Cargo from accessing the network for any reason. Without diff --git a/src/doc/man/generated_txt/cargo-clean.txt b/src/doc/man/generated_txt/cargo-clean.txt index fb50ba7ece4..066a70352a3 100644 --- a/src/doc/man/generated_txt/cargo-clean.txt +++ b/src/doc/man/generated_txt/cargo-clean.txt @@ -92,13 +92,18 @@ OPTIONS Cargo.toml file in the current directory or any parent directory. --locked - Requires the Cargo.lock file be up-to-date. If the lock file is - missing, or it needs to be updated due to changes in the Cargo.toml - file, for example a new dependency is added, Cargo will exit with an - error. + Asserts that the exact same dependencies and versions are used as + when the existing Cargo.lock file was originally generated. Cargo + will exit with an error when either of the following scenarios + arises: - It may be used in environments where you want to assert that the - Cargo.lock file is up-to-date (such as a CI build). + o The lock file is missing. + + o Cargo attempted to change the lock file due to a different + dependency resolution. + + It may be used in environments where deterministic builds are + desired, such as in CI pipelines. --offline Prevents Cargo from accessing the network for any reason. Without diff --git a/src/doc/man/generated_txt/cargo-doc.txt b/src/doc/man/generated_txt/cargo-doc.txt index f4b93a9985a..d6b0eb2afdc 100644 --- a/src/doc/man/generated_txt/cargo-doc.txt +++ b/src/doc/man/generated_txt/cargo-doc.txt @@ -229,13 +229,18 @@ OPTIONS Cargo.toml file in the current directory or any parent directory. --locked - Requires the Cargo.lock file be up-to-date. If the lock file is - missing, or it needs to be updated due to changes in the Cargo.toml - file, for example a new dependency is added, Cargo will exit with an - error. + Asserts that the exact same dependencies and versions are used as + when the existing Cargo.lock file was originally generated. Cargo + will exit with an error when either of the following scenarios + arises: - It may be used in environments where you want to assert that the - Cargo.lock file is up-to-date (such as a CI build). + o The lock file is missing. + + o Cargo attempted to change the lock file due to a different + dependency resolution. + + It may be used in environments where deterministic builds are + desired, such as in CI pipelines. --offline Prevents Cargo from accessing the network for any reason. Without diff --git a/src/doc/man/generated_txt/cargo-fetch.txt b/src/doc/man/generated_txt/cargo-fetch.txt index 37ecd928bec..63fa205a3c5 100644 --- a/src/doc/man/generated_txt/cargo-fetch.txt +++ b/src/doc/man/generated_txt/cargo-fetch.txt @@ -72,13 +72,18 @@ OPTIONS Cargo.toml file in the current directory or any parent directory. --locked - Requires the Cargo.lock file be up-to-date. If the lock file is - missing, or it needs to be updated due to changes in the Cargo.toml - file, for example a new dependency is added, Cargo will exit with an - error. + Asserts that the exact same dependencies and versions are used as + when the existing Cargo.lock file was originally generated. Cargo + will exit with an error when either of the following scenarios + arises: - It may be used in environments where you want to assert that the - Cargo.lock file is up-to-date (such as a CI build). + o The lock file is missing. + + o Cargo attempted to change the lock file due to a different + dependency resolution. + + It may be used in environments where deterministic builds are + desired, such as in CI pipelines. --offline Prevents Cargo from accessing the network for any reason. Without diff --git a/src/doc/man/generated_txt/cargo-fix.txt b/src/doc/man/generated_txt/cargo-fix.txt index 81830bf1c13..92b2d9d0881 100644 --- a/src/doc/man/generated_txt/cargo-fix.txt +++ b/src/doc/man/generated_txt/cargo-fix.txt @@ -331,13 +331,18 @@ OPTIONS Cargo.toml file in the current directory or any parent directory. --locked - Requires the Cargo.lock file be up-to-date. If the lock file is - missing, or it needs to be updated due to changes in the Cargo.toml - file, for example a new dependency is added, Cargo will exit with an - error. + Asserts that the exact same dependencies and versions are used as + when the existing Cargo.lock file was originally generated. Cargo + will exit with an error when either of the following scenarios + arises: - It may be used in environments where you want to assert that the - Cargo.lock file is up-to-date (such as a CI build). + o The lock file is missing. + + o Cargo attempted to change the lock file due to a different + dependency resolution. + + It may be used in environments where deterministic builds are + desired, such as in CI pipelines. --offline Prevents Cargo from accessing the network for any reason. Without diff --git a/src/doc/man/generated_txt/cargo-generate-lockfile.txt b/src/doc/man/generated_txt/cargo-generate-lockfile.txt index 7e5dae0627d..d1951275e3b 100644 --- a/src/doc/man/generated_txt/cargo-generate-lockfile.txt +++ b/src/doc/man/generated_txt/cargo-generate-lockfile.txt @@ -47,13 +47,18 @@ OPTIONS Cargo.toml file in the current directory or any parent directory. --locked - Requires the Cargo.lock file be up-to-date. If the lock file is - missing, or it needs to be updated due to changes in the Cargo.toml - file, for example a new dependency is added, Cargo will exit with an - error. + Asserts that the exact same dependencies and versions are used as + when the existing Cargo.lock file was originally generated. Cargo + will exit with an error when either of the following scenarios + arises: - It may be used in environments where you want to assert that the - Cargo.lock file is up-to-date (such as a CI build). + o The lock file is missing. + + o Cargo attempted to change the lock file due to a different + dependency resolution. + + It may be used in environments where deterministic builds are + desired, such as in CI pipelines. --offline Prevents Cargo from accessing the network for any reason. Without diff --git a/src/doc/man/generated_txt/cargo-install.txt b/src/doc/man/generated_txt/cargo-install.txt index 2ba85c59632..1e362195250 100644 --- a/src/doc/man/generated_txt/cargo-install.txt +++ b/src/doc/man/generated_txt/cargo-install.txt @@ -243,13 +243,18 @@ OPTIONS Manifest Options --locked - Requires the Cargo.lock file be up-to-date. If the lock file is - missing, or it needs to be updated due to changes in the Cargo.toml - file, for example a new dependency is added, Cargo will exit with an - error. + Asserts that the exact same dependencies and versions are used as + when the existing Cargo.lock file was originally generated. Cargo + will exit with an error when either of the following scenarios + arises: - It may be used in environments where you want to assert that the - Cargo.lock file is up-to-date (such as a CI build). + o The lock file is missing. + + o Cargo attempted to change the lock file due to a different + dependency resolution. + + It may be used in environments where deterministic builds are + desired, such as in CI pipelines. --offline Prevents Cargo from accessing the network for any reason. Without diff --git a/src/doc/man/generated_txt/cargo-metadata.txt b/src/doc/man/generated_txt/cargo-metadata.txt index dd670191add..f1f5b1fc275 100644 --- a/src/doc/man/generated_txt/cargo-metadata.txt +++ b/src/doc/man/generated_txt/cargo-metadata.txt @@ -405,13 +405,18 @@ OPTIONS Cargo.toml file in the current directory or any parent directory. --locked - Requires the Cargo.lock file be up-to-date. If the lock file is - missing, or it needs to be updated due to changes in the Cargo.toml - file, for example a new dependency is added, Cargo will exit with an - error. + Asserts that the exact same dependencies and versions are used as + when the existing Cargo.lock file was originally generated. Cargo + will exit with an error when either of the following scenarios + arises: - It may be used in environments where you want to assert that the - Cargo.lock file is up-to-date (such as a CI build). + o The lock file is missing. + + o Cargo attempted to change the lock file due to a different + dependency resolution. + + It may be used in environments where deterministic builds are + desired, such as in CI pipelines. --offline Prevents Cargo from accessing the network for any reason. Without diff --git a/src/doc/man/generated_txt/cargo-package.txt b/src/doc/man/generated_txt/cargo-package.txt index 1dbed569220..f24d09b75c9 100644 --- a/src/doc/man/generated_txt/cargo-package.txt +++ b/src/doc/man/generated_txt/cargo-package.txt @@ -159,13 +159,18 @@ OPTIONS Cargo.toml file in the current directory or any parent directory. --locked - Requires the Cargo.lock file be up-to-date. If the lock file is - missing, or it needs to be updated due to changes in the Cargo.toml - file, for example a new dependency is added, Cargo will exit with an - error. + Asserts that the exact same dependencies and versions are used as + when the existing Cargo.lock file was originally generated. Cargo + will exit with an error when either of the following scenarios + arises: - It may be used in environments where you want to assert that the - Cargo.lock file is up-to-date (such as a CI build). + o The lock file is missing. + + o Cargo attempted to change the lock file due to a different + dependency resolution. + + It may be used in environments where deterministic builds are + desired, such as in CI pipelines. --offline Prevents Cargo from accessing the network for any reason. Without diff --git a/src/doc/man/generated_txt/cargo-pkgid.txt b/src/doc/man/generated_txt/cargo-pkgid.txt index 00bcd4f3e72..3123dcad20b 100644 --- a/src/doc/man/generated_txt/cargo-pkgid.txt +++ b/src/doc/man/generated_txt/cargo-pkgid.txt @@ -85,13 +85,18 @@ OPTIONS Cargo.toml file in the current directory or any parent directory. --locked - Requires the Cargo.lock file be up-to-date. If the lock file is - missing, or it needs to be updated due to changes in the Cargo.toml - file, for example a new dependency is added, Cargo will exit with an - error. + Asserts that the exact same dependencies and versions are used as + when the existing Cargo.lock file was originally generated. Cargo + will exit with an error when either of the following scenarios + arises: - It may be used in environments where you want to assert that the - Cargo.lock file is up-to-date (such as a CI build). + o The lock file is missing. + + o Cargo attempted to change the lock file due to a different + dependency resolution. + + It may be used in environments where deterministic builds are + desired, such as in CI pipelines. --offline Prevents Cargo from accessing the network for any reason. Without diff --git a/src/doc/man/generated_txt/cargo-publish.txt b/src/doc/man/generated_txt/cargo-publish.txt index 16c4010655c..d0b32a1582d 100644 --- a/src/doc/man/generated_txt/cargo-publish.txt +++ b/src/doc/man/generated_txt/cargo-publish.txt @@ -129,13 +129,18 @@ OPTIONS Cargo.toml file in the current directory or any parent directory. --locked - Requires the Cargo.lock file be up-to-date. If the lock file is - missing, or it needs to be updated due to changes in the Cargo.toml - file, for example a new dependency is added, Cargo will exit with an - error. + Asserts that the exact same dependencies and versions are used as + when the existing Cargo.lock file was originally generated. Cargo + will exit with an error when either of the following scenarios + arises: - It may be used in environments where you want to assert that the - Cargo.lock file is up-to-date (such as a CI build). + o The lock file is missing. + + o Cargo attempted to change the lock file due to a different + dependency resolution. + + It may be used in environments where deterministic builds are + desired, such as in CI pipelines. --offline Prevents Cargo from accessing the network for any reason. Without diff --git a/src/doc/man/generated_txt/cargo-remove.txt b/src/doc/man/generated_txt/cargo-remove.txt index 5092dd94e50..9d8c14afcc9 100644 --- a/src/doc/man/generated_txt/cargo-remove.txt +++ b/src/doc/man/generated_txt/cargo-remove.txt @@ -62,13 +62,18 @@ OPTIONS Cargo.toml file in the current directory or any parent directory. --locked - Requires the Cargo.lock file be up-to-date. If the lock file is - missing, or it needs to be updated due to changes in the Cargo.toml - file, for example a new dependency is added, Cargo will exit with an - error. + Asserts that the exact same dependencies and versions are used as + when the existing Cargo.lock file was originally generated. Cargo + will exit with an error when either of the following scenarios + arises: - It may be used in environments where you want to assert that the - Cargo.lock file is up-to-date (such as a CI build). + o The lock file is missing. + + o Cargo attempted to change the lock file due to a different + dependency resolution. + + It may be used in environments where deterministic builds are + desired, such as in CI pipelines. --offline Prevents Cargo from accessing the network for any reason. Without diff --git a/src/doc/man/generated_txt/cargo-run.txt b/src/doc/man/generated_txt/cargo-run.txt index e977975cb20..0a86eaba12d 100644 --- a/src/doc/man/generated_txt/cargo-run.txt +++ b/src/doc/man/generated_txt/cargo-run.txt @@ -177,13 +177,18 @@ OPTIONS Cargo.toml file in the current directory or any parent directory. --locked - Requires the Cargo.lock file be up-to-date. If the lock file is - missing, or it needs to be updated due to changes in the Cargo.toml - file, for example a new dependency is added, Cargo will exit with an - error. + Asserts that the exact same dependencies and versions are used as + when the existing Cargo.lock file was originally generated. Cargo + will exit with an error when either of the following scenarios + arises: - It may be used in environments where you want to assert that the - Cargo.lock file is up-to-date (such as a CI build). + o The lock file is missing. + + o Cargo attempted to change the lock file due to a different + dependency resolution. + + It may be used in environments where deterministic builds are + desired, such as in CI pipelines. --offline Prevents Cargo from accessing the network for any reason. Without diff --git a/src/doc/man/generated_txt/cargo-rustc.txt b/src/doc/man/generated_txt/cargo-rustc.txt index 878889cc188..e16633b7dde 100644 --- a/src/doc/man/generated_txt/cargo-rustc.txt +++ b/src/doc/man/generated_txt/cargo-rustc.txt @@ -275,13 +275,18 @@ OPTIONS Cargo.toml file in the current directory or any parent directory. --locked - Requires the Cargo.lock file be up-to-date. If the lock file is - missing, or it needs to be updated due to changes in the Cargo.toml - file, for example a new dependency is added, Cargo will exit with an - error. + Asserts that the exact same dependencies and versions are used as + when the existing Cargo.lock file was originally generated. Cargo + will exit with an error when either of the following scenarios + arises: - It may be used in environments where you want to assert that the - Cargo.lock file is up-to-date (such as a CI build). + o The lock file is missing. + + o Cargo attempted to change the lock file due to a different + dependency resolution. + + It may be used in environments where deterministic builds are + desired, such as in CI pipelines. --offline Prevents Cargo from accessing the network for any reason. Without diff --git a/src/doc/man/generated_txt/cargo-rustdoc.txt b/src/doc/man/generated_txt/cargo-rustdoc.txt index 92c32864f54..024796e2ed3 100644 --- a/src/doc/man/generated_txt/cargo-rustdoc.txt +++ b/src/doc/man/generated_txt/cargo-rustdoc.txt @@ -245,13 +245,18 @@ OPTIONS Cargo.toml file in the current directory or any parent directory. --locked - Requires the Cargo.lock file be up-to-date. If the lock file is - missing, or it needs to be updated due to changes in the Cargo.toml - file, for example a new dependency is added, Cargo will exit with an - error. + Asserts that the exact same dependencies and versions are used as + when the existing Cargo.lock file was originally generated. Cargo + will exit with an error when either of the following scenarios + arises: - It may be used in environments where you want to assert that the - Cargo.lock file is up-to-date (such as a CI build). + o The lock file is missing. + + o Cargo attempted to change the lock file due to a different + dependency resolution. + + It may be used in environments where deterministic builds are + desired, such as in CI pipelines. --offline Prevents Cargo from accessing the network for any reason. Without diff --git a/src/doc/man/generated_txt/cargo-test.txt b/src/doc/man/generated_txt/cargo-test.txt index a0b4c43fd1a..690fb31ddba 100644 --- a/src/doc/man/generated_txt/cargo-test.txt +++ b/src/doc/man/generated_txt/cargo-test.txt @@ -365,13 +365,18 @@ OPTIONS Cargo.toml file in the current directory or any parent directory. --locked - Requires the Cargo.lock file be up-to-date. If the lock file is - missing, or it needs to be updated due to changes in the Cargo.toml - file, for example a new dependency is added, Cargo will exit with an - error. + Asserts that the exact same dependencies and versions are used as + when the existing Cargo.lock file was originally generated. Cargo + will exit with an error when either of the following scenarios + arises: - It may be used in environments where you want to assert that the - Cargo.lock file is up-to-date (such as a CI build). + o The lock file is missing. + + o Cargo attempted to change the lock file due to a different + dependency resolution. + + It may be used in environments where deterministic builds are + desired, such as in CI pipelines. --offline Prevents Cargo from accessing the network for any reason. Without diff --git a/src/doc/man/generated_txt/cargo-tree.txt b/src/doc/man/generated_txt/cargo-tree.txt index 0bd39986c62..4037e7f0c5c 100644 --- a/src/doc/man/generated_txt/cargo-tree.txt +++ b/src/doc/man/generated_txt/cargo-tree.txt @@ -212,13 +212,18 @@ OPTIONS Cargo.toml file in the current directory or any parent directory. --locked - Requires the Cargo.lock file be up-to-date. If the lock file is - missing, or it needs to be updated due to changes in the Cargo.toml - file, for example a new dependency is added, Cargo will exit with an - error. + Asserts that the exact same dependencies and versions are used as + when the existing Cargo.lock file was originally generated. Cargo + will exit with an error when either of the following scenarios + arises: - It may be used in environments where you want to assert that the - Cargo.lock file is up-to-date (such as a CI build). + o The lock file is missing. + + o Cargo attempted to change the lock file due to a different + dependency resolution. + + It may be used in environments where deterministic builds are + desired, such as in CI pipelines. --offline Prevents Cargo from accessing the network for any reason. Without diff --git a/src/doc/man/generated_txt/cargo-update.txt b/src/doc/man/generated_txt/cargo-update.txt index a4b9c24f6bb..a1be485b987 100644 --- a/src/doc/man/generated_txt/cargo-update.txt +++ b/src/doc/man/generated_txt/cargo-update.txt @@ -82,13 +82,18 @@ OPTIONS Cargo.toml file in the current directory or any parent directory. --locked - Requires the Cargo.lock file be up-to-date. If the lock file is - missing, or it needs to be updated due to changes in the Cargo.toml - file, for example a new dependency is added, Cargo will exit with an - error. + Asserts that the exact same dependencies and versions are used as + when the existing Cargo.lock file was originally generated. Cargo + will exit with an error when either of the following scenarios + arises: - It may be used in environments where you want to assert that the - Cargo.lock file is up-to-date (such as a CI build). + o The lock file is missing. + + o Cargo attempted to change the lock file due to a different + dependency resolution. + + It may be used in environments where deterministic builds are + desired, such as in CI pipelines. --offline Prevents Cargo from accessing the network for any reason. Without diff --git a/src/doc/man/generated_txt/cargo-vendor.txt b/src/doc/man/generated_txt/cargo-vendor.txt index a46c2afe96e..ab1e9a0f09b 100644 --- a/src/doc/man/generated_txt/cargo-vendor.txt +++ b/src/doc/man/generated_txt/cargo-vendor.txt @@ -54,13 +54,18 @@ OPTIONS Cargo.toml file in the current directory or any parent directory. --locked - Requires the Cargo.lock file be up-to-date. If the lock file is - missing, or it needs to be updated due to changes in the Cargo.toml - file, for example a new dependency is added, Cargo will exit with an - error. + Asserts that the exact same dependencies and versions are used as + when the existing Cargo.lock file was originally generated. Cargo + will exit with an error when either of the following scenarios + arises: - It may be used in environments where you want to assert that the - Cargo.lock file is up-to-date (such as a CI build). + o The lock file is missing. + + o Cargo attempted to change the lock file due to a different + dependency resolution. + + It may be used in environments where deterministic builds are + desired, such as in CI pipelines. --offline Prevents Cargo from accessing the network for any reason. Without diff --git a/src/doc/man/generated_txt/cargo-verify-project.txt b/src/doc/man/generated_txt/cargo-verify-project.txt index 86736043b25..aca632b5c6f 100644 --- a/src/doc/man/generated_txt/cargo-verify-project.txt +++ b/src/doc/man/generated_txt/cargo-verify-project.txt @@ -50,13 +50,18 @@ OPTIONS Cargo.toml file in the current directory or any parent directory. --locked - Requires the Cargo.lock file be up-to-date. If the lock file is - missing, or it needs to be updated due to changes in the Cargo.toml - file, for example a new dependency is added, Cargo will exit with an - error. + Asserts that the exact same dependencies and versions are used as + when the existing Cargo.lock file was originally generated. Cargo + will exit with an error when either of the following scenarios + arises: - It may be used in environments where you want to assert that the - Cargo.lock file is up-to-date (such as a CI build). + o The lock file is missing. + + o Cargo attempted to change the lock file due to a different + dependency resolution. + + It may be used in environments where deterministic builds are + desired, such as in CI pipelines. --offline Prevents Cargo from accessing the network for any reason. Without diff --git a/src/doc/man/includes/options-locked.md b/src/doc/man/includes/options-locked.md index 34fa96bef9c..31c8d1e006d 100644 --- a/src/doc/man/includes/options-locked.md +++ b/src/doc/man/includes/options-locked.md @@ -1,10 +1,13 @@ {{#option "`--locked`"}} -Requires the `Cargo.lock` file be up-to-date. If the lock file is missing, -or it needs to be updated due to changes in the `Cargo.toml` file, for example -a new dependency is added, Cargo will exit with an error. +Asserts that the exact same dependencies and versions are used as when the +existing `Cargo.lock` file was originally generated. Cargo will exit with an +error when either of the following scenarios arises: -It may be used in environments where you want to assert that the `Cargo.lock` -file is up-to-date (such as a CI build). +* The lock file is missing. +* Cargo attempted to change the lock file due to a different dependency resolution. + +It may be used in environments where deterministic builds are desired, +such as in CI pipelines. {{/option}} {{#option "`--offline`"}} diff --git a/src/doc/src/commands/cargo-add.md b/src/doc/src/commands/cargo-add.md index 15b461ab1eb..80fb05615ac 100644 --- a/src/doc/src/commands/cargo-add.md +++ b/src/doc/src/commands/cargo-add.md @@ -192,11 +192,15 @@ terminal.
--locked
-
Requires the Cargo.lock file be up-to-date. If the lock file is missing, -or it needs to be updated due to changes in the Cargo.toml file, for example -a new dependency is added, Cargo will exit with an error.

-

It may be used in environments where you want to assert that the Cargo.lock -file is up-to-date (such as a CI build).

+
Asserts that the exact same dependencies and versions are used as when the +existing Cargo.lock file was originally generated. Cargo will exit with an +error when either of the following scenarios arises:

+
    +
  • The lock file is missing.
    • +
  • Cargo attempted to change the lock file due to a different dependency resolution.
    • +
+

It may be used in environments where deterministic builds are desired, +such as in CI pipelines.

--offline
diff --git a/src/doc/src/commands/cargo-bench.md b/src/doc/src/commands/cargo-bench.md index 40ee4fd1b99..45b26f2aa75 100644 --- a/src/doc/src/commands/cargo-bench.md +++ b/src/doc/src/commands/cargo-bench.md @@ -378,11 +378,15 @@ coming from rustc are still emitted. Cannot be used with human or <
--locked
-
Requires the Cargo.lock file be up-to-date. If the lock file is missing, -or it needs to be updated due to changes in the Cargo.toml file, for example -a new dependency is added, Cargo will exit with an error.

-

It may be used in environments where you want to assert that the Cargo.lock -file is up-to-date (such as a CI build).

+
Asserts that the exact same dependencies and versions are used as when the +existing Cargo.lock file was originally generated. Cargo will exit with an +error when either of the following scenarios arises:

+
    +
  • The lock file is missing.
    • +
  • Cargo attempted to change the lock file due to a different dependency resolution.
    • +
+

It may be used in environments where deterministic builds are desired, +such as in CI pipelines.

--offline
diff --git a/src/doc/src/commands/cargo-build.md b/src/doc/src/commands/cargo-build.md index 85cc12a18b0..83296999f84 100644 --- a/src/doc/src/commands/cargo-build.md +++ b/src/doc/src/commands/cargo-build.md @@ -309,11 +309,15 @@ See https://github.com/
--locked
-
Requires the Cargo.lock file be up-to-date. If the lock file is missing, -or it needs to be updated due to changes in the Cargo.toml file, for example -a new dependency is added, Cargo will exit with an error.

-

It may be used in environments where you want to assert that the Cargo.lock -file is up-to-date (such as a CI build).

+
Asserts that the exact same dependencies and versions are used as when the +existing Cargo.lock file was originally generated. Cargo will exit with an +error when either of the following scenarios arises:

+
    +
  • The lock file is missing.
    • +
  • Cargo attempted to change the lock file due to a different dependency resolution.
    • +
+

It may be used in environments where deterministic builds are desired, +such as in CI pipelines.

--offline
diff --git a/src/doc/src/commands/cargo-check.md b/src/doc/src/commands/cargo-check.md index 8ef1a28df15..b8c991d57c1 100644 --- a/src/doc/src/commands/cargo-check.md +++ b/src/doc/src/commands/cargo-check.md @@ -291,11 +291,15 @@ coming from rustc are still emitted. Cannot be used with human or <
--locked
-
Requires the Cargo.lock file be up-to-date. If the lock file is missing, -or it needs to be updated due to changes in the Cargo.toml file, for example -a new dependency is added, Cargo will exit with an error.

-

It may be used in environments where you want to assert that the Cargo.lock -file is up-to-date (such as a CI build).

+
Asserts that the exact same dependencies and versions are used as when the +existing Cargo.lock file was originally generated. Cargo will exit with an +error when either of the following scenarios arises:

+
    +
  • The lock file is missing.
    • +
  • Cargo attempted to change the lock file due to a different dependency resolution.
    • +
+

It may be used in environments where deterministic builds are desired, +such as in CI pipelines.

--offline
diff --git a/src/doc/src/commands/cargo-clean.md b/src/doc/src/commands/cargo-clean.md index fbcc783a06c..aa4e0eb46e3 100644 --- a/src/doc/src/commands/cargo-clean.md +++ b/src/doc/src/commands/cargo-clean.md @@ -111,11 +111,15 @@ terminal.
--locked
-
Requires the Cargo.lock file be up-to-date. If the lock file is missing, -or it needs to be updated due to changes in the Cargo.toml file, for example -a new dependency is added, Cargo will exit with an error.

-

It may be used in environments where you want to assert that the Cargo.lock -file is up-to-date (such as a CI build).

+
Asserts that the exact same dependencies and versions are used as when the +existing Cargo.lock file was originally generated. Cargo will exit with an +error when either of the following scenarios arises:

+
    +
  • The lock file is missing.
    • +
  • Cargo attempted to change the lock file due to a different dependency resolution.
    • +
+

It may be used in environments where deterministic builds are desired, +such as in CI pipelines.

--offline
diff --git a/src/doc/src/commands/cargo-doc.md b/src/doc/src/commands/cargo-doc.md index a15c5a2cadb..0c49b9e7a79 100644 --- a/src/doc/src/commands/cargo-doc.md +++ b/src/doc/src/commands/cargo-doc.md @@ -266,11 +266,15 @@ coming from rustc are still emitted. Cannot be used with human or <
--locked
-
Requires the Cargo.lock file be up-to-date. If the lock file is missing, -or it needs to be updated due to changes in the Cargo.toml file, for example -a new dependency is added, Cargo will exit with an error.

-

It may be used in environments where you want to assert that the Cargo.lock -file is up-to-date (such as a CI build).

+
Asserts that the exact same dependencies and versions are used as when the +existing Cargo.lock file was originally generated. Cargo will exit with an +error when either of the following scenarios arises:

+
    +
  • The lock file is missing.
    • +
  • Cargo attempted to change the lock file due to a different dependency resolution.
    • +
+

It may be used in environments where deterministic builds are desired, +such as in CI pipelines.

--offline
diff --git a/src/doc/src/commands/cargo-fetch.md b/src/doc/src/commands/cargo-fetch.md index 07a2b27dee8..694a4a2f0ca 100644 --- a/src/doc/src/commands/cargo-fetch.md +++ b/src/doc/src/commands/cargo-fetch.md @@ -80,11 +80,15 @@ terminal.
--locked
-
Requires the Cargo.lock file be up-to-date. If the lock file is missing, -or it needs to be updated due to changes in the Cargo.toml file, for example -a new dependency is added, Cargo will exit with an error.

-

It may be used in environments where you want to assert that the Cargo.lock -file is up-to-date (such as a CI build).

+
Asserts that the exact same dependencies and versions are used as when the +existing Cargo.lock file was originally generated. Cargo will exit with an +error when either of the following scenarios arises:

+
    +
  • The lock file is missing.
    • +
  • Cargo attempted to change the lock file due to a different dependency resolution.
    • +
+

It may be used in environments where deterministic builds are desired, +such as in CI pipelines.

--offline
diff --git a/src/doc/src/commands/cargo-fix.md b/src/doc/src/commands/cargo-fix.md index 3ea28ff05eb..7c78b6b89da 100644 --- a/src/doc/src/commands/cargo-fix.md +++ b/src/doc/src/commands/cargo-fix.md @@ -371,11 +371,15 @@ coming from rustc are still emitted. Cannot be used with human or <
--locked
-
Requires the Cargo.lock file be up-to-date. If the lock file is missing, -or it needs to be updated due to changes in the Cargo.toml file, for example -a new dependency is added, Cargo will exit with an error.

-

It may be used in environments where you want to assert that the Cargo.lock -file is up-to-date (such as a CI build).

+
Asserts that the exact same dependencies and versions are used as when the +existing Cargo.lock file was originally generated. Cargo will exit with an +error when either of the following scenarios arises:

+
    +
  • The lock file is missing.
    • +
  • Cargo attempted to change the lock file due to a different dependency resolution.
    • +
+

It may be used in environments where deterministic builds are desired, +such as in CI pipelines.

--offline
diff --git a/src/doc/src/commands/cargo-generate-lockfile.md b/src/doc/src/commands/cargo-generate-lockfile.md index df20604f012..ee52d544c2c 100644 --- a/src/doc/src/commands/cargo-generate-lockfile.md +++ b/src/doc/src/commands/cargo-generate-lockfile.md @@ -59,11 +59,15 @@ terminal.
--locked
-
Requires the Cargo.lock file be up-to-date. If the lock file is missing, -or it needs to be updated due to changes in the Cargo.toml file, for example -a new dependency is added, Cargo will exit with an error.

-

It may be used in environments where you want to assert that the Cargo.lock -file is up-to-date (such as a CI build).

+
Asserts that the exact same dependencies and versions are used as when the +existing Cargo.lock file was originally generated. Cargo will exit with an +error when either of the following scenarios arises:

+
    +
  • The lock file is missing.
    • +
  • Cargo attempted to change the lock file due to a different dependency resolution.
    • +
+

It may be used in environments where deterministic builds are desired, +such as in CI pipelines.

--offline
diff --git a/src/doc/src/commands/cargo-install.md b/src/doc/src/commands/cargo-install.md index 2629c8df9b4..d664bc7ed42 100644 --- a/src/doc/src/commands/cargo-install.md +++ b/src/doc/src/commands/cargo-install.md @@ -267,11 +267,15 @@ information about timing information.
--locked
-
Requires the Cargo.lock file be up-to-date. If the lock file is missing, -or it needs to be updated due to changes in the Cargo.toml file, for example -a new dependency is added, Cargo will exit with an error.

-

It may be used in environments where you want to assert that the Cargo.lock -file is up-to-date (such as a CI build).

+
Asserts that the exact same dependencies and versions are used as when the +existing Cargo.lock file was originally generated. Cargo will exit with an +error when either of the following scenarios arises:

+
    +
  • The lock file is missing.
    • +
  • Cargo attempted to change the lock file due to a different dependency resolution.
    • +
+

It may be used in environments where deterministic builds are desired, +such as in CI pipelines.

--offline
diff --git a/src/doc/src/commands/cargo-metadata.md b/src/doc/src/commands/cargo-metadata.md index ebe3f990e27..31c01df85b7 100644 --- a/src/doc/src/commands/cargo-metadata.md +++ b/src/doc/src/commands/cargo-metadata.md @@ -429,11 +429,15 @@ terminal.
--locked
-
Requires the Cargo.lock file be up-to-date. If the lock file is missing, -or it needs to be updated due to changes in the Cargo.toml file, for example -a new dependency is added, Cargo will exit with an error.

-

It may be used in environments where you want to assert that the Cargo.lock -file is up-to-date (such as a CI build).

+
Asserts that the exact same dependencies and versions are used as when the +existing Cargo.lock file was originally generated. Cargo will exit with an +error when either of the following scenarios arises:

+
    +
  • The lock file is missing.
    • +
  • Cargo attempted to change the lock file due to a different dependency resolution.
    • +
+

It may be used in environments where deterministic builds are desired, +such as in CI pipelines.

--offline
diff --git a/src/doc/src/commands/cargo-package.md b/src/doc/src/commands/cargo-package.md index ee36ff32971..94fd89bd670 100644 --- a/src/doc/src/commands/cargo-package.md +++ b/src/doc/src/commands/cargo-package.md @@ -183,11 +183,15 @@ be specified multiple times, which enables all specified features.
--locked
-
Requires the Cargo.lock file be up-to-date. If the lock file is missing, -or it needs to be updated due to changes in the Cargo.toml file, for example -a new dependency is added, Cargo will exit with an error.

-

It may be used in environments where you want to assert that the Cargo.lock -file is up-to-date (such as a CI build).

+
Asserts that the exact same dependencies and versions are used as when the +existing Cargo.lock file was originally generated. Cargo will exit with an +error when either of the following scenarios arises:

+
    +
  • The lock file is missing.
    • +
  • Cargo attempted to change the lock file due to a different dependency resolution.
    • +
+

It may be used in environments where deterministic builds are desired, +such as in CI pipelines.

--offline
diff --git a/src/doc/src/commands/cargo-pkgid.md b/src/doc/src/commands/cargo-pkgid.md index 04fbbb2a5b1..e392985f1f5 100644 --- a/src/doc/src/commands/cargo-pkgid.md +++ b/src/doc/src/commands/cargo-pkgid.md @@ -91,11 +91,15 @@ terminal.
--locked
-
Requires the Cargo.lock file be up-to-date. If the lock file is missing, -or it needs to be updated due to changes in the Cargo.toml file, for example -a new dependency is added, Cargo will exit with an error.

-

It may be used in environments where you want to assert that the Cargo.lock -file is up-to-date (such as a CI build).

+
Asserts that the exact same dependencies and versions are used as when the +existing Cargo.lock file was originally generated. Cargo will exit with an +error when either of the following scenarios arises:

+
    +
  • The lock file is missing.
    • +
  • Cargo attempted to change the lock file due to a different dependency resolution.
    • +
+

It may be used in environments where deterministic builds are desired, +such as in CI pipelines.

--offline
diff --git a/src/doc/src/commands/cargo-publish.md b/src/doc/src/commands/cargo-publish.md index 8aecf270ce8..17d917b7ca5 100644 --- a/src/doc/src/commands/cargo-publish.md +++ b/src/doc/src/commands/cargo-publish.md @@ -152,11 +152,15 @@ be specified multiple times, which enables all specified features.
--locked
-
Requires the Cargo.lock file be up-to-date. If the lock file is missing, -or it needs to be updated due to changes in the Cargo.toml file, for example -a new dependency is added, Cargo will exit with an error.

-

It may be used in environments where you want to assert that the Cargo.lock -file is up-to-date (such as a CI build).

+
Asserts that the exact same dependencies and versions are used as when the +existing Cargo.lock file was originally generated. Cargo will exit with an +error when either of the following scenarios arises:

+
    +
  • The lock file is missing.
    • +
  • Cargo attempted to change the lock file due to a different dependency resolution.
    • +
+

It may be used in environments where deterministic builds are desired, +such as in CI pipelines.

--offline
diff --git a/src/doc/src/commands/cargo-remove.md b/src/doc/src/commands/cargo-remove.md index fd000e22ac4..afbcbf590eb 100644 --- a/src/doc/src/commands/cargo-remove.md +++ b/src/doc/src/commands/cargo-remove.md @@ -82,11 +82,15 @@ terminal.
--locked
-
Requires the Cargo.lock file be up-to-date. If the lock file is missing, -or it needs to be updated due to changes in the Cargo.toml file, for example -a new dependency is added, Cargo will exit with an error.

-

It may be used in environments where you want to assert that the Cargo.lock -file is up-to-date (such as a CI build).

+
Asserts that the exact same dependencies and versions are used as when the +existing Cargo.lock file was originally generated. Cargo will exit with an +error when either of the following scenarios arises:

+
    +
  • The lock file is missing.
    • +
  • Cargo attempted to change the lock file due to a different dependency resolution.
    • +
+

It may be used in environments where deterministic builds are desired, +such as in CI pipelines.

--offline
diff --git a/src/doc/src/commands/cargo-run.md b/src/doc/src/commands/cargo-run.md index 57b36519194..cebd0edb2a5 100644 --- a/src/doc/src/commands/cargo-run.md +++ b/src/doc/src/commands/cargo-run.md @@ -211,11 +211,15 @@ coming from rustc are still emitted. Cannot be used with human or <
--locked
-
Requires the Cargo.lock file be up-to-date. If the lock file is missing, -or it needs to be updated due to changes in the Cargo.toml file, for example -a new dependency is added, Cargo will exit with an error.

-

It may be used in environments where you want to assert that the Cargo.lock -file is up-to-date (such as a CI build).

+
Asserts that the exact same dependencies and versions are used as when the +existing Cargo.lock file was originally generated. Cargo will exit with an +error when either of the following scenarios arises:

+
    +
  • The lock file is missing.
    • +
  • Cargo attempted to change the lock file due to a different dependency resolution.
    • +
+

It may be used in environments where deterministic builds are desired, +such as in CI pipelines.

--offline
diff --git a/src/doc/src/commands/cargo-rustc.md b/src/doc/src/commands/cargo-rustc.md index 772632c46c3..3d72c5b2b4a 100644 --- a/src/doc/src/commands/cargo-rustc.md +++ b/src/doc/src/commands/cargo-rustc.md @@ -305,11 +305,15 @@ coming from rustc are still emitted. Cannot be used with human or <
--locked
-
Requires the Cargo.lock file be up-to-date. If the lock file is missing, -or it needs to be updated due to changes in the Cargo.toml file, for example -a new dependency is added, Cargo will exit with an error.

-

It may be used in environments where you want to assert that the Cargo.lock -file is up-to-date (such as a CI build).

+
Asserts that the exact same dependencies and versions are used as when the +existing Cargo.lock file was originally generated. Cargo will exit with an +error when either of the following scenarios arises:

+
    +
  • The lock file is missing.
    • +
  • Cargo attempted to change the lock file due to a different dependency resolution.
    • +
+

It may be used in environments where deterministic builds are desired, +such as in CI pipelines.

--offline
diff --git a/src/doc/src/commands/cargo-rustdoc.md b/src/doc/src/commands/cargo-rustdoc.md index 574787b3cc7..d6faf986e5e 100644 --- a/src/doc/src/commands/cargo-rustdoc.md +++ b/src/doc/src/commands/cargo-rustdoc.md @@ -286,11 +286,15 @@ coming from rustc are still emitted. Cannot be used with human or <
--locked
-
Requires the Cargo.lock file be up-to-date. If the lock file is missing, -or it needs to be updated due to changes in the Cargo.toml file, for example -a new dependency is added, Cargo will exit with an error.

-

It may be used in environments where you want to assert that the Cargo.lock -file is up-to-date (such as a CI build).

+
Asserts that the exact same dependencies and versions are used as when the +existing Cargo.lock file was originally generated. Cargo will exit with an +error when either of the following scenarios arises:

+
    +
  • The lock file is missing.
    • +
  • Cargo attempted to change the lock file due to a different dependency resolution.
    • +
+

It may be used in environments where deterministic builds are desired, +such as in CI pipelines.

--offline
diff --git a/src/doc/src/commands/cargo-test.md b/src/doc/src/commands/cargo-test.md index 6815b2f43fe..f631e9d454d 100644 --- a/src/doc/src/commands/cargo-test.md +++ b/src/doc/src/commands/cargo-test.md @@ -407,11 +407,15 @@ coming from rustc are still emitted. Cannot be used with human or <
--locked
-
Requires the Cargo.lock file be up-to-date. If the lock file is missing, -or it needs to be updated due to changes in the Cargo.toml file, for example -a new dependency is added, Cargo will exit with an error.

-

It may be used in environments where you want to assert that the Cargo.lock -file is up-to-date (such as a CI build).

+
Asserts that the exact same dependencies and versions are used as when the +existing Cargo.lock file was originally generated. Cargo will exit with an +error when either of the following scenarios arises:

+
    +
  • The lock file is missing.
    • +
  • Cargo attempted to change the lock file due to a different dependency resolution.
    • +
+

It may be used in environments where deterministic builds are desired, +such as in CI pipelines.

--offline
diff --git a/src/doc/src/commands/cargo-tree.md b/src/doc/src/commands/cargo-tree.md index 78c6a9d4dc6..a596a9b9882 100644 --- a/src/doc/src/commands/cargo-tree.md +++ b/src/doc/src/commands/cargo-tree.md @@ -223,11 +223,15 @@ single quotes or double quotes around each pattern.
--locked
-
Requires the Cargo.lock file be up-to-date. If the lock file is missing, -or it needs to be updated due to changes in the Cargo.toml file, for example -a new dependency is added, Cargo will exit with an error.

-

It may be used in environments where you want to assert that the Cargo.lock -file is up-to-date (such as a CI build).

+
Asserts that the exact same dependencies and versions are used as when the +existing Cargo.lock file was originally generated. Cargo will exit with an +error when either of the following scenarios arises:

+
    +
  • The lock file is missing.
    • +
  • Cargo attempted to change the lock file due to a different dependency resolution.
    • +
+

It may be used in environments where deterministic builds are desired, +such as in CI pipelines.

--offline
diff --git a/src/doc/src/commands/cargo-update.md b/src/doc/src/commands/cargo-update.md index f20a48df46d..6416c8149ca 100644 --- a/src/doc/src/commands/cargo-update.md +++ b/src/doc/src/commands/cargo-update.md @@ -100,11 +100,15 @@ terminal.
--locked
-
Requires the Cargo.lock file be up-to-date. If the lock file is missing, -or it needs to be updated due to changes in the Cargo.toml file, for example -a new dependency is added, Cargo will exit with an error.

-

It may be used in environments where you want to assert that the Cargo.lock -file is up-to-date (such as a CI build).

+
Asserts that the exact same dependencies and versions are used as when the +existing Cargo.lock file was originally generated. Cargo will exit with an +error when either of the following scenarios arises:

+
    +
  • The lock file is missing.
    • +
  • Cargo attempted to change the lock file due to a different dependency resolution.
    • +
+

It may be used in environments where deterministic builds are desired, +such as in CI pipelines.

--offline
diff --git a/src/doc/src/commands/cargo-vendor.md b/src/doc/src/commands/cargo-vendor.md index d3e029e8f71..12269570bb0 100644 --- a/src/doc/src/commands/cargo-vendor.md +++ b/src/doc/src/commands/cargo-vendor.md @@ -69,11 +69,15 @@ only a subset of the packages have changed.
--locked
-
Requires the Cargo.lock file be up-to-date. If the lock file is missing, -or it needs to be updated due to changes in the Cargo.toml file, for example -a new dependency is added, Cargo will exit with an error.

-

It may be used in environments where you want to assert that the Cargo.lock -file is up-to-date (such as a CI build).

+
Asserts that the exact same dependencies and versions are used as when the +existing Cargo.lock file was originally generated. Cargo will exit with an +error when either of the following scenarios arises:

+
    +
  • The lock file is missing.
    • +
  • Cargo attempted to change the lock file due to a different dependency resolution.
    • +
+

It may be used in environments where deterministic builds are desired, +such as in CI pipelines.

--offline
diff --git a/src/doc/src/commands/cargo-verify-project.md b/src/doc/src/commands/cargo-verify-project.md index f9f135dfb70..68bd00344ef 100644 --- a/src/doc/src/commands/cargo-verify-project.md +++ b/src/doc/src/commands/cargo-verify-project.md @@ -64,11 +64,15 @@ terminal.
--locked
-
Requires the Cargo.lock file be up-to-date. If the lock file is missing, -or it needs to be updated due to changes in the Cargo.toml file, for example -a new dependency is added, Cargo will exit with an error.

-

It may be used in environments where you want to assert that the Cargo.lock -file is up-to-date (such as a CI build).

+
Asserts that the exact same dependencies and versions are used as when the +existing Cargo.lock file was originally generated. Cargo will exit with an +error when either of the following scenarios arises:

+
    +
  • The lock file is missing.
    • +
  • Cargo attempted to change the lock file due to a different dependency resolution.
    • +
+

It may be used in environments where deterministic builds are desired, +such as in CI pipelines.

--offline
diff --git a/src/etc/man/cargo-add.1 b/src/etc/man/cargo-add.1 index 7632b295d85..49cd2fba9b5 100644 --- a/src/etc/man/cargo-add.1 +++ b/src/etc/man/cargo-add.1 @@ -223,12 +223,20 @@ Add dependencies to only the specified package. .sp \fB\-\-locked\fR .RS 4 -Requires the \fBCargo.lock\fR file be up\-to\-date. If the lock file is missing, -or it needs to be updated due to changes in the \fBCargo.toml\fR file, for example -a new dependency is added, Cargo will exit with an error. +Asserts that the exact same dependencies and versions are used as when the +existing \fBCargo.lock\fR file was originally generated. Cargo will exit with an +error when either of the following scenarios arises: .sp -It may be used in environments where you want to assert that the \fBCargo.lock\fR -file is up\-to\-date (such as a CI build). +.RS 4 +\h'-04'\(bu\h'+02'The lock file is missing. +.RE +.sp +.RS 4 +\h'-04'\(bu\h'+02'Cargo attempted to change the lock file due to a different dependency resolution. +.RE +.sp +It may be used in environments where deterministic builds are desired, +such as in CI pipelines. .RE .sp \fB\-\-offline\fR diff --git a/src/etc/man/cargo-bench.1 b/src/etc/man/cargo-bench.1 index b43e8f74140..a307f8c8c74 100644 --- a/src/etc/man/cargo-bench.1 +++ b/src/etc/man/cargo-bench.1 @@ -419,12 +419,20 @@ Path to the \fBCargo.toml\fR file. By default, Cargo searches for the .sp \fB\-\-locked\fR .RS 4 -Requires the \fBCargo.lock\fR file be up\-to\-date. If the lock file is missing, -or it needs to be updated due to changes in the \fBCargo.toml\fR file, for example -a new dependency is added, Cargo will exit with an error. +Asserts that the exact same dependencies and versions are used as when the +existing \fBCargo.lock\fR file was originally generated. Cargo will exit with an +error when either of the following scenarios arises: .sp -It may be used in environments where you want to assert that the \fBCargo.lock\fR -file is up\-to\-date (such as a CI build). +.RS 4 +\h'-04'\(bu\h'+02'The lock file is missing. +.RE +.sp +.RS 4 +\h'-04'\(bu\h'+02'Cargo attempted to change the lock file due to a different dependency resolution. +.RE +.sp +It may be used in environments where deterministic builds are desired, +such as in CI pipelines. .RE .sp \fB\-\-offline\fR diff --git a/src/etc/man/cargo-build.1 b/src/etc/man/cargo-build.1 index 6e51d3320c1..7046b7f3fdf 100644 --- a/src/etc/man/cargo-build.1 +++ b/src/etc/man/cargo-build.1 @@ -337,12 +337,20 @@ Path to the \fBCargo.toml\fR file. By default, Cargo searches for the .sp \fB\-\-locked\fR .RS 4 -Requires the \fBCargo.lock\fR file be up\-to\-date. If the lock file is missing, -or it needs to be updated due to changes in the \fBCargo.toml\fR file, for example -a new dependency is added, Cargo will exit with an error. +Asserts that the exact same dependencies and versions are used as when the +existing \fBCargo.lock\fR file was originally generated. Cargo will exit with an +error when either of the following scenarios arises: .sp -It may be used in environments where you want to assert that the \fBCargo.lock\fR -file is up\-to\-date (such as a CI build). +.RS 4 +\h'-04'\(bu\h'+02'The lock file is missing. +.RE +.sp +.RS 4 +\h'-04'\(bu\h'+02'Cargo attempted to change the lock file due to a different dependency resolution. +.RE +.sp +It may be used in environments where deterministic builds are desired, +such as in CI pipelines. .RE .sp \fB\-\-offline\fR diff --git a/src/etc/man/cargo-check.1 b/src/etc/man/cargo-check.1 index be0adf1630d..40207103b21 100644 --- a/src/etc/man/cargo-check.1 +++ b/src/etc/man/cargo-check.1 @@ -318,12 +318,20 @@ Path to the \fBCargo.toml\fR file. By default, Cargo searches for the .sp \fB\-\-locked\fR .RS 4 -Requires the \fBCargo.lock\fR file be up\-to\-date. If the lock file is missing, -or it needs to be updated due to changes in the \fBCargo.toml\fR file, for example -a new dependency is added, Cargo will exit with an error. +Asserts that the exact same dependencies and versions are used as when the +existing \fBCargo.lock\fR file was originally generated. Cargo will exit with an +error when either of the following scenarios arises: .sp -It may be used in environments where you want to assert that the \fBCargo.lock\fR -file is up\-to\-date (such as a CI build). +.RS 4 +\h'-04'\(bu\h'+02'The lock file is missing. +.RE +.sp +.RS 4 +\h'-04'\(bu\h'+02'Cargo attempted to change the lock file due to a different dependency resolution. +.RE +.sp +It may be used in environments where deterministic builds are desired, +such as in CI pipelines. .RE .sp \fB\-\-offline\fR diff --git a/src/etc/man/cargo-clean.1 b/src/etc/man/cargo-clean.1 index ddb1e7253da..00f47ad91f5 100644 --- a/src/etc/man/cargo-clean.1 +++ b/src/etc/man/cargo-clean.1 @@ -117,12 +117,20 @@ Path to the \fBCargo.toml\fR file. By default, Cargo searches for the .sp \fB\-\-locked\fR .RS 4 -Requires the \fBCargo.lock\fR file be up\-to\-date. If the lock file is missing, -or it needs to be updated due to changes in the \fBCargo.toml\fR file, for example -a new dependency is added, Cargo will exit with an error. +Asserts that the exact same dependencies and versions are used as when the +existing \fBCargo.lock\fR file was originally generated. Cargo will exit with an +error when either of the following scenarios arises: .sp -It may be used in environments where you want to assert that the \fBCargo.lock\fR -file is up\-to\-date (such as a CI build). +.RS 4 +\h'-04'\(bu\h'+02'The lock file is missing. +.RE +.sp +.RS 4 +\h'-04'\(bu\h'+02'Cargo attempted to change the lock file due to a different dependency resolution. +.RE +.sp +It may be used in environments where deterministic builds are desired, +such as in CI pipelines. .RE .sp \fB\-\-offline\fR diff --git a/src/etc/man/cargo-doc.1 b/src/etc/man/cargo-doc.1 index e449a6ba8d4..52ade6daed9 100644 --- a/src/etc/man/cargo-doc.1 +++ b/src/etc/man/cargo-doc.1 @@ -285,12 +285,20 @@ Path to the \fBCargo.toml\fR file. By default, Cargo searches for the .sp \fB\-\-locked\fR .RS 4 -Requires the \fBCargo.lock\fR file be up\-to\-date. If the lock file is missing, -or it needs to be updated due to changes in the \fBCargo.toml\fR file, for example -a new dependency is added, Cargo will exit with an error. +Asserts that the exact same dependencies and versions are used as when the +existing \fBCargo.lock\fR file was originally generated. Cargo will exit with an +error when either of the following scenarios arises: .sp -It may be used in environments where you want to assert that the \fBCargo.lock\fR -file is up\-to\-date (such as a CI build). +.RS 4 +\h'-04'\(bu\h'+02'The lock file is missing. +.RE +.sp +.RS 4 +\h'-04'\(bu\h'+02'Cargo attempted to change the lock file due to a different dependency resolution. +.RE +.sp +It may be used in environments where deterministic builds are desired, +such as in CI pipelines. .RE .sp \fB\-\-offline\fR diff --git a/src/etc/man/cargo-fetch.1 b/src/etc/man/cargo-fetch.1 index 323130c4d18..6687506f46a 100644 --- a/src/etc/man/cargo-fetch.1 +++ b/src/etc/man/cargo-fetch.1 @@ -85,12 +85,20 @@ Path to the \fBCargo.toml\fR file. By default, Cargo searches for the .sp \fB\-\-locked\fR .RS 4 -Requires the \fBCargo.lock\fR file be up\-to\-date. If the lock file is missing, -or it needs to be updated due to changes in the \fBCargo.toml\fR file, for example -a new dependency is added, Cargo will exit with an error. +Asserts that the exact same dependencies and versions are used as when the +existing \fBCargo.lock\fR file was originally generated. Cargo will exit with an +error when either of the following scenarios arises: .sp -It may be used in environments where you want to assert that the \fBCargo.lock\fR -file is up\-to\-date (such as a CI build). +.RS 4 +\h'-04'\(bu\h'+02'The lock file is missing. +.RE +.sp +.RS 4 +\h'-04'\(bu\h'+02'Cargo attempted to change the lock file due to a different dependency resolution. +.RE +.sp +It may be used in environments where deterministic builds are desired, +such as in CI pipelines. .RE .sp \fB\-\-offline\fR diff --git a/src/etc/man/cargo-fix.1 b/src/etc/man/cargo-fix.1 index 0e3436d50fd..fbf933fd3f1 100644 --- a/src/etc/man/cargo-fix.1 +++ b/src/etc/man/cargo-fix.1 @@ -413,12 +413,20 @@ Path to the \fBCargo.toml\fR file. By default, Cargo searches for the .sp \fB\-\-locked\fR .RS 4 -Requires the \fBCargo.lock\fR file be up\-to\-date. If the lock file is missing, -or it needs to be updated due to changes in the \fBCargo.toml\fR file, for example -a new dependency is added, Cargo will exit with an error. +Asserts that the exact same dependencies and versions are used as when the +existing \fBCargo.lock\fR file was originally generated. Cargo will exit with an +error when either of the following scenarios arises: .sp -It may be used in environments where you want to assert that the \fBCargo.lock\fR -file is up\-to\-date (such as a CI build). +.RS 4 +\h'-04'\(bu\h'+02'The lock file is missing. +.RE +.sp +.RS 4 +\h'-04'\(bu\h'+02'Cargo attempted to change the lock file due to a different dependency resolution. +.RE +.sp +It may be used in environments where deterministic builds are desired, +such as in CI pipelines. .RE .sp \fB\-\-offline\fR diff --git a/src/etc/man/cargo-generate-lockfile.1 b/src/etc/man/cargo-generate-lockfile.1 index 066357ea31e..a436909f8d3 100644 --- a/src/etc/man/cargo-generate-lockfile.1 +++ b/src/etc/man/cargo-generate-lockfile.1 @@ -64,12 +64,20 @@ Path to the \fBCargo.toml\fR file. By default, Cargo searches for the .sp \fB\-\-locked\fR .RS 4 -Requires the \fBCargo.lock\fR file be up\-to\-date. If the lock file is missing, -or it needs to be updated due to changes in the \fBCargo.toml\fR file, for example -a new dependency is added, Cargo will exit with an error. +Asserts that the exact same dependencies and versions are used as when the +existing \fBCargo.lock\fR file was originally generated. Cargo will exit with an +error when either of the following scenarios arises: .sp -It may be used in environments where you want to assert that the \fBCargo.lock\fR -file is up\-to\-date (such as a CI build). +.RS 4 +\h'-04'\(bu\h'+02'The lock file is missing. +.RE +.sp +.RS 4 +\h'-04'\(bu\h'+02'Cargo attempted to change the lock file due to a different dependency resolution. +.RE +.sp +It may be used in environments where deterministic builds are desired, +such as in CI pipelines. .RE .sp \fB\-\-offline\fR diff --git a/src/etc/man/cargo-install.1 b/src/etc/man/cargo-install.1 index e14be11a584..c59d54b01f6 100644 --- a/src/etc/man/cargo-install.1 +++ b/src/etc/man/cargo-install.1 @@ -304,12 +304,20 @@ information about timing information. .sp \fB\-\-locked\fR .RS 4 -Requires the \fBCargo.lock\fR file be up\-to\-date. If the lock file is missing, -or it needs to be updated due to changes in the \fBCargo.toml\fR file, for example -a new dependency is added, Cargo will exit with an error. +Asserts that the exact same dependencies and versions are used as when the +existing \fBCargo.lock\fR file was originally generated. Cargo will exit with an +error when either of the following scenarios arises: .sp -It may be used in environments where you want to assert that the \fBCargo.lock\fR -file is up\-to\-date (such as a CI build). +.RS 4 +\h'-04'\(bu\h'+02'The lock file is missing. +.RE +.sp +.RS 4 +\h'-04'\(bu\h'+02'Cargo attempted to change the lock file due to a different dependency resolution. +.RE +.sp +It may be used in environments where deterministic builds are desired, +such as in CI pipelines. .RE .sp \fB\-\-offline\fR diff --git a/src/etc/man/cargo-metadata.1 b/src/etc/man/cargo-metadata.1 index 60e99f9dfdb..e3cc27732e6 100644 --- a/src/etc/man/cargo-metadata.1 +++ b/src/etc/man/cargo-metadata.1 @@ -438,12 +438,20 @@ Path to the \fBCargo.toml\fR file. By default, Cargo searches for the .sp \fB\-\-locked\fR .RS 4 -Requires the \fBCargo.lock\fR file be up\-to\-date. If the lock file is missing, -or it needs to be updated due to changes in the \fBCargo.toml\fR file, for example -a new dependency is added, Cargo will exit with an error. +Asserts that the exact same dependencies and versions are used as when the +existing \fBCargo.lock\fR file was originally generated. Cargo will exit with an +error when either of the following scenarios arises: .sp -It may be used in environments where you want to assert that the \fBCargo.lock\fR -file is up\-to\-date (such as a CI build). +.RS 4 +\h'-04'\(bu\h'+02'The lock file is missing. +.RE +.sp +.RS 4 +\h'-04'\(bu\h'+02'Cargo attempted to change the lock file due to a different dependency resolution. +.RE +.sp +It may be used in environments where deterministic builds are desired, +such as in CI pipelines. .RE .sp \fB\-\-offline\fR diff --git a/src/etc/man/cargo-package.1 b/src/etc/man/cargo-package.1 index 81ed84da828..a6ab96cb634 100644 --- a/src/etc/man/cargo-package.1 +++ b/src/etc/man/cargo-package.1 @@ -200,12 +200,20 @@ Path to the \fBCargo.toml\fR file. By default, Cargo searches for the .sp \fB\-\-locked\fR .RS 4 -Requires the \fBCargo.lock\fR file be up\-to\-date. If the lock file is missing, -or it needs to be updated due to changes in the \fBCargo.toml\fR file, for example -a new dependency is added, Cargo will exit with an error. +Asserts that the exact same dependencies and versions are used as when the +existing \fBCargo.lock\fR file was originally generated. Cargo will exit with an +error when either of the following scenarios arises: .sp -It may be used in environments where you want to assert that the \fBCargo.lock\fR -file is up\-to\-date (such as a CI build). +.RS 4 +\h'-04'\(bu\h'+02'The lock file is missing. +.RE +.sp +.RS 4 +\h'-04'\(bu\h'+02'Cargo attempted to change the lock file due to a different dependency resolution. +.RE +.sp +It may be used in environments where deterministic builds are desired, +such as in CI pipelines. .RE .sp \fB\-\-offline\fR diff --git a/src/etc/man/cargo-pkgid.1 b/src/etc/man/cargo-pkgid.1 index 6ac6a480b82..f8b7724bd58 100644 --- a/src/etc/man/cargo-pkgid.1 +++ b/src/etc/man/cargo-pkgid.1 @@ -123,12 +123,20 @@ Path to the \fBCargo.toml\fR file. By default, Cargo searches for the .sp \fB\-\-locked\fR .RS 4 -Requires the \fBCargo.lock\fR file be up\-to\-date. If the lock file is missing, -or it needs to be updated due to changes in the \fBCargo.toml\fR file, for example -a new dependency is added, Cargo will exit with an error. +Asserts that the exact same dependencies and versions are used as when the +existing \fBCargo.lock\fR file was originally generated. Cargo will exit with an +error when either of the following scenarios arises: .sp -It may be used in environments where you want to assert that the \fBCargo.lock\fR -file is up\-to\-date (such as a CI build). +.RS 4 +\h'-04'\(bu\h'+02'The lock file is missing. +.RE +.sp +.RS 4 +\h'-04'\(bu\h'+02'Cargo attempted to change the lock file due to a different dependency resolution. +.RE +.sp +It may be used in environments where deterministic builds are desired, +such as in CI pipelines. .RE .sp \fB\-\-offline\fR diff --git a/src/etc/man/cargo-publish.1 b/src/etc/man/cargo-publish.1 index 57919c8dc83..8a65416f7dd 100644 --- a/src/etc/man/cargo-publish.1 +++ b/src/etc/man/cargo-publish.1 @@ -156,12 +156,20 @@ Path to the \fBCargo.toml\fR file. By default, Cargo searches for the .sp \fB\-\-locked\fR .RS 4 -Requires the \fBCargo.lock\fR file be up\-to\-date. If the lock file is missing, -or it needs to be updated due to changes in the \fBCargo.toml\fR file, for example -a new dependency is added, Cargo will exit with an error. +Asserts that the exact same dependencies and versions are used as when the +existing \fBCargo.lock\fR file was originally generated. Cargo will exit with an +error when either of the following scenarios arises: .sp -It may be used in environments where you want to assert that the \fBCargo.lock\fR -file is up\-to\-date (such as a CI build). +.RS 4 +\h'-04'\(bu\h'+02'The lock file is missing. +.RE +.sp +.RS 4 +\h'-04'\(bu\h'+02'Cargo attempted to change the lock file due to a different dependency resolution. +.RE +.sp +It may be used in environments where deterministic builds are desired, +such as in CI pipelines. .RE .sp \fB\-\-offline\fR diff --git a/src/etc/man/cargo-remove.1 b/src/etc/man/cargo-remove.1 index 1296a8bedd9..12f1dcfe808 100644 --- a/src/etc/man/cargo-remove.1 +++ b/src/etc/man/cargo-remove.1 @@ -83,12 +83,20 @@ Path to the \fBCargo.toml\fR file. By default, Cargo searches for the .sp \fB\-\-locked\fR .RS 4 -Requires the \fBCargo.lock\fR file be up\-to\-date. If the lock file is missing, -or it needs to be updated due to changes in the \fBCargo.toml\fR file, for example -a new dependency is added, Cargo will exit with an error. +Asserts that the exact same dependencies and versions are used as when the +existing \fBCargo.lock\fR file was originally generated. Cargo will exit with an +error when either of the following scenarios arises: .sp -It may be used in environments where you want to assert that the \fBCargo.lock\fR -file is up\-to\-date (such as a CI build). +.RS 4 +\h'-04'\(bu\h'+02'The lock file is missing. +.RE +.sp +.RS 4 +\h'-04'\(bu\h'+02'Cargo attempted to change the lock file due to a different dependency resolution. +.RE +.sp +It may be used in environments where deterministic builds are desired, +such as in CI pipelines. .RE .sp \fB\-\-offline\fR diff --git a/src/etc/man/cargo-run.1 b/src/etc/man/cargo-run.1 index 451489c4c81..8b356404925 100644 --- a/src/etc/man/cargo-run.1 +++ b/src/etc/man/cargo-run.1 @@ -222,12 +222,20 @@ Path to the \fBCargo.toml\fR file. By default, Cargo searches for the .sp \fB\-\-locked\fR .RS 4 -Requires the \fBCargo.lock\fR file be up\-to\-date. If the lock file is missing, -or it needs to be updated due to changes in the \fBCargo.toml\fR file, for example -a new dependency is added, Cargo will exit with an error. +Asserts that the exact same dependencies and versions are used as when the +existing \fBCargo.lock\fR file was originally generated. Cargo will exit with an +error when either of the following scenarios arises: .sp -It may be used in environments where you want to assert that the \fBCargo.lock\fR -file is up\-to\-date (such as a CI build). +.RS 4 +\h'-04'\(bu\h'+02'The lock file is missing. +.RE +.sp +.RS 4 +\h'-04'\(bu\h'+02'Cargo attempted to change the lock file due to a different dependency resolution. +.RE +.sp +It may be used in environments where deterministic builds are desired, +such as in CI pipelines. .RE .sp \fB\-\-offline\fR diff --git a/src/etc/man/cargo-rustc.1 b/src/etc/man/cargo-rustc.1 index fb1b78adefc..621db1e6eb8 100644 --- a/src/etc/man/cargo-rustc.1 +++ b/src/etc/man/cargo-rustc.1 @@ -336,12 +336,20 @@ Path to the \fBCargo.toml\fR file. By default, Cargo searches for the .sp \fB\-\-locked\fR .RS 4 -Requires the \fBCargo.lock\fR file be up\-to\-date. If the lock file is missing, -or it needs to be updated due to changes in the \fBCargo.toml\fR file, for example -a new dependency is added, Cargo will exit with an error. +Asserts that the exact same dependencies and versions are used as when the +existing \fBCargo.lock\fR file was originally generated. Cargo will exit with an +error when either of the following scenarios arises: .sp -It may be used in environments where you want to assert that the \fBCargo.lock\fR -file is up\-to\-date (such as a CI build). +.RS 4 +\h'-04'\(bu\h'+02'The lock file is missing. +.RE +.sp +.RS 4 +\h'-04'\(bu\h'+02'Cargo attempted to change the lock file due to a different dependency resolution. +.RE +.sp +It may be used in environments where deterministic builds are desired, +such as in CI pipelines. .RE .sp \fB\-\-offline\fR diff --git a/src/etc/man/cargo-rustdoc.1 b/src/etc/man/cargo-rustdoc.1 index cec32b0e690..32bdb57d179 100644 --- a/src/etc/man/cargo-rustdoc.1 +++ b/src/etc/man/cargo-rustdoc.1 @@ -304,12 +304,20 @@ Path to the \fBCargo.toml\fR file. By default, Cargo searches for the .sp \fB\-\-locked\fR .RS 4 -Requires the \fBCargo.lock\fR file be up\-to\-date. If the lock file is missing, -or it needs to be updated due to changes in the \fBCargo.toml\fR file, for example -a new dependency is added, Cargo will exit with an error. +Asserts that the exact same dependencies and versions are used as when the +existing \fBCargo.lock\fR file was originally generated. Cargo will exit with an +error when either of the following scenarios arises: .sp -It may be used in environments where you want to assert that the \fBCargo.lock\fR -file is up\-to\-date (such as a CI build). +.RS 4 +\h'-04'\(bu\h'+02'The lock file is missing. +.RE +.sp +.RS 4 +\h'-04'\(bu\h'+02'Cargo attempted to change the lock file due to a different dependency resolution. +.RE +.sp +It may be used in environments where deterministic builds are desired, +such as in CI pipelines. .RE .sp \fB\-\-offline\fR diff --git a/src/etc/man/cargo-test.1 b/src/etc/man/cargo-test.1 index e1b93f994ea..09a47068dd6 100644 --- a/src/etc/man/cargo-test.1 +++ b/src/etc/man/cargo-test.1 @@ -446,12 +446,20 @@ Path to the \fBCargo.toml\fR file. By default, Cargo searches for the .sp \fB\-\-locked\fR .RS 4 -Requires the \fBCargo.lock\fR file be up\-to\-date. If the lock file is missing, -or it needs to be updated due to changes in the \fBCargo.toml\fR file, for example -a new dependency is added, Cargo will exit with an error. +Asserts that the exact same dependencies and versions are used as when the +existing \fBCargo.lock\fR file was originally generated. Cargo will exit with an +error when either of the following scenarios arises: .sp -It may be used in environments where you want to assert that the \fBCargo.lock\fR -file is up\-to\-date (such as a CI build). +.RS 4 +\h'-04'\(bu\h'+02'The lock file is missing. +.RE +.sp +.RS 4 +\h'-04'\(bu\h'+02'Cargo attempted to change the lock file due to a different dependency resolution. +.RE +.sp +It may be used in environments where deterministic builds are desired, +such as in CI pipelines. .RE .sp \fB\-\-offline\fR diff --git a/src/etc/man/cargo-tree.1 b/src/etc/man/cargo-tree.1 index 1cdf3397b70..9c08491c8b9 100644 --- a/src/etc/man/cargo-tree.1 +++ b/src/etc/man/cargo-tree.1 @@ -268,12 +268,20 @@ Path to the \fBCargo.toml\fR file. By default, Cargo searches for the .sp \fB\-\-locked\fR .RS 4 -Requires the \fBCargo.lock\fR file be up\-to\-date. If the lock file is missing, -or it needs to be updated due to changes in the \fBCargo.toml\fR file, for example -a new dependency is added, Cargo will exit with an error. +Asserts that the exact same dependencies and versions are used as when the +existing \fBCargo.lock\fR file was originally generated. Cargo will exit with an +error when either of the following scenarios arises: .sp -It may be used in environments where you want to assert that the \fBCargo.lock\fR -file is up\-to\-date (such as a CI build). +.RS 4 +\h'-04'\(bu\h'+02'The lock file is missing. +.RE +.sp +.RS 4 +\h'-04'\(bu\h'+02'Cargo attempted to change the lock file due to a different dependency resolution. +.RE +.sp +It may be used in environments where deterministic builds are desired, +such as in CI pipelines. .RE .sp \fB\-\-offline\fR diff --git a/src/etc/man/cargo-update.1 b/src/etc/man/cargo-update.1 index 78550378c60..daad6db8aac 100644 --- a/src/etc/man/cargo-update.1 +++ b/src/etc/man/cargo-update.1 @@ -107,12 +107,20 @@ Path to the \fBCargo.toml\fR file. By default, Cargo searches for the .sp \fB\-\-locked\fR .RS 4 -Requires the \fBCargo.lock\fR file be up\-to\-date. If the lock file is missing, -or it needs to be updated due to changes in the \fBCargo.toml\fR file, for example -a new dependency is added, Cargo will exit with an error. +Asserts that the exact same dependencies and versions are used as when the +existing \fBCargo.lock\fR file was originally generated. Cargo will exit with an +error when either of the following scenarios arises: .sp -It may be used in environments where you want to assert that the \fBCargo.lock\fR -file is up\-to\-date (such as a CI build). +.RS 4 +\h'-04'\(bu\h'+02'The lock file is missing. +.RE +.sp +.RS 4 +\h'-04'\(bu\h'+02'Cargo attempted to change the lock file due to a different dependency resolution. +.RE +.sp +It may be used in environments where deterministic builds are desired, +such as in CI pipelines. .RE .sp \fB\-\-offline\fR diff --git a/src/etc/man/cargo-vendor.1 b/src/etc/man/cargo-vendor.1 index bc1de2f71e6..b739f2c8f88 100644 --- a/src/etc/man/cargo-vendor.1 +++ b/src/etc/man/cargo-vendor.1 @@ -64,12 +64,20 @@ Path to the \fBCargo.toml\fR file. By default, Cargo searches for the .sp \fB\-\-locked\fR .RS 4 -Requires the \fBCargo.lock\fR file be up\-to\-date. If the lock file is missing, -or it needs to be updated due to changes in the \fBCargo.toml\fR file, for example -a new dependency is added, Cargo will exit with an error. +Asserts that the exact same dependencies and versions are used as when the +existing \fBCargo.lock\fR file was originally generated. Cargo will exit with an +error when either of the following scenarios arises: .sp -It may be used in environments where you want to assert that the \fBCargo.lock\fR -file is up\-to\-date (such as a CI build). +.RS 4 +\h'-04'\(bu\h'+02'The lock file is missing. +.RE +.sp +.RS 4 +\h'-04'\(bu\h'+02'Cargo attempted to change the lock file due to a different dependency resolution. +.RE +.sp +It may be used in environments where deterministic builds are desired, +such as in CI pipelines. .RE .sp \fB\-\-offline\fR diff --git a/src/etc/man/cargo-verify-project.1 b/src/etc/man/cargo-verify-project.1 index 657ca5f2b45..b0e6d8c7cae 100644 --- a/src/etc/man/cargo-verify-project.1 +++ b/src/etc/man/cargo-verify-project.1 @@ -74,12 +74,20 @@ Path to the \fBCargo.toml\fR file. By default, Cargo searches for the .sp \fB\-\-locked\fR .RS 4 -Requires the \fBCargo.lock\fR file be up\-to\-date. If the lock file is missing, -or it needs to be updated due to changes in the \fBCargo.toml\fR file, for example -a new dependency is added, Cargo will exit with an error. +Asserts that the exact same dependencies and versions are used as when the +existing \fBCargo.lock\fR file was originally generated. Cargo will exit with an +error when either of the following scenarios arises: .sp -It may be used in environments where you want to assert that the \fBCargo.lock\fR -file is up\-to\-date (such as a CI build). +.RS 4 +\h'-04'\(bu\h'+02'The lock file is missing. +.RE +.sp +.RS 4 +\h'-04'\(bu\h'+02'Cargo attempted to change the lock file due to a different dependency resolution. +.RE +.sp +It may be used in environments where deterministic builds are desired, +such as in CI pipelines. .RE .sp \fB\-\-offline\fR diff --git a/tests/testsuite/cargo/help/stdout.term.svg b/tests/testsuite/cargo/help/stdout.term.svg index 0b087a57455..19d2cee5410 100644 --- a/tests/testsuite/cargo/help/stdout.term.svg +++ b/tests/testsuite/cargo/help/stdout.term.svg @@ -45,7 +45,7 @@ -C <DIRECTORY> Change to DIRECTORY before doing anything (nightly-only) - --locked Require Cargo.lock to be up-to-date + --locked Assert that `Cargo.lock` will remain unchanged --offline Run without accessing the network diff --git a/tests/testsuite/cargo_add/help/stdout.term.svg b/tests/testsuite/cargo_add/help/stdout.term.svg index 0d86a19d86f..729a83c6c52 100644 --- a/tests/testsuite/cargo_add/help/stdout.term.svg +++ b/tests/testsuite/cargo_add/help/stdout.term.svg @@ -181,7 +181,7 @@ --locked - Require Cargo.lock to be up-to-date + Assert that `Cargo.lock` will remain unchanged diff --git a/tests/testsuite/cargo_bench/help/stdout.term.svg b/tests/testsuite/cargo_bench/help/stdout.term.svg index 029db745a77..2fe6694e8f8 100644 --- a/tests/testsuite/cargo_bench/help/stdout.term.svg +++ b/tests/testsuite/cargo_bench/help/stdout.term.svg @@ -127,7 +127,7 @@ --manifest-path <PATH> Path to Cargo.toml - --locked Require Cargo.lock to be up-to-date + --locked Assert that `Cargo.lock` will remain unchanged --offline Run without accessing the network diff --git a/tests/testsuite/cargo_build/help/stdout.term.svg b/tests/testsuite/cargo_build/help/stdout.term.svg index 6cc51e692ee..8487003574e 100644 --- a/tests/testsuite/cargo_build/help/stdout.term.svg +++ b/tests/testsuite/cargo_build/help/stdout.term.svg @@ -125,7 +125,7 @@ --manifest-path <PATH> Path to Cargo.toml - --locked Require Cargo.lock to be up-to-date + --locked Assert that `Cargo.lock` will remain unchanged --offline Run without accessing the network diff --git a/tests/testsuite/cargo_check/help/stdout.term.svg b/tests/testsuite/cargo_check/help/stdout.term.svg index df573a98762..7f145892b41 100644 --- a/tests/testsuite/cargo_check/help/stdout.term.svg +++ b/tests/testsuite/cargo_check/help/stdout.term.svg @@ -121,7 +121,7 @@ --manifest-path <PATH> Path to Cargo.toml - --locked Require Cargo.lock to be up-to-date + --locked Assert that `Cargo.lock` will remain unchanged --offline Run without accessing the network diff --git a/tests/testsuite/cargo_clean/help/stdout.term.svg b/tests/testsuite/cargo_clean/help/stdout.term.svg index f2c6ef2efc5..125fdd4c784 100644 --- a/tests/testsuite/cargo_clean/help/stdout.term.svg +++ b/tests/testsuite/cargo_clean/help/stdout.term.svg @@ -69,7 +69,7 @@ --manifest-path <PATH> Path to Cargo.toml - --locked Require Cargo.lock to be up-to-date + --locked Assert that `Cargo.lock` will remain unchanged --offline Run without accessing the network diff --git a/tests/testsuite/cargo_config/help/stdout.term.svg b/tests/testsuite/cargo_config/help/stdout.term.svg index e57c40e2724..184a739c724 100644 --- a/tests/testsuite/cargo_config/help/stdout.term.svg +++ b/tests/testsuite/cargo_config/help/stdout.term.svg @@ -51,7 +51,7 @@ Manifest Options: - --locked Require Cargo.lock to be up-to-date + --locked Assert that `Cargo.lock` will remain unchanged --offline Run without accessing the network diff --git a/tests/testsuite/cargo_doc/help/stdout.term.svg b/tests/testsuite/cargo_doc/help/stdout.term.svg index 625889afff7..7c3433c9e39 100644 --- a/tests/testsuite/cargo_doc/help/stdout.term.svg +++ b/tests/testsuite/cargo_doc/help/stdout.term.svg @@ -115,7 +115,7 @@ --manifest-path <PATH> Path to Cargo.toml - --locked Require Cargo.lock to be up-to-date + --locked Assert that `Cargo.lock` will remain unchanged --offline Run without accessing the network diff --git a/tests/testsuite/cargo_fetch/help/stdout.term.svg b/tests/testsuite/cargo_fetch/help/stdout.term.svg index 26e762e8f49..78c9dcc69fc 100644 --- a/tests/testsuite/cargo_fetch/help/stdout.term.svg +++ b/tests/testsuite/cargo_fetch/help/stdout.term.svg @@ -53,7 +53,7 @@ --manifest-path <PATH> Path to Cargo.toml - --locked Require Cargo.lock to be up-to-date + --locked Assert that `Cargo.lock` will remain unchanged --offline Run without accessing the network diff --git a/tests/testsuite/cargo_fix/help/stdout.term.svg b/tests/testsuite/cargo_fix/help/stdout.term.svg index 7a2286fc66f..f4b05252fe9 100644 --- a/tests/testsuite/cargo_fix/help/stdout.term.svg +++ b/tests/testsuite/cargo_fix/help/stdout.term.svg @@ -129,7 +129,7 @@ --manifest-path <PATH> Path to Cargo.toml - --locked Require Cargo.lock to be up-to-date + --locked Assert that `Cargo.lock` will remain unchanged --offline Run without accessing the network diff --git a/tests/testsuite/cargo_generate_lockfile/help/stdout.term.svg b/tests/testsuite/cargo_generate_lockfile/help/stdout.term.svg index 98f5fae89a7..80de855faee 100644 --- a/tests/testsuite/cargo_generate_lockfile/help/stdout.term.svg +++ b/tests/testsuite/cargo_generate_lockfile/help/stdout.term.svg @@ -47,7 +47,7 @@ --manifest-path <PATH> Path to Cargo.toml - --locked Require Cargo.lock to be up-to-date + --locked Assert that `Cargo.lock` will remain unchanged --offline Run without accessing the network diff --git a/tests/testsuite/cargo_help/help/stdout.term.svg b/tests/testsuite/cargo_help/help/stdout.term.svg index 251fcef43be..e63595e209a 100644 --- a/tests/testsuite/cargo_help/help/stdout.term.svg +++ b/tests/testsuite/cargo_help/help/stdout.term.svg @@ -51,7 +51,7 @@ Manifest Options: - --locked Require Cargo.lock to be up-to-date + --locked Assert that `Cargo.lock` will remain unchanged --offline Run without accessing the network diff --git a/tests/testsuite/cargo_init/help/stdout.term.svg b/tests/testsuite/cargo_init/help/stdout.term.svg index 7080cf488f2..fdfabe6e7f3 100644 --- a/tests/testsuite/cargo_init/help/stdout.term.svg +++ b/tests/testsuite/cargo_init/help/stdout.term.svg @@ -69,7 +69,7 @@ Manifest Options: - --locked Require Cargo.lock to be up-to-date + --locked Assert that `Cargo.lock` will remain unchanged --offline Run without accessing the network diff --git a/tests/testsuite/cargo_install/help/stdout.term.svg b/tests/testsuite/cargo_install/help/stdout.term.svg index d226bdc3bfc..0e1a81c75a5 100644 --- a/tests/testsuite/cargo_install/help/stdout.term.svg +++ b/tests/testsuite/cargo_install/help/stdout.term.svg @@ -121,7 +121,7 @@ Manifest Options: - --locked Require Cargo.lock to be up-to-date + --locked Assert that `Cargo.lock` will remain unchanged --offline Run without accessing the network diff --git a/tests/testsuite/cargo_locate_project/help/stdout.term.svg b/tests/testsuite/cargo_locate_project/help/stdout.term.svg index 70b305a8476..2282c274eeb 100644 --- a/tests/testsuite/cargo_locate_project/help/stdout.term.svg +++ b/tests/testsuite/cargo_locate_project/help/stdout.term.svg @@ -53,7 +53,7 @@ --manifest-path <PATH> Path to Cargo.toml - --locked Require Cargo.lock to be up-to-date + --locked Assert that `Cargo.lock` will remain unchanged --offline Run without accessing the network diff --git a/tests/testsuite/cargo_login/help/stdout.term.svg b/tests/testsuite/cargo_login/help/stdout.term.svg index 51be04e8247..d6b62219b02 100644 --- a/tests/testsuite/cargo_login/help/stdout.term.svg +++ b/tests/testsuite/cargo_login/help/stdout.term.svg @@ -55,7 +55,7 @@ Manifest Options: - --locked Require Cargo.lock to be up-to-date + --locked Assert that `Cargo.lock` will remain unchanged --offline Run without accessing the network diff --git a/tests/testsuite/cargo_logout/help/stdout.term.svg b/tests/testsuite/cargo_logout/help/stdout.term.svg index f8750437ed7..2b390fe9972 100644 --- a/tests/testsuite/cargo_logout/help/stdout.term.svg +++ b/tests/testsuite/cargo_logout/help/stdout.term.svg @@ -47,7 +47,7 @@ Manifest Options: - --locked Require Cargo.lock to be up-to-date + --locked Assert that `Cargo.lock` will remain unchanged --offline Run without accessing the network diff --git a/tests/testsuite/cargo_metadata/help/stdout.term.svg b/tests/testsuite/cargo_metadata/help/stdout.term.svg index 43a082c29ba..6c6196be44f 100644 --- a/tests/testsuite/cargo_metadata/help/stdout.term.svg +++ b/tests/testsuite/cargo_metadata/help/stdout.term.svg @@ -69,7 +69,7 @@ --manifest-path <PATH> Path to Cargo.toml - --locked Require Cargo.lock to be up-to-date + --locked Assert that `Cargo.lock` will remain unchanged --offline Run without accessing the network diff --git a/tests/testsuite/cargo_new/help/stdout.term.svg b/tests/testsuite/cargo_new/help/stdout.term.svg index d6f12aafaa1..c7819a1c717 100644 --- a/tests/testsuite/cargo_new/help/stdout.term.svg +++ b/tests/testsuite/cargo_new/help/stdout.term.svg @@ -69,7 +69,7 @@ Manifest Options: - --locked Require Cargo.lock to be up-to-date + --locked Assert that `Cargo.lock` will remain unchanged --offline Run without accessing the network diff --git a/tests/testsuite/cargo_owner/help/stdout.term.svg b/tests/testsuite/cargo_owner/help/stdout.term.svg index 4d040bcadbf..ed0adcc6cf2 100644 --- a/tests/testsuite/cargo_owner/help/stdout.term.svg +++ b/tests/testsuite/cargo_owner/help/stdout.term.svg @@ -63,7 +63,7 @@ Manifest Options: - --locked Require Cargo.lock to be up-to-date + --locked Assert that `Cargo.lock` will remain unchanged --offline Run without accessing the network diff --git a/tests/testsuite/cargo_package/help/stdout.term.svg b/tests/testsuite/cargo_package/help/stdout.term.svg index 5d0a0decf4b..0b341bc2243 100644 --- a/tests/testsuite/cargo_package/help/stdout.term.svg +++ b/tests/testsuite/cargo_package/help/stdout.term.svg @@ -87,7 +87,7 @@ --manifest-path <PATH> Path to Cargo.toml - --locked Require Cargo.lock to be up-to-date + --locked Assert that `Cargo.lock` will remain unchanged --offline Run without accessing the network diff --git a/tests/testsuite/cargo_pkgid/help/stdout.term.svg b/tests/testsuite/cargo_pkgid/help/stdout.term.svg index 3e7d985cf99..3efa36f6fbe 100644 --- a/tests/testsuite/cargo_pkgid/help/stdout.term.svg +++ b/tests/testsuite/cargo_pkgid/help/stdout.term.svg @@ -59,7 +59,7 @@ --manifest-path <PATH> Path to Cargo.toml - --locked Require Cargo.lock to be up-to-date + --locked Assert that `Cargo.lock` will remain unchanged --offline Run without accessing the network diff --git a/tests/testsuite/cargo_publish/help/stdout.term.svg b/tests/testsuite/cargo_publish/help/stdout.term.svg index 240bb9ee1e2..671bd5c96a0 100644 --- a/tests/testsuite/cargo_publish/help/stdout.term.svg +++ b/tests/testsuite/cargo_publish/help/stdout.term.svg @@ -87,7 +87,7 @@ --manifest-path <PATH> Path to Cargo.toml - --locked Require Cargo.lock to be up-to-date + --locked Assert that `Cargo.lock` will remain unchanged --offline Run without accessing the network diff --git a/tests/testsuite/cargo_read_manifest/help/stdout.term.svg b/tests/testsuite/cargo_read_manifest/help/stdout.term.svg index f81c9a26829..b636b69f630 100644 --- a/tests/testsuite/cargo_read_manifest/help/stdout.term.svg +++ b/tests/testsuite/cargo_read_manifest/help/stdout.term.svg @@ -51,7 +51,7 @@ --manifest-path <PATH> Path to Cargo.toml - --locked Require Cargo.lock to be up-to-date + --locked Assert that `Cargo.lock` will remain unchanged --offline Run without accessing the network diff --git a/tests/testsuite/cargo_remove/help/stdout.term.svg b/tests/testsuite/cargo_remove/help/stdout.term.svg index cbaab26ce4c..7e6ee2832cf 100644 --- a/tests/testsuite/cargo_remove/help/stdout.term.svg +++ b/tests/testsuite/cargo_remove/help/stdout.term.svg @@ -71,7 +71,7 @@ --manifest-path <PATH> Path to Cargo.toml - --locked Require Cargo.lock to be up-to-date + --locked Assert that `Cargo.lock` will remain unchanged --offline Run without accessing the network diff --git a/tests/testsuite/cargo_report/help/stdout.term.svg b/tests/testsuite/cargo_report/help/stdout.term.svg index 2df6b7d3320..477a51a7cf7 100644 --- a/tests/testsuite/cargo_report/help/stdout.term.svg +++ b/tests/testsuite/cargo_report/help/stdout.term.svg @@ -51,7 +51,7 @@ Manifest Options: - --locked Require Cargo.lock to be up-to-date + --locked Assert that `Cargo.lock` will remain unchanged --offline Run without accessing the network diff --git a/tests/testsuite/cargo_run/help/stdout.term.svg b/tests/testsuite/cargo_run/help/stdout.term.svg index 916e047c301..e459231d756 100644 --- a/tests/testsuite/cargo_run/help/stdout.term.svg +++ b/tests/testsuite/cargo_run/help/stdout.term.svg @@ -103,7 +103,7 @@ --manifest-path <PATH> Path to Cargo.toml - --locked Require Cargo.lock to be up-to-date + --locked Assert that `Cargo.lock` will remain unchanged --offline Run without accessing the network diff --git a/tests/testsuite/cargo_rustc/help/stdout.term.svg b/tests/testsuite/cargo_rustc/help/stdout.term.svg index 0c8f491797b..e6e97c39988 100644 --- a/tests/testsuite/cargo_rustc/help/stdout.term.svg +++ b/tests/testsuite/cargo_rustc/help/stdout.term.svg @@ -125,7 +125,7 @@ --manifest-path <PATH> Path to Cargo.toml - --locked Require Cargo.lock to be up-to-date + --locked Assert that `Cargo.lock` will remain unchanged --offline Run without accessing the network diff --git a/tests/testsuite/cargo_rustdoc/help/stdout.term.svg b/tests/testsuite/cargo_rustdoc/help/stdout.term.svg index 9b31646bf0a..3d5bbbbfae7 100644 --- a/tests/testsuite/cargo_rustdoc/help/stdout.term.svg +++ b/tests/testsuite/cargo_rustdoc/help/stdout.term.svg @@ -123,7 +123,7 @@ --manifest-path <PATH> Path to Cargo.toml - --locked Require Cargo.lock to be up-to-date + --locked Assert that `Cargo.lock` will remain unchanged --offline Run without accessing the network diff --git a/tests/testsuite/cargo_search/help/stdout.term.svg b/tests/testsuite/cargo_search/help/stdout.term.svg index 9884ffa31d8..2824777d159 100644 --- a/tests/testsuite/cargo_search/help/stdout.term.svg +++ b/tests/testsuite/cargo_search/help/stdout.term.svg @@ -57,7 +57,7 @@ Manifest Options: - --locked Require Cargo.lock to be up-to-date + --locked Assert that `Cargo.lock` will remain unchanged --offline Run without accessing the network diff --git a/tests/testsuite/cargo_test/help/stdout.term.svg b/tests/testsuite/cargo_test/help/stdout.term.svg index 994387fc08c..0ec4686cda6 100644 --- a/tests/testsuite/cargo_test/help/stdout.term.svg +++ b/tests/testsuite/cargo_test/help/stdout.term.svg @@ -133,7 +133,7 @@ --manifest-path <PATH> Path to Cargo.toml - --locked Require Cargo.lock to be up-to-date + --locked Assert that `Cargo.lock` will remain unchanged --offline Run without accessing the network diff --git a/tests/testsuite/cargo_tree/help/stdout.term.svg b/tests/testsuite/cargo_tree/help/stdout.term.svg index 57568a0bda2..7e87db4d536 100644 --- a/tests/testsuite/cargo_tree/help/stdout.term.svg +++ b/tests/testsuite/cargo_tree/help/stdout.term.svg @@ -97,7 +97,7 @@ --manifest-path <PATH> Path to Cargo.toml - --locked Require Cargo.lock to be up-to-date + --locked Assert that `Cargo.lock` will remain unchanged --offline Run without accessing the network diff --git a/tests/testsuite/cargo_uninstall/help/stdout.term.svg b/tests/testsuite/cargo_uninstall/help/stdout.term.svg index 4eb4f3a9ac2..be47dba3627 100644 --- a/tests/testsuite/cargo_uninstall/help/stdout.term.svg +++ b/tests/testsuite/cargo_uninstall/help/stdout.term.svg @@ -65,7 +65,7 @@ Manifest Options: - --locked Require Cargo.lock to be up-to-date + --locked Assert that `Cargo.lock` will remain unchanged --offline Run without accessing the network diff --git a/tests/testsuite/cargo_update/help/stdout.term.svg b/tests/testsuite/cargo_update/help/stdout.term.svg index 46285c95d0c..f069ae4dec0 100644 --- a/tests/testsuite/cargo_update/help/stdout.term.svg +++ b/tests/testsuite/cargo_update/help/stdout.term.svg @@ -61,7 +61,7 @@ --manifest-path <PATH> Path to Cargo.toml - --locked Require Cargo.lock to be up-to-date + --locked Assert that `Cargo.lock` will remain unchanged --offline Run without accessing the network diff --git a/tests/testsuite/cargo_vendor/help/stdout.term.svg b/tests/testsuite/cargo_vendor/help/stdout.term.svg index 9b1fe4aea5a..3481541c7ff 100644 --- a/tests/testsuite/cargo_vendor/help/stdout.term.svg +++ b/tests/testsuite/cargo_vendor/help/stdout.term.svg @@ -63,7 +63,7 @@ --manifest-path <PATH> Path to Cargo.toml - --locked Require Cargo.lock to be up-to-date + --locked Assert that `Cargo.lock` will remain unchanged --offline Run without accessing the network diff --git a/tests/testsuite/cargo_verify_project/help/stdout.term.svg b/tests/testsuite/cargo_verify_project/help/stdout.term.svg index d36c7403085..8d537a83d96 100644 --- a/tests/testsuite/cargo_verify_project/help/stdout.term.svg +++ b/tests/testsuite/cargo_verify_project/help/stdout.term.svg @@ -47,7 +47,7 @@ --manifest-path <PATH> Path to Cargo.toml - --locked Require Cargo.lock to be up-to-date + --locked Assert that `Cargo.lock` will remain unchanged --offline Run without accessing the network diff --git a/tests/testsuite/cargo_version/help/stdout.term.svg b/tests/testsuite/cargo_version/help/stdout.term.svg index ee3ffa43f13..5482147256d 100644 --- a/tests/testsuite/cargo_version/help/stdout.term.svg +++ b/tests/testsuite/cargo_version/help/stdout.term.svg @@ -45,7 +45,7 @@ Manifest Options: - --locked Require Cargo.lock to be up-to-date + --locked Assert that `Cargo.lock` will remain unchanged --offline Run without accessing the network diff --git a/tests/testsuite/cargo_yank/help/stdout.term.svg b/tests/testsuite/cargo_yank/help/stdout.term.svg index c378d4d009a..7a71b49e122 100644 --- a/tests/testsuite/cargo_yank/help/stdout.term.svg +++ b/tests/testsuite/cargo_yank/help/stdout.term.svg @@ -61,7 +61,7 @@ Manifest Options: - --locked Require Cargo.lock to be up-to-date + --locked Assert that `Cargo.lock` will remain unchanged --offline Run without accessing the network