From 85d151718411d72391f00804c8346a676f4f5a44 Mon Sep 17 00:00:00 2001
From: Aaron Lehmann <aaron.lehmann@docker.com>
Date: Mon, 28 Mar 2016 17:10:11 -0700
Subject: [PATCH] Mention "docker login" in push/pull documentation

It was suggested to me that documentation for "docker pull" and "docker
push" should reference "docker login", to make clearer how to specify
credentials for a push or pull operation. Add a note to the manual pages
and reference documentation explaining how registry credentials are
managed.

Signed-off-by: Aaron Lehmann <aaron.lehmann@docker.com>
(cherry picked from commit fb5ea0c0efec238aeeff7c5c3742a0e4eccff2c7)
---
 docs/reference/commandline/pull.md | 2 ++
 docs/reference/commandline/push.md | 2 ++
 man/docker-pull.1.md               | 2 ++
 man/docker-push.1.md               | 2 ++
 4 files changed, 8 insertions(+)

diff --git a/docs/reference/commandline/pull.md b/docs/reference/commandline/pull.md
index 8e7d777356..01ec88e8a6 100644
--- a/docs/reference/commandline/pull.md
+++ b/docs/reference/commandline/pull.md
@@ -165,6 +165,8 @@ listening on port 5000 (`myregistry.local:5000`):
 $ docker pull myregistry.local:5000/testing/test-image
 ```
 
+Registry credentials are managed by [docker login](login.md).
+
 Docker uses the `https://` protocol to communicate with a registry, unless the
 registry is allowed to be accessed over an insecure connection. Refer to the
 [insecure registries](daemon.md#insecure-registries) section for more information.
diff --git a/docs/reference/commandline/push.md b/docs/reference/commandline/push.md
index 315d3ce376..81091b1430 100644
--- a/docs/reference/commandline/push.md
+++ b/docs/reference/commandline/push.md
@@ -22,3 +22,5 @@ registry or to a self-hosted one.
 
 Killing the `docker push` process, for example by pressing `CTRL-c` while it is
 running in a terminal, will terminate the push operation.
+
+Registry credentials are managed by [docker login](login.md).
diff --git a/man/docker-pull.1.md b/man/docker-pull.1.md
index e4a7550d5b..c61d005308 100644
--- a/man/docker-pull.1.md
+++ b/man/docker-pull.1.md
@@ -151,6 +151,8 @@ listening on port 5000 (`myregistry.local:5000`):
 
     $ docker pull myregistry.local:5000/testing/test-image
 
+Registry credentials are managed by **docker-login(1)**.
+
 Docker uses the `https://` protocol to communicate with a registry, unless the
 registry is allowed to be accessed over an insecure connection. Refer to the
 [insecure registries](https://docs.docker.com/engine/reference/commandline/daemon/#insecure-registries)
diff --git a/man/docker-push.1.md b/man/docker-push.1.md
index cf4bc255f1..1b487a0d55 100644
--- a/man/docker-push.1.md
+++ b/man/docker-push.1.md
@@ -44,6 +44,8 @@ Check that this worked by running:
 You should see both `rhel-httpd` and `registry-host:5000/myadmin/rhel-httpd`
 listed.
 
+Registry credentials are managed by **docker-login(1)**.
+
 # HISTORY
 April 2014, Originally compiled by William Henry (whenry at redhat dot com)
 based on docker.com source material and internal work.