Merge pull request #15414 from edsantiago/docs_dedup_cidfile

Man pages: refactor common options: --cidfile

docs/source/markdown/.gitignore

@@ -4,14 +4,19 @@ podman-container-clone.1.md
 podman-container-runlabel.1.md
 podman-create.1.md
 podman-image-sign.1.md
+podman-kill.1.md
 podman-kube-play.1.md
 podman-login.1.md
 podman-logout.1.md
 podman-manifest-add.1.md
 podman-manifest-push.1.md
+podman-pause.1.md
 podman-pod-clone.1.md
 podman-pod-create.1.md
 podman-pull.1.md
 podman-push.1.md
+podman-rm.1.md
 podman-run.1.md
 podman-search.1.md
+podman-stop.1.md
+podman-unpause.1.md

docs/source/markdown/options/cidfile.read.md

@@ -0,0 +1,4 @@
+#### **--cidfile**=*file*
+
+Read container ID from the specified *file* and <<subcommand>> the container.
+Can be specified multiple times.

docs/source/markdown/options/cidfile.write.md

@@ -0,0 +1,3 @@
+#### **--cidfile**=*file*
+
+Write the container ID to *file*.

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

@@ -105,9 +105,7 @@ Block IO relative device weight.
 
 @@option chrootdirs
 
-#### **--cidfile**=*id*
+@@option cidfile.write
-
-Write the container ID to the file
 
 @@option conmon-pidfile
 

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

@@ -16,9 +16,7 @@ The main process inside each container specified will be sent SIGKILL, or any si
 
 Signal all running and paused containers.
 
-#### **--cidfile**
+@@option cidfile.read
-
-Read container ID from the specified file and remove the container.  Can be specified multiple times.
 
 #### **--latest**, **-l**
 

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

@@ -17,9 +17,7 @@ Pauses all the processes in one or more containers.  You may use container IDs o
 
 Pause all running containers.
 
-#### **--cidfile**
+@@option cidfile.read
-
-Read container ID from the specified file and pause the container.  Can be specified multiple times.
 
 #### **--filter**, **-f**=*filter*
 

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

@@ -18,9 +18,7 @@ Running or unusable containers will not be removed without the **-f** option.
 
 Remove all containers.  Can be used in conjunction with **-f** as well.
 
-#### **--cidfile**
+@@option cidfile.read
-
-Read container ID from the specified file and remove the container.  Can be specified multiple times.
 
 #### **--depend**
 

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

@@ -120,9 +120,7 @@ each of **stdin**, **stdout**, and **stderr**.
 
 @@option chrootdirs
 
-#### **--cidfile**=*file*
+@@option cidfile.write
-
-Write the container ID to *file*.
 
 @@option conmon-pidfile
 

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

@@ -21,9 +21,7 @@ container and also via command line when creating the container.
 
 Stop all running containers.  This does not include paused containers.
 
-#### **--cidfile**
+@@option cidfile.read
-
-Read container ID from the specified file and remove the container.  Can be specified multiple times.
 
 #### **--filter**, **-f**=*filter*
 

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

@@ -17,9 +17,7 @@ Unpauses the processes in one or more containers.  You may use container IDs or
 
 Unpause all paused containers.
 
-#### **--cidfile**
+@@option cidfile.read
-
-Read container ID from the specified file and unpause the container.  Can be specified multiple times.
 
 #### **--filter**, **-f**=*filter*