# Vim Interaction #
  
  The plugin presents a function called `callvim` whose usage is:
  
      usage: callvim [-b cmd] [-a cmd] [file ... fileN]
      
        -b cmd     Run this command in GVIM before editing the first file
        -a cmd     Run this command in GVIM after editing the first file
        file       The file to edit
        ... fileN  The other files to add to the argslist
  
  ## Rationale ##
  
  The idea for this script is to give you some decent interaction with a running
  GVim session.  Normally you'll be running around your filesystem doing any
  number of amazing things and you'll need to load some files into GVim for
  editing, inspecting, destruction, or other bits of mayhem.  This script lets you
  do that.
  
  ## Aliases ##
  
  There are a few aliases presented as well:
  
  * `v` A shorthand for `callvim`
  * `vvsp` Edits the passed in file but first makes a vertical split
  * `vhsp` Edits the passed in file but first makes a horizontal split
  
  ## Post Callout ##
  
  At the end of the `callvim` function we invoke the `postCallVim` function if it
  exists.  If you're using MacVim, for example, you could define a function that
  brings window focus to it after the file is loaded:
  
      function postCallVim
      {
        osascript -e 'tell application "MacVim" to activate'
      }
  
  This'll be different depending on your OS / Window Manager.
  
  ## Examples ##
  
  This will load `/tmp/myfile.scala` into the running GVim session:
  
      > v /tmp/myfile.scala
  
  This will load it after first doing a vertical split:
  
      > vvsp /tmp/myfile.scala
      or
      > v -b':vsp' /tmp/myfile.scala
  
  This will load it after doing a horizontal split, then moving to the bottom of
  the file:
  
      > vhsp -aG /tmp/myfile.scala
      or
      > v -b':sp' -aG /tmp/myfile.scala
  
  This will load the file and then copy the first line to the end (Why you would
  ever want to do this... I dunno):
  
      > v -a':1t$' /tmp/myfile.scala
  
  And this will load all of the `*.txt` files into the args list:
  
      > v *.txt
  
  If you want to load files into areas that are already split, use one of the
  aliases for that:
  
      # Do a ':wincmd h' first
      > vh /tmp/myfile.scala
  
      # Do a ':wincmd j' first
      > vj /tmp/myfile.scala
  
      # Do a ':wincmd k' first
      > vk /tmp/myfile.scala
  
      # Do a ':wincmd l' first
      > vl /tmp/myfile.scala