From 9ab1d55d06b3f8b8480c64a5c958c45a1361f286 Mon Sep 17 00:00:00 2001
From: Jarrod Pooler <jarrod.pooler@homesite.com>
Date: Fri, 8 Jul 2016 15:56:15 -0400
Subject: [PATCH] Updating arg docs in the proper place

Signed-off-by: Jarrod Pooler <jarrod.pooler@homesite.com>
---
 docs/compose-file.md | 23 +++++++++++++++++++++++
 1 file changed, 23 insertions(+)

diff --git a/docs/compose-file.md b/docs/compose-file.md
index d286257d3..fce3f1bcc 100644
--- a/docs/compose-file.md
+++ b/docs/compose-file.md
@@ -119,6 +119,29 @@ Add build arguments. You can use either an array or a dictionary. Any
 boolean values; true, false, yes, no, need to be enclosed in quotes to ensure
 they are not converted to True or False by the YML parser.
 
+First, specify the arguments in your Dockerfile:
+
+    ARG buildno
+    ARG password
+
+    RUN echo "Build number: $buildno"
+    RUN script-requiring-password.sh "$password"
+
+Then specify the arguments under the `build` key. You can pass either a mapping
+or a list:
+
+    build:
+      context: .
+      args:
+        buildno: 1
+        password: secret
+
+    build:
+      context: .
+      args:
+        - buildno=1
+        - password=secret
+
 Build arguments with only a key are resolved to their environment value on the
 machine Compose is running on.