docs(lsp): type annotation for lsp.client (#22509)

* Also fix newly found type mismatch.
* Note that it generates new warnings about using @private client
  methods. A proper fix would be to revamp the lsp client documentation
  altogether.
This commit is contained in:
Jaehwang Jung 2023-03-10 06:17:08 +09:00 committed by GitHub
parent 68aa2857dd
commit 0ecb4d725e
No known key found for this signature in database
GPG Key ID: 4AEE18F83AFDEB23
2 changed files with 6 additions and 3 deletions

View File

@ -655,7 +655,7 @@ buf_notify({bufnr}, {method}, {params}) *vim.lsp.buf_notify()*
Send a notification to a server
Parameters: ~
• {bufnr} (number|nil) The number of the buffer
• {bufnr} (integer|nil) The number of the buffer
• {method} (string) Name of the request method
• {params} (any) Arguments to send to the server

View File

@ -154,6 +154,8 @@ local all_buffer_active_clients = {}
local uninitialized_clients = {}
---@private
---@param bufnr? integer
---@param fn fun(client: lsp.Client, client_id: integer, bufnr: integer)
local function for_each_buffer_client(bufnr, fn, restrict_client_ids)
validate({
fn = { fn, 'f' },
@ -1240,6 +1242,7 @@ function lsp.start_client(config)
return
end
---@class lsp.Client
local client = {
id = client_id,
name = name,
@ -1390,7 +1393,7 @@ function lsp.start_client(config)
--- checks for capabilities and handler availability.
---
---@param method string LSP method name.
---@param params table LSP request params.
---@param params table|nil LSP request params.
---@param handler lsp-handler|nil Response |lsp-handler| for this method.
---@param bufnr integer Buffer handle (0 for current).
---@return boolean status, integer|nil request_id {status} is a bool indicating
@ -2087,7 +2090,7 @@ function lsp.buf_request_sync(bufnr, method, params, timeout_ms)
end
--- Send a notification to a server
---@param bufnr (number|nil) The number of the buffer
---@param bufnr (integer|nil) The number of the buffer
---@param method (string) Name of the request method
---@param params (any) Arguments to send to the server
---