Auto merge of #12832 - weihanglo:cargo-login, r=ehuss

doc(cargo-login): mention args after `--` in manpage

Author: bors

src/doc/man/cargo-login.md

@@ -6,14 +6,16 @@ cargo-login --- Log in to a registry
 
 ## SYNOPSIS
 
-`cargo login` [_options_] [_token_] -- [_args_]
+`cargo login` [_options_] [_token_] [`--` _args_]
 
 ## DESCRIPTION
 
 This command will run a credential provider to save a token so that commands
 that require authentication, such as {{man "cargo-publish" 1}}, will be
 automatically authenticated.
 
+All the arguments following the two dashes (`--`) are passed to the credential provider.
+
 For the default `cargo:token` credential provider, the token is saved
 in `$CARGO_HOME/credentials.toml`. `CARGO_HOME` defaults to `.cargo`
 in your home directory.

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

@@ -4,13 +4,16 @@ NAME
        cargo-login — Log in to a registry
 
 SYNOPSIS
-       cargo login [options] [token] – [args]
+       cargo login [options] [token] [-- args]
 
 DESCRIPTION
        This command will run a credential provider to save a token so that
        commands that require authentication, such as cargo-publish(1), will be
        automatically authenticated.
 
+       All the arguments following the two dashes (--) are passed to the
+       credential provider.
+
        For the default cargo:token credential provider, the token is saved in
        $CARGO_HOME/credentials.toml. CARGO_HOME defaults to .cargo in your home
        directory.

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

@@ -6,14 +6,16 @@ cargo-login --- Log in to a registry
 
 ## SYNOPSIS
 
-`cargo login` [_options_] [_token_] -- [_args_]
+`cargo login` [_options_] [_token_] [`--` _args_]
 
 ## DESCRIPTION
 
 This command will run a credential provider to save a token so that commands
 that require authentication, such as [cargo-publish(1)](cargo-publish.html), will be
 automatically authenticated.
 
+All the arguments following the two dashes (`--`) are passed to the credential provider.
+
 For the default `cargo:token` credential provider, the token is saved
 in `$CARGO_HOME/credentials.toml`. `CARGO_HOME` defaults to `.cargo`
 in your home directory.

src/etc/man/cargo-login.1

@@ -6,12 +6,14 @@
 .SH "NAME"
 cargo\-login \[em] Log in to a registry
 .SH "SYNOPSIS"
-\fBcargo login\fR [\fIoptions\fR] [\fItoken\fR] \[en] [\fIargs\fR]
+\fBcargo login\fR [\fIoptions\fR] [\fItoken\fR] [\fB\-\-\fR \fIargs\fR]
 .SH "DESCRIPTION"
 This command will run a credential provider to save a token so that commands
 that require authentication, such as \fBcargo\-publish\fR(1), will be
 automatically authenticated.
 .sp
+All the arguments following the two dashes (\fB\-\-\fR) are passed to the credential provider.
+.sp
 For the default \fBcargo:token\fR credential provider, the token is saved
 in \fB$CARGO_HOME/credentials.toml\fR\&. \fBCARGO_HOME\fR defaults to \fB\&.cargo\fR
 in your home directory.