diff --git a/components/engine/docs/reference/commandline/build.md b/components/engine/docs/reference/commandline/build.md
index eb1bb426b7..8ef0628598 100644
--- a/components/engine/docs/reference/commandline/build.md
+++ b/components/engine/docs/reference/commandline/build.md
@@ -298,6 +298,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).