1. docker
  2. Commit 9b5e0ea7dedac3c1cbbaf6770aa6834c8e7b7774
Browse code

Update docker-load documentation

Signed-off-by: Vincent Demeester <vincent@sbr.pm>

Vincent Demeester authored on 2016/06/09 00:40:37
Showing 2 changed files
docs/reference/commandline/load.md
History View file @ 9b5e0ea
... ... 
@@ -12,11 +12,12 @@ parent = "smn_cli"
12 12
13 13 
     Usage: docker load [OPTIONS]
14 14
15 
-    Load an image from a tar archive or STDIN
15 
+    Load an image from a tar archive or STDIN and shows image names or
16 
+    IDs imported.
16 17
17 18 
       --help             Print usage
18 19 
       -i, --input=""     Read from a tar archive file, instead of STDIN. The tarball may be compressed with gzip, bzip, or xz
19 
-      -q, --quiet        Suppress the load output. Without this option, a progress bar is displayed.
20 
+      -q, --quiet        Suppress the load progress bar but still outputs the imported images
20 21
21 22 
 Loads a tarred repository from a file or the standard input stream.
22 23 
 Restores both images and tags.
... ... 
@@ -24,10 +25,17 @@ Restores both images and tags.
24 24 
     $ docker images
25 25 
     REPOSITORY          TAG                 IMAGE ID            CREATED             SIZE
26 26 
     $ docker load < busybox.tar.gz
27 
+    # […]
28 
+    Loaded image: busybox:latest
27 29 
     $ docker images
28 30 
     REPOSITORY          TAG                 IMAGE ID            CREATED             SIZE
29 31 
     busybox             latest              769b9341d937        7 weeks ago         2.489 MB
30 32 
     $ docker load --input fedora.tar
33 
+    # […]
34 
+    Loaded image: fedora:rawhide
35 
+    # […]
36 
+    Loaded image: fedora:20
37 
+    # […]
31 38 
     $ docker images
32 39 
     REPOSITORY          TAG                 IMAGE ID            CREATED             SIZE
33 40 
     busybox             latest              769b9341d937        7 weeks ago         2.489 MB
man/docker-load.1.md
History View file @ 9b5e0ea
... ... 
@@ -13,7 +13,8 @@ docker-load - Load an image from a tar archive or STDIN
13 13 
 # DESCRIPTION
14 14
15 15 
 Loads a tarred repository from a file or the standard input stream.
16 
-Restores both images and tags.
16 
+Restores both images and tags. Write image names or IDs imported it
17 
+standard output stream.
17 18
18 19 
 # OPTIONS
19 20 
 **--help**
... ... 
@@ -23,7 +24,7 @@ Restores both images and tags.
23 23 
    Read from a tar archive file, instead of STDIN. The tarball may be compressed with gzip, bzip, or xz.
24 24
25 25 
 **-q**, **--quiet**
26 
-   Suppress the load output. Without this option, a progress bar is displayed.
26 
+   Suppress the load progress bar but still outputs the imported images.
27 27
28 28 
 # EXAMPLES
29 29
... ... 
@@ -31,6 +32,11 @@ Restores both images and tags.
31 31 
     REPOSITORY          TAG                 IMAGE ID            CREATED             SIZE
32 32 
     busybox             latest              769b9341d937        7 weeks ago         2.489 MB
33 33 
     $ docker load --input fedora.tar
34 
+    # […]
35 
+    Loaded image: fedora:rawhide
36 
+    # […]
37 
+    Loaded image: fedora:20
38 
+    # […]
34 39 
     $ docker images
35 40 
     REPOSITORY          TAG                 IMAGE ID            CREATED             SIZE
36 41 
     busybox             latest              769b9341d937        7 weeks ago         2.489 MB
... ... 
@@ -47,3 +53,4 @@ April 2014, Originally compiled by William Henry (whenry at redhat dot com)
47 47 
 based on docker.com source material and internal work.
48 48 
 June 2014, updated by Sven Dowideit <SvenDowideit@home.org.au>
49 49 
 July 2015 update by Mary Anthony <mary@docker.com>
50 
+June 2016 update by Vincent Demeester <vincent@sbr.pm>