diff --git a/README.mkd b/README.mkd index fbee4aa..990a7a6 100644 --- a/README.mkd +++ b/README.mkd @@ -273,13 +273,13 @@ endif To customise the colours, set up the following highlight groups in your colorscheme or `~/.vimrc`: ```viml -GitGutterAdd " an added line -GitGutterChange " a changed line -GitGutterDelete " at least one removed line -GitGutterChangeDelete " a changed line followed by at least one removed line +GitGutterAdd " an added line (default: links to DiffAdd) +GitGutterChange " a changed line (default: links to DiffChange) +GitGutterDelete " at least one removed line (default: links to DiffDelete) +GitGutterChangeDelete " a changed line followed by at least one removed line (default: links to GitGutterChange) ``` -You can either set these with `highlight GitGutterAdd {key}={arg}...` or link them to existing highlight groups with, say, `highlight link GitGutterAdd DiffAdd`. +You can either set these with `highlight GitGutterAdd {key}={arg}...` or link them to existing highlight groups with, say, `highlight link GitGutterAdd MyDiffAdd`. To customise the symbols, add the following to your `~/.vimrc`: @@ -303,6 +303,12 @@ GitGutterDeleteLine " default: links to DiffDelete GitGutterChangeDeleteLine " default: links to GitGutterChangeLineDefault, i.e. DiffChange ``` +For example, in some colorschemes the `DiffText` highlight group is easier to read than `DiffChange`. You could use it like this: + +```viml +highlight link GitGutterChangeLine DiffText +``` + #### The base of the diff diff --git a/autoload/gitgutter/highlight.vim b/autoload/gitgutter/highlight.vim index b8bc771..62746f7 100644 --- a/autoload/gitgutter/highlight.vim +++ b/autoload/gitgutter/highlight.vim @@ -45,20 +45,15 @@ function! gitgutter#highlight#define_highlights() abort " Highlights used by the signs. - execute "highlight GitGutterAddDefault guifg=#009900 guibg=" . guibg . " ctermfg=2 ctermbg=" . ctermbg - execute "highlight GitGutterChangeDefault guifg=#bbbb00 guibg=" . guibg . " ctermfg=3 ctermbg=" . ctermbg - execute "highlight GitGutterDeleteDefault guifg=#ff2222 guibg=" . guibg . " ctermfg=1 ctermbg=" . ctermbg - highlight default link GitGutterChangeDeleteDefault GitGutterChangeDefault - execute "highlight GitGutterAddInvisible guifg=bg guibg=" . guibg . " ctermfg=" . ctermbg . " ctermbg=" . ctermbg execute "highlight GitGutterChangeInvisible guifg=bg guibg=" . guibg . " ctermfg=" . ctermbg . " ctermbg=" . ctermbg execute "highlight GitGutterDeleteInvisible guifg=bg guibg=" . guibg . " ctermfg=" . ctermbg . " ctermbg=" . ctermbg highlight default link GitGutterChangeDeleteInvisible GitGutterChangeInvisible - highlight default link GitGutterAdd GitGutterAddDefault - highlight default link GitGutterChange GitGutterChangeDefault - highlight default link GitGutterDelete GitGutterDeleteDefault - highlight default link GitGutterChangeDelete GitGutterChangeDeleteDefault + highlight default link GitGutterAdd DiffAdd + highlight default link GitGutterChange DiffChange + highlight default link GitGutterDelete DiffDelete + highlight default link GitGutterChangeDelete GitGutterChange " Highlights used for the whole line. diff --git a/doc/gitgutter.txt b/doc/gitgutter.txt index 49d6d99..87825da 100644 --- a/doc/gitgutter.txt +++ b/doc/gitgutter.txt @@ -438,7 +438,7 @@ colorscheme or |vimrc|: You can either set these with `highlight GitGutterAdd {key}={arg}...` or link them to existing highlight groups with, say: > - highlight link GitGutterAdd DiffAdd + highlight link GitGutterAdd MyDiffAdd < To change the line highlights, set up the following highlight groups in your @@ -450,6 +450,11 @@ colorscheme or |vimrc|: GitGutterChangeDeleteLine " default: links to GitGutterChangeLineDefault < +For example, to use |hl-DiffText| instead of |hl-DiffChange|: +> + highlight link GitGutterChangeLine DiffChange +< + =============================================================================== FAQ *gitgutter-faq*