Merge pull request #23842 from edsantiago/options-dedup

man pages: refactor two more options

docs/source/markdown/options/compat-auth-file.md

@@ -0,0 +1,7 @@
+####> This option file is used in:
+####>   podman login, logout
+####> If file is edited, make sure the changes
+####> are applicable to all of those.
+#### **--compat-auth-file**=*path*
+
+Instead of updating the default credentials file, update the one at *path*, and use a Docker-compatible format.

docs/source/markdown/options/sign-by-sigstore.md

@@ -0,0 +1,8 @@
+####> This option file is used in:
+####>   podman manifest push, push
+####> If file is edited, make sure the changes
+####> are applicable to all of those.
+#### **--sign-by-sigstore**=*param-file*
+
+Add a sigstore signature based on further options specified in a container's sigstore signing parameter file *param-file*.
+See containers-sigstore-signing-params.yaml(5) for details about the file format.

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

@@ -32,9 +32,7 @@ For more details about format and configurations of the auth.json file, see cont
 
 @@option cert-dir
 
-#### **--compat-auth-file**=*path*
-
-Instead of updating the default credentials file, update the one at *path*, and use a Docker-compatible format.
+@@option compat-auth-file
 
 #### **--get-login**
 

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

@@ -27,9 +27,7 @@ Remove the cached credentials for all registries in the auth file
 
 @@option authfile
 
-#### **--compat-auth-file**=*path*
-
-Instead of updating the default credentials file, update the one at *path*, and use a Docker-compatible format.
+@@option compat-auth-file
 
 #### **--help**, **-h**
 

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

@@ -64,10 +64,7 @@ Delete the manifest list or image index from local storage if pushing succeeds.
 
 Sign the pushed images with a “simple signing” signature using the specified key. (This option is not available with the remote Podman client, including Mac and Windows (excluding WSL2) machines)
 
-#### **--sign-by-sigstore**=*param-file*
-
-Add a sigstore signature based on further options specified in a container's sigstore signing parameter file *param-file*.
-See containers-sigstore-signing-params.yaml(5) for details about the file format.
+@@option sign-by-sigstore
 
 #### **--sign-by-sigstore-private-key**=*path*
 

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

@@ -92,10 +92,7 @@ Discard any pre-existing signatures in the image.
 
 Add a “simple signing” signature at the destination using the specified key. (This option is not available with the remote Podman client, including Mac and Windows (excluding WSL2) machines)
 
-#### **--sign-by-sigstore**=*param-file*
-
-Add a sigstore signature based on further options specified in a container's sigstore signing parameter file *param-file*.
-See containers-sigstore-signing-params.yaml(5) for details about the file format.
+@@option sign-by-sigstore
 
 #### **--sign-by-sigstore-private-key**=*path*