fix burnettk#17: allow users to turn off alternate functionality

Author: burnettk

README.md

@@ -52,6 +52,13 @@ If there is a common convention that you feel should really work out of
 the box, feel free to file a pull request to make it work (please
 include a test to prove that it works).
 
+If you don't want to use the alternate functionality, set this before the
+plugin loads:
+
+```
+let g:angular_skip_alternate_mappings = 1
+```
+
 ### Jump to definition of service/directive/controller/etc
 
     gf

doc/angular.txt

@@ -37,7 +37,9 @@ gf                      Bolsters the original gf by also sending you to the
                         That's ok; you can tell angular.vim where your source
                         and test directories are located with
                         g:angular_source_directory and
-                        g:angular_test_directory.
+                        g:angular_test_directory. You can disable this
+                        functionality by doing this before the plugin loads:
+                        let g:angular_skip_alternate_mappings = 1
 
                                                 *angular-:AS*
 :AS                     Like :A, but in a split.

plugin/angular.vim

@@ -296,13 +296,15 @@ augroup angular_gf
   autocmd FileType javascript,html nmap <buffer> <C-W>gf     <Plug>AngularGfTabjump
 augroup END
 
-augroup angular_alternate
-  autocmd!
-  autocmd FileType javascript command! -buffer -bar -bang A :exe s:Alternate('edit<bang>')
-  autocmd FileType javascript command! -buffer -bar AS :exe s:Alternate('split')
-  autocmd FileType javascript command! -buffer -bar AV :exe s:Alternate('vsplit')
-  autocmd FileType javascript command! -buffer -bar AT :exe s:Alternate('tabedit')
-augroup END
+if !exists('g:angular_skip_alternate_mappings')
+  augroup angular_alternate
+    autocmd!
+    autocmd FileType javascript command! -buffer -bar -bang A :exe s:Alternate('edit<bang>')
+    autocmd FileType javascript command! -buffer -bar AS :exe s:Alternate('split')
+    autocmd FileType javascript command! -buffer -bar AV :exe s:Alternate('vsplit')
+    autocmd FileType javascript command! -buffer -bar AT :exe s:Alternate('tabedit')
+  augroup END
+endif
 
 augroup angular_run_spec
   autocmd!

spec/alternate_spec.rb

@@ -6,6 +6,18 @@
     assume_blank_vimrc_by_unsetting_any_global_variables
   end
 
+  # g:angular_skip_alternate_mappings is used at angular.vim load
+  # time, so it's not as simple as this to test it.
+  # specify "should allow user to disable alternates" do
+  #   assume_vimrc('let g:angular_skip_alternate_mappings = "true"')
+  #   file_a = 'app/src/poo.js'
+  #   file_b = 'test/unit/poo.js'
+  #   setup_filesystem(file_a, file_b)
+  #   vim.edit file_a
+  #   vim.command 'A'
+  #   current_file_name.should eq file_a
+  # end
+
   specify "pairs that should work" do
     should_alternate_between('app/src/poo.js', 'test/unit/poo.js')
     should_alternate_between('app/src/poo.js', 'test/unit/poo.spec.js')