From b60d08c468337f65bad2f1a041779b05e64d6bf8 Mon Sep 17 00:00:00 2001
From: Jan Larres <jan@majutsushi.net>
Date: Tue, 5 Nov 2013 09:16:58 +1300
Subject: [PATCH] Add comment why BufReadPost is needed

---
 autoload/tagbar.vim | 2 ++
 1 file changed, 2 insertions(+)

diff --git a/autoload/tagbar.vim b/autoload/tagbar.vim
index ec9ec6c..2682b43 100644
--- a/autoload/tagbar.vim
+++ b/autoload/tagbar.vim
@@ -971,6 +971,8 @@ function! s:CreateAutocommands() abort
 
         autocmd BufWritePost * call
                     \ s:AutoUpdate(fnamemodify(expand('<afile>'), ':p'), 1)
+        " BufReadPost is needed for reloading the current buffer if the file
+        " was changed by an external command; see commit 17d199f
         autocmd BufReadPost,BufEnter,CursorHold,FileType * call
                     \ s:AutoUpdate(fnamemodify(expand('<afile>'), ':p'), 0)
         autocmd BufDelete,BufUnload,BufWipeout * call