Fix up example description of podman-pod commands

Signed-off-by: Daniel J Walsh <[email protected]>

Author: rhatdan

docs/source/markdown/podman-pod-exists.1.md

@@ -14,20 +14,16 @@ was an issue accessing the local storage.
 
 ## EXAMPLES
 
-Check if a pod called `web` exists in local storage (the pod does actually exist).
+Check if specified pod exists in local storage (the pod does actually exist):
 ```
-$ sudo podman pod exists web
-$ echo $?
+$ sudo podman pod exists web; echo $?
 0
-$
 ```
 
-Check if a pod called `backend` exists in local storage (the pod does not actually exist).
+Check if specified pod exists in local storage (the pod does not actually exist):
 ```
-$ sudo podman pod exists backend
-$ echo $?
+$ sudo podman pod exists backend; echo $?
 1
-$
 ```
 
 ## SEE ALSO

docs/source/markdown/podman-pod-inspect.1.md.in

@@ -60,6 +60,8 @@ Valid placeholders for the Go template are listed below:
 @@option latest
 
 ## EXAMPLE
+
+Inspect specified pod:
 ```
 # podman pod inspect foobar
 [

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

@@ -20,27 +20,27 @@ Sends signal to all containers associated with a pod.
 
 ## EXAMPLE
 
-Kill pod with a given name
+Kill pod with a given name:
 ```
 podman pod kill mywebserver
 ```
 
-Kill pod with a given ID
+Kill pod with a given ID:
 ```
 podman pod kill 860a4b23
 ```
 
-Terminate pod by sending `TERM` signal
+Terminate pod by sending `TERM` signal:
 ```
 podman pod kill --signal TERM 860a4b23
 ```
 
-Kill the latest pod. (This option is not available with the remote Podman client, including Mac and Windows (excluding WSL2) machines)
+Kill the latest pod. (This option is not available with the remote Podman client, including Mac and Windows (excluding WSL2) machines):
 ```
 podman pod kill --latest
 ```
 
-Terminate all pods by sending `KILL` signal
+Terminate all pods by sending `KILL` signal:
 ```
 podman pod kill --all
 ```

docs/source/markdown/podman-pod-logs.1.md.in

@@ -40,7 +40,7 @@ To view a pod's logs:
 podman pod logs -t podIdorName
 ```
 
-To view logs of a specific container on the pod
+To view logs of a specific container on the pod:
 ```
 podman pod logs -c ctrIdOrName podIdOrName
 ```

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

