From 4228a95ed1e9927baa7261e349c25e8192eccf60 Mon Sep 17 00:00:00 2001
From: kyoh86 <me@kyoh86.dev>
Date: Sat, 29 Jul 2023 14:59:18 +0900
Subject: [PATCH] Describe how the options be used by ddu.vim

---
 doc/ddu.txt | 19 +++++++++++++++++++
 1 file changed, 19 insertions(+)

diff --git a/doc/ddu.txt b/doc/ddu.txt
index 68159e7..e90b0af 100644
--- a/doc/ddu.txt
+++ b/doc/ddu.txt
@@ -1355,6 +1355,9 @@ FAQ 6:							|ddu-faq-6|
 FAQ 7:							|ddu-faq-7|
 	I want to execute grep action from items.
 
+FAQ 8:							|ddu-faq-8|
+	How ddu.vim use options?
+
 
 ------------------------------------------------------------------------------
                                                                    *ddu-faq-1*
@@ -1434,6 +1437,22 @@ A: The example is here. >
 	      \ })
 	endfunction
 <
+							*ddu-faq-8*
+Q: How ddu.vim use options?
+
+	There're 4 layers of options for the ddu.vim in order of priority:
+
+		user: as passed in |ddu#start()| or |ddu#get_items()|.
+		local: as assembled by |ddu#custom#patch_local()| with a name.
+		global: as assembled by |ddu#custom#patch_global()|.
+		default: as described in each |ddu-options|.
+
+	ddu.vim merges them recursively.
+
+	The |ddu-option-name| describes the name which local option be used.
+	And |ddu-option-name| value is also decided by user, global and
+	default options.
+
 
 ==============================================================================
 COMPATIBILITY                                              *ddu-compatibility*