which images is "docker pull" supposed to pull by default?

[Robert P. J. Day]

more nitpicky pedantry regarding docker on fedora 22 ... if i read
the man page for "docker-pull" on my f22 system, i see:

"This command pulls down an image or a repository from a registry. If
there is more than one image for a repository (e.g., fedora) then all
images for that repository name are pulled down including any tags."

note the reference to "all images" being pulled down. and the
example given seems to reinforce the notion that, if you specify
simply a repository, you'll get all corresponding tagged images:

docker pull fedora
              Pulling repository fedora
              ad57ef8d78d7: Download complete
              105182bb5e8b: Download complete
              511136ea3c5a: Download complete
              73bd853d2ea5: Download complete

Status: Downloaded newer image for fedora

docker images
              REPOSITORY   TAG         IMAGE ID        CREATED      VIRTUAL SIZE
              fedora       rawhide     ad57ef8d78d7    5 days ago   359.3 MB
              fedora       20          105182bb5e8b    5 days ago   372.7 MB
              fedora       heisenbug   105182bb5e8b    5 days ago   372.7 MB
              fedora       latest      105182bb5e8b    5 days ago   372.7 MB

*however*, the explanation of the "-a" option seems to disagree with
that:

OPTIONS
       -a, --all-tags=true|false
          Download all tagged images in the repository. The default is false.

which suggests that, by default, you *don't* get all tagged images
unless you specify "-a".

and a quick test shows that, if i run "docker pull fedora", all i
appear to get is:

# docker images
REPOSITORY          TAG                 IMAGE ID            CREATED             VIRTUAL SIZE
docker.io/fedora    latest              ded7cd95e059        7 weeks ago         186.5 MB
#

so ... what am i misreading here? the man page seems just a touch
confusing and contradictory.

rday

[Daniel J Walsh]

Please open a bugzilla with the docker package to fix the man page.

On 07/19/2015 05:05 AM, Robert P. J. Day wrote:
> more nitpicky pedantry regarding docker on fedora 22 ... if i read
> the man page for "docker-pull" on my f22 system, i see:
>
> "This command pulls down an image or a repository from a registry. If
> there is more than one image for a repository (e.g., fedora) then all
> images for that repository name are pulled down including any tags."
>
> note the reference to "all images" being pulled down. and the
> example given seems to reinforce the notion that, if you specify
> simply a repository, you'll get all corresponding tagged images:
>           docker pull fedora
>           Pulling repository fedora
>           ad57ef8d78d7: Download complete
>           105182bb5e8b: Download complete
>           511136ea3c5a: Download complete
>           73bd853d2ea5: Download complete
>
>           Status: Downloaded newer image for fedora
>
>           docker images
>           REPOSITORY   TAG         IMAGE ID        CREATED      VIRTUAL SIZE
>           fedora       rawhide     ad57ef8d78d7    5 days ago   359.3 MB
>           fedora       20          105182bb5e8b    5 days ago   372.7 MB
>           fedora       heisenbug   105182bb5e8b    5 days ago   372.7 MB
>           fedora       latest      105182bb5e8b    5 days ago   372.7 MB
>
> *however*, the explanation of the "-a" option seems to disagree with
> that:
> OPTIONS
>    -a, --all-tags=true|false
>       Download all tagged images in the repository. The default is false.
>
> which suggests that, by default, you *don't* get all tagged images
> unless you specify "-a".
>
> and a quick test shows that, if i run "docker pull fedora", all i
> appear to get is:
>
> # docker images
> REPOSITORY          TAG                 IMAGE ID            CREATED             VIRTUAL SIZE
> docker.io/fedora    latest              ded7cd95e059        7 weeks ago         186.5 MB
> #
>
> so ... what am i misreading here? the man page seems just a touch
> confusing and contradictory.
>
> rday