feat(lsp)!: support multiple clients in goto methods (#30877)

Relates to:

- https://github.com/neovim/neovim/issues/30034
- https://github.com/neovim/neovim/issues/17712
- https://github.com/neovim/neovim/issues/16363

Closes:

- https://github.com/neovim/neovim/issues/26936 (but only provides bufnr
  and method)
- https://github.com/neovim/neovim/issues/22318

Might fix: https://github.com/neovim/neovim/issues/30737

3 files changed, 8 insertions, 13 deletions

diff --git a/runtime/doc/deprecated.txt b/runtime/doc/deprecated.txt
index 6895348d05..ace509845a 100644
--- a/runtime/doc/deprecated.txt
+++ b/runtime/doc/deprecated.txt
@@ -41,6 +41,9 @@ TREESITTER
   |TSNode:child_with_descendant()| instead; it is identical except that it can
   return the descendant itself.
 
+LSP
+• *vim.lsp.util.jump_to_location*
+
 ------------------------------------------------------------------------------
 DEPRECATED IN 0.10					*deprecated-0.10*
 
diff --git a/runtime/doc/lsp.txt b/runtime/doc/lsp.txt
index f8467faedb..f601ffab4c 100644
--- a/runtime/doc/lsp.txt
+++ b/runtime/doc/lsp.txt
@@ -2027,19 +2027,6 @@ get_effective_tabstop({bufnr})          *vim.lsp.util.get_effective_tabstop()*
     See also: ~
       • 'shiftwidth'
 
-                                             *vim.lsp.util.jump_to_location()*
-jump_to_location({location}, {offset_encoding}, {reuse_win})
-    Jumps to a location.
-
-    Parameters: ~
-      • {location}         (`lsp.Location|lsp.LocationLink`)
-      • {offset_encoding}  (`'utf-8'|'utf-16'|'utf-32'?`)
-      • {reuse_win}        (`boolean?`) Jump to existing window if buffer is
-                           already open.
-
-    Return: ~
-        (`boolean`) `true` if the jump succeeded
-
                                            *vim.lsp.util.locations_to_items()*
 locations_to_items({locations}, {offset_encoding})
     Returns the items with the byte position calculated correctly and in
diff --git a/runtime/doc/news.txt b/runtime/doc/news.txt
index 56104d9fdb..9045f9f669 100644
--- a/runtime/doc/news.txt
+++ b/runtime/doc/news.txt
@@ -82,6 +82,11 @@ LSP
 • |vim.lsp.buf.references()| now handles multiple clients but no longer
   triggers the global `textDocument/references` handler from
   `vim.lsp.handlers`
+• |vim.lsp.buf.declaration()|, |vim.lsp.buf.definition()|,
+  |vim.lsp.buf.type_definition()| and |vim.lsp.buf.implementation()| now
+  support merging the results of multiple clients but no longer trigger the
+  global handlers from `vim.lsp.handlers`
+
 
 LUA