Skip to main content

Emacs

The ELP project can be used as a language server in the Emacs text editor via the lsp-mode LSP client.

Requirements​

lsp-mode​

Install the lsp-mode package, which is a generic Emacs client for LSP servers. You can follow these instructions to install it.

Configure Emacs​

Add the following to your emacs .emacs file or equivalent.

(use-package lsp-mode

  :config
  ;; Enable LSP automatically for Erlang files
  (add-hook 'erlang-mode-hook #'lsp)

  ;; ELP, added as priority 0 (> -1) so takes priority over the built-in one
  (lsp-register-client
   (make-lsp-client :new-connection (lsp-stdio-connection '("elp" "server"))
                    :major-modes '(erlang-mode)
                    :priority 0
                    :server-id 'erlang-language-platform))
  )

For a list of available configuration option, please refer to this page and to the lsp-mode settings documentation.

Troubleshooting​

The following servers support current file but do not have automatic installation​

Ensure that the elp executable is available in your PATH via Emacs. A workaround is:

;; Ensure your Emacs environment looks like your user's shell one
(package-require 'exec-path-from-shell)
(exec-path-from-shell-initialize)