• INSTALLATION
• RELEASE NOTES
• FILES
• CREDITS

Integration of Git for Vim/gVim. The plug-in at hand allows to use Git from within Vim, eliminating the need for context switches. The output of commands like "git status" is written into buffers, and the commit can be manipulated from right there. Further commands allow to quickly add the file in the current buffer or show its diff. Please read the documentation.

This plug-in can be used with Vim version 7.4+ and Neovim 0.2.1+.

The subdirectories in the zip archive git-support.zip mirror the directory structure which is needed below the local installation directory

 $HOME/.vim/ 

(find the value of $HOME with :echo $HOME from inside Vim).

(1.1) Copy the zip archive git-support.zip to $HOME/.vim and run

 unzip git-support.zip 

(1.2) Loading of plug-in files must be enabled. If not use

 :filetype plugin on 

This is the minimal content of the file $HOME/.vimrc. Create one if there is none or use the file in $HOME/.vim/git-support/rc as a starting point.

(1.3) Make the plug-in help accessible by typing the following command on the Vim command line:

 :helptags $HOME/.vim/doc/ 

(1.4) To get a syntax highlighting closer to the one Git uses, take a look at the suggestions in git-support/rc/additions.vimrc, which offers example settings for bright and dark backgrounds.

(1.5) Consider additional settings in the file $HOME/.vimrc. The files customization.vimrc and customization.gvimrc are replacements or extensions for your .vimrc and .gvimrc. You may want to use parts of them. The files are documented.

The subdirectories in the zip archive git-support.zip mirror the directory structure which is needed below the local installation directory

 $HOME/vimfiles/ 

(find the value of $HOME with :echo $HOME from inside Vim).

(2.1) Copy the zip archive git-support.zip to $HOME/vimfiles and run

 unzip git-support.zip 

(2.2) Loading of plug-in files must be enabled. If not use

 :filetype plugin on 

This is the minimal content of the file $HOME/_vimrc. Create one if there is none or use the file in $HOME/vimfiles/git-support/rc as a starting point.

(2.3) Make the plug-in help accessible by typing the following command on the Vim command line:

 :helptags $HOME\vimfiles\doc\ 

(2.4) Set the correct executable. This is not necessary if git is already on your path. See :help g:Git_Executable.

(2.5) To get a syntax highlighting closer to the one Git uses, take a look at the suggestions in git-support\rc\additions.vimrc, which offers example settings for bright and dark backgrounds.

(2.6) Consider additional settings in the file $HOME/_vimrc. The files customization.vimrc and customization.gvimrc are replacements or extensions for your _vimrc and _gvimrc. You may want to use parts of them. The files are documented.

There are a lot of features and options which can be used and influenced:

• the Git executable
• removing the Git menu
• the syntax highlighting
• the behavior of various commands

Please read the documentation:

 :help gitsupport 

Any problems? See the TROUBLESHOOTING section at the end of the help file doc/gitsupport.txt.

• Improve cmd-line completion
• Add option g:Git_AddExpandEmpty
• Remove add with a bang :GitAdd!, use :GitAdd -f instead
• Remove command :GitMergeUpstream, since this is the default behavior of :GitMerge with no arguments
• Add maps to these buffers: branch

-> see file ChangeLog.md

• Windows: When entered on the Vim command line, commands containing filenames as parameters cause errors such as "... file not found ...".
  • This may happen if filenames contain special characters such as spaces. The Vim command line escapes those differently then Windows expects then to be escaped.
  • However, a filename containing spaces can always be escape using quotes: :GitAdd "help 1.txt"
  • If you already are in the corresponding buffer, simply use: :GitAdd

README.md This file. doc/gitsupport.txt The help file for Git Support. plugin/git-support.vim The Git plug-in for Vim/gVim. syntax/gitsbranch.vim syntax/gitscommit.vim syntax/gitsdiff.vim syntax/gitslog.vim syntax/gitssshort.vim syntax/gitsstatus.vim The syntax files used by Git Support. gitssshort.vim is used for the output of "git status --short". gitscommit.vim is used for commit messages. 

The following files and extensions are for convenience only. git-support.vim will work without them. The settings are explained in the files themselves.

git-support/doc/ChangeLog Complete change log. git-support/rc/additions.gvimrc Additional settings for use in .gvimrc: hot keys, mouse settings, fonts, ... git-support/rc/additions.vimrc Example settings for use in .vimrc: setup of the plug-in, syntax highlighting git-support/rc/customization.gvimrc Suggestion for the configuration file .gvimrc: hot keys, mouse settings, fonts, ... git-support/rc/customization.vimrc Suggestion for the configuration file .vimrc: hot keys, tabstop, use of dictionaries, the setup of the plug-in, ... 

For a complete list of people who made contributions to this plug-in, please be so kind as to take a look at the credits:

 :help gitsupport-credits