Add a workaround for using autochdir

Related to justinmk#19

Allow the :cd on autocmd emulation of autochdir to work with dirvish.
Describe this workaround for autochdir-like behavior in the help.

This change might be a first step towards autochdir, but it's not enough
yet.

The autocmd breaks dirvish when we try to force an alternate file
because we're :cd-ing while dirvish is trying to do stuff and we end up
with an empty buffername. This change tracks when we're in set_altbuf so
the autocmd can be disabled during that region (using noau didn't work
and replacing set_altbuf with keepalt everywhere didn't work either).

Ideally, we detect if autochdir is enabled and re-enable it when we're
clear of set_altbuf, but it doesn't work yet.

Author: idbrii

autoload/dirvish.vim

@@ -4,6 +4,9 @@ let s:noswapfile = (2 == exists(':noswapfile')) ? 'noswapfile' : ''
 let s:noau       = 'silent noautocmd keepjumps'
 let s:cb_map = {}   " callback map
 
+" Can autochdir when <= 0, should set autochdir when < 0.
+let s:dirvish_autochdir_blocked_level = 0 - &autochdir
+
 function! s:msg_error(msg) abort
   redraw | echohl ErrorMsg | echomsg 'dirvish:' a:msg | echohl None
 endfunction
@@ -288,11 +291,23 @@ function! s:set_altbuf(bnr) abort
   if has('patch-7.4.605') | let @# = a:bnr | return | endif
 
   let curbuf = bufnr('%')
+
+  set noautochdir
+  let s:dirvish_autochdir_blocked_level += 1
+
   if s:try_visit(a:bnr, 1)
     let noau = bufloaded(curbuf) ? 'noau' : ''
     " Return to the current buffer.
     execute 'silent keepjumps' noau s:noswapfile 'buffer' curbuf
   endif
+
+  let s:dirvish_autochdir_blocked_level -= 1
+
+  if s:should_autochdir()
+    " TODO: Using autochdir still breaks other things (buffername is sometimes
+    " empty).
+    "set autochdir
+  endif
 endfunction
 
 function! s:try_visit(bnr, noau) abort
@@ -472,9 +487,17 @@ function! s:buf_isvalid(bnr) abort
   return bufexists(a:bnr) && !isdirectory(s:sl(bufname(a:bnr)))
 endfunction
 
+function! s:should_autochdir() abort
+  return s:dirvish_autochdir_blocked_level == -1
+endfunction
+
+function! dirvish#can_autochdir() abort
+  return s:dirvish_autochdir_blocked_level <= 0
+endfunction
+
 function! dirvish#open(...) range abort
   if &autochdir
-    call s:msg_error("'autochdir' is not supported")
+    call s:msg_error("'autochdir' is not supported. See help for workaround.")
     return
   endif
   if !&autowriteall && !&hidden && &modified

doc/dirvish.txt

@@ -231,6 +231,14 @@ Check your 'isfname' setting. On Windows (where filepaths may contain
 backslashes "\") |fnamemodify()| may produce nonsense if 'isfname' does not
 contain the aforementioned unusual characters.
 
+Is there a way to use 'autochdir'?~
+Since autochdir is not supported, you can use this workaround: >
+    " 'autochdir' alternative to specify exceptions.
+    " Switch to the directory of the current file, unless it's a help or conflicts with dirvish.
+    autocmd BufEnter * if dirvish#can_autochdir() && match(['help', 'dirvish'], printf("\<%s\>", &ft)) < 0 && filereadable(expand("%")) | silent! cd %:p:h | endif
+<
+Alternatively, you can use |BufReadPost| instead of |BufEnter| to change directories only on load.
+
 How to override the netrw :Explore, :Sexplore, :Vexplore commands? ~
 Put this in your vimrc: >