Add doc for new blacklist and patterns variables

Author: guns

doc/clojure.txt

@@ -47,15 +47,48 @@ Maximum scan distance of searchpairpos().
     let g:clojure_maxlines = 100
 <
 
-                  *g:clojure_fuzzy_indent* *g:clojure_fuzzy_indent_patterns*
+                                                  *g:clojure_fuzzy_indent*
+                                         *g:clojure_fuzzy_indent_patterns*
+                                        *g:clojure_fuzzy_indent_blacklist*
 
-Indent words that match patterns as if they are included in 'lispwords'
+The 'lispwords' option is a list of comma-separated words that mark special
+forms whose following lines must be indented as if the word is on the
+first line alone.
+
+For example:
+>
+    (defn good []
+      "Correct indentation")
+
+    (defn bad []
+          "Incorrect indentation")
+<
+
+If you would like to match words that match a pattern, you can use the
+fuzzy indent feature. The defaults are:
 >
     " Default
     let g:clojure_fuzzy_indent = 1
+    let g:clojure_fuzzy_indent_patterns = ['^with', '^def', '^let']
+    let g:clojure_fuzzy_indent_blacklist = ['^with-meta$', '-fn$']
+
+    " Legacy comma-delimited string version; the list format above is
+    " recommended. Note that patterns are implicitly anchored with ^ and $.
     let g:clojure_fuzzy_indent_patterns = 'with.*,def.*,let.*'
 <
 
+*g:clojure_fuzzy_indent_patterns* and *g:clojure_fuzzy_indent_blacklist* are
+*Lists* of patterns that will be matched against the unqualified symbol at the
+head of a list. This means that a pattern like "^foo" will match all these
+candidates: "foobar", "my.ns/foobar", and "#'foobar".
+
+Each candidate word is tested for special treatment in this order:
+
+    1. Return true if word is literally in 'lispwords'
+    2. Return false if word matches a pattern in *g:clojure_fuzzy_indent_blacklist*
+    3. Return true if word matches a pattern in *g:clojure_fuzzy_indent_patterns*
+    4. Return false and indent normally otherwise
+
                                        *g:clojure_align_multiline_strings*
 
 When indenting multiline strings, align subsequent lines to the column