@@ -21,12 +21,12 @@ Instead of providing the pod name or ID, pause the last created pod. (This optio
 
 ## EXAMPLE
 
-Pause a pod with a given name
+Pause a pod with a given name:
 ```
 podman pod pause mywebserverpod
 ```
 
-Pause a pod with a given ID
+Pause a pod with a given ID:
 ```
 podman pod pause 860a4b23
 ```

docs/source/markdown/podman-pod-restart.1.md

@@ -24,26 +24,26 @@ Instead of providing the pod name or ID, restart the last created pod. (This opt
 
 ## EXAMPLE
 
-Restart pod with a given name
+Restart pod with a given name:
 ```
 podman pod restart mywebserverpod
 cc8f0bea67b1a1a11aec1ecd38102a1be4b145577f21fc843c7c83b77fc28907
 ```
 
-Restart multiple pods with given IDs
+Restart multiple pods with given IDs:
 ```
 podman pod restart 490eb 3557fb
 490eb241aaf704d4dd2629904410fe4aa31965d9310a735f8755267f4ded1de5
 3557fbea6ad61569de0506fe037479bd9896603c31d3069a6677f23833916fab
 ```
 
-Restart the last created pod
+Restart the last created pod:
 ```
 podman pod restart --latest
 3557fbea6ad61569de0506fe037479bd9896603c31d3069a6677f23833916fab
 ```
 
-Restart all pods
+Restart all pods:
 ```
 podman pod restart --all
 19456b4cd557eaf9629825113a552681a6013f8c8cad258e36ab825ef536e818

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

@@ -32,28 +32,28 @@ The --force option must be specified to use the --time option.
 
 ## EXAMPLE
 
-Remove pod with a given name
+Remove pod with a given name:
 ```
 podman pod rm mywebserverpod
 ```
 
-Remove multiple pods with given names and/or IDs
+Remove multiple pods with given names and/or IDs:
 ```
 podman pod rm mywebserverpod myflaskserverpod 860a4b23
 ```
 
-Forcefully remove pod with a given ID
+Forcefully remove pod with a given ID:
 ```
 podman pod rm -f 860a4b23
 ```
 
-Forcefully remove all pods
+Forcefully remove all pods:
 ```
 podman pod rm -f -a
 podman pod rm -fa
 ```
 
-Remove pod using ID specified in a given file
+Remove pod using ID specified in a given file:
 ```
 podman pod rm --pod-id-file /path/to/id/file
 ```

docs/source/markdown/podman-pod-start.1.md.in

@@ -22,27 +22,27 @@ Starts all pods
 
 ## EXAMPLE
 
-Start pod with a given name
+Start pod with a given name:
 ```
 podman pod start mywebserverpod
 ```
 
-Start pods with given IDs
+Start pods with given IDs:
 ```
 podman pod start 860a4b23 5421ab4
 ```
 
-Start the latest pod. (This option is not available with the remote Podman client, including Mac and Windows (excluding WSL2) machines)
+Start the latest pod. (This option is not available with the remote Podman client, including Mac and Windows (excluding WSL2) machines):
 ```
 podman pod start --latest
 ```
 
-Start all pods
+Start all pods:
 ```
 podman pod start --all
 ```
 
-Start pod using ID specified in a given file
+Start pod using ID specified in a given file:
 ```
 podman pod start --pod-id-file /path/to/id/file
 ```

docs/source/markdown/podman-pod-stats.1.md.in

@@ -44,19 +44,22 @@ When using a Go template, precede the format with `table` to print headers.
 
 ## EXAMPLE
 
+List statistics about all pods without streaming:
 ```
 # podman pod stats -a --no-stream
 ID             NAME              CPU %   MEM USAGE / LIMIT   MEM %   NET IO    BLOCK IO   PIDS
 a9f807ffaacd   frosty_hodgkin    --      3.092MB / 16.7GB    0.02%   -- / --   -- / --    2
 3b33001239ee   sleepy_stallman   --      -- / --             --      -- / --   -- / --    --
 ```
 
+List statistics about specified pod without streaming:
 ```
 # podman pod stats --no-stream a9f80
 ID             NAME             CPU %   MEM USAGE / LIMIT   MEM %   NET IO    BLOCK IO   PIDS
 a9f807ffaacd   frosty_hodgkin   --      3.092MB / 16.7GB    0.02%   -- / --   -- / --    2
 ```
 
+List statistics about specified pod in JSON format without streaming:
 ```
 # podman pod stats --no-stream --format=json a9f80
 [
@@ -73,6 +76,7 @@ a9f807ffaacd   frosty_hodgkin   --      3.092MB / 16.7GB    0.02%   -- / --   --
 ]
 ```
 
+List selected statistics formatted in a table about specified pod:
 ```
 # podman pod stats --no-stream --format "table {{.ID}} {{.Name}} {{.MemUsage}}" 6eae
 ID             NAME           MEM USAGE / LIMIT

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

@@ -21,12 +21,12 @@ Instead of providing the pod name or ID, unpause the last created pod. (This opt
 
 ## EXAMPLE
 
-Unpause pod with a given name
+Unpause pod with a given name:
 ```
 podman pod unpause mywebserverpod
 ```
 
-Unpause pod with a given ID
+Unpause pod with a given ID:
 ```
 podman pod unpause 860a4b23
 ```