From db36840ecfae4ff6a178a7f25c79aaa77d122821 Mon Sep 17 00:00:00 2001
From: "Andy K. Massimino" <massimino@gatech.edu>
Date: Fri, 17 Nov 2017 11:09:06 -0500
Subject: [PATCH] Document deferred highlighting

---
 README.md | 21 ++++++++++++++++++---
 1 file changed, 18 insertions(+), 3 deletions(-)

diff --git a/README.md b/README.md
index dc2f9b8..b61c41f 100644
--- a/README.md
+++ b/README.md
@@ -387,13 +387,28 @@ let g:matchup_matchparen_status_offscreen = 0
 ```
 default: 1
 
-Adjust timeouts in milliseconds for matchparen highlighting
-```
+Adjust timeouts in milliseconds for matchparen highlighting:
+```vim
 let g:matchup_matchparen_timeout = 300
-let g:matchparen_insert_timeout = 60
+let g:matchup_matchparen_insert_timeout = 60
 ```
 default: 300, 60
 
+Deferred highlighting improves cursor movement performance (for example,
+when using `hjkl`) by delaying highlighting for a short time and waiting
+to see if the cursor continues moving;
+```vim
+let g:matchup_matchparen_deferred = 1
+```
+default: 0 (disabled)
+
+Adjust timeouts in milliseconds for deferred highlighting:
+```vim
+let g:matchparen_matchparen_deferred_show_time = 50
+let g:matchparen_matchparen_deferred_hide_time = 700
+```
+default: 50, 700
+
 ### Module motion
 
 In vim, `{count}%` goes to the `{count}` percentage in the file.