/homebrew-neovim

Primary LanguageRubyMIT LicenseMIT

homebrew-neovim

Build Status

Homebrew formula for neovim.

Usage

To install the latest release:

$ brew install neovim/neovim/neovim

To upgrade from a previous version:

$ brew update
$ brew upgrade neovim

For instructions on how to install the Python modules, see :help nvim-python.

If you instead want to install a developer version of Neovim based on the current GitHub revision, use:

$ brew tap neovim/neovim
$ brew install --HEAD neovim

To upgrade:

$ brew update
$ brew reinstall --HEAD neovim

Troubleshooting

  • Make sure you're using the right formula. brew info neovim should have a From line similar to this:

    From: https://github.com/neovim/homebrew-neovim/blob/master/Formula/neovim.rb
    

    If your formula points elsewhere, then you need to retap the neovim formula. Do so with the following sequence of commands:

    $ brew uninstall neovim --force
    $ brew prune
    $ brew tap neovim/neovim
    $ brew tap --repair
    $ brew install neovim --HEAD
    
  • If you encounter the error Failed to update tap: neovim/neovim, try:

    $ brew untap neovim/neovim
    $ brew tap neovim/neovim
    
  • Run brew update — then try again.

  • Run brew doctor — the doctor diagnoses common issues.

  • Check that Command Line Tools for Xcode (CLT) and/or Xcode are up to date by checking for updates in the App Store.

    • If the build fails with fatal error: '__debug' file not found, you have to install Xcode. This is due to a bug in the Xcode CLT 6.3.
    • If the build fails with ld: library not found for -lgcc_s, make sure you have the same version of Xcode and Xcode CLT installed.
  • Check the Homebrew Troubleshooting page. In particular, the Check for common issues section.

  • You can create a gist log with brew gist-logs neovim.

  • Use --verbose to get the verbose output, i.e. brew install --HEAD --verbose neovim.

  • Use --debug to be in the debug mode. In the debug mode, when failing, you can go into the interactive shell to check the building files before homebrew neutralizing them.

  • If you encounter the error CMAKE_USE_SYSTEM_CURL is ON but a curl is not found, then you're missing the dependency for cURL that allows downloads over TLS. Refer to your operating system's section in Linuxbrew Dependencies to fix this.