From 17d9a733296dbdb4e2b1e2bb6b5e9c717ee82fcd Mon Sep 17 00:00:00 2001
From: TomSweeneyRedHat <tsweeney@redhat.com>
Date: Tue, 16 Jan 2018 07:31:32 -0500
Subject: [PATCH] Touchup rm and container man pages

Signed-off-by: TomSweeneyRedHat <tsweeney@redhat.com>

Closes: #391
Approved by: rhatdan
---
 docs/buildah-containers.md | 33 ++++++++++++++++++++++++++++++++-
 docs/buildah-rm.md         |  2 +-
 2 files changed, 33 insertions(+), 2 deletions(-)

diff --git a/docs/buildah-containers.md b/docs/buildah-containers.md
index 197dd498a..0a4fecc5b 100644
--- a/docs/buildah-containers.md
+++ b/docs/buildah-containers.md
@@ -15,7 +15,7 @@ IDs, and the names and IDs of the images from which they were initialized.
 **--all, -a**
 
 List information about all containers, including those which were not created
-by and are not being used by Buildah.
+by and are not being used by Buildah.  Containers created by Buildah are denoted with an '*' in the 'BUILDER' column.
 
 **--json**
 
@@ -36,12 +36,43 @@ Displays only the container IDs.
 ## EXAMPLE
 
 buildah containers
+```
+CONTAINER ID  BUILDER  IMAGE ID     IMAGE NAME                       CONTAINER NAME
+29bdb522fc62     *     3fd9065eaf02 docker.io/library/alpine:latest  alpine-working-container
+c6b04237ac8e     *     f9b6f7f7b9d3 docker.io/library/busybox:latest busybox-working-container
+```
 
 buildah containers --quiet
+```
+29bdb522fc62d43fca0c1a0f11cfc6dfcfed169cf6cf25f928ebca1a612ff5b0
+c6b04237ac8e9d435ec9cf0e7eda91e302f2db9ef908418522c2d666352281eb
+```
 
 buildah containers -q --noheading --notruncate
+```
+29bdb522fc62d43fca0c1a0f11cfc6dfcfed169cf6cf25f928ebca1a612ff5b0
+c6b04237ac8e9d435ec9cf0e7eda91e302f2db9ef908418522c2d666352281eb
+```
 
 buildah containers --json
+```
+[
+    {
+        "id": "29bdb522fc62d43fca0c1a0f11cfc6dfcfed169cf6cf25f928ebca1a612ff5b0",
+        "builder": true,
+        "imageid": "3fd9065eaf02feaf94d68376da52541925650b81698c53c6824d92ff63f98353",
+        "imagename": "docker.io/library/alpine:latest",
+        "containername": "alpine-working-container"
+    },
+    {
+        "id": "c6b04237ac8e9d435ec9cf0e7eda91e302f2db9ef908418522c2d666352281eb",
+        "builder": true,
+        "imageid": "f9b6f7f7b9d34113f66e16a9da3e921a580937aec98da344b852ca540aaa2242",
+        "imagename": "docker.io/library/busybox:latest",
+        "containername": "busybox-working-container"
+    }
+]
+```
 
 ## SEE ALSO
 buildah(1)
diff --git a/docs/buildah-rm.md b/docs/buildah-rm.md
index cffe401cb..1ee995f06 100644
--- a/docs/buildah-rm.md
+++ b/docs/buildah-rm.md
@@ -13,7 +13,7 @@ Removes one or more working containers, unmounting them if necessary.
 
 **--all, -a**
 
-All containers will be removed.
+All Buildah containers will be removed.  Buildah containers are denoted with an '*' in the 'BUILDER' column listed by the command 'buildah containers'.
 
 ## EXAMPLE