From e40de088f382d7f88b541084d8829c92cae576db Mon Sep 17 00:00:00 2001
From: Aanand Prasad <aanand.prasad@gmail.com>
Date: Thu, 21 Jan 2016 13:55:40 +0000
Subject: [PATCH] Document depends_on

Signed-off-by: Aanand Prasad <aanand.prasad@gmail.com>
---
 docs/compose-file.md | 23 +++++++++++++++++++++++
 1 file changed, 23 insertions(+)

diff --git a/docs/compose-file.md b/docs/compose-file.md
index ba6b4cb40..d1c4f36f6 100644
--- a/docs/compose-file.md
+++ b/docs/compose-file.md
@@ -169,6 +169,29 @@ client create option.
     devices:
       - "/dev/ttyUSB0:/dev/ttyUSB0"
 
+### depends_on
+
+Express dependency between services, which has two effects:
+
+- `docker-compose up` will start services in dependency order. In the following
+  example, `db` and `redis` will be started before `web`.
+
+- `docker-compose up SERVICE` will automatically include `SERVICE`'s
+  dependencies. In the following example, `docker-compose up web` will also
+  create and start `db` and `redis`.
+
+    version: 2
+    services:
+      web:
+        build: .
+        depends_on:
+          - db
+          - redis
+      redis:
+        image: redis
+      db:
+        image: postgres
+
 ### dns
 
 Custom DNS servers. Can be a single value or a list.