From c4776804f42ef9fda80b382fca17626fb294d4fd Mon Sep 17 00:00:00 2001
From: Boaz Shuster <ripcurld.github@gmail.com>
Date: Sun, 13 Nov 2016 10:28:25 +0200
Subject: [PATCH] Change the docker-tag usage text to be clearer

Signed-off-by: Boaz Shuster <ripcurld.github@gmail.com>
---
 docs/reference/commandline/tag.md | 4 ++--
 man/docker-tag.1.md               | 4 ++--
 2 files changed, 4 insertions(+), 4 deletions(-)

diff --git a/docs/reference/commandline/tag.md b/docs/reference/commandline/tag.md
index 131d375193..983bfe27b2 100644
--- a/docs/reference/commandline/tag.md
+++ b/docs/reference/commandline/tag.md
@@ -16,9 +16,9 @@ keywords: "tag, name, image"
 # tag
 
 ```markdown
-Usage:  docker tag IMAGE[:TAG] IMAGE[:TAG]
+Usage:  docker tag SOURCE_IMAGE[:TAG] TARGET_IMAGE[:TAG]
 
-Tag an image into a repository
+Create a tag TARGET_IMAGE that refers to SOURCE_IMAGE
 
 Options:
       --help   Print usage
diff --git a/man/docker-tag.1.md b/man/docker-tag.1.md
index 9bb252aef0..7f27e1b0e1 100644
--- a/man/docker-tag.1.md
+++ b/man/docker-tag.1.md
@@ -2,12 +2,12 @@
 % Docker Community
 % JUNE 2014
 # NAME
-docker-tag - Tag an image into a repository
+docker-tag - Create a tag `TARGET_IMAGE` that refers to `SOURCE_IMAGE`
 
 # SYNOPSIS
 **docker tag**
 [**--help**]
-NAME[:TAG] NAME[:TAG]
+SOURCE_NAME[:TAG] TARGET_NAME[:TAG]
 
 # DESCRIPTION
 Assigns a new alias to an image in a registry. An alias refers to the