Merge pull request #15412 from edsantiago/docs_dedup_creds

Man pages: refactor common options: --creds

docs/source/markdown/options/creds.md

@@ -0,0 +1,5 @@
+#### **--creds**=*[username[:password]]*
+
+The [username[:password]] to use to authenticate with the registry if required.
+If one or both values are not supplied, a command line prompt will appear and the
+value can be entered.  The password is entered without echo.

docs/source/markdown/podman-build.1.md.in

@@ -196,11 +196,7 @@ Set additional flags to pass to the C Preprocessor cpp(1). Containerfiles ending
 
 @@option cpuset-mems
 
-#### **--creds**=*creds*
+@@option creds
-
-The [username[:password]] to use to authenticate with the registry if required.
-If one or both values are not supplied, a command line prompt will appear and
-the value can be entered.  The password is entered without echo.
 
 #### **--decryption-key**=*key[:passphrase]*
 

docs/source/markdown/podman-container-runlabel.1.md.in

@@ -37,9 +37,7 @@ Will be replaced with the current working directory.
 Use certificates at *path* (\*.crt, \*.cert, \*.key) to connect to the registry. (Default: /etc/containers/certs.d)
 Please refer to containers-certs.d(5) for details. (This option is not available with the remote Podman client, including Mac and Windows (excluding WSL2) machines)
 
-#### **--creds**=*[username[:password]]*
+@@option creds
-
-The [username[:password]] to use to authenticate with the registry if required.  If one or both values are not supplied, a command line prompt will appear and the value can be entered.  The password is entered without echo.
 
 #### **--display**
 

docs/source/markdown/podman-kube-play.1.md.in

@@ -130,11 +130,7 @@ Note: The *--configmap* option can be used multiple times or a comma-separated l
 
 Use *path* as the build context directory for each image. Requires --build option be true. (This option is not available with the remote Podman client)
 
-#### **--creds**
+@@option creds
-
-The [username[:password]] to use to authenticate with the registry if required.
-If one or both values are not supplied, a command line prompt will appear and the
-value can be entered.  The password is entered without echo.
 
 #### **--help**, **-h**
 

docs/source/markdown/podman-manifest-add.1.md.in

@@ -40,11 +40,7 @@ retrieved from the image's configuration information.
 Use certificates at *path* (\*.crt, \*.cert, \*.key) to connect to the registry. (Default: /etc/containers/certs.d)
 Please refer to containers-certs.d(5) for details. (This option is not available with the remote Podman client, including Mac and Windows (excluding WSL2) machines)
 
-#### **--creds**=*creds*
+@@option creds
-
-The [username[:password]] to use to authenticate with the registry if required.
-If one or both values are not supplied, a command line prompt will appear and the
-value can be entered.  The password is entered without echo.
 
 #### **--features**
 

docs/source/markdown/podman-manifest-push.1.md.in

@@ -30,11 +30,7 @@ Please refer to containers-certs.d(5) for details. (This option is not available
 
 Specifies the compression format to use.  Supported values are: `gzip`, `zstd` and `zstd:chunked`.  The default is `gzip` unless overridden in the containers.conf file.
 
-#### **--creds**=*creds*
+@@option creds
-
-The [username[:password]] to use to authenticate with the registry if required.
-If one or both values are not supplied, a command line prompt will appear and the
-value can be entered.  The password is entered without echo.
 
 #### **--digestfile**=*Digestfile*
 

docs/source/markdown/podman-pull.1.md.in

@@ -55,11 +55,7 @@ All tagged images in the repository will be pulled.
 
 @@option cert-dir
 
-#### **--creds**=*[username[:password]]*
+@@option creds
-
-The [username[:password]] to use to authenticate with the registry if required.
-If one or both values are not supplied, a command line prompt will appear and the
-value can be entered.  The password is entered without echo.
 
 #### **--disable-content-trust**
 

docs/source/markdown/podman-push.1.md.in

@@ -63,11 +63,7 @@ Note: This flag can only be set when using the **dir** transport
 
 Specifies the compression format to use.  Supported values are: `gzip`, `zstd` and `zstd:chunked`.  The default is `gzip` unless overridden in the containers.conf file.
 
-#### **--creds**=*[username[:password]]*
+@@option creds
-
-The [username[:password]] to use to authenticate with the registry if required.
-If one or both values are not supplied, a command line prompt will appear and the
-value can be entered.  The password is entered without echo.
 
 #### **--digestfile**=*Digestfile*