summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorOpenShift Merge Robot <openshift-merge-robot@users.noreply.github.com>2022-04-06 04:44:52 -0400
committerGitHub <noreply@github.com>2022-04-06 04:44:52 -0400
commit8b6f911e4818d02bca65ff263dcb61bfe082a470 (patch)
treec2dbd20ea4d6a5ce1e4108b8c9c1f9ae0194ed4f
parent370821f3e3537f8ae5ff2885a3a30de196180b06 (diff)
parente73547a6352042d27c6dc34574d08ae51f84ee65 (diff)
downloadpodman-8b6f911e4818d02bca65ff263dcb61bfe082a470.tar.gz
podman-8b6f911e4818d02bca65ff263dcb61bfe082a470.tar.bz2
podman-8b6f911e4818d02bca65ff263dcb61bfe082a470.zip
Merge pull request #13786 from patrycja-guzik/docu3
[CI:DOCS] Unify examples section across several man pages: pod rm/start/unpause
-rw-r--r--docs/source/markdown/podman-pod-rm.1.md16
-rw-r--r--docs/source/markdown/podman-pod-start.1.md15
-rw-r--r--docs/source/markdown/podman-pod-unpause.1.md6
3 files changed, 36 insertions, 1 deletions
diff --git a/docs/source/markdown/podman-pod-rm.1.md b/docs/source/markdown/podman-pod-rm.1.md
index 75a44c6d4..befab6791 100644
--- a/docs/source/markdown/podman-pod-rm.1.md
+++ b/docs/source/markdown/podman-pod-rm.1.md
@@ -39,17 +39,31 @@ Seconds to wait before forcibly stopping running containers within the pod. The
## EXAMPLE
+Remove pod with a given name
+```
podman pod rm mywebserverpod
+```
+Remove multiple pods with given names and/or IDs
+```
podman pod rm mywebserverpod myflaskserverpod 860a4b23
+```
+Forcefully remove pod with a given ID
+```
podman pod rm -f 860a4b23
+```
+Forcefully remove all pods
+```
podman pod rm -f -a
-
podman pod rm -fa
+```
+Remove pod using ID specified in a given file
+```
podman pod rm --pod-id-file /path/to/id/file
+```
## Exit Status
**0** All specified pods removed
diff --git a/docs/source/markdown/podman-pod-start.1.md b/docs/source/markdown/podman-pod-start.1.md
index bab109212..45fc50c51 100644
--- a/docs/source/markdown/podman-pod-start.1.md
+++ b/docs/source/markdown/podman-pod-start.1.md
@@ -26,15 +26,30 @@ Read pod ID from the specified file and start the pod. Can be specified multipl
## EXAMPLE
+Start pod with a given name
+```
podman pod start mywebserverpod
+```
+Start pods with given IDs
+```
podman pod start 860a4b23 5421ab4
+```
+Start the latest pod created by Podman
+```
podman pod start --latest
+```
+Start all pods
+```
podman pod start --all
+```
+Start pod using ID specified in a given file
+```
podman pod start --pod-id-file /path/to/id/file
+```
## SEE ALSO
**[podman(1)](podman.1.md)**, **[podman-pod(1)](podman-pod.1.md)**, **[podman-pod-stop(1)](podman-pod-stop.1.md)**
diff --git a/docs/source/markdown/podman-pod-unpause.1.md b/docs/source/markdown/podman-pod-unpause.1.md
index ce883af69..d6645d69c 100644
--- a/docs/source/markdown/podman-pod-unpause.1.md
+++ b/docs/source/markdown/podman-pod-unpause.1.md
@@ -21,9 +21,15 @@ Instead of providing the pod name or ID, unpause the last created pod. (This opt
## EXAMPLE
+Unpause pod with a given name
+```
podman pod unpause mywebserverpod
+```
+Unpause pod with a given ID
+```
podman pod unpause 860a4b23
+```
## SEE ALSO
**[podman(1)](podman.1.md)**, **[podman-pod(1)](podman-pod.1.md)**, **[podman-pod-pause(1)](podman-pod-pause.1.md)**