Merge pull request spf13#435 from mikedfunk/vimrc_before

updated documentation and comments for .vimrc.before

Author: spf13

.vimrc

@@ -90,7 +90,7 @@
 
     " Most prefer to automatically switch to the current file directory when
     " a new buffer is opened; to prevent this behavior, add the following to
-    " your .vimrc.bundles.local file:
+    " your .vimrc.before file:
     "   let g:spf13_no_autochdir = 1
     if !exists('g:spf13_no_autochdir')
         autocmd BufEnter * if bufname("") !~ "^\[A-Za-z0-9\]*://" | lcd %:p:h | endif
@@ -117,7 +117,7 @@
             set undoreload=10000        " Maximum number lines to save for undo on a buffer reload
         endif
 
-        " To disable views add the following to your .vimrc.bundles.local file:
+        " To disable views add the following to your .vimrc.before file:
         "   let g:spf13_no_views = 1
         if !exists('g:spf13_no_views')
             " Add exclusions to mkview and loadview
@@ -224,7 +224,7 @@
 
     " The default leader is '\', but many people prefer ',' as it's in a standard
     " location. To override this behavior and set it back to '\' (or any other
-    " character) add the following to your .vimrc.bundles.local file:
+    " character) add the following to your .vimrc.before file:
     "   let g:spf13_leader='\'
     if !exists('g:spf13_leader')
         let mapleader = ','
@@ -235,7 +235,7 @@
     " Easier moving in tabs and windows
     " The lines conflict with the default digraph mapping of <C-K>
     " If you prefer that functionality, add let g:spf13_no_easyWindows = 1
-    " in your .vimrc.bundles.local file
+    " in your .vimrc.before file
 
     if !exists('g:spf13_no_easyWindows')
         map <C-J> <C-W>j<C-W>_
@@ -251,7 +251,7 @@
     " The following two lines conflict with moving to top and
     " bottom of the screen
     " If you prefer that functionality, add the following to your
-    " .vimrc.bundles.local file:
+    " .vimrc.before file:
     "   let g:spf13_no_fastTabs = 1
     if !exists('g:spf13_no_fastTabs')
         map <S-H> gT
@@ -545,7 +545,7 @@
             " These two lines conflict with the default digraph mapping of <C-K>
             " If you prefer that functionality, add
             " let g:spf13_no_neosnippet_expand = 1
-            " in your .vimrc.bundles.local file
+            " in your .vimrc.before file
 
             if !exists('g:spf13_no_neosnippet_expand')
                 imap <C-k> <Plug>(neosnippet_expand_or_jump)
@@ -648,7 +648,7 @@
             " These two lines conflict with the default digraph mapping of <C-K>
             " If you prefer that functionality, add
             " let g:spf13_no_neosnippet_expand = 1
-            " in your .vimrc.bundles.local file
+            " in your .vimrc.before file
 
             if !exists('g:spf13_no_neosnippet_expand')
                 imap <C-k> <Plug>(neosnippet_expand_or_jump)

README.markdown

@@ -11,7 +11,7 @@ spf13-vim is a distribution of vim plugins and resources for Vim, Gvim and [MacV
 
 It is a good starting point for anyone intending to use VIM for development running equally well on Windows, Linux, \*nix and Mac.
 
-The distribution is completely customisable using a `~/.vimrc.local` and `~/.vimrc.bundles.local` Vim RC files.
+The distribution is completely customisable using a `~/.vimrc.local`, `~/.vimrc.bundles.local`, and `~/.vimrc.before` Vim RC files.
 
 ![spf13-vim image][spf13-vim-img]
 
@@ -151,18 +151,29 @@ For example, to override the default color schemes:
     echo colorscheme ir_black  >> ~/.vimrc.local
 ```
 
+### Before File
+
+Create a `~/.vimrc.before` file to define any customizations
+that get loaded *before* the spf-13 `.vimrc`.
+
+For example, to prevent autocd into a file directory:
+```bash
+    echo let g:spf13_no_autochdir = 1 >> ~/.vimrc.before
+```
+
 ### Fork Customization
 
 There is an additional tier of customization available to those who want to maintain a
 fork of spf13-vim specialized for a particular group. These users can create `.vimrc.fork`
 and `.vimrc.bundles.fork` files in the root of their fork.  The load order for the configuration is:
 
-1. `.vimrc.bundles.local` - local user bundle configuration
-2. `.vimrc.bundles.fork` - fork bundle configuration
-3. `.vimrc.bundles` - spf13-vim bundle configuration
-4. `.vimrc` - spf13-vim vim configuration
-5. `.vimrc.fork` - fork vim configuration
-6. `.vimrc.local` - local user configuration
+1. `.vimrc.before` - before user configuration
+2. `.vimrc.bundles.local` - local user bundle configuration
+3. `.vimrc.bundles.fork` - fork bundle configuration
+4. `.vimrc.bundles` - spf13-vim bundle configuration
+5. `.vimrc` - spf13-vim vim configuration
+6. `.vimrc.fork` - fork vim configuration
+7. `.vimrc.local` - local user configuration
 
 See `.vimrc.bundles` for specifics on what options can be set to override bundle configuration. See `.vimrc` for specifics
 on what options can be overridden. Most vim configuration options should be set in your `.vimrc.fork` file, bundle configuration