Join GitHub today
GitHub is home to over 28 million developers working together to host and review code, manage projects, and build software together.Sign up
Vimscript library of common functions. http://www.vim.org/scripts/script.php…
Fetching latest commit…
Cannot retrieve the latest commit at this time.
|Failed to load latest commit information.|
This is a mirror of http://www.vim.org/scripts/script.php?script_id=4433 DESCRIPTION This library contains common autoload functions that are used by almost all of my plugins (http://www.vim.org/account/profile.php?user_id=9713). Instead of duplicating the functionality, or installing potentially conflicting versions with each plugin, this one core dependency fosters a lean Vim runtime and easier plugin updates. RELATED WORKS Other authors have published separate support libraries, too: - genutils (vimscript #197) by Hari Krishna Dara - lh-vim-lib (vimscript #214) by Luc Hermitte - cecutil (vimscript #1066) by DrChip - tlib (vimscript #1863) by Thomas Link - TOVL (vimscript #1963) by Marc Weber - l9 (vimscript #3252) by Takeshi Nishida - anwolib (vimscript #3800) by Andy Wokula - vim-misc (vimscript #4597) by Peter Odding - maktaba (https://github.com/google/maktaba) by Google - vital (https://github.com/vim-jp/vital.vim) by the Japanese Vim user group - underscore.vim (vimscript #5149) by haya14busa provides functional programming functions and depends on the (rather complex) vital library There have been initiatives to gather and consolidate useful functions into a "standard Vim library", but these efforts have mostly fizzled out. USAGE This library is mainly intended to be used by my own plugins. However, I try to maintain backwards compatibility as much as possible. Feel free to use the library for your own plugins and customizations, too. I'd also like to hear from you if you have additions or comments. EXCEPTION HANDLING For exceptional conditions (e.g. cannot locate window that should be there) and programming errors (e.g. passing a wrong variable type to a library function), error strings are |:throw|n. These are prefixed with (something resembling) the short function name, so that it's possible to :catch these and e.g. convert them into a proper error (e.g. via ingo#err#SetCustomException()).