From df313b859f19857a9773627d60bf2e6c8d6ba9b3 Mon Sep 17 00:00:00 2001
From: John MacFarlane <fiddlosopher@gmail.com>
Date: Thu, 19 Sep 2013 21:04:58 -0700
Subject: [PATCH] Added small explanation of difference btw `-M` and `-V`.

---
 README | 6 +++++-
 1 file changed, 5 insertions(+), 1 deletion(-)

diff --git a/README b/README
index 6c9c9d3ed..ba1f93661 100644
--- a/README
+++ b/README
@@ -289,7 +289,11 @@ Reader options
 :   Set the metadata field *KEY* to the value *VAL*.  A value specified
     on the command line overrides a value specified in the document.
     Values will be parsed as YAML boolean or string values. If no value is
-    specified, the value will be treated as Boolean true.
+    specified, the value will be treated as Boolean true.  Like
+    `--variable`, `--metadata` causes template variables to be set.
+    But unlike `--variable`, `--metadata` affects the metadata of the
+    underlying document (which is accessible from filters and may be
+    printed in some output formats).
 
 `--normalize`
 :   Normalize the document after reading:  merge adjacent