Merge branch 'release/v0.7.0'v0.7.0

* release/v0.7.0: (21 commits)
  Update dotfiles(7) manual from README.md
  Bump version number
  Add heading for Vim plugins subsection
  Update README to mention Vim plugins
  Rename toggle plugin again, use commands not funcs
  Add short documentation for new custom plugins
  Use same comment boilerplate for custom plugins
  Check 'eval' feature for loading command_typos.vim
  Wrap detect_background.vim func call in 'silent!'
  Rename and refactor option toggle plugin
  Don't suggest mappings in Vim plugin comments
  Move Vim background detection logic into plugin
  Specify an install-vim-autoload target
  Spin 'fo' toggle out into new flag toggler plugin
  Spin copyable linebreak config into new plugin
  Spin stable join config out into new plugin
  Use <Plug> prefix, make space strip configurable
  Rename a misnamed variable in big_file.vim
  Rename bigfile plugin to big_file
  Move trailing space strip config into plugin
  ...

1 files changed, 44 insertions, 0 deletions

diff --git a/vim/plugin/toggle_option_flag.vim b/vim/plugin/toggle_option_flag.vim
new file mode 100644
index 00000000..10b4fe7a
--- /dev/null
+++ b/vim/plugin/toggle_option_flag.vim
@@ -0,0 +1,44 @@
+"
+" toggle_option_flag.vim: Provide commands to toggle flags in single-char
+" grouped options like 'formatoptions', 'shortmess', 'complete' etc.
+"
+" This will fail hilariously if you try to set e.g. 'switchbuf' with it!
+"
+" Author: Tom Ryder <tom@sanctum.geek.nz>
+" License: Same as Vim itself
+"
+if has('eval') && has('user_commands')
+
+  " Internal function to do the toggling
+  function! s:Toggle(option, flag, local)
+
+    " Check for weird options, we don't want to eval() anything funny
+    if a:option =~# '[^a-z]'
+      echoerr 'Illegal option name'
+      return
+    endif
+
+    " Weird flags, too; should be a single inoffensive char
+    if a:flag !~# '^[a-z0-9.]$'
+      echoerr 'Illegal flag'
+      return
+    endif
+
+    " Choose which set command to use
+    let l:set = a:local ? 'setlocal' : 'set'
+
+    " Use eval() to assign -= or += to l:op for the option toggle
+    " (I couldn't get {curly braces} indirection to work)
+    let l:op = ''
+    execute 'let l:op = &'.a:option.' =~# a:flag ? "-=" : "+="'
+
+    " Use eval() to perform the option toggle and then print the value
+    execute l:set . ' ' . a:option . l:op . a:flag . ' ' . a:option . '?'
+
+  endfunction
+
+  " User commands wrapping around calls to the above function
+  command! -nargs=+ ToggleOptionFlag :call <SID>Toggle(<f-args>, 0)
+  command! -nargs=+ ToggleOptionFlagLocal :call <SID>Toggle(<f-args>, 1)
+
+endif