From a1d0d9f5d1d72f3ca0d1d2af36f9542f6f21ff91 Mon Sep 17 00:00:00 2001
From: umohnani8 <umohnani@redhat.com>
Date: Tue, 28 Nov 2017 09:34:07 -0500
Subject: Update man pages and output for kpod images

The size had a precision of 4, but wanted a precision of 3
to match the output of docker images
updated the man page with more examples
vendored in new version of docker/go-units to allow
for customized precisions

Signed-off-by: umohnani8 <umohnani@redhat.com>

Closes: #82
Approved by: rhatdan
---
 docs/kpod-images.1.md | 87 ++++++++++++++++++++++++++++++++++++++++++++-------
 1 file changed, 76 insertions(+), 11 deletions(-)

(limited to 'docs')

diff --git a/docs/kpod-images.1.md b/docs/kpod-images.1.md
index 96408090d..b852e047b 100644
--- a/docs/kpod-images.1.md
+++ b/docs/kpod-images.1.md
@@ -41,17 +41,82 @@ Lists only the image IDs.
 
 ## EXAMPLE
 
-kpod images
-
-kpod images --quiet
-
-kpod images -q --noheading --notruncate
-
-kpod images --format json
-
-kpod images --format "{{.ID}}"
-
-kpod images --filter dangling=true
+```
+# kpod images
+REPOSITORY                                   TAG      IMAGE ID       CREATED       SIZE
+docker.io/kubernetes/pause                   latest   e3d42bcaf643   3 years ago   251kB
+<none>                                       <none>   ebb91b73692b   4 weeks ago   27.2MB
+docker.io/library/ubuntu                     latest   4526339ae51c   6 weeks ago   126MB
+```
+
+```
+# kpod images --quiet
+e3d42bcaf643
+ebb91b73692b
+4526339ae51c
+```
+
+```
+# kpod images --noheading
+docker.io/kubernetes/pause                   latest   e3d42bcaf643   3 years ago   251kB
+<none>                                       <none>   ebb91b73692b   4 weeks ago   27.2MB
+docker.io/library/ubuntu                     latest   4526339ae51c   6 weeks ago   126MB
+```
+
+```
+# kpod images --no-trunc
+REPOSITORY                                   TAG      IMAGE ID                                                                  CREATED       SIZE
+docker.io/kubernetes/pause                   latest   sha256:e3d42bcaf643097dd1bb0385658ae8cbe100a80f773555c44690d22c25d16b27   3 years ago   251kB
+<none>                                       <none>   sha256:ebb91b73692bd27890685846412ae338d13552165eacf7fcd5f139bfa9c2d6d9   4 weeks ago   27.2MB
+docker.io/library/ubuntu                     latest   sha256:4526339ae51c3cdc97956a7a961c193c39dfc6bd9733b0d762a36c6881b5583a   6 weeks ago   126MB
+```
+
+```
+# kpod images --format "table {{.ID}} {{.Repository}} {{.Tag}}"
+IMAGE ID       REPOSITORY                                   TAG
+e3d42bcaf643   docker.io/kubernetes/pause                   latest
+ebb91b73692b   <none>                                       <none>
+4526339ae51c   docker.io/library/ubuntu                     latest
+```
+
+```
+# kpod images --filter dangling=true
+REPOSITORY   TAG      IMAGE ID       CREATED       SIZE
+<none>       <none>   ebb91b73692b   4 weeks ago   27.2MB
+```
+
+```
+# kpod images --format json
+[
+    {
+        "id": "e3d42bcaf643097dd1bb0385658ae8cbe100a80f773555c44690d22c25d16b27",
+        "names": [
+            "docker.io/kubernetes/pause:latest"
+        ],
+        "digest": "sha256:0aecf73ff86844324847883f2e916d3f6984c5fae3c2f23e91d66f549fe7d423",
+        "created": "2014-07-19T07:02:32.267701596Z",
+        "size": 250665
+    },
+    {
+        "id": "ebb91b73692bd27890685846412ae338d13552165eacf7fcd5f139bfa9c2d6d9",
+        "names": [
+            "\u003cnone\u003e"
+        ],
+        "digest": "sha256:ba7e4091d27e8114a205003ca6a768905c3395d961624a2c78873d9526461032",
+        "created": "2017-10-26T03:07:22.796184288Z",
+        "size": 27170520
+    },
+    {
+        "id": "4526339ae51c3cdc97956a7a961c193c39dfc6bd9733b0d762a36c6881b5583a",
+        "names": [
+            "docker.io/library/ubuntu:latest"
+        ],
+        "digest": "sha256:193f7734ddd68e0fb24ba9af8c2b673aecb0227b026871f8e932dab45add7753",
+        "created": "2017-10-10T20:59:05.10196344Z",
+        "size": 126085200
+    }
+]
+```
 
 ## SEE ALSO
 kpod(1)
-- 
cgit v1.2.3-54-g00ecf