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

[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
>