Shortcut for most recent container

It is desirable to have a shortcut for the most
recently created container.  We can now use "**latest"
to represent the most recent container instead of its
container ID or name.  For example:

Signed-off-by: baude <bbaude@redhat.com>

Closes: #179
Approved by: baude

9 files changed, 44 insertions, 0 deletions

diff --git a/docs/podman-attach.1.md b/docs/podman-attach.1.md
index 4d8b803c8..64163b340 100644
--- a/docs/podman-attach.1.md
+++ b/docs/podman-attach.1.md
@@ -20,6 +20,10 @@ sequence is CTRL-p CTRL-q. You configure the key sequence using the --detach-key
 Override the key sequence for detaching a container. Format is a single character [a-Z] or
 ctrl-<value> where <value> is one of: a-z, @, ^, [, , or _.
 
+**--latest, -l**
+Instead of providing the container name or ID, use the last created container. If you use methods other than Podman
+to run containers such as CRI-O, the last started container could be from either of those methods.
+
 **--no-stdin**
 Do not attach STDIN. The default is false.
 
@@ -30,6 +34,10 @@ podman attach foobar
 [root@localhost /]#
 ```
 ```
+podman attach --latest
+[root@localhost /]#
+```
+```
 podman attach 1234
 [root@localhost /]#
 ```
diff --git a/docs/podman-exec.1.md b/docs/podman-exec.1.md
index a9795002e..3c501b169 100644
--- a/docs/podman-exec.1.md
+++ b/docs/podman-exec.1.md
@@ -22,6 +22,10 @@ command to be executed.
 **--interactive, -i**
 Not supported.  All exec commands are interactive by default.
 
+**--latest, -l**
+Instead of providing the container name or ID, use the last created container. If you use methods other than Podman
+to run containers such as CRI-O, the last started  container could be from either of those methods.
+
 **--privileged**
 Give the process extended Linux capabilities when running the command in container.
 
diff --git a/docs/podman-inspect.1.md b/docs/podman-inspect.1.md
index c2edf896d..5b8a344d7 100644
--- a/docs/podman-inspect.1.md
+++ b/docs/podman-inspect.1.md
@@ -21,6 +21,10 @@ Return data on items of the specified type.  Type can be 'container', 'image' or
 
 Format the output using the given Go template
 
+**--latest, -l**
+Instead of providing the container name or ID, use the last created container. If you use methods other than Podman
+to run containers such as CRI-O, the last started container could be from either of those methods.
+
 **--size**
 
 Display the total file size if the type is a container
diff --git a/docs/podman-kill.1.md b/docs/podman-kill.1.md
index e254f2af3..62cb39db4 100644
--- a/docs/podman-kill.1.md
+++ b/docs/podman-kill.1.md
@@ -12,6 +12,9 @@ podman kill - Kills one or more containers with a signal
 The main process inside each container specified will be sent SIGKILL, or any signal specified with option --signal.
 
 ## OPTIONS
+**--latest, -l**
+Instead of providing the container name or ID, use the last created container. If you use methods other than Podman
+to run containers such as CRI-O, the last started container could be from either of those methods.
 
 **--signal, s**
 
@@ -26,6 +29,8 @@ podman kill 860a4b23
 
 podman kill --signal TERM 860a4b23
 
+podman kill --latest
+
 ## SEE ALSO
 podman(1), podman-stop(1)
 
diff --git a/docs/podman-rm.1.md b/docs/podman-rm.1.md
index 0d86dae1c..1047c7fc7 100644
--- a/docs/podman-rm.1.md
+++ b/docs/podman-rm.1.md
@@ -21,6 +21,9 @@ Force the removal of a running container
 
 Remove all containers.  Can be used in conjunction with -f as well.
 
+**--latest, -l**
+Instead of providing the container name or ID, use the last created container. If you use methods other than Podman
+to run containers such as CRI-O, the last started container could be from either of those methods.
 ## EXAMPLE
 
 podman rm mywebserver
@@ -31,6 +34,8 @@ podman rm -f 860a4b23
 
 podman rm -f -a
 
+podman rm -f --latest
+
 ## SEE ALSO
 podman(1), podman-rmi(1)
 
diff --git a/docs/podman-start.1.md b/docs/podman-start.1.md
index a6791127a..492787e6c 100644
--- a/docs/podman-start.1.md
+++ b/docs/podman-start.1.md
@@ -29,6 +29,9 @@ ctrl-<value> where <value> is one of: a-z, @, ^, [, , or _.
 
 Attach container's STDIN. The default is false.
 
+**--latest, -l**
+Instead of providing the container name or ID, use the last created container. If you use methods other than Podman
+to run containers such as CRI-O, the last started container could be from either of those methods.
 
 ## EXAMPLE
 
@@ -38,6 +41,8 @@ podman start 860a4b23 5421ab4
 
 podman start -i -a 860a4b23
 
+podman start -i -l
+
 ## SEE ALSO
 podman(1), podman-create(1)
 
diff --git a/docs/podman-stats.1.md b/docs/podman-stats.1.md
index 6d050b485..b071a27fa 100644
--- a/docs/podman-stats.1.md
+++ b/docs/podman-stats.1.md
@@ -17,6 +17,10 @@ Display a live stream of one or more containers' resource usage statistics
 
 Show all containers.  Only running containers are shown by default
 
+**--latest, -l**
+Instead of providing the container name or ID, use the last created container. If you use methods other than Podman
+to run containers such as CRI-O, the last started container could be from either of those methods.
+
 **--no-reset**
 
 Do not clear the terminal/screen in between reporting intervals
diff --git a/docs/podman-stop.1.md b/docs/podman-stop.1.md
index ad15b9117..f4372be5f 100644
--- a/docs/podman-stop.1.md
+++ b/docs/podman-stop.1.md
@@ -23,6 +23,9 @@ Timeout to wait before forcibly stopping the container
 
 Stop all running containers.  This does not include paused containers.
 
+**--latest, -l**
+Instead of providing the container name or ID, use the last created container. If you use methods other than Podman
+to run containers such as CRI-O, the last started container could be from either of those methods.
 
 ## EXAMPLE
 
@@ -36,6 +39,8 @@ podman stop --timeout 2 860a4b23
 
 podman stop -a
 
+podman stop --latest
+
 ## SEE ALSO
 podman(1), podman-rm(1)
 
diff --git a/docs/podman-top.1.md b/docs/podman-top.1.md
index 1067cdc52..eed15c584 100644
--- a/docs/podman-top.1.md
+++ b/docs/podman-top.1.md
@@ -21,6 +21,10 @@ Display the running process of the container. ps-OPTION can be any of the option
 **--format**
   Display the output in an alternate format.  The only supported format is **JSON**.
 
+**--latest, -l**
+Instead of providing the container name or ID, use the last created container. If you use methods other than Podman
+to run containers such as CRI-O, the last started container could be from either of those methods.
+
 ## EXAMPLES
 
 ```