From db76121d89670108b27b2bcc958ff7f84203a2c8 Mon Sep 17 00:00:00 2001
From: "Benjamin J. Balter" <ben.balter@github.com>
Date: Mon, 15 Apr 2013 12:56:33 -0400
Subject: [PATCH] Make --config usage more explicit.

See https://github.com/mojombo/jekyll/pull/965#discussion_r3797116 and https://github.com/mojombo/jekyll/pull/965#discussion_r3797085

Props @parkr.
---
 site/_posts/2012-07-01-upgrading.md | 8 +++++---
 1 file changed, 5 insertions(+), 3 deletions(-)

diff --git a/site/_posts/2012-07-01-upgrading.md b/site/_posts/2012-07-01-upgrading.md
index f4992a92..7bd04397 100644
--- a/site/_posts/2012-07-01-upgrading.md
+++ b/site/_posts/2012-07-01-upgrading.md
@@ -28,12 +28,14 @@ Simply add the `--config` flag to the `jekyll` command, followed by the path
 to one or more config files.
 
 <div class="note info">
-  <h5 mardown="1">The `--config` flag overrides your `_config.yml` file</h5>
+  <h5 mardown="1">The `--config` explicitly specifies your configuration file</h5>
   <p markdown="1">If you use the `--config` flag, Jekyll will ignore your 
     `_config.yml` file. Want to merge a custom configuration with the normal 
     configuration? No problem. Jekyll will accept more than one custom config 
-    file via the command line. Simply pass the path to both files with the latter 
-    file overriding the former.</p>
+    file via the command line. Config files cascade from right to left, such 
+    that if I run `jekyll serve --config `--config _config.yml,_config-dev.yml`,
+    the values in the config files on the right (`_config-dev.yml`) overwrite 
+    those on the left (`_config.yml`) when both contain the same key. , </p>
 </div>
 
 #### As a result, the following command line flags are now deprecated: