From 57eca1a73e50607abddbf580b7e86862e4c1c9d1 Mon Sep 17 00:00:00 2001
From: Daniel Nephin <dnephin@docker.com>
Date: Fri, 12 May 2017 18:45:08 -0400
Subject: [PATCH] Document arg before from

Signed-off-by: Daniel Nephin <dnephin@docker.com>
Upstream-commit: c6e78b9c5f915bc0d717cc4949e32fcfbbe85f55
Component: cli
---
 components/cli/docs/reference/builder.md | 11 +++++++++++
 1 file changed, 11 insertions(+)

diff --git a/components/cli/docs/reference/builder.md b/components/cli/docs/reference/builder.md
index 9c28e8b47f..2571511b64 100644
--- a/components/cli/docs/reference/builder.md
+++ b/components/cli/docs/reference/builder.md
@@ -530,6 +530,17 @@ 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:
+
+```Dockerfile
+ARG  SETTINGS=default
+
+FROM busybox
+ARG  SETTINGS
+
+```
+
 ## RUN
 
 RUN has 2 forms: