" vim600: set foldmethod=marker:

"

"

" Last Change:   2006/02/22

" Version:       1.76

" License:       This file is placed in the public domain.

" Credits: {{{1

" Section: Documentation {{{1

"

" (either the current buffer, or, in the case of an directory buffer, the file

" on the current line).  The output of the commands is captured in a new

" another window.

"

" Command documentation {{{2

"

"

"                  argument is given, the argument is used as a revision

"                  number to display.  If not given an argument, it uses the

"                  most recent version of the file on the current branch.

"                  already, the version number on the current line is used.

"

"                  non-zero value, the version previous to the one on the

"                  current line is used instead.  This allows one to navigate

"                  back to examine the previous version of a line.

"

"                  the arguments as the log message.

"

"                  If '!' is used, an empty log message is committed.

"

"                  If called with no arguments, this is a two-step command.

"                  The first step opens a buffer to accept a log message.

"                  When that buffer is written, it is automatically closed and

"                  the file is committed using the information from that log

"                  message.  The commit can be abandoned if the log message

"                  buffer is deleted or wiped before being written.

"

"                  current file against the specified revision.  With two

"                  revisions of the current file.  This command uses the

"                  that variable does not exist, then 'wbBc' is assumed.  If

"                  you wish to have no options, then set it to the empty

"                  string.

"

"

"

"                  most recent version from the repository.

"

"                  argument is given, the most recent version of the file on

"                  the current branch is retrieved.  The specified revision is

"                  retrieved into a new buffer.

"

"

"

"                  then uses vimdiff to display the differences between the

"                  current file and the specified revision.  If no revision is

"                  specified, the most recent version of the file on the

"                  current branch is used.  With one argument, that argument

"                  is used as the revision as above.  With two arguments, the

"                  differences between the two revisions is displayed using

"                  vimdiff.

"

"                  With either zero or one argument, the original buffer is used

"                  to perform the vimdiff.  When the other buffer is closed, the

"                  original buffer will be returned to normal mode.

"

"                  Once vimdiff mode is started using the above methods,

"                  additional vimdiff buffers may be added by passing a single

"                  version argument to the command.  There may be up to 4

"                  vimdiff buffers total.

"

"                  Using the 2-argument form of the command resets the vimdiff

"                  to only those 2 versions.  Additionally, invoking the

"                  command on a different file will close the previous vimdiff

"                  buffers.

"

"

" Mapping documentation: {{{2

"

" By default, a mapping is defined for each command.  User-provided mappings

" can be used instead by mapping to <Plug>CommandName, for instance:

"

"

" The default mappings are as follow:

"

"

" Options documentation: {{{2

"

" Several variables are checked by the script to determine behavior as follow:

"

"   This variable, if set to a non-zero value, causes the zero-argument form

"   previous to that displayed on the current line.  If not set, it defaults

"   to 0.

"

"   to take place immediately as soon as the log message buffer is written.

"   to occur.  If not set, it defaults to 1.

"

"   buffers to automatically delete themselves when hidden.

"

"   This variable, if set, determines the options passed to the diff command

"

"

"   This variable controls whether the original buffer is replaced ('edit') or

"   split ('split').  If not set, it defaults to 'edit'.

"

"   displaying version information in the status bar.

"

"   This variable, if set to a non-zero value, causes appropriate functions (for

"   instead of the current revision if none is specified.

"

"   This variable, if set, configures the special attention-getting characters

"   value.  If not set, it defaults to '_'.  

"

"   or set to a false value, the result buffer is nameless.

"

"   This variable controls the orientation of the various window splits that

"   If set to 'horizontal', the resulting windows will be on stacked on top of

"   one another.  If set to 'vertical', the resulting windows will be

"   side-by-side.  If not set, it defaults to 'horizontal' for all but

"

" Event documentation {{{2

"   match the various hooks.

"

"   For instance, the following could be added to the vimrc to provide a 'q'

"

"   augroup END

"

"   The following hooks are available:

"

"                              result buffer is created and filled with the

"                              the context of the new buffer.

"

"                              occurs, if enabled.

