From 77ff9c3a6b303ff7f5447cf79391d21b8e6075e1 Mon Sep 17 00:00:00 2001
From: Mitchell Hashimoto <mitchell.hashimoto@gmail.com>
Date: Sun, 20 Jul 2014 17:54:16 -0700
Subject: [PATCH] config: some docs

---
 config/loader.go | 9 ++++++++-
 1 file changed, 8 insertions(+), 1 deletion(-)

diff --git a/config/loader.go b/config/loader.go
index 4ec23330b..bfbb3e210 100644
--- a/config/loader.go
+++ b/config/loader.go
@@ -33,7 +33,14 @@ func Load(path string) (*Config, error) {
 }
 
 // LoadDir loads all the Terraform configuration files in a single
-// directory and merges them together.
+// directory and appends them together.
+//
+// Special files known as "override files" can also be present, which
+// are merged into the loaded configuration. That is, the non-override
+// files are loaded first to create the configuration. Then, the overrides
+// are merged into the configuration to create the final configuration.
+//
+// Files are loaded in lexical order.
 func LoadDir(root string) (*Config, error) {
 	var files, overrides []string