From a11a3a41b83a89be7efb89432ed4cb7b035696b6 Mon Sep 17 00:00:00 2001 From: Doron Behar Date: Tue, 26 Mar 2019 09:45:53 +0200 Subject: [PATCH] README.md: Add EACCESS errors desc & workarounds Also add coc.nvim reference under installation. --- README.md | 21 +++++++++++++++++++++ 1 file changed, 21 insertions(+) diff --git a/README.md b/README.md index bcb974e70..e51110d4c 100644 --- a/README.md +++ b/README.md @@ -20,6 +20,13 @@ with [explainshell][explainshell] integration. npm i -g bash-language-server ``` +If you encounter `EACCESS` errors on installation, similarly to what's described in [#93](https://github.com/mads-hartmann/bash-language-server/issues/93), you may need to solve either or both of the following issues: + +- https://wiki.archlinux.org/index.php/Node.js#node-gyp_python_errors +- https://bugs.archlinux.org/task/54981 + +The workaround for the missing `semver@5.3.0` dependency described in [the Arch Linux Bug report](https://bugs.archlinux.org/task/54981), is best workaround by running `npm install` in `/usr/lib/node_modules/node-gyp`. + ### Clients The following editors and IDEs have available clients: @@ -45,6 +52,19 @@ if executable('bash-language-server') endif ``` +For Vim 8 or Neovim using [neoclide/coc.nvim][coc.nvim], according to [it's Wiki article](https://github.com/neoclide/coc.nvim/wiki/Language-servers#bash), add the following to your `coc-settings.json`: + +```jsonc + "languageserver": { + "bash": { + "command": "bash-language-server", + "args": ["start"], + "filetypes": ["sh"], + "ignoredRootPaths": ["~"] + } + } +``` + For Vim 8 or NeoVim using [w0rp/ale][vim-ale] add the following configuration to your `.vimrc`: @@ -87,3 +107,4 @@ Please see [docs/development-guide][dev-guide] for more information. [languageclient-neovim]: https://github.com/autozimu/LanguageClient-neovim [vim-lsp]: https://github.com/prabirshrestha/vim-lsp [vim-ale]: https://github.com/w0rp/ale +[coc.nvim]: https://github.com/neoclide/coc.nvim