From 3973a5e40505422c7ac42692eaecc1ff84f89e7f Mon Sep 17 00:00:00 2001
From: Jongwook Choi <wookayin@gmail.com>
Date: Sun, 14 Jan 2024 23:12:54 -0500
Subject: refactor(lsp): deprecate `vim.lsp.util.lookup_section`

This function is used only in the `workspace/configuration` handler,
and does not warrant a public API because of its confusing return types.

The only caller `vim.lsp.handlers["workspace.configuration"]` is also
refactored to use `vim.tbl_get()` instead.
---
 runtime/doc/deprecated.txt |  2 ++
 runtime/doc/lsp.txt        | 11 -----------
 2 files changed, 2 insertions(+), 11 deletions(-)

(limited to 'runtime/doc')

diff --git a/runtime/doc/deprecated.txt b/runtime/doc/deprecated.txt
index 0f2dbaa77c..1b16a19aca 100644
--- a/runtime/doc/deprecated.txt
+++ b/runtime/doc/deprecated.txt
@@ -144,6 +144,8 @@ LSP FUNCTIONS
 						`progress` of |vim.lsp.client|
 - *vim.lsp.get_active_clients()*		Use |vim.lsp.get_clients()|
 - *vim.lsp.for_each_buffer_client()*		Use |vim.lsp.get_clients()|
+- *vim.lsp.util.lookup_section()*		Use |vim.tbl_get()| and
+						|vim.split()| with {plain=true} instead.
 - *vim.lsp.util.trim_empty_lines()*		Use |vim.split()| with `trimempty` instead.
 - *vim.lsp.util.try_trim_markdown_code_blocks()*
 - *vim.lsp.util.set_lines()*
diff --git a/runtime/doc/lsp.txt b/runtime/doc/lsp.txt
index 9de30f1e8a..e3fc616df4 100644
--- a/runtime/doc/lsp.txt
+++ b/runtime/doc/lsp.txt
@@ -1821,17 +1821,6 @@ locations_to_items({locations}, {offset_encoding})
     Return: ~
         (`vim.lsp.util.LocationItem[]`) list of items
 
-lookup_section({settings}, {section})          *vim.lsp.util.lookup_section()*
-    Helper function to return nested values in language server settings
-
-    Parameters: ~
-      • {settings}  (`table`) language server settings
-      • {section}   (`string`) indicating the field of the settings table
-
-    Return: ~
-        (`table|string|vim.NIL`) The value of settings accessed via section.
-        `vim.NIL` if not found.
-
                                   *vim.lsp.util.make_floating_popup_options()*
 make_floating_popup_options({width}, {height}, {opts})
     Creates a table with sensible default options for a floating window. The
-- 
cgit