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

-- 

========================================================================
Robert P. J. Day                                 Ottawa, Ontario, CANADA
                        http://crashcourse.ca

Twitter:                                       http://twitter.com/rpjday
LinkedIn:                               http://ca.linkedin.com/in/rpjday
========================================================================