asdf-vim ( / / )

vim plugin for the asdf version manager.

Forked from srivathsanmurali/asdf-cmake.

Contents

• Dependencies
• Install
  • Plugin
  • vim
    • Installation Variable
• Contributing
• License

Dependencies

• bash, curl, tar, and POSIX utilities.
• build-tools and compilers required to build vim, and libraries that vim needs to link.

Install

Plugin:

asdf plugin add vim
# or
asdf plugin add vim https://github.com/tsuyoshicho/asdf-vim.git

vim:

Installation Variable

• ASDF_VIM_TYPE: vim install type [tiny - huge]. default huge.
• ASDF_VIM_CONFIG: vim install configure arguments. default, see install script.
• ASDF_VIM_GUI: optional Vim GUI selection passed as --enable-gui=.... If unset and ASDF_VIM_CONFIG does not specify a GUI, Vim automatically detects available GUI support, so this usually does not need to be set. Supported values are auto, no, gtk2, gnome2, gtk3, gtk4, motif, haiku, photon, and carbon.

Install the required GUI development libraries before building to enable a GUI. For example:

ASDF_VIM_GUI=gtk3 asdf install vim latest

The +image feature requires a huge build and Pixman development files discoverable through pkg-config as pixman-1. Vim detects and links Pixman automatically.

The default configure arguments contain only --with-compiledby=asdf. Setting ASDF_VIM_CONFIG replaces those defaults. When ASDF_VIM_GUI is set, its value takes precedence over any GUI selection in ASDF_VIM_CONFIG.

To make Pixman support required instead of automatically detected, include --enable-pixman --enable-fail-if-missing in ASDF_VIM_CONFIG, for example:

ASDF_VIM_CONFIG="--with-compiledby=asdf --enable-pixman --enable-fail-if-missing" asdf install vim latest

# Show all installable versions
asdf list-all vim

# Install specific version
asdf install vim latest

# Set a version globally (on your ~/.tool-versions file)
asdf global vim latest

# Now vim commands are available
vim --version

Check asdf readme for more instructions on how to install & manage versions.

Contributing

Contributions of any kind welcome! See the contributing guide.

Thanks goes to these contributors!

License

MIT License: See LICENSE file © Tsuyoshi CHO