From b47dd5295d06c329c9317a077ce4dca1e873ba40 Mon Sep 17 00:00:00 2001
From: Nahum Shalman <nshalman@omniti.com>
Date: Mon, 23 May 2016 10:01:59 -0400
Subject: [PATCH] Clarification about 'docker build --build-arg'

See #22860

Signed-off-by: Nahum Shalman <nshalman@omniti.com>
---
 docs/reference/commandline/build.md | 3 +++
 1 file changed, 3 insertions(+)

diff --git a/docs/reference/commandline/build.md b/docs/reference/commandline/build.md
index 66b8c42edf..ea820b5d96 100644
--- a/docs/reference/commandline/build.md
+++ b/docs/reference/commandline/build.md
@@ -299,6 +299,9 @@ accessed like regular environment variables in the `RUN` instruction of the
 Dockerfile. Also, these values don't persist in the intermediate or final images
 like `ENV` values do.
 
+Using this flag will not alter the output you see when the `ARG` lines from the
+Dockerfile are echoed during the build process.
+
 For detailed information on using `ARG` and `ENV` instructions, see the
 [Dockerfile reference](../builder.md).