Clarify docs about ARG in FROM

Signed-off-by: Daniel Nephin <dnephin@docker.com>
docker · Jul 13, 2017 · cc6044b · cc6044b
1 parent e3746d3
commit cc6044b
Showing 1 changed file with 4 additions and 2 deletions.
diff --git a/docs/reference/builder.md b/docs/reference/builder.md
@@ -530,8 +530,10 @@ FROM extras:${CODE_VERSION}
 CMD  /code/run-extras
 ```
 
-To use the default value of an `ARG` declared before the first `FROM` use an
-`ARG` instruction without a value:
+An `ARG` declared before a `FROM` is outside of a build stage, so it
+can't be used in any instruction after a `FROM`. To use the default value of
+an `ARG` declared before the first `FROM` use an `ARG` instruction without
+a value inside of a build stage:
 
 ```Dockerfile
 ARG  SETTINGS=default