"

"                              first loads.

"

"                              plugin loads.

"

"                              command executes to allow customization of,

"                              for instance, window placement and focus.

"

" Section: Plugin header {{{1

" completes.  This allows various actions to only be taken by functions after

" system initialization.

   finish

endif

if v:version < 602

  finish

endif

" Section: Event group setup {{{1

augroup END

" Section: Plugin initialization {{{1

" Section: Script variable initialization {{{1

unlet! s:vimDiffRestoreCmd

unlet! s:vimDiffSourceBuffer

unlet! s:vimDiffBufferCount

unlet! s:vimDiffScratchList

" Section: Utility functions {{{1

" Fully resolve the given file name to remove shortcuts or symbolic links.

  let resolved = resolve(a:fileName)

  if resolved != a:fileName

  endif

  return resolved

endfunction

  let oldCwd=getcwd()

  let newCwd=fnamemodify(fileName, ':h')

  if strlen(newCwd) > 0

    execute 'cd' escape(newCwd, ' ')

  endif

  return oldCwd

endfunction

" Grab a user-specified option to override the default provided.  Options are

" searched in the window, buffer, then global spaces.

  if exists("s:" . a:name . "Override")

    execute "return s:".a:name."Override"

  elseif exists("w:" . a:name)

    execute "return w:".a:name

  elseif exists("b:" . a:name)

    execute "return b:".a:name

  elseif exists("g:" . a:name)

    execute "return g:".a:name

  else

    return a:default

  endif

endfunction

" Wrapper around the 'edit' command to provide some helpful error text if the

" current buffer can't be abandoned.  If name is provided, it is used;

" otherwise, a nameless scratch buffer is used.

" Returns: 0 if successful, -1 if an error occurs.

  "Name parameter will be pasted into expression.

  let name = escape(a:name, ' *?\')

  if editCommand != 'edit'

      if name == ""

        let editCommand = 'rightbelow new'

      else

        let editCommand = 'rightbelow split ' . name

      endif

    else

      if name == ""

        let editCommand = 'vert rightbelow new'

      else

        let editCommand = 'vert rightbelow split ' . name

      endif

    endif

  else

    if name == ""

      let editCommand = 'enew'

    else

      let editCommand = 'edit ' . name

    endif

  endif

  " Protect against useless buffer set-up

  try

    execute editCommand

  finally

  endtry

endfunction

" Creates a new scratch buffer and captures the output from execution of the

" given command.  The name of the scratch buffer is returned.

  let fileName=bufname(a:origBuffNR)

  let resultBufferName=''

    if strlen(a:statusText) > 0

      let bufName=a:cmdName . ' -- ' . a:statusText

    else

      let bufName=a:cmdName

    endif

    let bufName=fileName . ' ' . nameMarker . bufName . nameMarker

    let counter=0

    let resultBufferName = bufName

    while buflisted(resultBufferName)

      let counter=counter + 1

      let resultBufferName=bufName . ' (' . counter . ')'

    endwhile

  endif

  " HACK:  diff command does not return proper error codes

    else

    endif

    return -1

  endif

    " Handle case of no output.  In this case, it is important to check the

    " of the file with no visible output.

    checktime

    return -1

  endif

    return -1

  endif

  set buftype=nofile

  set noswapfile

  set filetype=

    set bufhidden=delete

  endif

  " The last command left a blank line at the end of the buffer.  If the

  " last line is folded (a side effect of the 'put') then the attempt to

  " remove the blank line will kill the last fold.

  "

  " This could be fixed by explicitly detecting whether the last line is

  " within a fold, but I prefer to simply unfold the result buffer altogether.

  if has('folding')

    normal zR

  endif

  $d

  1

  " Define the environment and execute user-defined hooks.

  if a:statusText != ""

  endif

  return bufnr("%")

endfunction

" for a given buffer.

  if origBuffer

    if bufexists(origBuffer)

      return origBuffer

    else

      " Original buffer no longer exists.

      return -1 

    endif

  else

    " No original buffer

  endif

endfunction

" for the current buffer.

endfunction