Auto merge of #8737 - ehuss:doc-update-lockfile, r=alexcrichton

Fix minor error in `cargo update` docs.

`cargo update` does not require `Cargo.lock` to exist.

Also updated `generate-lockfile` to maybe be a little clearer (to me).

Author: bors

src/doc/man/cargo-generate-lockfile.md

@@ -11,8 +11,8 @@ cargo-generate-lockfile - Generate the lockfile for a package
 ## DESCRIPTION
 
 This command will create the `Cargo.lock` lockfile for the current package or
-workspace. If the lockfile already exists, it will be rebuilt if there are any
-manifest changes or dependency updates.
+workspace. If the lockfile already exists, it will be rebuilt with the latest
+available version of every package.
 
 See also {{man "cargo-update" 1}} which is also capable of creating a `Cargo.lock`
 lockfile and has more options for controlling update behavior.

src/doc/man/cargo-update.md

@@ -11,8 +11,8 @@ cargo-update - Update dependencies as recorded in the local lock file
 ## DESCRIPTION
 
 This command will update dependencies in the `Cargo.lock` file to the latest
-version. It requires that the `Cargo.lock` file already exists as generated
-by commands such as {{man "cargo-build" 1}} or {{man "cargo-generate-lockfile" 1}}.
+version. If the `Cargo.lock` file does not exist, it will be created with the
+latest available versions.
 
 ## OPTIONS
 

src/doc/man/generated_txt/cargo-generate-lockfile.txt

@@ -8,8 +8,8 @@ SYNOPSIS
 
 DESCRIPTION
        This command will create the Cargo.lock lockfile for the current package
-       or workspace. If the lockfile already exists, it will be rebuilt if
-       there are any manifest changes or dependency updates.
+       or workspace. If the lockfile already exists, it will be rebuilt with
+       the latest available version of every package.
 
        See also cargo-update(1) which is also capable of creating a Cargo.lock
        lockfile and has more options for controlling update behavior.

src/doc/man/generated_txt/cargo-update.txt

@@ -8,9 +8,8 @@ SYNOPSIS
 
 DESCRIPTION
        This command will update dependencies in the Cargo.lock file to the
-       latest version. It requires that the Cargo.lock file already exists as
-       generated by commands such as cargo-build(1) or
-       cargo-generate-lockfile(1).
+       latest version. If the Cargo.lock file does not exist, it will be
+       created with the latest available versions.
 
 OPTIONS
    Update Options

src/doc/src/commands/cargo-generate-lockfile.md

@@ -11,8 +11,8 @@ cargo-generate-lockfile - Generate the lockfile for a package
 ## DESCRIPTION
 
 This command will create the `Cargo.lock` lockfile for the current package or
-workspace. If the lockfile already exists, it will be rebuilt if there are any
-manifest changes or dependency updates.
+workspace. If the lockfile already exists, it will be rebuilt with the latest
+available version of every package.
 
 See also [cargo-update(1)](cargo-update.md) which is also capable of creating a `Cargo.lock`
 lockfile and has more options for controlling update behavior.

src/doc/src/commands/cargo-update.md

@@ -11,8 +11,8 @@ cargo-update - Update dependencies as recorded in the local lock file
 ## DESCRIPTION
 
 This command will update dependencies in the `Cargo.lock` file to the latest
-version. It requires that the `Cargo.lock` file already exists as generated
-by commands such as [cargo-build(1)](cargo-build.md) or [cargo-generate-lockfile(1)](cargo-generate-lockfile.md).
+version. If the `Cargo.lock` file does not exist, it will be created with the
+latest available versions.
 
 ## OPTIONS
 

src/etc/man/cargo-generate-lockfile.1

@@ -9,8 +9,8 @@ cargo\-generate\-lockfile \- Generate the lockfile for a package
 \fBcargo generate\-lockfile\fR [\fIoptions\fR]
 .SH "DESCRIPTION"
 This command will create the \fBCargo.lock\fR lockfile for the current package or
-workspace. If the lockfile already exists, it will be rebuilt if there are any
-manifest changes or dependency updates.
+workspace. If the lockfile already exists, it will be rebuilt with the latest
+available version of every package.
 .sp
 See also \fBcargo\-update\fR(1) which is also capable of creating a \fBCargo.lock\fR
 lockfile and has more options for controlling update behavior.

src/etc/man/cargo-update.1

@@ -9,8 +9,8 @@ cargo\-update \- Update dependencies as recorded in the local lock file
 \fBcargo update\fR [\fIoptions\fR]
 .SH "DESCRIPTION"
 This command will update dependencies in the \fBCargo.lock\fR file to the latest
-version. It requires that the \fBCargo.lock\fR file already exists as generated
-by commands such as \fBcargo\-build\fR(1) or \fBcargo\-generate\-lockfile\fR(1).
+version. If the \fBCargo.lock\fR file does not exist, it will be created with the
+latest available versions.
 .SH "OPTIONS"
 .SS "Update Options"
 .sp