vim-signify/README.md
2014-05-04 13:16:07 -07:00

73 lines
2.1 KiB
Markdown

vim-signify
-----------
![Example:signify in action](https://github.com/mhinz/vim-signify/raw/master/signify.gif)
by Marco Hinz
Twitter: https://twitter.com/_mhinz_
IRC: __mhi^__ (Freenode)
If you use any of my plugins, please star them on github. It's a great way of
getting feedback and gives me the kick to put more time into their development.
If you encounter any bugs or have feature requests, just open an issue report on
Github.
Intro
-----
Signify (or just Sy) is a quite unobtrusive plugin. It uses signs to indicate
added, modified and removed lines based on data of an underlying version
control system.
It's __fast__, __easy to use__ and __well documented__.
---
Features:
- supports git, mercurial, darcs, bazaar, subversion, cvs, rcs, fossil, accurev,
perforce
- quick jumping between blocks of changed lines
- apart from signs there is also optional line highlighting
- fully configurable through global variables (options and mappings)
- optional preserving of signs from other plugins
- you can toggle the plugin per buffer
- skip certain filetypes and filenames
- good documentation
- depending on your usual workflow you can disable it per default and enable on
demand later
- quick developer response! :-)
What about vim-gitgutter?
-------------------------
Sy provides a superset of gitgutter.
So here is the short answer: The main difference in Sy is its support for version
control systems other than git. Moreover, two of its design goals are speed and
ease of use.
Installation & Documentation
----------------------------
If you have no preferred installation method, I suggest using tpope's
[pathogen](https://github.com/tpope/vim-pathogen). Afterwards installing
vim-signify is as easy as pie:
$ git clone https://github.com/mhinz/vim-signify ~/.vim/bundle/vim-signify
It works without any configuration, but you might want to look into the
documentation for further customization:
:Helptags " rebuilding tags files
:h signify
_NOTE_: The single most important option by far is `g:signify_vcs_list`. Please
read `:h signify-option-vcs_list`.
License
-------
MIT license. Copyright (c) 2013 Marco Hinz.