Fire event when LSP client is attached to a buffer

This provides a hook for users to configure buffers that use LSP. For
example,

    autocmd User LspAttached {
        nnoremap <buffer> <C-]> <Cmd>LspGotoDefinition<CR>
    }

diff --git a/autoload/lsp/lsp.vim b/autoload/lsp/lsp.vim
index e4f4c8ba4c8cfd46471b42eb97fbb576844058c0..9c8accb18efd737c39ed27d5c6291305e208303c 100644 (file)
--- a/autoload/lsp/lsp.vim
+++ b/autoload/lsp/lsp.vim
@@ -406,6 +406,8 @@ export def AddFile(bnr: number): void
     endif
   augroup END
 
+  doautocmd <nomodeline> User LspAttached
+
   buf.BufLspServerSet(bnr, lspserver)
 enddef
 

diff --git a/doc/lsp.txt b/doc/lsp.txt
index 0ad70a077aed7a2057c2c24ea7dd535294684471..6d7be53d403314336f44ca46ca48ae484c5dfb38 100644 (file)
--- a/doc/lsp.txt
+++ b/doc/lsp.txt
@@ -543,5 +543,11 @@ default. The following example disables omni-completion for python: >
                \   ]
 <
 ==============================================================================
+7. Autocommands                                                *lsp-autocmds*
+
+                                                       *LspAttached*
+LspAttached                    A |User| autocommand fired when the LSP client
+                               attaches to a buffer. Can be used to configure
+                               buffer-local mappings or options.
 
 vim:tw=78:ts=8:noet:ft=help:norl: